From fd838b3e6d94c2505054665bb1f552c08e8b22db Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Tue, 23 Dec 2025 16:53:41 -0800 Subject: [PATCH] replace funny whitespace character --- .../IExtendPropertySheet2.xml | 10 +- xml/Microsoft.IE/Manager.xml | 10 +- xml/Microsoft.VisualBasic/Conversion.xml | 12 +- xml/Microsoft.Vsa/BaseVsaSite.xml | 2 +- xml/Microsoft.Vsa/IVsaCodeItem.xml | 16 +- xml/Microsoft.Windows.Themes/BulletChrome.xml | 4 +- .../ClassicBorderDecorator.xml | 2 +- .../DataGridHeaderBorder.xml | 2 +- .../ListBoxChrome.xml | 2 +- .../SystemDropShadowChrome.xml | 2 +- .../ModelItem.xml | 242 +++--- xml/System.Data.Linq/DataContext.xml | 4 +- xml/System.Data.OracleClient/OracleString.xml | 176 ++--- .../ContractOptionAttribute.xml | 130 ++-- .../DebuggerStepThroughAttribute.xml | 10 +- xml/System.Drawing.Design/UITypeEditor.xml | 4 +- xml/System.Net.Http/HttpClient.xml | 2 +- xml/System.Security.Policy/Evidence.xml | 2 +- .../SslStreamSecurityBindingElement.xml | 414 +++++------ .../BaseAddressPrefixFilterElement.xml | 70 +- .../TcpTransportSecurity.xml | 104 +-- xml/System.Windows.Forms/Form.xml | 6 +- xml/System.Windows.Forms/NumericUpDown.xml | 476 ++++++------ .../ToolStripComboBox.xml | 2 +- .../ToolStripMenuItem.xml | 4 +- xml/System.Windows.Forms/UpDownBase.xml | 610 +++++++-------- xml/System.Windows/UIElement.xml | 2 +- xml/System.Windows/Vector.xml | 696 +++++++++--------- xml/System/Attribute.xml | 12 +- xml/System/Convert.xml | 12 +- 30 files changed, 1520 insertions(+), 1520 deletions(-) diff --git a/xml/Microsoft.Aspnet.Snapin/IExtendPropertySheet2.xml b/xml/Microsoft.Aspnet.Snapin/IExtendPropertySheet2.xml index 0bfe2c73cba..122fd586837 100644 --- a/xml/Microsoft.Aspnet.Snapin/IExtendPropertySheet2.xml +++ b/xml/Microsoft.Aspnet.Snapin/IExtendPropertySheet2.xml @@ -25,7 +25,7 @@ @@ -67,7 +67,7 @@ For more information about programming with the IExtendPropertySheet2 interface interface and the Microsoft Management Console (MMC), see the [MMC Programmer's Guide](https://learn.microsoft.com/previous-versions/windows/desktop/mmc/mmc-programmer-s-guide-overview). ]]> @@ -103,14 +103,14 @@ For more information about programming with the The handle to a bitmap that serves as the header for Wizard 97 pages. The handle to a palette used for the bitmaps specified by lphWatermark and lphHeader. A GetWatermarks return value: true if the watermark and header bitmaps should be stretched rather than tiled; otherwise, false. - Retrieves the watermark and header bitmaps for wizard sheets that are implemented as Wizard 97-style wizards. + Retrieves the watermark and header bitmaps for wizard sheets that are implemented as Wizard 97-style wizards. | Return Value | Description | | --- | --- | | etch | true if the watermark and header bitmaps should be stretched rather than tiled; otherwise, false. | interface and the Microsoft Management Console (MMC), see the [MMC Programmer's Guide](https://learn.microsoft.com/previous-versions/windows/desktop/mmc/mmc-programmer-s-guide-overview). ]]> @@ -148,7 +148,7 @@ For more information about programming with the interface and the Microsoft Management Console (MMC), see the [MMC Programmer's Guide](https://learn.microsoft.com/previous-versions/windows/desktop/mmc/mmc-programmer-s-guide-overview). ]]> diff --git a/xml/Microsoft.IE/Manager.xml b/xml/Microsoft.IE/Manager.xml index d4762ed047d..97b49309f40 100644 --- a/xml/Microsoft.IE/Manager.xml +++ b/xml/Microsoft.IE/Manager.xml @@ -29,7 +29,7 @@ @@ -218,8 +218,8 @@ The Manager class initializes the properties that enable managed code to execute The name of the assembly. The name of the class. - Not implemented. - + Not implemented. + This API is not CLS-compliant. Always null (Nothing in Visual Basic). To be added. @@ -355,12 +355,12 @@ This API is not CLS-compliant. The name of the assembly. Creates a class factory that provides security information about the assembly. -This API is not CLS-compliant.  +This API is not CLS-compliant. An object that represents the secure class factory. diff --git a/xml/Microsoft.VisualBasic/Conversion.xml b/xml/Microsoft.VisualBasic/Conversion.xml index 1e1c6d10e54..0a2dbcf4277 100644 --- a/xml/Microsoft.VisualBasic/Conversion.xml +++ b/xml/Microsoft.VisualBasic/Conversion.xml @@ -2901,13 +2901,13 @@ Dim i3 As Integer = CInt(Fix(sng)) ' Result: 175 The following call returns the value 1615198. ```vb -Val(" 1615 198th Street N.E.")  +Val(" 1615 198th Street N.E.") ``` The following call returns the decimal value -1. ```vb -Val("&HFFFF")  +Val("&HFFFF") ``` > [!NOTE] @@ -2995,13 +2995,13 @@ Dim n = 1.34& The following call returns the value 1234123. ```vb -Val(" 1234 123th Street N.E.")  +Val(" 1234 123th Street N.E.") ``` The following call returns the decimal value -1. ```vb -Val("&HFFFF")  +Val("&HFFFF") ``` > [!NOTE] @@ -3090,13 +3090,13 @@ Val("&HFFFF")  The following call returns the value 1234123. ```vb -Val(" 1234 123th Street N.E.")  +Val(" 1234 123th Street N.E.") ``` The following call returns the decimal value -1. ```vb -Val("&HFFFF")  +Val("&HFFFF") ``` > [!NOTE] diff --git a/xml/Microsoft.Vsa/BaseVsaSite.xml b/xml/Microsoft.Vsa/BaseVsaSite.xml index e371efce0fe..10991eab66c 100644 --- a/xml/Microsoft.Vsa/BaseVsaSite.xml +++ b/xml/Microsoft.Vsa/BaseVsaSite.xml @@ -234,7 +234,7 @@ - The IVsaError object representing the offending error. + The IVsaError object representing the offending error. Notifies the host about how to respond to compiler errors encountered by the script engine. if the compiler is directed to continue reporting further errors to the IJSVsaSite object; if the compiler is directed to stop reporting further errors to the IVsaSite object. diff --git a/xml/Microsoft.Vsa/IVsaCodeItem.xml b/xml/Microsoft.Vsa/IVsaCodeItem.xml index 5c3820fad11..7a625bd9b0c 100644 --- a/xml/Microsoft.Vsa/IVsaCodeItem.xml +++ b/xml/Microsoft.Vsa/IVsaCodeItem.xml @@ -34,7 +34,7 @@ [!NOTE] -> The JScript .NET script engine does not support this method. In cases where the JScript .NET engine must hook up an event, you must do so using a global item. Rather than event sources, the JScript .NET engine uses AppGlobal item types. For more information, see VsaItemType. +> The JScript .NET script engine does not support this method. In cases where the JScript .NET engine must hook up an event, you must do so using a global item. Rather than event sources, the JScript .NET engine uses AppGlobal item types. For more information, see VsaItemType. Within the code item, you can access the event source object by name, and, once accessed, you can write event handlers against the object. The event source type is passed as a string rather than as a Type object to facilitate implementing event sources by unmanaged hosts. @@ -114,7 +114,7 @@ For more information about the mechanisms for hooking up events for the script e @@ -177,7 +177,7 @@ The CodeDOM property is typically generated as part of the compilation step of t @@ -206,7 +206,7 @@ Removing an event source does not remove the underlying event handler from sourc + ``` -or- ```xaml - + ``` ]]> diff --git a/xml/Microsoft.Windows.Themes/ClassicBorderDecorator.xml b/xml/Microsoft.Windows.Themes/ClassicBorderDecorator.xml index 19199737fbb..52a4e3b58c7 100644 --- a/xml/Microsoft.Windows.Themes/ClassicBorderDecorator.xml +++ b/xml/Microsoft.Windows.Themes/ClassicBorderDecorator.xml @@ -34,7 +34,7 @@ ```xaml -  singleChild + singleChild ``` diff --git a/xml/Microsoft.Windows.Themes/DataGridHeaderBorder.xml b/xml/Microsoft.Windows.Themes/DataGridHeaderBorder.xml index 73178b9070b..3aa9c20acc7 100644 --- a/xml/Microsoft.Windows.Themes/DataGridHeaderBorder.xml +++ b/xml/Microsoft.Windows.Themes/DataGridHeaderBorder.xml @@ -83,7 +83,7 @@ ```xaml -  singleChild + singleChild ``` diff --git a/xml/Microsoft.Windows.Themes/ListBoxChrome.xml b/xml/Microsoft.Windows.Themes/ListBoxChrome.xml index 987c207dccd..70f5b25edbd 100644 --- a/xml/Microsoft.Windows.Themes/ListBoxChrome.xml +++ b/xml/Microsoft.Windows.Themes/ListBoxChrome.xml @@ -43,7 +43,7 @@ ```xaml -  singleChild + singleChild ``` diff --git a/xml/Microsoft.Windows.Themes/SystemDropShadowChrome.xml b/xml/Microsoft.Windows.Themes/SystemDropShadowChrome.xml index a091641e076..f2eeab9c4b3 100644 --- a/xml/Microsoft.Windows.Themes/SystemDropShadowChrome.xml +++ b/xml/Microsoft.Windows.Themes/SystemDropShadowChrome.xml @@ -86,7 +86,7 @@ ```xaml -  singleChild + singleChild ``` diff --git a/xml/System.Activities.Presentation.Model/ModelItem.xml b/xml/System.Activities.Presentation.Model/ModelItem.xml index de8df9d10d6..938ccbdf8e1 100644 --- a/xml/System.Activities.Presentation.Model/ModelItem.xml +++ b/xml/System.Activities.Presentation.Model/ModelItem.xml @@ -20,89 +20,89 @@ Represents a single item in the editing model. An item can be anything from a complex data structure down to a color or integer. - collection and make changes to the values of the properties. - - A is a wrapper around the underlying data model of the designer. You can access the underlying model through the method. - + collection and make changes to the values of the properties. + + A is a wrapper around the underlying data model of the designer. You can access the underlying model through the method. + > [!NOTE] -> Any changes you make to an object returned from the method will not be reflected by the serialization and undo systems of the designer. - - - -## Examples - The can be thought of as a thin proxy for an object at which it points. First define a simple `Animal` object. - -```csharp - -public class Animal -{ - // simple property - public string Name { get; set; } - // complex property - public Location Residence { get; set; } - // list - public List CloseRelatives { get; set; } - // dictionary - public Dictionary Features { get; set; } -} - -public class Location -{ - public string StreetAddress { get; set; } - public string City { get; set; } - public string State { get; set; } -} - -``` - - Secondly, create an instance of that `Animal` and a that is a proxy for it. The object can then be retrieved by calling . The following code also shows how to use other properties defined by . - -```csharp - -EditingContext ec = new EditingContext(); -var companion1 = new Animal { Name = "Houdini the parakeet" }; -var companion2 = new Animal { Name = "Groucho the fish" }; -var animal = new Animal - { - Name = "Sasha the pug", - Residence = new Location - { - StreetAddress = "123 Main Street", - City = "AnyTown", - State = "Washington" - }, - Features = new Dictionary { - {"noise", "snort" }, - {"MeanTimeUntilNaps", TimeSpan.FromMinutes(15) } - }, - CloseRelatives = new List { companion1, companion2 } - }; -ModelTreeManager mtm = new ModelTreeManager(ec);  mtm.Load(animal); -ModelItem mi = mtm.Root; - -//Testing other properties of the class -ModelItem root = mtm.Root; -Assert.IsTrue(root.GetCurrentValue() == animal, "GetCurrentValue() returns same object"); -Assert.IsTrue(root.ItemType == typeof(Animal),"ItemType describes the item"); -Assert.IsTrue(root.Parent == null,"root parent is null"); -Assert.IsTrue(root.Source == null, "root source is null"); -Assert.IsTrue(((List)root.Properties["CloseRelatives"].ComputedValue)[0] == companion1, - "ComputedValue of prop == actual object"); -Assert.IsFalse(((List)root.Properties["CloseRelatives"].ComputedValue)[0] == companion2, - "ComputedValue of prop == actual object"); -Assert.AreEqual(root.Properties["Residence"]. - Value. - Properties["StreetAddress"]. - Value.GetCurrentValue(), "123 Main Street", "get actual value back out"); -Assert.AreEqual(root, root.Properties["Residence"].Parent, "property points to owner"); -ModelItem location = root.Properties["Residence"].Value; -Assert.AreEqual(root.Properties["Residence"], location.Source, "sources point to the right place"); - -``` - +> Any changes you make to an object returned from the method will not be reflected by the serialization and undo systems of the designer. + + + +## Examples + The can be thought of as a thin proxy for an object at which it points. First define a simple `Animal` object. + +```csharp + +public class Animal +{ + // simple property + public string Name { get; set; } + // complex property + public Location Residence { get; set; } + // list + public List CloseRelatives { get; set; } + // dictionary + public Dictionary Features { get; set; } +} + +public class Location +{ + public string StreetAddress { get; set; } + public string City { get; set; } + public string State { get; set; } +} + +``` + + Secondly, create an instance of that `Animal` and a that is a proxy for it. The object can then be retrieved by calling . The following code also shows how to use other properties defined by . + +```csharp + +EditingContext ec = new EditingContext(); +var companion1 = new Animal { Name = "Houdini the parakeet" }; +var companion2 = new Animal { Name = "Groucho the fish" }; +var animal = new Animal + { + Name = "Sasha the pug", + Residence = new Location + { + StreetAddress = "123 Main Street", + City = "AnyTown", + State = "Washington" + }, + Features = new Dictionary { + {"noise", "snort" }, + {"MeanTimeUntilNaps", TimeSpan.FromMinutes(15) } + }, + CloseRelatives = new List { companion1, companion2 } + }; +ModelTreeManager mtm = new ModelTreeManager(ec); mtm.Load(animal); +ModelItem mi = mtm.Root; + +//Testing other properties of the class +ModelItem root = mtm.Root; +Assert.IsTrue(root.GetCurrentValue() == animal, "GetCurrentValue() returns same object"); +Assert.IsTrue(root.ItemType == typeof(Animal),"ItemType describes the item"); +Assert.IsTrue(root.Parent == null,"root parent is null"); +Assert.IsTrue(root.Source == null, "root source is null"); +Assert.IsTrue(((List)root.Properties["CloseRelatives"].ComputedValue)[0] == companion1, + "ComputedValue of prop == actual object"); +Assert.IsFalse(((List)root.Properties["CloseRelatives"].ComputedValue)[0] == companion2, + "ComputedValue of prop == actual object"); +Assert.AreEqual(root.Properties["Residence"]. + Value. + Properties["StreetAddress"]. + Value.GetCurrentValue(), "123 Main Street", "get actual value back out"); +Assert.AreEqual(root, root.Properties["Residence"].Parent, "property points to owner"); +ModelItem location = root.Properties["Residence"].Value; +Assert.AreEqual(root.Properties["Residence"], location.Source, "sources point to the right place"); + +``` + ]]> @@ -181,13 +181,13 @@ Assert.AreEqual(root.Properties["Residence"], location.Source, "sources point to Opens an editing scope for the designer. After an editing scope is open, all changes across all objects will be saved into the scope until the transaction is completed or reverted. Editing scopes can be nested, but must be committed in order. A , which must be either completed or reverted. - @@ -241,13 +241,13 @@ Assert.AreEqual(root.Properties["Residence"], location.Source, "sources point to Opens an editing scope for the designer. After an editing scope is open, all changes across all objects will be saved into the scope until the transaction is completed or reverted. Editing scopes can be nested, but must be committed in order. A , which must be either completed or reverted. - @@ -321,11 +321,11 @@ Assert.AreEqual(root.Properties["Residence"], location.Source, "sources point to Returns the current value of the underlying model object that the is wrapping. The current value of the underlying model object that the is wrapping as an . - method can return either an existing or new cloned instance of the object. - + method can return either an existing or new cloned instance of the object. + ]]> @@ -370,11 +370,11 @@ Assert.AreEqual(root.Properties["Residence"], location.Source, "sources point to Gets or sets the name or ID of the item. The name or ID of the item as a . - on an item. If the of this item declares a `RuntimeNamePropertyAttribute`, the property is a direct mapping to the property dictated by that attribute. - + on an item. If the of this item declares a `RuntimeNamePropertyAttribute`, the property is a direct mapping to the property dictated by that attribute. + ]]> @@ -440,11 +440,11 @@ Assert.AreEqual(root.Properties["Residence"], location.Source, "sources point to Gets the public properties on this item. A that contains the public properties of this item. - @@ -471,11 +471,11 @@ Assert.AreEqual(root.Properties["Residence"], location.Source, "sources point to Implements . Use this event to listen for changes to the model. This is also used by the data binding features of WPF. - @@ -520,11 +520,11 @@ Assert.AreEqual(root.Properties["Residence"], location.Source, "sources point to Gets the property that provided this value. A that indicates the source of this value. - diff --git a/xml/System.Data.Linq/DataContext.xml b/xml/System.Data.Linq/DataContext.xml index 7a5faec385a..752bd4f6597 100644 --- a/xml/System.Data.Linq/DataContext.xml +++ b/xml/System.Data.Linq/DataContext.xml @@ -884,8 +884,8 @@ The following example opens a connection and passes a SQL `UPDATE` command to th ```csharp var customers = db.ExecuteQuery(@"SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax - FROM   dbo.Customers - WHERE  City = {0}", "London"); + FROM dbo.Customers + WHERE City = {0}", "London"); foreach (Customer c in customers) Console.WriteLine(c.ContactName); diff --git a/xml/System.Data.OracleClient/OracleString.xml b/xml/System.Data.OracleClient/OracleString.xml index f824fec3758..23f6d6d45b2 100644 --- a/xml/System.Data.OracleClient/OracleString.xml +++ b/xml/System.Data.OracleClient/OracleString.xml @@ -25,58 +25,58 @@ Represents a variable-length stream of characters to be stored in or retrieved from the database. - object, call the method. - - - -## Examples - -``` -using System; -using System.Data.OracleClient; -public class Class1 { -   public static void Main() { -      OracleString oraclestring1 = new OracleString("MyOracleString1"); -      OracleString oraclestring2 = new OracleString("MyOracleString2"); -      OracleString oraclestring3 = new OracleString("MyOracleString1"); - -      // Type: System.Data.OracleClient.OracleString -      Console.WriteLine("Type: " + oraclestring1.GetType()); - -      // Length: 15 -      Console.WriteLine("Length: " + oraclestring1.Length); - -      // False -      Console.WriteLine(oraclestring1.IsNull); - -      // -1 -      Console.WriteLine(oraclestring1.CompareTo(oraclestring2)); - -      // 0 -      Console.WriteLine(oraclestring1.CompareTo(oraclestring3)); - -      // 1 -      Console.WriteLine(oraclestring2.CompareTo(oraclestring3)); - -      // False -      Console.WriteLine(oraclestring1.Equals(oraclestring2)); - -      // True -      Console.WriteLine(oraclestring1.Equals(oraclestring3)); - -      // MyOracleString1 -      Console.WriteLine(oraclestring1.Value); - -      // MyOracleString2 -      Console.WriteLine(oraclestring2.ToString()); -   } -} - -``` - + object, call the method. + + + +## Examples + +``` +using System; +using System.Data.OracleClient; +public class Class1 { + public static void Main() { + OracleString oraclestring1 = new OracleString("MyOracleString1"); + OracleString oraclestring2 = new OracleString("MyOracleString2"); + OracleString oraclestring3 = new OracleString("MyOracleString1"); + + // Type: System.Data.OracleClient.OracleString + Console.WriteLine("Type: " + oraclestring1.GetType()); + + // Length: 15 + Console.WriteLine("Length: " + oraclestring1.Length); + + // False + Console.WriteLine(oraclestring1.IsNull); + + // -1 + Console.WriteLine(oraclestring1.CompareTo(oraclestring2)); + + // 0 + Console.WriteLine(oraclestring1.CompareTo(oraclestring3)); + + // 1 + Console.WriteLine(oraclestring2.CompareTo(oraclestring3)); + + // False + Console.WriteLine(oraclestring1.Equals(oraclestring2)); + + // True + Console.WriteLine(oraclestring1.Equals(oraclestring3)); + + // MyOracleString1 + Console.WriteLine(oraclestring1.Value); + + // MyOracleString2 + Console.WriteLine(oraclestring2.ToString()); + } +} + +``` + ]]> @@ -130,28 +130,28 @@ public class Class1 { The object to be compared. Compares this instance of to the supplied object and returns an indication of their relative values. - A signed number indicating the relative values of the instance and the object. - - Return Value - - Condition - - Less than zero - - This instance is less than object. - - Zero - - This instance is the same as object. - - Greater than zero - - This instance is greater than object - - -or- - - object is a null reference () - + A signed number indicating the relative values of the instance and the object. + + Return Value + + Condition + + Less than zero + + This instance is less than object. + + Zero + + This instance is the same as object. + + Greater than zero + + This instance is greater than object + + -or- + + object is a null reference () + To be added. @@ -406,15 +406,15 @@ public class Class1 { Gets the single byte from the property located at the position indicated by the integer parameter, . The byte located at the position indicated by the integer parameter. - property and the `Length` property before reading `this`. - - This property is read-only. - + property and the `Length` property before reading `this`. + + This property is read-only. + ]]> @@ -549,11 +549,11 @@ public class Class1 { Represents a null value that can be assigned to the property of an instance of the structure. - diff --git a/xml/System.Diagnostics.Contracts/ContractOptionAttribute.xml b/xml/System.Diagnostics.Contracts/ContractOptionAttribute.xml index 3a53bdc9df0..c7e146c1a9a 100644 --- a/xml/System.Diagnostics.Contracts/ContractOptionAttribute.xml +++ b/xml/System.Diagnostics.Contracts/ContractOptionAttribute.xml @@ -57,58 +57,58 @@ Enables you to set contract and tool options at assembly, type, or method granularity. - -[ContractOption("contract", "inheritance", false)] -class MyConcurrentList : IList { -   ... -} - -[ContractOption("runtime", "checking", false)] -public override MyMethod(int x) { -   // no inherited contracts checked at runtime, -   // no invariants checked at runtime. -   ... -} - -       [ContractOption("runtime", "checking", false)] -       public void MethodWithoutRuntimeChecking(...) { -          ... -       } -   } - -``` - + +[ContractOption("contract", "inheritance", false)] +class MyConcurrentList : IList { + ... +} + +[ContractOption("runtime", "checking", false)] +public override MyMethod(int x) { + // no inherited contracts checked at runtime, + // no invariants checked at runtime. + ... +} + + [ContractOption("runtime", "checking", false)] + public void MethodWithoutRuntimeChecking(...) { + ... + } + } + +``` + ]]> @@ -208,19 +208,19 @@ public override MyMethod(int x) { The value for the setting. Initializes a new instance of the class by using the provided category, setting, and value. - overload by specifying "true" or "false" in string format; for example: - -```csharp -[ContractOption("contract", "inheritance", "false")] -class MyConcurrentList : IList { -   ... -} - -``` - + overload by specifying "true" or "false" in string format; for example: + +```csharp +[ContractOption("contract", "inheritance", "false")] +class MyConcurrentList : IList { + ... +} + +``` + ]]> diff --git a/xml/System.Diagnostics/DebuggerStepThroughAttribute.xml b/xml/System.Diagnostics/DebuggerStepThroughAttribute.xml index cf7a19343df..2d47da64092 100644 --- a/xml/System.Diagnostics/DebuggerStepThroughAttribute.xml +++ b/xml/System.Diagnostics/DebuggerStepThroughAttribute.xml @@ -86,11 +86,11 @@ ```vb _ -    Private Sub InitializeComponent() -        components = New System.ComponentModel.Container() -        Me.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font -        Me.Text = "Form1" -    End Sub + Private Sub InitializeComponent() + components = New System.ComponentModel.Container() + Me.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font + Me.Text = "Form1" + End Sub ``` This attribute avoids having to step into compiler-provided code and only steps into developer-provided code. For example, if you are stepping through code by using the **F11** (Step Into) key, the attribute will cause the step to behave like an **F10** (Step Over) key for compiler-provided code. The method won't be stepped into, but it will be executed. diff --git a/xml/System.Drawing.Design/UITypeEditor.xml b/xml/System.Drawing.Design/UITypeEditor.xml index 67291354673..2a701312579 100644 --- a/xml/System.Drawing.Design/UITypeEditor.xml +++ b/xml/System.Drawing.Design/UITypeEditor.xml @@ -517,7 +517,7 @@ ``` -  + ``` @@ -582,7 +582,7 @@ ``` -  + ``` diff --git a/xml/System.Net.Http/HttpClient.xml b/xml/System.Net.Http/HttpClient.xml index 5dadd225300..5c86d675a05 100644 --- a/xml/System.Net.Http/HttpClient.xml +++ b/xml/System.Net.Http/HttpClient.xml @@ -357,7 +357,7 @@ The specified `handler` will be disposed of by calling [HttpClient.Dispose](xref  instances use if no proxy is set explicitly in the  passed through its constructor. +This static property determines the default proxy that all instances use if no proxy is set explicitly in the passed through its constructor. The default instance returned by this property will initialize following a different set of rules depending on your platform: * **For Windows:** Reads proxy configuration from environment variables or, if those are not defined, from the user's proxy settings. diff --git a/xml/System.Security.Policy/Evidence.xml b/xml/System.Security.Policy/Evidence.xml index 6e1d86ae923..30ec25dd870 100644 --- a/xml/System.Security.Policy/Evidence.xml +++ b/xml/System.Security.Policy/Evidence.xml @@ -864,7 +864,7 @@ The following code example shows the use of the Equals method. This example is p ```vb Console.WriteLine(ControlChars.Lf & "Make a copy of the current evidence.") -Dim evidenceCopy As New Evidence(myEvidence) +Dim evidenceCopy As New Evidence(myEvidence) Console.WriteLine(("Count of new evidence items = " & evidenceCopy.Count.ToString())) Console.WriteLine(("Does the copy equal the current evidence? " & myEvidence.Equals(evidenceCopy))) ``` diff --git a/xml/System.ServiceModel.Channels/SslStreamSecurityBindingElement.xml b/xml/System.ServiceModel.Channels/SslStreamSecurityBindingElement.xml index 8d088d59e10..26ed44fcf9c 100644 --- a/xml/System.ServiceModel.Channels/SslStreamSecurityBindingElement.xml +++ b/xml/System.ServiceModel.Channels/SslStreamSecurityBindingElement.xml @@ -72,134 +72,134 @@ Represents a custom binding element that supports channel security using an SSL stream. - , which can be configured and added to a custom binding. In addition, a third party can write their own custom `StreamSecurityBindingElement`. These binding elements extend the class that is called to build the client and server stream upgrade providers. - - A custom binding contains a collection of binding elements arranged in a specific order: the element that represents the top of the binding stack is added first, the next element down in the binding stack is added second, and so on. - -### To add this class to a binding - -1. Create a . - -2. Create custom binding elements that are above this binding element in the binding stack, such as the optional and . - -3. Add the created elements in the order described previously to the using the method. - -4. Create an instance of and add it to the collection. - -5. Add any additional custom binding elements to the collection, such as . - - There are three scenarios in which you must either manually specify the correct UPN/SPN on the client endpoint after importing the WSDL, or specify a custom on the client's . - -1. No service identity is published in WSDL. and HTTPS are used (for example, a with SecurityMode = ). If the service is not running with the machine identity, you must manually specify the correct UPN/SPN on the client endpoint after importing the WSDL. - -2. DNS service identity is published in WSDL. and are used (for example, with SecurityMode = ) instead of a UPN/SPN. If the service is not running with the machine identity, or the DNS identity is not the machine's identity, you must manually specify the correct UPN/SPN on the client endpoint after importing the WSDL. - -3. DNS identity is published in WSDL. If is overridden on the client, you must specify a custom on the client's . - - The following code shows how to manually specify the correct UPN/SPN on the client endpoint, as well as how to specify a custom on the client's . - -``` - -using System; -using System.Collections.Generic; -using System.Linq; -using System.Net; -using System.IdentityModel.Claims; -using System.IdentityModel.Policy; -using System.Security.Cryptography.X509Certificates; -using System.ServiceModel; -using System.ServiceModel.Channels; -using System.ServiceModel.Description; -using System.ServiceModel.Security; -using System.Xml; - -namespace ServiceNamespace -{ - [ServiceContract] - interface IService - { - [OperationContract] - void DoSomething(); - } - - class DnsIdentityVerifier : IdentityVerifier - { - DnsEndpointIdentity _expectedIdentity; - - public DnsIdentityVerifier(EndpointAddress serviceEndpoint) - { - _expectedIdentity = new DnsEndpointIdentity(serviceEndpoint.Uri.DnsSafeHost); - } - - public override bool CheckAccess(EndpointIdentity identity, AuthorizationContext authContext) - { - Claim dnsClaim = authContext.Claims().Single(claim => claim.ClaimType == ClaimTypes.Dns); - return String.Equals(_expectedIdentity.IdentityClaim.Resource, dnsClaim.Resource); - } - - public override bool TryGetIdentity(EndpointAddress reference, out EndpointIdentity identity) - { - identity = _expectedIdentity; - return true; - } - } - - static class LinqExtensionForClaims - { - public static IEnumerable Claims(this AuthorizationContext authContext) - { - if (null != authContext.ClaimSets) - { - foreach (ClaimSet claimSet in authContext.ClaimSets) - { - if (null != claimSet) - { - foreach (Claim claim in claimSet) - { - yield return claim; - } - } - } - } - } - } - - class Service : IService - { - public void DoSomething() - { - Console.WriteLine("Service called."); - } - } - - class Program - { - static void Main(string[] args) - { - string hostname = Dns.GetHostEntry(String.Empty).HostName; - NetTcpBinding serviceBinding = new NetTcpBinding(SecurityMode.TransportWithMessageCredential); - - ServiceHost serviceHost = new ServiceHost(typeof(Service), new Uri(String.Format("net.tcp://{0}:8080/Service", hostname))); - serviceHost.Credentials.ServiceCertificate.SetCertificate(StoreLocation.LocalMachine, StoreName.My, X509FindType.FindByThumbprint, "8a 42 1b eb cf 8a 14 b1 de 83 d9 a5 70 88 0a 62 f9 bf 69 06"); - ServiceEndpoint serviceEndpoint = serviceHost.AddServiceEndpoint(typeof(IService), serviceBinding, "Endpoint"); - serviceHost.Open(); - - CustomBinding clientBinding = new CustomBinding(serviceBinding.CreateBindingElements()); - SslStreamSecurityBindingElement sslStream = clientBinding.Elements.Find(); - sslStream.IdentityVerifier = new DnsIdentityVerifier(serviceEndpoint.Address); - - ChannelFactory channelFactory = new ChannelFactory(clientBinding, new EndpointAddress(serviceEndpoint.Address.Uri, UpnEndpointIdentity.CreateUpnIdentity("username@domain"))); - channelFactory.Credentials.Windows.AllowNtlm = false; - IService channel = channelFactory.CreateChannel(); - channel.DoSomething(); - } - } - -``` - + , which can be configured and added to a custom binding. In addition, a third party can write their own custom `StreamSecurityBindingElement`. These binding elements extend the class that is called to build the client and server stream upgrade providers. + + A custom binding contains a collection of binding elements arranged in a specific order: the element that represents the top of the binding stack is added first, the next element down in the binding stack is added second, and so on. + +### To add this class to a binding + +1. Create a . + +2. Create custom binding elements that are above this binding element in the binding stack, such as the optional and . + +3. Add the created elements in the order described previously to the using the method. + +4. Create an instance of and add it to the collection. + +5. Add any additional custom binding elements to the collection, such as . + + There are three scenarios in which you must either manually specify the correct UPN/SPN on the client endpoint after importing the WSDL, or specify a custom on the client's . + +1. No service identity is published in WSDL. and HTTPS are used (for example, a with SecurityMode = ). If the service is not running with the machine identity, you must manually specify the correct UPN/SPN on the client endpoint after importing the WSDL. + +2. DNS service identity is published in WSDL. and are used (for example, with SecurityMode = ) instead of a UPN/SPN. If the service is not running with the machine identity, or the DNS identity is not the machine's identity, you must manually specify the correct UPN/SPN on the client endpoint after importing the WSDL. + +3. DNS identity is published in WSDL. If is overridden on the client, you must specify a custom on the client's . + + The following code shows how to manually specify the correct UPN/SPN on the client endpoint, as well as how to specify a custom on the client's . + +``` + +using System; +using System.Collections.Generic; +using System.Linq; +using System.Net; +using System.IdentityModel.Claims; +using System.IdentityModel.Policy; +using System.Security.Cryptography.X509Certificates; +using System.ServiceModel; +using System.ServiceModel.Channels; +using System.ServiceModel.Description; +using System.ServiceModel.Security; +using System.Xml; + +namespace ServiceNamespace +{ + [ServiceContract] + interface IService + { + [OperationContract] + void DoSomething(); + } + + class DnsIdentityVerifier : IdentityVerifier + { + DnsEndpointIdentity _expectedIdentity; + + public DnsIdentityVerifier(EndpointAddress serviceEndpoint) + { + _expectedIdentity = new DnsEndpointIdentity(serviceEndpoint.Uri.DnsSafeHost); + } + + public override bool CheckAccess(EndpointIdentity identity, AuthorizationContext authContext) + { + Claim dnsClaim = authContext.Claims().Single(claim => claim.ClaimType == ClaimTypes.Dns); + return String.Equals(_expectedIdentity.IdentityClaim.Resource, dnsClaim.Resource); + } + + public override bool TryGetIdentity(EndpointAddress reference, out EndpointIdentity identity) + { + identity = _expectedIdentity; + return true; + } + } + + static class LinqExtensionForClaims + { + public static IEnumerable Claims(this AuthorizationContext authContext) + { + if (null != authContext.ClaimSets) + { + foreach (ClaimSet claimSet in authContext.ClaimSets) + { + if (null != claimSet) + { + foreach (Claim claim in claimSet) + { + yield return claim; + } + } + } + } + } + } + + class Service : IService + { + public void DoSomething() + { + Console.WriteLine("Service called."); + } + } + + class Program + { + static void Main(string[] args) + { + string hostname = Dns.GetHostEntry(String.Empty).HostName; + NetTcpBinding serviceBinding = new NetTcpBinding(SecurityMode.TransportWithMessageCredential); + + ServiceHost serviceHost = new ServiceHost(typeof(Service), new Uri(String.Format("net.tcp://{0}:8080/Service", hostname))); + serviceHost.Credentials.ServiceCertificate.SetCertificate(StoreLocation.LocalMachine, StoreName.My, X509FindType.FindByThumbprint, "8a 42 1b eb cf 8a 14 b1 de 83 d9 a5 70 88 0a 62 f9 bf 69 06"); + ServiceEndpoint serviceEndpoint = serviceHost.AddServiceEndpoint(typeof(IService), serviceBinding, "Endpoint"); + serviceHost.Open(); + + CustomBinding clientBinding = new CustomBinding(serviceBinding.CreateBindingElements()); + SslStreamSecurityBindingElement sslStream = clientBinding.Elements.Find(); + sslStream.IdentityVerifier = new DnsIdentityVerifier(serviceEndpoint.Address); + + ChannelFactory channelFactory = new ChannelFactory(clientBinding, new EndpointAddress(serviceEndpoint.Address.Uri, UpnEndpointIdentity.CreateUpnIdentity("username@domain"))); + channelFactory.Credentials.Windows.AllowNtlm = false; + IService channel = channelFactory.CreateChannel(); + channel.DoSomething(); + } + } + +``` + ]]> @@ -337,11 +337,11 @@ namespace ServiceNamespace Creates a channel factory of a specified type. An object that represents the channel factory of type . - @@ -387,11 +387,11 @@ namespace ServiceNamespace Creates a channel listener of a specified type. An object that represents a channel listener of type . - @@ -433,13 +433,13 @@ namespace ServiceNamespace Creates an instance on the client of the based on the channel context provided. An instance of the . - abstract class. - - The parameter enables reacting to other elements in the channel stack. - + abstract class. + + The parameter enables reacting to other elements in the channel stack. + ]]> @@ -474,13 +474,13 @@ namespace ServiceNamespace Creates an instance on the server of the based on the channel context provided. An instance of the . - abstract class. - - The parameter enables reacting to other elements in the channel stack. - + abstract class. + + The parameter enables reacting to other elements in the channel stack. + ]]> @@ -536,11 +536,11 @@ namespace ServiceNamespace if a channel factory of the specified type can be built; otherwise, . - @@ -587,11 +587,11 @@ namespace ServiceNamespace if a channel listener of the specified type can be built; otherwise, . - @@ -697,11 +697,11 @@ namespace ServiceNamespace Gets a specified object from the . The object of type from the , or if the object is not found. - . - + . + ]]> @@ -736,11 +736,11 @@ namespace ServiceNamespace Gets the that represents the transport token used in the security binding. An that represents the transport token used in the security binding. - @@ -924,30 +924,30 @@ namespace ServiceNamespace Specifies the list of SSL/TLS protocols to negotiate when using a client credential type of TcpClientCredentialType.Certificate. The value can be a combination of one of more of the following enumeration members: Ssl3, Tls, Tls11, Tls12. Returns . - (); -sslStream.SslProtocols = SslProtocols.Tls11 | SslProtocols.Tls12; -EndpointAddress a = new EndpointAddress("net.tcp://contoso.com/TcpAddress"); -ChannelFactory cf = new ChannelFactory(b, a); -cf.Credentials.ClientCertificate.SetCertificate( -    StoreLocation.LocalMachine, -    StoreName.My, -    X509FindType.FindByThumbprint, -    "0000000000000000000000000000000000000000"); -``` - + (); +sslStream.SslProtocols = SslProtocols.Tls11 | SslProtocols.Tls12; +EndpointAddress a = new EndpointAddress("net.tcp://contoso.com/TcpAddress"); +ChannelFactory cf = new ChannelFactory(b, a); +cf.Credentials.ClientCertificate.SetCertificate( + StoreLocation.LocalMachine, + StoreName.My, + X509FindType.FindByThumbprint, + "0000000000000000000000000000000000000000"); +``` + ]]> @@ -986,17 +986,17 @@ cf.Credentials.ClientCertificate.SetCertificate( The that you can use to insert your custom policy assertion. Exports a custom policy assertion about bindings. - and objects. Use the , , and methods to obtain collections of policy assertions that have already been exported at various scopes. Then use this method to add your own policy assertions to the appropriate collection. - - The property exposes the for the endpoint that is being exported. This enables this method to correctly scope their exported policy assertions. For example, security attributes in code can add behaviors to the that indicate where security policy assertions should be added. - - Once custom policy assertions are attached to the WSDL information, clients can detect and import the custom binding assertions by implementing an interface. - + and objects. Use the , , and methods to obtain collections of policy assertions that have already been exported at various scopes. Then use this method to add your own policy assertions to the appropriate collection. + + The property exposes the for the endpoint that is being exported. This enables this method to correctly scope their exported policy assertions. For example, security attributes in code can add behaviors to the that indicate where security policy assertions should be added. + + Once custom policy assertions are attached to the WSDL information, clients can detect and import the custom binding assertions by implementing an interface. + ]]> diff --git a/xml/System.ServiceModel.Configuration/BaseAddressPrefixFilterElement.xml b/xml/System.ServiceModel.Configuration/BaseAddressPrefixFilterElement.xml index 0e2329ef0ea..5cb51be960d 100644 --- a/xml/System.ServiceModel.Configuration/BaseAddressPrefixFilterElement.xml +++ b/xml/System.ServiceModel.Configuration/BaseAddressPrefixFilterElement.xml @@ -17,42 +17,42 @@ Represents a configuration element that specifies a pass through filter, which provides a mechanism to pick the appropriate IIS bindings when hosting a Windows Communication Foundation (WCF) application in IIS. This class cannot be inherited. - - - -        -        -  - - -``` - - In this example, `net.tcp://test1.fabrikam.com:8000` and `http://test2.fabrikam.com:9000` are the only base addresses for their respective schemes which are allowed to be passed through. - - By default, when prefix is not specified, all addresses are passed through. Specifying the prefix will result in only the matching base address for that scheme to be passed through. - + + + + + + + + +``` + + In this example, `net.tcp://test1.fabrikam.com:8000` and `http://test2.fabrikam.com:9000` are the only base addresses for their respective schemes which are allowed to be passed through. + + By default, when prefix is not specified, all addresses are passed through. Specifying the prefix will result in only the matching base address for that scheme to be passed through. + > [!NOTE] -> The filter does not support any wildcards. In addition, the baseAddresses supplied by IIS may have addresses bound to other schemes not present in the `baseAddressPrefixFilters` list. These addresses are not filtered out. - +> The filter does not support any wildcards. In addition, the baseAddresses supplied by IIS may have addresses bound to other schemes not present in the `baseAddressPrefixFilters` list. These addresses are not filtered out. + ]]> diff --git a/xml/System.ServiceModel/TcpTransportSecurity.xml b/xml/System.ServiceModel/TcpTransportSecurity.xml index 1918d470c82..7feb4e90090 100644 --- a/xml/System.ServiceModel/TcpTransportSecurity.xml +++ b/xml/System.ServiceModel/TcpTransportSecurity.xml @@ -46,11 +46,11 @@ Provides properties that control authentication parameters and protection level for the TCP transport. - to set the transport-level security settings for a binding. - + to set the transport-level security settings for a binding. + ]]> @@ -126,31 +126,31 @@ Gets or sets the type of client credential used for authentication. Returns the . - - -- - -- - -- - -- - -- - - - -## Examples - The following code shows how to access and set this property. - + + +- + +- + +- + +- + +- + + + +## Examples + The following code shows how to access and set this property. + :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/c_programmingsecurity/cs/source.cs" id="Snippet13"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/c_programmingsecurity/vb/source.vb" id="Snippet13"::: - + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/c_programmingsecurity/vb/source.vb" id="Snippet13"::: + ]]> @@ -308,29 +308,29 @@ Specifies the list of SSL/TLS protocols to negotiate when using a client credential type of TcpClientCredentialType.Certificate. The value can be a combination of one of more of the following enumeration members: Ssl3, Tls, Tls11, Tls12. Returns . - cf = new ChannelFactory(b, a); -cf.Credentials.ClientCertificate.SetCertificate( -    StoreLocation.LocalMachine, -    StoreName.My, -    X509FindType.FindByThumbprint, -    "0000000000000000000000000000000000000000"); -``` - + cf = new ChannelFactory(b, a); +cf.Credentials.ClientCertificate.SetCertificate( + StoreLocation.LocalMachine, + StoreName.My, + X509FindType.FindByThumbprint, + "0000000000000000000000000000000000000000"); +``` + ]]> diff --git a/xml/System.Windows.Forms/Form.xml b/xml/System.Windows.Forms/Form.xml index e794c81f2cf..c15790ee515 100644 --- a/xml/System.Windows.Forms/Form.xml +++ b/xml/System.Windows.Forms/Form.xml @@ -8939,9 +8939,9 @@ This example assumes that the `CreateMyOpaqueForm` method is called from another ```csharp private void Form1_Shown(object sender, EventArgs e) -        { -            this.WindowState = System.Windows.Forms.FormWindowState.Maximized; -        } + { + this.WindowState = System.Windows.Forms.FormWindowState.Maximized; + } ``` ```vb diff --git a/xml/System.Windows.Forms/NumericUpDown.xml b/xml/System.Windows.Forms/NumericUpDown.xml index c9b93fbf881..24d5846a4b8 100644 --- a/xml/System.Windows.Forms/NumericUpDown.xml +++ b/xml/System.Windows.Forms/NumericUpDown.xml @@ -54,35 +54,35 @@ Represents a Windows spin box (also known as an up-down control) that displays numeric values. - control contains a single numeric value that can be incremented or decremented by clicking the up or down buttons of the control. The user can also enter in a value, unless the property is set to `true`. - - The numeric display can be formatted by setting the , , or properties. To display hexadecimal values in the control, set the property to `true`. To display a thousands separator in decimal numbers when appropriate, set the property to `true`. To specify the number of digits displayed after the decimal symbol, set the property to the number of decimal places to display. - - To specify the allowable range of values for the control, set the and properties. Set the value to specify the value to be incremented or decremented to the property when the user clicks the up or down arrow buttons. You can increase the speed that the control moves through numbers when the user continuously presses the up or down arrow by setting the property. - - When the or methods are called, either in code or by the click of the up or down buttons, the new value is validated and the control is updated with the new value in the appropriate format. Specifically, if the property is set to `true`, the method is called prior to validating or updating the value. The value is then verified to be between the and values, and the method is called. - - Starting with the .NET Framework 4.6, the control will be resized based on the system DPI setting when the app.config file contains the following entry: - -``` - -  - - -``` - - - -## Examples - The following code example creates and initializes a control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. - + control contains a single numeric value that can be incremented or decremented by clicking the up or down buttons of the control. The user can also enter in a value, unless the property is set to `true`. + + The numeric display can be formatted by setting the , , or properties. To display hexadecimal values in the control, set the property to `true`. To display a thousands separator in decimal numbers when appropriate, set the property to `true`. To specify the number of digits displayed after the decimal symbol, set the property to the number of decimal places to display. + + To specify the allowable range of values for the control, set the and properties. Set the value to specify the value to be incremented or decremented to the property when the user clicks the up or down arrow buttons. You can increase the speed that the control moves through numbers when the user continuously presses the up or down arrow by setting the property. + + When the or methods are called, either in code or by the click of the up or down buttons, the new value is validated and the control is updated with the new value in the appropriate format. Specifically, if the property is set to `true`, the method is called prior to validating or updating the value. The value is then verified to be between the and values, and the method is called. + + Starting with the .NET Framework 4.6, the control will be resized based on the system DPI setting when the app.config file contains the following entry: + +``` + + + + +``` + + + +## Examples + The following code example creates and initializes a control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic NumericUpDown Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/NumericUpDown/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: + ]]> @@ -113,15 +113,15 @@ Initializes a new instance of the class. - control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. - + control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic NumericUpDown Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/NumericUpDown/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: + ]]> @@ -163,19 +163,19 @@ Gets a collection of sorted acceleration objects for the control. A containing the sorted acceleration objects for the control. - property can be used to increase the speed with which the moves through a large set of numbers when the user holds the up or down arrow, either with the keyboard or with the mouse. Setting this property will decrease the number of events that occur depending on the and property values specified for each object in the collection. The objects contained in the collection are sorted by their property. - - - -## Examples - The following code example demonstrates how to use the property. To run this example, paste the following code into a form and call the `InitializeAcceleratedUpDown` method from the form's constructor or event-handling method. While the code is running, press and hold the up or down arrow to see the acceleration occur. - + property can be used to increase the speed with which the moves through a large set of numbers when the user holds the up or down arrow, either with the keyboard or with the mouse. Setting this property will decrease the number of events that occur depending on the and property values specified for each object in the collection. The objects contained in the collection are sorted by their property. + + + +## Examples + The following code example demonstrates how to use the property. To run this example, paste the following code into a form and call the `InitializeAcceleratedUpDown` method from the form's constructor or event-handling method. While the code is running, press and hold the up or down arrow to see the acceleration occur. + :::code language="csharp" source="~/snippets/csharp/System.Drawing.Printing/PageSettings/Overview/Form1.cs" id="Snippet6"::: - :::code language="vb" source="~/snippets/visualbasic/System.Drawing.Printing/PageSettings/Overview/form1.vb" id="Snippet6"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Drawing.Printing/PageSettings/Overview/form1.vb" id="Snippet6"::: + ]]> @@ -277,28 +277,28 @@ Gets or sets the number of decimal places to display in the spin box (also known as an up-down control). This property doesn't affect the property. The number of decimal places to display in the spin box. The default is 0. - property is set, the method is called to update the spin box's display to the new format. - - The appropriate decimal symbol is determined by the regional settings of the user's operating system. - - - -## Examples - The following code example creates and initializes a control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. - + property is set, the method is called to update the spin box's display to the new format. + + The appropriate decimal symbol is determined by the regional settings of the user's operating system. + + + +## Examples + The following code example creates and initializes a control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic NumericUpDown Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/NumericUpDown/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: + ]]> - The value assigned is less than 0. - - -or- - + The value assigned is less than 0. + + -or- + The value assigned is greater than 99. @@ -332,11 +332,11 @@ Decrements the value of the spin box (also known as an up-down control). - method is called, either in code or by the click of the down button, the new value is validated and the control is updated with the new value in the appropriate format. Specifically, if the property is set to `true`, the method is called prior to validating or updating the value. The value is then validated to be between the and values, and the method is called. - + method is called, either in code or by the click of the down button, the new value is validated and the control is updated with the new value in the appropriate format. Specifically, if the property is set to `true`, the method is called prior to validating or updating the value. The value is then validated to be between the and values, and the method is called. + ]]> @@ -416,22 +416,22 @@ if the spin box should display its value in hexadecimal format; otherwise, . The default is . - property is set, the method is called to update the spin box's display to the new format. - - When the property is set to `true`, the property should be set to and the property should be set to . - - - -## Examples - The following code example creates and initializes a control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. - + property is set, the method is called to update the spin box's display to the new format. + + When the property is set to `true`, the property should be set to and the property should be set to . + + + +## Examples + The following code example creates and initializes a control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic NumericUpDown Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/NumericUpDown/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: + ]]> @@ -466,20 +466,20 @@ Gets or sets the value to increment or decrement the spin box (also known as an up-down control) when the up or down buttons are clicked. The value to increment or decrement the property when the up or down buttons are clicked on the spin box. The default value is 1. - property to increment by the amount specified by the property and approach the property. Clicking the down button causes the property to be decremented by the amount specified by the property and approach the property. - - - -## Examples - The following code example creates and initializes a control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. - + property to increment by the amount specified by the property and approach the property. Clicking the down button causes the property to be decremented by the amount specified by the property and approach the property. + + + +## Examples + The following code example creates and initializes a control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic NumericUpDown Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/NumericUpDown/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: + ]]> The assigned value is not greater than or equal to zero. @@ -524,20 +524,20 @@ Gets or sets the maximum value for the spin box (also known as an up-down control). The maximum value for the spin box. The default value is 100. - property is set, the property is evaluated and the method is called. If the property is greater than the new property, the property value is set equal to the value. If the current is greater than the new value. the property value is set equal to the value. - - - -## Examples - The following code example creates and initializes a control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. - + property is set, the property is evaluated and the method is called. If the property is greater than the new property, the property value is set equal to the value. If the current is greater than the new value. the property value is set equal to the value. + + + +## Examples + The following code example creates and initializes a control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic NumericUpDown Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/NumericUpDown/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: + ]]> @@ -582,20 +582,20 @@ Gets or sets the minimum allowed value for the spin box (also known as an up-down control). The minimum allowed value for the spin box. The default value is 0. - property is set, the property is evaluated and the method is called. If the new property value is greater than the property value, the value is set equal to the value. If the is less than the new value, the property is also set equal to the value. - - - -## Examples - The following code example creates and initializes a control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. - + property is set, the property is evaluated and the method is called. If the new property value is greater than the property value, the value is set equal to the value. If the is less than the new value, the property is also set equal to the value. + + + +## Examples + The following code example creates and initializes a control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic NumericUpDown Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/NumericUpDown/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: + ]]> @@ -632,13 +632,13 @@ A that contains the event data. Raises the event. - method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> @@ -675,13 +675,13 @@ A that contains the event data. Raises the event. - method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> @@ -718,13 +718,13 @@ An that contains the event data. Raises the event. - method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> @@ -772,11 +772,11 @@ A that contains the event data. Raises the event. - control accepts only digits, the negative sign, the decimal point, and editing keystrokes, such as BACKSPACE. If the property is set to `true`, accepts hexadecimal digits. - + control accepts only digits, the negative sign, the decimal point, and editing keystrokes, such as BACKSPACE. If the property is set to `true`, accepts hexadecimal digits. + ]]> @@ -811,13 +811,13 @@ An that contains the event data. Raises the event. - method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> @@ -868,11 +868,11 @@ in all cases. - property has no effect on the appearance of the control. - + property has no effect on the appearance of the control. + ]]> @@ -917,11 +917,11 @@ Occurs when the value of the property changes. - @@ -953,11 +953,11 @@ Converts the text displayed in the spin box (also known as an up-down control) to a numeric value and evaluates it. - property is set to `true`, the text displayed is converted to a numeric value so it can be validated to be between the and property values. - + property is set to `true`, the text displayed is converted to a numeric value so it can be validated to be between the and property values. + ]]> @@ -1011,11 +1011,11 @@ . - has no effect on the appearance of the control; therefore, it is hidden in the designer and from IntelliSense. - + has no effect on the appearance of the control; therefore, it is hidden in the designer and from IntelliSense. + ]]> @@ -1105,22 +1105,22 @@ if a thousands separator is displayed in the spin box when appropriate; otherwise, . The default value is . - property is set, the method is called to update the spin box's display to the new format. - - The appropriate thousands separator is determined by the regional settings of the user's operating system. - - - -## Examples - The following code example creates and initializes a control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. - + property is set, the method is called to update the spin box's display to the new format. + + The appropriate thousands separator is determined by the regional settings of the user's operating system. + + + +## Examples + The following code example creates and initializes a control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic NumericUpDown Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/NumericUpDown/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: + ]]> @@ -1156,11 +1156,11 @@ Returns a string that represents the control. A string that represents the current . - and properties. - + and properties. + ]]> @@ -1192,11 +1192,11 @@ Increments the value of the spin box (also known as an up-down control). - method is called, either in code or by the click of the up button, the new value is validated and the control is updated with the new value in the appropriate format. Specifically, if is set to `true`, is called prior to validating or updating the value. The value is then validated to be between the and values and the method is called. - + method is called, either in code or by the click of the up button, the new value is validated and the control is updated with the new value in the appropriate format. Specifically, if is set to `true`, is called prior to validating or updating the value. The value is then validated to be between the and values and the method is called. + ]]> @@ -1233,11 +1233,11 @@ Displays the current value of the spin box (also known as an up-down control) in the appropriate format. - and values and is converted to the correct format for display in the control. - + and values and is converted to the correct format for display in the control. + ]]> @@ -1274,11 +1274,11 @@ Validates and updates the text displayed in the spin box (also known as an up-down control). - method calls the and methods to validate and update the display of the spin box. - + method calls the and methods to validate and update the display of the spin box. + ]]> @@ -1318,26 +1318,26 @@ Gets or sets the value assigned to the spin box (also known as an up-down control). The numeric value of the control. - property is set, the new value is validated to be between the and values. Following this, the method is called to update the spin box's display with the new value in the appropriate format. - - - -## Examples - The following code example creates and initializes a control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. - + property is set, the new value is validated to be between the and values. Following this, the method is called to update the spin box's display with the new value in the appropriate format. + + + +## Examples + The following code example creates and initializes a control, sets some of its common properties, and allows the user to change some of these properties at run time. This code assumes three controls have been placed on a form and handlers for their events have been instantiated. The , , and properties are set on the event of each check box. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic NumericUpDown Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/NumericUpDown/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/NumericUpDown/Overview/source.vb" id="Snippet1"::: + ]]> - The assigned value is less than the property value. - - -or- - + The assigned value is less than the property value. + + -or- + The assigned value is greater than the property value. @@ -1377,23 +1377,23 @@ Occurs when the property has been changed in some way. - event to occur, the property can be changed in code, by clicking the up or down button, or by the user entering a new value that is read by the control. The new value is read when the user hits the ENTER key or navigates away from the control. If the user enters a new value and then clicks the up or down button, the event will occur twice. - - For more information about handling events, see [Handling and Raising Events](/dotnet/standard/events/). - - - -## Examples - The following code example demonstrates the use of this member. In the example, an event handler reports on the occurrence of the event. This report helps you to learn when the event occurs and can assist you in debugging. To report on multiple events or on events that occur frequently, consider replacing with or appending the message to a multiline . - - To run the example code, paste it into a project that contains an instance of type named `NumericUpDown1`. Then ensure that the event handler is associated with the event. - + event to occur, the property can be changed in code, by clicking the up or down button, or by the user entering a new value that is read by the control. The new value is read when the user hits the ENTER key or navigates away from the control. If the user enters a new value and then clicks the up or down button, the event will occur twice. + + For more information about handling events, see [Handling and Raising Events](/dotnet/standard/events/). + + + +## Examples + The following code example demonstrates the use of this member. In the example, an event handler reports on the occurrence of the event. This report helps you to learn when the event occurs and can assist you in debugging. To report on multiple events or on events that occur frequently, consider replacing with or appending the message to a multiline . + + To run the example code, paste it into a project that contains an instance of type named `NumericUpDown1`. Then ensure that the event handler is associated with the event. + :::code language="csharp" source="~/snippets/csharp/System.ComponentModel/CollectionChangeEventArgs/Overview/EventExamples.cs" id="Snippet515"::: - :::code language="vb" source="~/snippets/visualbasic/System.ComponentModel/CollectionChangeEventArgs/Overview/EventExamples.vb" id="Snippet515"::: - + :::code language="vb" source="~/snippets/visualbasic/System.ComponentModel/CollectionChangeEventArgs/Overview/EventExamples.vb" id="Snippet515"::: + ]]> diff --git a/xml/System.Windows.Forms/ToolStripComboBox.xml b/xml/System.Windows.Forms/ToolStripComboBox.xml index 2cd7c64b718..caabf9df6f2 100644 --- a/xml/System.Windows.Forms/ToolStripComboBox.xml +++ b/xml/System.Windows.Forms/ToolStripComboBox.xml @@ -1292,7 +1292,7 @@ ``` -  + ``` diff --git a/xml/System.Windows.Forms/ToolStripMenuItem.xml b/xml/System.Windows.Forms/ToolStripMenuItem.xml index 23c925995ee..ca8cebed65b 100644 --- a/xml/System.Windows.Forms/ToolStripMenuItem.xml +++ b/xml/System.Windows.Forms/ToolStripMenuItem.xml @@ -451,7 +451,7 @@ ```xml -  + ``` @@ -608,7 +608,7 @@ ```xml -  + ``` diff --git a/xml/System.Windows.Forms/UpDownBase.xml b/xml/System.Windows.Forms/UpDownBase.xml index 1684528c9b1..27d85f295d8 100644 --- a/xml/System.Windows.Forms/UpDownBase.xml +++ b/xml/System.Windows.Forms/UpDownBase.xml @@ -50,35 +50,35 @@ Implements the basic functionality required by a spin box (also known as an up-down control). - class links the two controls and allows the user to change the display in the text box by clicking the up or down buttons or by entering the appropriate type of value directly into the text box. Use the spin box in cases where you want to limit the list of values a user can select, similar to a list box or combo box. Depending upon the type of list you want to display, the advantage to using a spin box is that it allows you to quickly set a range of valid values, rather than adding items one at a time. Implementing a spin box requires less data validation than a text box, as you can limit the data type when you derive a class from . An example of this is the class, which limits the values to the numeric type and uses a and property to validate the data. - - To allow the user to use the arrow keys to change the contents of a spin box, set the property to `true`. To restrict the user to values you specify, set the property to `true`. To control the alignment of text in the spin box, set the property. To set the alignment of the up and down buttons in relation to the text box portion of the control, set the property to either or . - - The and methods, when overridden, handle the clicking of the up or down buttons. When overridden, the and methods validate the value (either selected or entered) and update the text displayed in the spin box. If the value fails validation, use the method to select the text that is not valid. This allows the user to quickly correct the text by simply typing in a new value without having to manually select or delete the existing text. - - Starting with the .NET Framework 4.6, the control will be resized based on the system DPI setting when the app.config file contains the following entry: - -``` - -  - - -``` - - - -## Examples - The following code example uses the derived class and sets some of its properties derived from . This code requires that you have a control named `numericUpDown1`, two controls named `comboBox1` and `comboBox2`, and three controls named `checkBox1`, `checkBox2`, and `checkBox2` created on a form. Add the following items to `comboBox1`: `None`, `Fixed3D`, and `FixedSingle`. Add the following items to `comboBox2`: `Left`, `Right`, and `Center`. - - The code allows you to change the property values at run time and see how each affects the appearance and behavior of the spin box. - + class links the two controls and allows the user to change the display in the text box by clicking the up or down buttons or by entering the appropriate type of value directly into the text box. Use the spin box in cases where you want to limit the list of values a user can select, similar to a list box or combo box. Depending upon the type of list you want to display, the advantage to using a spin box is that it allows you to quickly set a range of valid values, rather than adding items one at a time. Implementing a spin box requires less data validation than a text box, as you can limit the data type when you derive a class from . An example of this is the class, which limits the values to the numeric type and uses a and property to validate the data. + + To allow the user to use the arrow keys to change the contents of a spin box, set the property to `true`. To restrict the user to values you specify, set the property to `true`. To control the alignment of text in the spin box, set the property. To set the alignment of the up and down buttons in relation to the text box portion of the control, set the property to either or . + + The and methods, when overridden, handle the clicking of the up or down buttons. When overridden, the and methods validate the value (either selected or entered) and update the text displayed in the spin box. If the value fails validation, use the method to select the text that is not valid. This allows the user to quickly correct the text by simply typing in a new value without having to manually select or delete the existing text. + + Starting with the .NET Framework 4.6, the control will be resized based on the system DPI setting when the app.config file contains the following entry: + +``` + + + + +``` + + + +## Examples + The following code example uses the derived class and sets some of its properties derived from . This code requires that you have a control named `numericUpDown1`, two controls named `comboBox1` and `comboBox2`, and three controls named `checkBox1`, `checkBox2`, and `checkBox2` created on a form. Add the following items to `comboBox1`: `None`, `Fixed3D`, and `FixedSingle`. Add the following items to `comboBox2`: `Left`, `Right`, and `Center`. + + The code allows you to change the property values at run time and see how each affects the appearance and behavior of the spin box. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic UpDownBase Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/UpDownBase/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/Overview/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/Overview/source.vb" id="Snippet1"::: + ]]> @@ -157,11 +157,11 @@ in all cases. - control does not use the property. - + control does not use the property. + ]]> @@ -207,11 +207,11 @@ Gets or sets the size of the auto-scroll margin. A that represents the height and width, in pixels, of the auto-scroll margin. - control does not use the property. - + control does not use the property. + ]]> The or is less than 0. @@ -258,11 +258,11 @@ Gets or sets the minimum size of the auto-scroll area. A that represents the minimum height and width, in pixels, of the scroll bars. - control does not use the property. - + control does not use the property. + ]]> @@ -350,21 +350,21 @@ Occurs when the value of the property changes. - event. This report helps you to learn when the event occurs and can assist you in debugging. To report on multiple events or on events that occur frequently, consider replacing with or appending the message to a multiline . - - To run the example code, paste it into a project that contains an instance of a type that inherits from , such as a or . Then name the instance `UpDownBase1` and ensure that the event handler is associated with the event. - + event. This report helps you to learn when the event occurs and can assist you in debugging. To report on multiple events or on events that occur frequently, consider replacing with or appending the message to a multiline . + + To run the example code, paste it into a project that contains an instance of a type that inherits from , such as a or . Then name the instance `UpDownBase1` and ensure that the event handler is associated with the event. + :::code language="csharp" source="~/snippets/csharp/System.ComponentModel/CollectionChangeEventArgs/Overview/EventExamples.cs" id="Snippet380"::: - :::code language="vb" source="~/snippets/visualbasic/System.ComponentModel/CollectionChangeEventArgs/Overview/EventExamples.vb" id="Snippet380"::: - + :::code language="vb" source="~/snippets/visualbasic/System.ComponentModel/CollectionChangeEventArgs/Overview/EventExamples.vb" id="Snippet380"::: + ]]> @@ -444,11 +444,11 @@ Gets or sets the background image for the . The background image for the . - property has no effect on the appearance of the control; therefore, it is hidden in the designer and from IntelliSense. - + property has no effect on the appearance of the control; therefore, it is hidden in the designer and from IntelliSense. + ]]> @@ -536,11 +536,11 @@ Gets or sets the layout of the of the . One of the values. - property has no effect on the appearance of the control; therefore, it is hidden in the designer and from IntelliSense. - + property has no effect on the appearance of the control; therefore, it is hidden in the designer and from IntelliSense. + ]]> @@ -628,22 +628,22 @@ Gets or sets the border style for the spin box (also known as an up-down control). One of the values. The default value is . - property to create borderless and flat controls in addition to the default three-dimensional control. - - - -## Examples - The following code example uses the derived class and sets some of its properties derived from . This code requires that you have a control named `numericUpDown1`, two controls named `comboBox1` and `comboBox2`, and three controls named `checkBox1`, `checkBox2`, and `checkBox2` created on a form. Add the following items to `comboBox1`: `None`, `Fixed3D`, and `FixedSingle`. Add the following items to `comboBox2`: `Left`, `Right`, and `Center`. - - The code allows you to change the property values at run time and see how each affects the appearance and behavior of the spin box. - + property to create borderless and flat controls in addition to the default three-dimensional control. + + + +## Examples + The following code example uses the derived class and sets some of its properties derived from . This code requires that you have a control named `numericUpDown1`, two controls named `comboBox1` and `comboBox2`, and three controls named `checkBox1`, `checkBox2`, and `checkBox2` created on a form. Add the following items to `comboBox1`: `None`, `Fixed3D`, and `FixedSingle`. Add the following items to `comboBox2`: `Left`, `Right`, and `Center`. + + The code allows you to change the property values at run time and see how each affects the appearance and behavior of the spin box. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic UpDownBase Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/UpDownBase/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/Overview/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/Overview/source.vb" id="Snippet1"::: + ]]> The value assigned is not one of the values. @@ -688,11 +688,11 @@ if the property is being changed internally by the class; otherwise, . - property acts as a flag for the class. This property is used by derived classes to indicate when the class is changing the current property internally. If this property is set to `false`, the control requires that the user is changing the property and will set the property to `true`. - + property acts as a flag for the class. This property is used by derived classes to indicate when the class is changing the current property internally. If this property is set to `false`, the control requires that the user is changing the property and will set the property to `true`. + ]]> @@ -720,11 +720,11 @@ Gets or sets the shortcut menu associated with the spin box (also known as an up-down control). The associated with the spin box. - property. - + property. + ]]> @@ -762,11 +762,11 @@ Gets or sets the shortcut menu for the spin box (also known as an up-down control). The associated with the control. - @@ -921,11 +921,11 @@ Gets the dock padding settings for all edges of the control. The dock paddings settings for this control. - control does not use the property. - + control does not use the property. + ]]> @@ -1031,11 +1031,11 @@ Gets or sets the foreground color of the spin box (also known as an up-down control). The foreground of the spin box. - property will change the color of the text in the textbox portion of the spin box. - + property will change the color of the text in the textbox portion of the spin box. + ]]> @@ -1082,22 +1082,22 @@ if the control allows the use of the UP ARROW and DOWN ARROW keys to select values; otherwise, . The default value is . - property is set to `true` and the spin box (also known as an up-down control) has focus, the user can use the UP ARROW and DOWN ARROW keys to select values. - - - -## Examples - The following code example uses the derived class and sets some of its properties derived from . This code requires that you have a control named `numericUpDown1`, two controls named `comboBox1` and `comboBox2`, and three controls named `checkBox1`, `checkBox2`, and `checkBox2` created on a form. Add the following items to `comboBox1`: `None`, `Fixed3D`, and `FixedSingle`. Add the following items to `comboBox2`: `Left`, `Right`, and `Center`. - - The code allows you to change the property values at run time and see how each affects the appearance and behavior of the spin box. - + property is set to `true` and the spin box (also known as an up-down control) has focus, the user can use the UP ARROW and DOWN ARROW keys to select values. + + + +## Examples + The following code example uses the derived class and sets some of its properties derived from . This code requires that you have a control named `numericUpDown1`, two controls named `comboBox1` and `comboBox2`, and three controls named `checkBox1`, `checkBox2`, and `checkBox2` created on a form. Add the following items to `comboBox1`: `None`, `Fixed3D`, and `FixedSingle`. Add the following items to `comboBox2`: `Left`, `Right`, and `Center`. + + The code allows you to change the property values at run time and see how each affects the appearance and behavior of the spin box. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic UpDownBase Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/UpDownBase/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/Overview/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/Overview/source.vb" id="Snippet1"::: + ]]> @@ -1128,11 +1128,11 @@ Gets or sets the maximum size of the spin box (also known as an up-down control). The , which is the maximum size of the spin box. - of the maximum size will always be 0. - + of the maximum size will always be 0. + ]]> @@ -1409,13 +1409,13 @@ An that contains the event data. Raises the event. - method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> @@ -1453,13 +1453,13 @@ An that contains the event data. Raises the event. - method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> @@ -1496,13 +1496,13 @@ An that contains the event data. Raises the event. - method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> @@ -1540,18 +1540,18 @@ A that contains the event data. Raises the event. - method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - + When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. + Example @@ -1585,13 +1585,13 @@ A that contains the event data. Raises the event. - method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> @@ -1628,15 +1628,15 @@ A that contains the event data. Raises the event. - method will raise the event. - - Raising an event invokes the event handler through a delegate. For more information, see [Handling and Raising Events](/dotnet/standard/events/). - - The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + method will raise the event. + + Raising an event invokes the event handler through a delegate. For more information, see [Handling and Raising Events](/dotnet/standard/events/). + + The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> @@ -1674,15 +1674,15 @@ A that contains the event data. Raises the event. - or method is called. - - Raising an event invokes the event handler through a delegate. For more information, see [Handling and Raising Events](/dotnet/standard/events/). - - The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + or method is called. + + Raising an event invokes the event handler through a delegate. For more information, see [Handling and Raising Events](/dotnet/standard/events/). + + The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> @@ -1721,13 +1721,13 @@ A that contains the event data. Raises the event. - method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> @@ -1775,15 +1775,15 @@ A that contains the event data. Raises the event. - property is set to `true` and the user presses the UP ARROW key, the method is called. Likewise, if the user presses the DOWN ARROW key, the method is called. - - Raising an event invokes the event handler through a delegate. For more information, see [Handling and Raising Events](/dotnet/standard/events/). - - The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + property is set to `true` and the user presses the UP ARROW key, the method is called. Likewise, if the user presses the DOWN ARROW key, the method is called. + + Raising an event invokes the event handler through a delegate. For more information, see [Handling and Raising Events](/dotnet/standard/events/). + + The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> @@ -1835,13 +1835,13 @@ A that contains the event data. Raises the event. - method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> @@ -1890,15 +1890,15 @@ An that contains the event data. Raises the event. - method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> @@ -1947,15 +1947,15 @@ An that contains the event data. Raises the event. - method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> @@ -2004,13 +2004,13 @@ An that contains the event data. Raises the event. - method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. - + method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. + ]]> @@ -2060,20 +2060,20 @@ Gets the height of the spin box (also known as an up-down control). The height, in pixels, of the spin box. - property value is based on the property of the text box portion of the control and is adjusted for the style of border. - - - -## Examples - The following code example uses the derived class and sets some of its properties derived from . This code requires that you have a control, two controls, and three controls created on a form. Label the controls and . Label the controls , , and . The code allows you to change the property values at run time and see how each affects the appearance and behavior of the spin box. Add the following items to the combo box labeled BorderStyle: `None`, `Fixed3D`, and `FixedSingle`. Add the following items to the combo box labeled TextAlign: `Left`, `Right`, and `Center`. - + property value is based on the property of the text box portion of the control and is adjusted for the style of border. + + + +## Examples + The following code example uses the derived class and sets some of its properties derived from . This code requires that you have a control, two controls, and three controls created on a form. Label the controls and . Label the controls , , and . The code allows you to change the property values at run time and see how each affects the appearance and behavior of the spin box. Add the following items to the combo box labeled BorderStyle: `None`, `Fixed3D`, and `FixedSingle`. Add the following items to the combo box labeled TextAlign: `Left`, `Right`, and `Center`. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic UpDownBase.BorderStyle Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/UpDownBase/PreferredHeight/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/PreferredHeight/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/PreferredHeight/source.vb" id="Snippet1"::: + ]]> @@ -2113,23 +2113,23 @@ if the text can be changed by the use of the up or down buttons only; otherwise, . The default value is . - property to `true`, you will eliminate the need for much validation of the property. The user will be restricted to the use of the up and down buttons to change the values. It will only allow them to select values you specify. - + property to `true`, you will eliminate the need for much validation of the property. The user will be restricted to the use of the up and down buttons to change the values. It will only allow them to select values you specify. + > [!NOTE] -> In the derived class , the behavior described is slightly different. When is set to `true` and a key is pressed, the control selects the first item in the collection where the first character matches the key pressed. - - - -## Examples - The following code example uses the derived class and sets some of its properties derived from . This code requires that you have a control, two controls, and three controls created on a form. Label the controls and . Label the controls , , and . The code allows you to change the property values at run time and see how each affects the appearance and behavior of the spin box. Add the following items to the combo box labeled BorderStyle: `None`, `Fixed3D`, and `FixedSingle`. Add the following items to the combo box labeled TextAlign: `Left`, `Right`, and `Center`. - +> In the derived class , the behavior described is slightly different. When is set to `true` and a key is pressed, the control selects the first item in the collection where the first character matches the key pressed. + + + +## Examples + The following code example uses the derived class and sets some of its properties derived from . This code requires that you have a control, two controls, and three controls created on a form. Label the controls and . Label the controls , , and . The code allows you to change the property values at run time and see how each affects the appearance and behavior of the spin box. Add the following items to the combo box labeled BorderStyle: `None`, `Fixed3D`, and `FixedSingle`. Add the following items to the combo box labeled TextAlign: `Left`, `Right`, and `Center`. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic UpDownBase Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/UpDownBase/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/Overview/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/Overview/source.vb" id="Snippet1"::: + ]]> @@ -2199,20 +2199,20 @@ The total number of characters to be selected. Selects a range of text in the spin box (also known as an up-down control) specifying the starting position and number of characters to select. - method can be used when the spin box gets focus, or when the property fails data validation. When adding the validation code for the method in a derived class, call the method when validation fails. - - - -## Examples - The following code example uses the derived class . This code requires that a control and a have been created on a form and the namespace has been added as a reference. On the event for the button, the point size of text in the control increases. This prompts the control to adjust its property so that all the text is visible in the control. After the user enters a new value and leaves the control, the text is converted to a numeric value from a string value and validated to be between the and values. If the value is not valid, a is displayed with the error, and the method will select the text so the user can enter a new value. - + method can be used when the spin box gets focus, or when the property fails data validation. When adding the validation code for the method in a derived class, call the method when validation fails. + + + +## Examples + The following code example uses the derived class . This code requires that a control and a have been created on a form and the namespace has been added as a reference. On the event for the button, the point size of text in the control increases. This prompts the control to adjust its property so that all the text is visible in the control. After the user enters a new value and leaves the control, the text is converted to a numeric value from a string value and validated to be between the and values. If the value is not valid, a is displayed with the error, and the method will select the text so the user can enter a new value. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic UpDownBase.Text Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/UpDownBase/Select/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/Select/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/Select/source.vb" id="Snippet1"::: + ]]> @@ -2283,20 +2283,20 @@ Gets or sets the text displayed in the spin box (also known as an up-down control). The string value displayed in the spin box. - method is called if the property is set while the property is set to `true`. The method is called if the property is set while the property is set to `false`. - - - -## Examples - The following code example uses the derived class . This code requires that a control and a have been created on a form and the namespace has been added as a reference. On the event for the button, the point size of text in the control increases. This prompts the control to adjust its property so all the text is visible in the control. After the user enters a new value and leaves the control, the text is converted to a numeric value from a string value and validated to be between the and values. If the value is not valid, a is displayed with the error, and the method will select the text so the user can enter a new value. - + method is called if the property is set while the property is set to `true`. The method is called if the property is set while the property is set to `false`. + + + +## Examples + The following code example uses the derived class . This code requires that a control and a have been created on a form and the namespace has been added as a reference. On the event for the button, the point size of text in the control increases. This prompts the control to adjust its property so all the text is visible in the control. After the user enters a new value and leaves the control, the text is converted to a numeric value from a string value and validated to be between the and values. If the value is not valid, a is displayed with the error, and the method will select the text so the user can enter a new value. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic UpDownBase.Text Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/UpDownBase/Select/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/Select/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/Select/source.vb" id="Snippet1"::: + ]]> @@ -2341,17 +2341,17 @@ Gets or sets the alignment of the text in the spin box (also known as an up-down control). One of the values. The default value is . - and sets some of its properties derived from . This code requires that you have a control named `numericUpDown1`, two controls named `comboBox1` and `comboBox2`, and three controls named `checkBox1`, `checkBox2`, and `checkBox2` created on a form. Add the following items to `comboBox1`: `None`, `Fixed3D`, and `FixedSingle`. Add the following items to `comboBox2`: `Left`, `Right`, and `Center`. - - The code allows you to change the property values at run time and see how each affects the appearance and behavior of the spin box. - + and sets some of its properties derived from . This code requires that you have a control named `numericUpDown1`, two controls named `comboBox1` and `comboBox2`, and three controls named `checkBox1`, `checkBox2`, and `checkBox2` created on a form. Add the following items to `comboBox1`: `None`, `Fixed3D`, and `FixedSingle`. Add the following items to `comboBox2`: `Left`, `Right`, and `Center`. + + The code allows you to change the property values at run time and see how each affects the appearance and behavior of the spin box. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic UpDownBase Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/UpDownBase/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/Overview/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/Overview/source.vb" id="Snippet1"::: + ]]> The value assigned is not one of the values. @@ -2466,17 +2466,17 @@ Gets or sets the alignment of the up and down buttons on the spin box (also known as an up-down control). One of the values. The default value is . - and sets some of its properties derived from . This code requires that you have a control named `numericUpDown1`, two controls named `comboBox1` and `comboBox2`, and three controls named `checkBox1`, `checkBox2`, and `checkBox2` created on a form. Add the following items to `comboBox1`: `None`, `Fixed3D`, and `FixedSingle`. Add the following items to `comboBox2`: `Left`, `Right`, and `Center`. - - The code allows you to change the property values at run time and see how each affects the appearance and behavior of the spin box. - + and sets some of its properties derived from . This code requires that you have a control named `numericUpDown1`, two controls named `comboBox1` and `comboBox2`, and three controls named `checkBox1`, `checkBox2`, and `checkBox2` created on a form. Add the following items to `comboBox1`: `None`, `Fixed3D`, and `FixedSingle`. Add the following items to `comboBox2`: `Left`, `Right`, and `Center`. + + The code allows you to change the property values at run time and see how each affects the appearance and behavior of the spin box. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/Classic UpDownBase Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/UpDownBase/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/Overview/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows.Forms/UpDownBase/Overview/source.vb" id="Snippet1"::: + ]]> The value assigned is not one of the values. @@ -2521,11 +2521,11 @@ if the user has changed the property; otherwise, . - property is set while the property is set to `true`, the method is called. If the property is set while the property is set to `false`, the method is called. - + property is set while the property is set to `true`, the method is called. If the property is set while the property is set to `false`, the method is called. + ]]> @@ -2560,11 +2560,11 @@ When overridden in a derived class, validates the text displayed in the spin box (also known as an up-down control). - diff --git a/xml/System.Windows/UIElement.xml b/xml/System.Windows/UIElement.xml index 76a3950c521..3234f7213dd 100644 --- a/xml/System.Windows/UIElement.xml +++ b/xml/System.Windows/UIElement.xml @@ -14724,7 +14724,7 @@ For this call to be successful, some other element in the application needed to ## XAML Attribute Usage ```xaml - + ``` diff --git a/xml/System.Windows/Vector.xml b/xml/System.Windows/Vector.xml index cf65bdd9120..0ce070851ea 100644 --- a/xml/System.Windows/Vector.xml +++ b/xml/System.Windows/Vector.xml @@ -42,40 +42,40 @@ Represents a displacement in 2-D space. - represents a fixed position, but a represents a direction and a magnitude (for example, velocity or acceleration). Thus, the endpoints of a line segment are points but their difference is a vector; that is, the direction and length of that line segment. - - In XAML, the delimiter between the and values of a can be either a comma or a space. - - Some cultures might use the comma character as the decimal delimiter instead of the period character. XAML processing for invariant culture defaults to en-US in most XAML processor implementations, and expects the period to be the decimal delimiter. You should avoid using the comma character as the decimal delimiter if specifying a in XAML, because that will clash with the string type conversion of a attribute value into the and components. - - -## XAML Attribute Usage - -``` - --or- - -``` - - -## XAML Values - *x* - The vector's X component. For more information, see the property. - - *y* - The vector's Y component. For more information, see the property. - - - -## Examples - The following example shows how to add two structures. - + represents a fixed position, but a represents a direction and a magnitude (for example, velocity or acceleration). Thus, the endpoints of a line segment are points but their difference is a vector; that is, the direction and length of that line segment. + + In XAML, the delimiter between the and values of a can be either a comma or a space. + + Some cultures might use the comma character as the decimal delimiter instead of the period character. XAML processing for invariant culture defaults to en-US in most XAML processor implementations, and expects the period to be the decimal delimiter. You should avoid using the comma character as the decimal delimiter if specifying a in XAML, because that will clash with the string type conversion of a attribute value into the and components. + + +## XAML Attribute Usage + +``` + +-or- + +``` + + +## XAML Values + *x* + The vector's X component. For more information, see the property. + + *y* + The vector's Y component. For more information, see the property. + + + +## Examples + The following example shows how to add two structures. + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/Overview/Window1.xaml.cs" id="Snippet10"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Overview/window1.xaml.vb" id="Snippet10"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Overview/window1.xaml.vb" id="Snippet10"::: + ]]> @@ -115,13 +115,13 @@ The -offset of the new . Initializes a new instance of the structure. - @@ -167,13 +167,13 @@ Translates the specified point by the specified vector and returns the resulting point. The result of translating by . - structure to a structure. - - :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetaddpointandvectorexample_csharp"::: - + structure to a structure. + + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetaddpointandvectorexample_csharp"::: + ]]> @@ -211,13 +211,13 @@ Adds two vectors and returns the result as a structure. The sum of and . - structures. - - :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetaddtwovectorsexample_csharp"::: - + structures. + + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetaddtwovectorsexample_csharp"::: + ]]> @@ -255,13 +255,13 @@ Retrieves the angle, expressed in degrees, between the two specified vectors. The angle, in degrees, between and . - structures. - - :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetanglebetweenexample_csharp"::: - + structures. + + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetanglebetweenexample_csharp"::: + ]]> @@ -296,17 +296,17 @@ The first vector to evaluate. The second vector to evaluate. Calculates the cross product of two vectors. - The cross product of and . The following formula is used to calculate the cross product: - + The cross product of and . The following formula is used to calculate the cross product: + (Vector1.X * Vector2.Y) - (Vector1.Y * Vector2.X) - structures. - - :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetcrossproductexample_csharp"::: - + structures. + + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetcrossproductexample_csharp"::: + ]]> @@ -343,13 +343,13 @@ Calculates the determinant of two vectors. The determinant of and . - structures. - - :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetdeterminantexample_csharp"::: - + structures. + + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetdeterminantexample_csharp"::: + ]]> @@ -386,13 +386,13 @@ Divides the specified vector by the specified scalar and returns the result as a . The result of dividing by . - by a scalar. - - :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetdivideexample_csharp"::: - + by a scalar. + + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetdivideexample_csharp"::: + ]]> @@ -406,11 +406,11 @@ Compares two vectors for equality. - and properties are described using values. Because the value of a can lose precision when arithmetic operations are performed on it, a comparison between two structures that are logically equal might fail. - + and properties are described using values. Because the value of a can lose precision when arithmetic operations are performed on it, a comparison between two structures that are logically equal might fail. + ]]> @@ -446,18 +446,18 @@ if is a and has the same and values as this vector; otherwise, . - and properties are described using values. Because the value of a can lose precision when arithmetic operations are performed on it, a comparison between two structures that are logically equal might fail. - - - -## Examples - The following example shows how to use this method to check whether a and an are equal. - - :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetequalsexample2_csharp"::: - + and properties are described using values. Because the value of a can lose precision when arithmetic operations are performed on it, a comparison between two structures that are logically equal might fail. + + + +## Examples + The following example shows how to use this method to check whether a and an are equal. + + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetequalsexample2_csharp"::: + ]]> @@ -494,18 +494,18 @@ if has the same and values as this vector; otherwise, . - and properties are described using values. Because the value of a can lose precision when arithmetic operations are performed on it, a comparison between two structures that are logically equal might fail. - - - -## Examples - The following example shows how to use this method to check whether two structures are equal. - - :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetequalsexample2_csharp"::: - + and properties are described using values. Because the value of a can lose precision when arithmetic operations are performed on it, a comparison between two structures that are logically equal might fail. + + + +## Examples + The following example shows how to use this method to check whether two structures are equal. + + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetequalsexample2_csharp"::: + ]]> @@ -544,16 +544,16 @@ if the and components of and are equal; otherwise, . - and properties are described using values. Because the value of a can lose precision when arithmetic operations are performed on it, a comparison between two structures that are logically equal might fail. - -## Examples - The following example shows how to use this method to check whether two structures are equal. - - :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetequalsexample1_csharp"::: - + +## Examples + The following example shows how to use this method to check whether two structures are equal. + + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetequalsexample1_csharp"::: + ]]> @@ -586,13 +586,13 @@ Returns the hash code for this vector. The hash code for this instance. - . - - :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetgethashcodeexample_csharp"::: - + . + + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetgethashcodeexample_csharp"::: + ]]> @@ -623,19 +623,19 @@ Gets the length of this vector. The length of this vector. - @@ -666,19 +666,19 @@ Gets the square of the length of this vector. The square of the of this vector. - @@ -724,13 +724,13 @@ Multiplies the specified scalar by the specified vector and returns the resulting . The result of multiplying and . - . - - :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetmultiplyvectorbyscalarexample2_csharp"::: - + . + + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetmultiplyvectorbyscalarexample2_csharp"::: + ]]> @@ -768,13 +768,13 @@ Multiplies the specified vector by the specified scalar and returns the resulting . The result of multiplying and . - by a scalar. - - :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetmultiplyvectorbyscalarexample1_csharp"::: - + by a scalar. + + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetmultiplyvectorbyscalarexample1_csharp"::: + ]]> @@ -812,13 +812,13 @@ Transforms the coordinate space of the specified vector using the specified . The result of transforming by . - by a . - - :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetmultiplyvectorbymatrixexample_csharp"::: - + by a . + + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetmultiplyvectorbymatrixexample_csharp"::: + ]]> @@ -854,17 +854,17 @@ The first vector to multiply. The second vector structure to multiply. Calculates the dot product of the two specified vectors and returns the result as a . - A containing the scalar dot product of and , which is calculated using the following formula: - + A containing the scalar dot product of and , which is calculated using the following formula: + (vector1.X * vector2.X) + (vector1.Y * vector2.Y) - by a . - - :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetgetdotproductexample_csharp"::: - + by a . + + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetgetdotproductexample_csharp"::: + ]]> @@ -896,13 +896,13 @@ Negates this vector. The vector has the same magnitude as before, but its direction is now opposite. - @@ -934,18 +934,18 @@ Normalizes this vector. - becomes 1. The resulting vector is often called a unit vector. A vector is normalized by dividing the vector by its own . - - - -## Examples - The following example shows how to use this method to normalize a vector. - - :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetnormalizeexample_csharp"::: - + becomes 1. The resulting vector is often called a unit vector. A vector is normalized by dividing the vector by its own . + + + +## Examples + The following example shows how to use this method to normalize a vector. + + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetnormalizeexample_csharp"::: + ]]> @@ -991,14 +991,14 @@ Translates a point by the specified vector and returns the resulting point. The result of translating by . - structure to a structure. - + structure to a structure. + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetoverloadedadditionoperatorexample2"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedadditionoperatorexample2"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedadditionoperatorexample2"::: + ]]> @@ -1036,14 +1036,14 @@ Adds two vectors and returns the result as a vector. The sum of and . - structures and return a . - + structures and return a . + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetoverloadedadditionoperatorexample1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedadditionoperatorexample1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedadditionoperatorexample1"::: + ]]> @@ -1081,14 +1081,14 @@ Divides the specified vector by the specified scalar and returns the resulting vector. The result of dividing by . - structure by a scalar. - + structure by a scalar. + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetoverloadeddivisionoperatorexample"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadeddivisionoperatorexample"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadeddivisionoperatorexample"::: + ]]> @@ -1127,19 +1127,19 @@ if the and components of and are equal; otherwise, . - and properties are described using values. Because the value of a can lose precision when arithmetic operations are performed on it, a comparison between two structures that are logically equal might fail. - - - -## Examples - The following example shows how to use this operator (==) to check whether two structures are equal. - + and properties are described using values. Because the value of a can lose precision when arithmetic operations are performed on it, a comparison between two structures that are logically equal might fail. + + + +## Examples + The following example shows how to use this operator (==) to check whether two structures are equal. + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetoverloadedequalityoperatorexample"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedequalityoperatorexample"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedequalityoperatorexample"::: + ]]> @@ -1184,14 +1184,14 @@ Creates a with the and values of this vector. A point with - and -coordinate values equal to the and offset values of . - into a . - + into a . + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetoverloadedexplicitoperatorexample2"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedexplicitoperatorexample2"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedexplicitoperatorexample2"::: + ]]> @@ -1226,14 +1226,14 @@ Creates a from the offsets of this vector. A with a equal to the absolute value of this vector's property and a equal to the absolute value of this vector's property. - into a . - + into a . + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetoverloadedexplicitoperatorexample1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedexplicitoperatorexample1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedexplicitoperatorexample1"::: + ]]> @@ -1271,19 +1271,19 @@ if the and components of and are different; otherwise, . - and properties are described using values. Because the value of a can lose precision when arithmetic operations are performed on it, a comparison between two structures that are logically equal might fail. - - - -## Examples - The following example shows how to use this operator (!=) to check whether two structures are not equal. - + and properties are described using values. Because the value of a can lose precision when arithmetic operations are performed on it, a comparison between two structures that are logically equal might fail. + + + +## Examples + The following example shows how to use this operator (!=) to check whether two structures are not equal. + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetoverloadedinequalityoperatorexample"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedinequalityoperatorexample"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedinequalityoperatorexample"::: + ]]> @@ -1329,14 +1329,14 @@ Multiplies the specified scalar by the specified vector and returns the resulting vector. The result of multiplying and . - structure. - + structure. + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetoverloadedmultiplicationoperatorexample2"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedmultiplicationoperatorexample2"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedmultiplicationoperatorexample2"::: + ]]> @@ -1374,14 +1374,14 @@ Multiplies the specified vector by the specified scalar and returns the resulting vector. The result of multiplying and . - structure by a scalar. - + structure by a scalar. + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetoverloadedmultiplicationoperatorexample1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedmultiplicationoperatorexample1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedmultiplicationoperatorexample1"::: + ]]> @@ -1419,14 +1419,14 @@ Transforms the coordinate space of the specified vector using the specified . The result of transforming by . - structure by a structure. - + structure by a structure. + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetoverloadedmultiplyvectorbymatrixoperatorexample"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedmultiplyvectorbymatrixoperatorexample"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedmultiplyvectorbymatrixoperatorexample"::: + ]]> @@ -1462,18 +1462,18 @@ The first vector to multiply. The second vector to multiply. Calculates the dot product of the two specified vector structures and returns the result as a . - Returns a containing the scalar dot product of and , which is calculated using the following formula: - + Returns a containing the scalar dot product of and , which is calculated using the following formula: + vector1.X * vector2.X + vector1.Y * vector2.Y - structure by a . - + structure by a . + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetoverloadedoperatorgetdotproductexample"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedoperatorgetdotproductexample"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedoperatorgetdotproductexample"::: + ]]> @@ -1511,14 +1511,14 @@ Subtracts one specified vector from another. The difference between and . - structure from a structure. - + structure from a structure. + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetoverloadedsubtractionoperatorexample"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedsubtractionoperatorexample"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadedsubtractionoperatorexample"::: + ]]> @@ -1554,14 +1554,14 @@ Negates the specified vector. A vector with and values opposite of the and values of . - structure. - + structure. + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetoverloadednegationoperatorexample"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadednegationoperatorexample"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetoverloadednegationoperatorexample"::: + ]]> @@ -1597,14 +1597,14 @@ Converts a string representation of a vector into the equivalent structure. The equivalent structure. - structure. - + structure. + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetparseexample"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetparseexample"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetparseexample"::: + ]]> @@ -1642,14 +1642,14 @@ Subtracts the specified vector from another specified vector. The difference between and . - structure from a structure. - + structure from a structure. + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetsubtractexample"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetsubtractexample"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetsubtractexample"::: + ]]> @@ -1691,15 +1691,15 @@ - The string specifying the format to use. - - -or- - + The string specifying the format to use. + + -or- + to use the default format defined for the type of the implementation. - The to use to format the value. - - -or- - + The to use to format the value. + + -or- + to obtain the numeric format information from the current locale setting of the operating system. This member supports the Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code. For a description of this member, see . A string containing the value of the current instance in the specified format. @@ -1748,14 +1748,14 @@ Returns the string representation of this structure. A string that represents the and values of this . - . - + . + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippettostringexample"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippettostringexample"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippettostringexample"::: + ]]> @@ -1836,14 +1836,14 @@ Gets or sets the component of this vector. The component of this vector. The default value is 0. - structures for equality. - + structures for equality. + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetvectorequalityexample"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetvectorequalityexample"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetvectorequalityexample"::: + ]]> @@ -1885,14 +1885,14 @@ Gets or sets the component of this vector. The component of this vector. The default value is 0. - structures for equality. - + structures for equality. + :::code language="csharp" source="~/snippets/csharp/System.Windows/Vector/.ctor/VectorExample.cs" id="Snippetvectorequalityexample"::: - :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetvectorequalityexample"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Windows/Vector/Length/vectorexample.vb" id="Snippetvectorequalityexample"::: + ]]> diff --git a/xml/System/Attribute.xml b/xml/System/Attribute.xml index f61ac0db394..3ea9d6ac839 100644 --- a/xml/System/Attribute.xml +++ b/xml/System/Attribute.xml @@ -321,7 +321,7 @@ When implementing your own class derived from , you can o ## Examples The following code example illustrates the use of the method taking an as a parameter. -  + :::code language="csharp" source="~/snippets/csharp/System/Attribute/GetCustomAttribute/id1.cs" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR/IsDefined/FS/id1.fs" id="Snippet1"::: :::code language="vb" source="~/snippets/visualbasic/System/Attribute/GetCustomAttribute/id1.vb" id="Snippet1"::: @@ -399,7 +399,7 @@ When implementing your own class derived from , you can o ## Examples The following code example illustrates the use of the method taking a as a parameter. -  + :::code language="csharp" source="~/snippets/csharp/System/Attribute/GetCustomAttribute/id4.cs" id="Snippet4"::: :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR/IsDefined/FS/id4.fs" id="Snippet4"::: :::code language="vb" source="~/snippets/visualbasic/System/Attribute/GetCustomAttribute/id4.vb" id="Snippet4"::: @@ -472,7 +472,7 @@ When implementing your own class derived from , you can o ## Examples The following code example illustrates the use of the method taking a as a parameter. -  + :::code language="csharp" source="~/snippets/csharp/System/Attribute/GetCustomAttribute/id2.cs" id="Snippet2"::: :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR/IsDefined/FS/id2.fs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/System/Attribute/GetCustomAttribute/id2.vb" id="Snippet2"::: @@ -627,7 +627,7 @@ When implementing your own class derived from , you can o ## Examples The following code example illustrates the use of the method taking an as a parameter. -  + :::code language="csharp" source="~/snippets/csharp/System/Attribute/GetCustomAttribute/id1.cs" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR/IsDefined/FS/id1.fs" id="Snippet1"::: :::code language="vb" source="~/snippets/visualbasic/System/Attribute/GetCustomAttribute/id1.vb" id="Snippet1"::: @@ -706,7 +706,7 @@ When implementing your own class derived from , you can o ## Examples The following code example illustrates the use of the method taking a as a parameter. -  + :::code language="csharp" source="~/snippets/csharp/System/Attribute/GetCustomAttribute/id4.cs" id="Snippet4"::: :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR/IsDefined/FS/id4.fs" id="Snippet4"::: :::code language="vb" source="~/snippets/visualbasic/System/Attribute/GetCustomAttribute/id4.vb" id="Snippet4"::: @@ -781,7 +781,7 @@ When implementing your own class derived from , you can o ## Examples The following code example illustrates the use of the method taking a as a parameter. -  + :::code language="csharp" source="~/snippets/csharp/System/Attribute/GetCustomAttribute/id2.cs" id="Snippet2"::: :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR/IsDefined/FS/id2.fs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/System/Attribute/GetCustomAttribute/id2.vb" id="Snippet2"::: diff --git a/xml/System/Convert.xml b/xml/System/Convert.xml index db7ba975cbe..5c62a82e3e9 100644 --- a/xml/System/Convert.xml +++ b/xml/System/Convert.xml @@ -955,7 +955,7 @@ The span to convert. - The span in which to write the converted 8-bit unsigned integers. + The span in which to write the converted 8-bit unsigned integers. When this method returns, contains the number of bytes that were consumed from . When this method returns, contains the number of bytes that were written to . @@ -10645,7 +10645,7 @@ :::code language="csharp" source="~/snippets/csharp/System/Convert/ToInt32/toint32_1.cs" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System/Convert/ToInt32/toint32_1.fs" id="Snippet1"::: :::code language="vb" source="~/snippets/visualbasic/System/Convert/ToInt32/toint32_1.vb" id="Snippet1"::: -  + ]]> @@ -10707,7 +10707,7 @@ :::code language="csharp" source="~/snippets/csharp/System/Convert/ToInt32/toint32_1.cs" id="Snippet2"::: :::code language="fsharp" source="~/snippets/fsharp/System/Convert/ToInt32/toint32_1.fs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/System/Convert/ToInt32/toint32_1.vb" id="Snippet2"::: -  + ]]> @@ -10892,7 +10892,7 @@ :::code language="csharp" source="~/snippets/csharp/System/Convert/ToInt32/toint32_1.cs" id="Snippet4"::: :::code language="fsharp" source="~/snippets/fsharp/System/Convert/ToInt32/toint32_1.fs" id="Snippet4"::: :::code language="vb" source="~/snippets/visualbasic/System/Convert/ToInt32/toint32_1.vb" id="Snippet4"::: -  + ]]> @@ -10958,7 +10958,7 @@ :::code language="csharp" source="~/snippets/csharp/System/Convert/ToInt32/toint32_1.cs" id="Snippet5"::: :::code language="fsharp" source="~/snippets/fsharp/System/Convert/ToInt32/toint32_1.fs" id="Snippet5"::: :::code language="vb" source="~/snippets/visualbasic/System/Convert/ToInt32/toint32_1.vb" id="Snippet5"::: -  + ]]> @@ -11024,7 +11024,7 @@ :::code language="csharp" source="~/snippets/csharp/System/Convert/ToInt32/toint32_1.cs" id="Snippet6"::: :::code language="fsharp" source="~/snippets/fsharp/System/Convert/ToInt32/toint32_1.fs" id="Snippet6"::: :::code language="vb" source="~/snippets/visualbasic/System/Convert/ToInt32/toint32_1.vb" id="Snippet6"::: -  + ]]>