diff --git a/samples/snippets/csharp/VS_Snippets_CLR/Environment.NewLine/CS/newline.cs b/samples/snippets/csharp/VS_Snippets_CLR/Environment.NewLine/CS/newline.cs index f07a829b1c0..27a82f9c035 100644 --- a/samples/snippets/csharp/VS_Snippets_CLR/Environment.NewLine/CS/newline.cs +++ b/samples/snippets/csharp/VS_Snippets_CLR/Environment.NewLine/CS/newline.cs @@ -6,9 +6,9 @@ class Sample { public static void Main() { - Console.WriteLine(); - Console.WriteLine("NewLine: {0} first line{0} second line{0} third line", - Environment.NewLine); + Console.WriteLine(); + Console.WriteLine("NewLine: {0} first line{0} second line{0} third line", + Environment.NewLine); } } /* @@ -19,4 +19,4 @@ first line second line third line */ -// \ No newline at end of file +// diff --git a/xml/System.Collections.Concurrent/OrderablePartitioner`1.xml b/xml/System.Collections.Concurrent/OrderablePartitioner`1.xml index 8bb41a5134c..a499778891d 100644 --- a/xml/System.Collections.Concurrent/OrderablePartitioner`1.xml +++ b/xml/System.Collections.Concurrent/OrderablePartitioner`1.xml @@ -105,7 +105,7 @@ ]]> - Custom Partitioners for PLINQ and TPL + Custom Partitioners for PLINQ and TPL How to: Speed Up Small Loop Bodies How to: Implement a Partitioner With a Static Number of Partitions How to: Implement Dynamic Partitions @@ -159,7 +159,7 @@ ]]> Dynamic partitioning is not supported by the base class. It must be implemented in derived classes. - Custom Partitioners for PLINQ and TPL + Custom Partitioners for PLINQ and TPL How to: Speed Up Small Loop Bodies How to: Implement a Partitioner With a Static Number of Partitions How to: Implement Dynamic Partitions @@ -213,7 +213,7 @@ ]]> Dynamic partitioning is not supported by this partitioner. - Custom Partitioners for PLINQ and TPL + Custom Partitioners for PLINQ and TPL How to: Speed Up Small Loop Bodies How to: Implement a Partitioner With a Static Number of Partitions How to: Implement Dynamic Partitions @@ -267,7 +267,7 @@ ]]> - Custom Partitioners for PLINQ and TPL + Custom Partitioners for PLINQ and TPL How to: Speed Up Small Loop Bodies How to: Implement a Partitioner With a Static Number of Partitions How to: Implement Dynamic Partitions @@ -319,7 +319,7 @@ ]]> - Custom Partitioners for PLINQ and TPL + Custom Partitioners for PLINQ and TPL How to: Speed Up Small Loop Bodies How to: Implement a Partitioner With a Static Number of Partitions How to: Implement Dynamic Partitions @@ -413,7 +413,7 @@ ]]> - Custom Partitioners for PLINQ and TPL + Custom Partitioners for PLINQ and TPL How to: Speed Up Small Loop Bodies How to: Implement a Partitioner With a Static Number of Partitions How to: Implement Dynamic Partitions @@ -460,7 +460,7 @@ ]]> - Custom Partitioners for PLINQ and TPL + Custom Partitioners for PLINQ and TPL How to: Speed Up Small Loop Bodies How to: Implement a Partitioner With a Static Number of Partitions How to: Implement Dynamic Partitions diff --git a/xml/System.Collections.Concurrent/Partitioner`1.xml b/xml/System.Collections.Concurrent/Partitioner`1.xml index 3876a2e754d..06aff22568d 100644 --- a/xml/System.Collections.Concurrent/Partitioner`1.xml +++ b/xml/System.Collections.Concurrent/Partitioner`1.xml @@ -89,7 +89,7 @@ To be added. - Custom Partitioners for PLINQ and TPL + Custom Partitioners for PLINQ and TPL @@ -138,7 +138,7 @@ Dynamic partitioning is not supported by the base class. You must implement it in a derived class. - Custom Partitioners for PLINQ and TPL + Custom Partitioners for PLINQ and TPL @@ -187,7 +187,7 @@ - Custom Partitioners for PLINQ and TPL + Custom Partitioners for PLINQ and TPL @@ -233,7 +233,7 @@ - Custom Partitioners for PLINQ and TPL + Custom Partitioners for PLINQ and TPL diff --git a/xml/System.Collections.Generic/IEnumerable`1.xml b/xml/System.Collections.Generic/IEnumerable`1.xml index d5662a6a08a..f0a2558ad84 100644 --- a/xml/System.Collections.Generic/IEnumerable`1.xml +++ b/xml/System.Collections.Generic/IEnumerable`1.xml @@ -76,8 +76,9 @@ - Walkthrough: Implementing IEnumerable(Of T) in Visual Basic - Iterators (C# and Visual Basic) + Walkthrough: Implementing IEnumerable(Of T) in Visual Basic + Iterators (C#) + Iterators (Visual Basic) Generics Sample @@ -151,8 +152,9 @@ ]]> - Walkthrough: Implementing IEnumerable(Of T) in Visual Basic - Iterators (C# and Visual Basic) + Walkthrough: Implementing IEnumerable(Of T) in Visual Basic + Iterators (C#) + Iterators (Visual Basic) diff --git a/xml/System.ComponentModel/AsyncCompletedEventArgs.xml b/xml/System.ComponentModel/AsyncCompletedEventArgs.xml index b80b32ce703..8d60070e2b8 100644 --- a/xml/System.ComponentModel/AsyncCompletedEventArgs.xml +++ b/xml/System.ComponentModel/AsyncCompletedEventArgs.xml @@ -66,7 +66,7 @@ - Implementing the Event-based Asynchronous Pattern + Implementing the Event-based Asynchronous Pattern @@ -221,7 +221,7 @@ - Implementing the Event-based Asynchronous Pattern + Implementing the Event-based Asynchronous Pattern @@ -288,7 +288,7 @@ - Implementing the Event-based Asynchronous Pattern + Implementing the Event-based Asynchronous Pattern @@ -343,7 +343,7 @@ - Implementing the Event-based Asynchronous Pattern + Implementing the Event-based Asynchronous Pattern @@ -407,7 +407,7 @@ - Implementing the Event-based Asynchronous Pattern + Implementing the Event-based Asynchronous Pattern diff --git a/xml/System.ComponentModel/AsyncCompletedEventHandler.xml b/xml/System.ComponentModel/AsyncCompletedEventHandler.xml index f301605d8ab..a99e121ae45 100644 --- a/xml/System.ComponentModel/AsyncCompletedEventHandler.xml +++ b/xml/System.ComponentModel/AsyncCompletedEventHandler.xml @@ -62,6 +62,6 @@ - Asynchronous Pattern for Components + Asynchronous Pattern for Components diff --git a/xml/System.ComponentModel/AsyncOperation.xml b/xml/System.ComponentModel/AsyncOperation.xml index f80dd05a1f5..c34756e9cf9 100644 --- a/xml/System.ComponentModel/AsyncOperation.xml +++ b/xml/System.ComponentModel/AsyncOperation.xml @@ -401,7 +401,7 @@ Managed Threading Best Practices - Event-based Asynchronous Pattern Overview + Event-based Asynchronous Pattern Overview diff --git a/xml/System.ComponentModel/AsyncOperationManager.xml b/xml/System.ComponentModel/AsyncOperationManager.xml index d05328b997e..61bac85bf9a 100644 --- a/xml/System.ComponentModel/AsyncOperationManager.xml +++ b/xml/System.ComponentModel/AsyncOperationManager.xml @@ -56,7 +56,7 @@ ]]> - Implementing the Event-based Asynchronous Pattern + Implementing the Event-based Asynchronous Pattern Managed Threading Best Practices @@ -123,7 +123,7 @@ ]]> - Implementing the Event-based Asynchronous Pattern + Implementing the Event-based Asynchronous Pattern Managed Threading Best Practices diff --git a/xml/System.ComponentModel/IListSource.xml b/xml/System.ComponentModel/IListSource.xml index 0b34c855693..6593acae925 100644 --- a/xml/System.ComponentModel/IListSource.xml +++ b/xml/System.ComponentModel/IListSource.xml @@ -88,7 +88,7 @@ - Data Binding and Windows Forms + Data Binding and Windows Forms @@ -146,7 +146,7 @@ - Data Binding and Windows Forms + Data Binding and Windows Forms @@ -199,7 +199,7 @@ - Data Binding and Windows Forms + Data Binding and Windows Forms diff --git a/xml/System.ComponentModel/ITypedList.xml b/xml/System.ComponentModel/ITypedList.xml index 847898b6892..088f3b3e471 100644 --- a/xml/System.ComponentModel/ITypedList.xml +++ b/xml/System.ComponentModel/ITypedList.xml @@ -62,8 +62,8 @@ ]]> - How to: Implement the ITypedList Interface - Windows Forms Data Binding + How to: Implement the ITypedList Interface + Windows Forms Data Binding @@ -121,8 +121,8 @@ ]]> - How to: Implement the ITypedList Interface - Windows Forms Data Binding + How to: Implement the ITypedList Interface + Windows Forms Data Binding @@ -180,8 +180,8 @@ ]]> - How to: Implement the ITypedList Interface - Windows Forms Data Binding + How to: Implement the ITypedList Interface + Windows Forms Data Binding diff --git a/xml/System.ComponentModel/ListChangedEventArgs.xml b/xml/System.ComponentModel/ListChangedEventArgs.xml index 54b69680704..ae974395ab0 100644 --- a/xml/System.ComponentModel/ListChangedEventArgs.xml +++ b/xml/System.ComponentModel/ListChangedEventArgs.xml @@ -56,7 +56,7 @@ ]]> - Working with DataView Events + Working with DataView Events @@ -120,7 +120,7 @@ ]]> - Working with DataView Events + Working with DataView Events @@ -172,7 +172,7 @@ ]]> - Working with DataView Events + Working with DataView Events @@ -263,7 +263,7 @@ Initializes a new instance of the class given the type of change and the old and new index of the item that was moved. To be added. - Working with DataView Events + Working with DataView Events @@ -318,7 +318,7 @@ ]]> - Working with DataView Events + Working with DataView Events @@ -378,7 +378,7 @@ ]]> - Working with DataView Events + Working with DataView Events @@ -433,7 +433,7 @@ ]]> - Working with DataView Events + Working with DataView Events @@ -487,7 +487,7 @@ ]]> - Working with DataView Events + Working with DataView Events diff --git a/xml/System.Net.Configuration/HttpListenerElement.xml b/xml/System.Net.Configuration/HttpListenerElement.xml index 1be20ab1e62..31dca39bda7 100644 --- a/xml/System.Net.Configuration/HttpListenerElement.xml +++ b/xml/System.Net.Configuration/HttpListenerElement.xml @@ -89,7 +89,7 @@ Network Settings Schema - <httpListener> Element (Network Settings) + <httpListener> Element (Network Settings) @@ -264,7 +264,7 @@ Network Settings Schema - <httpListener> Element (Network Settings) + <httpListener> Element (Network Settings) diff --git a/xml/System.Net.Configuration/SettingsSection.xml b/xml/System.Net.Configuration/SettingsSection.xml index 1a3ae87be31..1b2c8c85a68 100644 --- a/xml/System.Net.Configuration/SettingsSection.xml +++ b/xml/System.Net.Configuration/SettingsSection.xml @@ -27,7 +27,7 @@ ]]> - Settings Element (Network Settings) + Settings Element (Network Settings) diff --git a/xml/System.Net.Configuration/WindowsAuthenticationElement.xml b/xml/System.Net.Configuration/WindowsAuthenticationElement.xml index 1b437e32752..2d1495db09c 100644 --- a/xml/System.Net.Configuration/WindowsAuthenticationElement.xml +++ b/xml/System.Net.Configuration/WindowsAuthenticationElement.xml @@ -61,7 +61,7 @@ . If this behavior impacts performance, you can use the `DefaultCredentialsHandleCacheSize` to use a single cached SSPI credential handle for default network credentials. You can do this by setting this property value to 0. This corresponds to the following configuration setting: +By default, the value of `defaultCredentialsHandleCacheSize` is 0. This causes Windows to allocate a separate SSPI handle for each . ```xml @@ -71,6 +71,8 @@ By default, Windows allocates a separate SSPI handle for each ``` +If this behavior impacts performance, set to a value greater than 0 to use a single, cached SSPI credential handle for default network credentials. The exact value depends on application requirements. Generally, a value between 50 and 100 works for most high-performant applications. + ]]> diff --git a/xml/System.Net.Http/WinHttpHandler.xml b/xml/System.Net.Http/WinHttpHandler.xml index 1ad164bbc2e..3921da4bd78 100644 --- a/xml/System.Net.Http/WinHttpHandler.xml +++ b/xml/System.Net.Http/WinHttpHandler.xml @@ -392,8 +392,8 @@ - To be added. - To be added. + to release both managed and unmanaged resources; to release only unmanaged resources. + Releases the unmanaged resources used by the , and optionally disposes of the managed resources. To be added. @@ -601,8 +601,8 @@ System.Collections.Generic.IDictionary<System.String,System.Object> - To be added. - To be added. + Gets a writable dictionary (that is, a map) of custom properties for the requests. The dictionary is initialized empty; you can insert and query key-value pairs for your custom handlers and special processing. + A writable dictionary of custom properties. To be added. diff --git a/xml/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapAnyUri.xml b/xml/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapAnyUri.xml index a2b912da449..4e9fd03de7a 100644 --- a/xml/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapAnyUri.xml +++ b/xml/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapAnyUri.xml @@ -34,7 +34,8 @@ - <dataContractSerializer> Element - Data Contract Known Types + <dataContractSerializer> Element + Data Contract Known Types @@ -79,8 +79,8 @@ To be added. - <dataContractSerializer> Element - Data Contract Known Types + <dataContractSerializer> Element + Data Contract Known Types diff --git a/xml/System.Runtime.Serialization.Configuration/DeclaredTypeElement.xml b/xml/System.Runtime.Serialization.Configuration/DeclaredTypeElement.xml index 4d7b71a1cc6..c2bc6d5246f 100644 --- a/xml/System.Runtime.Serialization.Configuration/DeclaredTypeElement.xml +++ b/xml/System.Runtime.Serialization.Configuration/DeclaredTypeElement.xml @@ -29,8 +29,8 @@ - <dataContractSerializer> Element - Data Contract Known Types + <dataContractSerializer> Element + Data Contract Known Types diff --git a/xml/System.Runtime.Serialization.Configuration/NetDataContractSerializerSection.xml b/xml/System.Runtime.Serialization.Configuration/NetDataContractSerializerSection.xml index e7d28adc1fe..de68ad4d2d6 100644 --- a/xml/System.Runtime.Serialization.Configuration/NetDataContractSerializerSection.xml +++ b/xml/System.Runtime.Serialization.Configuration/NetDataContractSerializerSection.xml @@ -19,8 +19,8 @@ - <dataContractSerializer> Element - Data Contract Known Types + <dataContractSerializer> Element + Data Contract Known Types diff --git a/xml/System.Runtime.Serialization.Configuration/ParameterElement.xml b/xml/System.Runtime.Serialization.Configuration/ParameterElement.xml index ec187bd0c8d..8336f8afafc 100644 --- a/xml/System.Runtime.Serialization.Configuration/ParameterElement.xml +++ b/xml/System.Runtime.Serialization.Configuration/ParameterElement.xml @@ -29,8 +29,8 @@ - <dataContractSerializer> Element - Data Contract Known Types + <dataContractSerializer> Element + Data Contract Known Types diff --git a/xml/System.Runtime.Serialization.Configuration/SerializationSectionGroup.xml b/xml/System.Runtime.Serialization.Configuration/SerializationSectionGroup.xml index 03786272415..17d98aa3013 100644 --- a/xml/System.Runtime.Serialization.Configuration/SerializationSectionGroup.xml +++ b/xml/System.Runtime.Serialization.Configuration/SerializationSectionGroup.xml @@ -27,7 +27,7 @@ ]]> - Data Contract Known Types + Data Contract Known Types diff --git a/xml/System.Runtime.Serialization.Configuration/TypeElement.xml b/xml/System.Runtime.Serialization.Configuration/TypeElement.xml index d956ea191f9..5cc889a23aa 100644 --- a/xml/System.Runtime.Serialization.Configuration/TypeElement.xml +++ b/xml/System.Runtime.Serialization.Configuration/TypeElement.xml @@ -26,8 +26,8 @@ - <dataContractSerializer> Element - Data Contract Known Types + <dataContractSerializer> Element + Data Contract Known Types diff --git a/xml/System.Runtime.Serialization.Configuration/TypeElementCollection.xml b/xml/System.Runtime.Serialization.Configuration/TypeElementCollection.xml index 7a00ba28199..84bd00c6225 100644 --- a/xml/System.Runtime.Serialization.Configuration/TypeElementCollection.xml +++ b/xml/System.Runtime.Serialization.Configuration/TypeElementCollection.xml @@ -34,8 +34,8 @@ - <dataContractSerializer> Element - Data Contract Known Types + <dataContractSerializer> Element + Data Contract Known Types diff --git a/xml/System.Runtime.Serialization/ContractNamespaceAttribute.xml b/xml/System.Runtime.Serialization/ContractNamespaceAttribute.xml index bd5be166137..92e7f247cf6 100644 --- a/xml/System.Runtime.Serialization/ContractNamespaceAttribute.xml +++ b/xml/System.Runtime.Serialization/ContractNamespaceAttribute.xml @@ -62,7 +62,7 @@ ]]> Using Data Contracts - Data Contract Names + Data Contract Names diff --git a/xml/System.Runtime.Serialization/IgnoreDataMemberAttribute.xml b/xml/System.Runtime.Serialization/IgnoreDataMemberAttribute.xml index 0def8081040..0dc68ab1c08 100644 --- a/xml/System.Runtime.Serialization/IgnoreDataMemberAttribute.xml +++ b/xml/System.Runtime.Serialization/IgnoreDataMemberAttribute.xml @@ -50,7 +50,7 @@ - Serializable Types + Serializable Types Types Supported by the Data Contract Serializer diff --git a/xml/System.Runtime.Serialization/ImportOptions.xml b/xml/System.Runtime.Serialization/ImportOptions.xml index 0f689fec4cc..1872fd10100 100644 --- a/xml/System.Runtime.Serialization/ImportOptions.xml +++ b/xml/System.Runtime.Serialization/ImportOptions.xml @@ -37,8 +37,8 @@ - Schema Import and Export - Importing Schema To Generate Classes + Schema Import and Export + Importing Schema To Generate Classes diff --git a/xml/System.Runtime.Serialization/KnownTypeAttribute.xml b/xml/System.Runtime.Serialization/KnownTypeAttribute.xml index 918dca14ff4..ac2bb1d9162 100644 --- a/xml/System.Runtime.Serialization/KnownTypeAttribute.xml +++ b/xml/System.Runtime.Serialization/KnownTypeAttribute.xml @@ -64,7 +64,7 @@ - Data Contract Known Types + Data Contract Known Types diff --git a/xml/System.Runtime.Serialization/XmlObjectSerializer.xml b/xml/System.Runtime.Serialization/XmlObjectSerializer.xml index 1d440e84ef9..737fd5c8838 100644 --- a/xml/System.Runtime.Serialization/XmlObjectSerializer.xml +++ b/xml/System.Runtime.Serialization/XmlObjectSerializer.xml @@ -57,7 +57,7 @@ Using Data Contracts - Data Contract Serializer + Data Contract Serializer diff --git a/xml/System.Runtime.Serialization/XsdDataContractImporter.xml b/xml/System.Runtime.Serialization/XsdDataContractImporter.xml index 45cdc9e1ae2..48034bcfc58 100644 --- a/xml/System.Runtime.Serialization/XsdDataContractImporter.xml +++ b/xml/System.Runtime.Serialization/XsdDataContractImporter.xml @@ -421,7 +421,7 @@ ]]> - Data Contract Known Types + Data Contract Known Types diff --git a/xml/System.Security.Authentication.ExtendedProtection/TokenBinding.xml b/xml/System.Security.Authentication.ExtendedProtection/TokenBinding.xml index f54af573455..b6595fd42a8 100644 --- a/xml/System.Security.Authentication.ExtendedProtection/TokenBinding.xml +++ b/xml/System.Security.Authentication.ExtendedProtection/TokenBinding.xml @@ -20,7 +20,8 @@ diff --git a/xml/System.Security.Cryptography.Pkcs/Pkcs9SigningTime.xml b/xml/System.Security.Cryptography.Pkcs/Pkcs9SigningTime.xml index 67d4e1f392d..448d9679475 100644 --- a/xml/System.Security.Cryptography.Pkcs/Pkcs9SigningTime.xml +++ b/xml/System.Security.Cryptography.Pkcs/Pkcs9SigningTime.xml @@ -32,7 +32,8 @@ diff --git a/xml/System.Security.Cryptography.X509Certificates/X500DistinguishedNameFlags.xml b/xml/System.Security.Cryptography.X509Certificates/X500DistinguishedNameFlags.xml index 872f6b416ed..6ca3c5ef7d0 100644 --- a/xml/System.Security.Cryptography.X509Certificates/X500DistinguishedNameFlags.xml +++ b/xml/System.Security.Cryptography.X509Certificates/X500DistinguishedNameFlags.xml @@ -164,7 +164,7 @@ 16384 - Forces the distinguished name to encode specific X.500 keys as UTF-8 strings rather than printable Unicode strings. For more information and the list of X.500 keys affected, see the X500NameFlags enumeration. + Forces the distinguished name to encode specific X.500 keys as UTF-8 strings rather than printable Unicode strings. For more information and the list of X.500 keys affected, see the X500NameFlags enumeration. diff --git a/xml/System.Security.Cryptography/Aes.xml b/xml/System.Security.Cryptography/Aes.xml index 992aaa966da..fbee1b9caa7 100644 --- a/xml/System.Security.Cryptography/Aes.xml +++ b/xml/System.Security.Cryptography/Aes.xml @@ -54,9 +54,9 @@ ## Examples The following example demonstrates how to encrypt and decrypt sample data by using the class. - [!code-csharp[AesSample#1](~/samples/snippets/csharp/VS_Snippets_CLR/aessample/cs/program.cs#1)] - [!code-vb[AesSample#1](~/samples/snippets/visualbasic/VS_Snippets_CLR/aessample/vb/program.vb#1)] - [!code-fsharp[AesSample#1](~/samples/snippets/fsharp/VS_Snippets_CLR/aessample/fs/program.fs#1)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR/aessample/cs/program.cs" interactive="try-dotnet" id="Snippet1"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR/aessample/vb/program.vb" id="Snippet1"::: + :::code language="fsharp" source="~/samples/snippets/fsharp/VS_Snippets_CLR/aessample/fs/program.fs" id="Snippet1"::: ]]> diff --git a/xml/System.Security.Cryptography/AesCryptoServiceProvider.xml b/xml/System.Security.Cryptography/AesCryptoServiceProvider.xml index b18b79d02cc..e1d0bf7d4fc 100644 --- a/xml/System.Security.Cryptography/AesCryptoServiceProvider.xml +++ b/xml/System.Security.Cryptography/AesCryptoServiceProvider.xml @@ -43,9 +43,9 @@ ## Examples The following example demonstrates how to encrypt and decrypt sample data using the class. - [!code-csharp[AesCryptoServProvider#1](~/samples/snippets/csharp/VS_Snippets_CLR/aescryptoservprovider/cs/program.cs#1)] - [!code-vb[AesCryptoServProvider#1](~/samples/snippets/visualbasic/VS_Snippets_CLR/aescryptoservprovider/vb/program.vb#1)] - [!code-fsharp[AesCryptoServProvider#1](~/samples/snippets/fsharp/VS_Snippets_CLR/aescryptoservprovider/fs/program.fs#1)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR/aescryptoservprovider/cs/program.cs" interactive="try-dotnet" id="Snippet1"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR/aescryptoservprovider/vb/program.vb" id="Snippet1"::: + :::code language="fsharp" source="~/samples/snippets/fsharp/VS_Snippets_CLR/aescryptoservprovider/fs/program.fs" id="Snippet1"::: ]]> diff --git a/xml/System.Security.Cryptography/AesManaged.xml b/xml/System.Security.Cryptography/AesManaged.xml index 79f8d417c2d..dd878b35c66 100644 --- a/xml/System.Security.Cryptography/AesManaged.xml +++ b/xml/System.Security.Cryptography/AesManaged.xml @@ -52,9 +52,9 @@ ## Examples The following example demonstrates how to encrypt and decrypt sample data using the class. - [!code-csharp[AesManaged#1](~/samples/snippets/csharp/VS_Snippets_CLR/aesmanaged/cs/program.cs#1)] - [!code-vb[AesManaged#1](~/samples/snippets/visualbasic/VS_Snippets_CLR/aesmanaged/vb/program.vb#1)] - [!code-fsharp[AesManaged#1](~/samples/snippets/fsharp/VS_Snippets_CLR/aesmanaged/fs/program.fs#1)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR/aesmanaged/cs/program.cs" interactive="try-dotnet" id="Snippet1"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR/aesmanaged/vb/program.vb" id="Snippet1"::: + :::code language="fsharp" source="~/samples/snippets/fsharp/VS_Snippets_CLR/aesmanaged/fs/program.fs" id="Snippet1"::: ]]> diff --git a/xml/System.Security.Cryptography/AsymmetricAlgorithm.xml b/xml/System.Security.Cryptography/AsymmetricAlgorithm.xml index c3525c346d6..34417243b1e 100644 --- a/xml/System.Security.Cryptography/AsymmetricAlgorithm.xml +++ b/xml/System.Security.Cryptography/AsymmetricAlgorithm.xml @@ -83,7 +83,7 @@ ]]> Cryptographic Services - How to: Create a Public/Private Key Pair + How to: Create a Public/Private Key Pair diff --git a/xml/System.Security.Cryptography/ECCurve+NamedCurves.xml b/xml/System.Security.Cryptography/ECCurve+NamedCurves.xml index 157d7633050..bce4c39a708 100644 --- a/xml/System.Security.Cryptography/ECCurve+NamedCurves.xml +++ b/xml/System.Security.Cryptography/ECCurve+NamedCurves.xml @@ -68,7 +68,7 @@ Gets a brainpoolP160r1 named curve. A brainpoolP160r1 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves @@ -104,7 +104,7 @@ Gets a brainpoolP160t1 named curve. A brainpoolP160t1 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves @@ -140,7 +140,7 @@ Gets a brainpoolP192r1 named curve. A brainpoolP192r1 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves @@ -176,7 +176,7 @@ Gets a brainpoolP192t1 named curve. A brainpoolP192t1 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves @@ -212,7 +212,7 @@ Gets a brainpoolP224r1 named curve. A brainpoolP224r1 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves @@ -248,7 +248,7 @@ Gets a brainpoolP224t1 named curve. A brainpoolP224t1 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves @@ -284,7 +284,7 @@ Gets a brainpoolP256r1 named curve. A brainpoolP256r1 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves @@ -320,7 +320,7 @@ Gets a brainpoolP256t1 named curve. A brainpoolP256t1 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves @@ -356,7 +356,7 @@ Gets a brainpoolP320r1 named curve. A brainpoolP320r1 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves @@ -392,7 +392,7 @@ Gets a brainpoolP320t1 named curve. A brainpoolP320t1 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves @@ -428,7 +428,7 @@ Gets a brainpoolP384r1 named curve. A brainpoolP384r1 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves @@ -464,7 +464,7 @@ Gets a brainpoolP384t1 named curve. A brainpoolP384t1 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves @@ -500,7 +500,7 @@ Gets a brainpoolP512r1 named curve. A brainpoolP512r1 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves @@ -536,7 +536,7 @@ Gets a brainpoolP512t1 named curve. A brainpoolP512t1 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves @@ -572,7 +572,7 @@ Gets a nistP256 named curve. A nistP256 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves @@ -608,7 +608,7 @@ Gets a nistP384 named curve. A nistP384 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves @@ -644,7 +644,7 @@ Gets a nistP521 named curve. A nistP521 named curve. To be added. - CNG Named Elliptic Curves + CNG Named Elliptic Curves diff --git a/xml/System.Security.Cryptography/HashAlgorithmName.xml b/xml/System.Security.Cryptography/HashAlgorithmName.xml index deaa4896fe3..fbd3dc222bb 100644 --- a/xml/System.Security.Cryptography/HashAlgorithmName.xml +++ b/xml/System.Security.Cryptography/HashAlgorithmName.xml @@ -47,7 +47,7 @@ ## Remarks The structure includes some static properties that return predefined hash algorithm names, as well as a property that can represent a custom hash algorithm name as a strongly-typed string. Hash algorithm names are case-sensitive. - Asymmetric algorithms implemented using Microsoft's CNG (Cryptographic Next Generation) API interpret the underlying string value as a [CNG algorithm identifier](https://msdn.microsoft.com/library/windows/desktop/aa375534.aspx). + Asymmetric algorithms implemented using Microsoft's CNG (Cryptographic Next Generation) API interpret the underlying string value as a [CNG algorithm identifier](/windows/win32/seccng/cng-algorithm-identifiers). Asymmetric algorithms implemented using other technologies: diff --git a/xml/System.Security.Cryptography/RSACryptoServiceProvider.xml b/xml/System.Security.Cryptography/RSACryptoServiceProvider.xml index f105d421040..4c669198895 100644 --- a/xml/System.Security.Cryptography/RSACryptoServiceProvider.xml +++ b/xml/System.Security.Cryptography/RSACryptoServiceProvider.xml @@ -56,7 +56,7 @@ The supports key sizes from 384 bits to 16384 bits in increments of 8 bits if you have the Microsoft Enhanced Cryptographic Provider installed. It supports key sizes from 384 bits to 512 bits in increments of 8 bits if you have the Microsoft Base Cryptographic Provider installed. - Valid key sizes are dependent on the cryptographic service provider (CSP) that is used by the instance. Windows CSPs enable keys sizes of 384 to 16384 bits for Windows versions prior to [!INCLUDE[win81](~/includes/win81-md.md)], and key sizes of 512 to 16384 bits for [!INCLUDE[win81](~/includes/win81-md.md)]. For more information, see [CryptGenKey](https://msdn.microsoft.com/library/aa379941\(v=vs.85\).aspx) function in the Windows documentation. + Valid key sizes are dependent on the cryptographic service provider (CSP) that is used by the instance. Windows CSPs enable keys sizes of 384 to 16384 bits for Windows versions prior to [!INCLUDE[win81](~/includes/win81-md.md)], and key sizes of 512 to 16384 bits for [!INCLUDE[win81](~/includes/win81-md.md)]. For more information, see [CryptGenKey](/windows/win32/api/wincrypt/nf-wincrypt-cryptgenkey) function in the Windows documentation. ## Interoperation with the Microsoft Cryptographic API (CAPI) Unlike the RSA implementation in unmanaged CAPI, the class reverses the order of an encrypted array of bytes after encryption and before decryption. By default, data encrypted by the class cannot be decrypted by the CAPI `CryptDecrypt` function and data encrypted by the CAPI `CryptEncrypt` method cannot be decrypted by the class. @@ -1302,7 +1302,7 @@ If no key is loaded via the supports key sizes from 384 bits to 16384 bits in increments of 8 bits if you have the Microsoft Enhanced Cryptographic Provider installed. It supports key sizes from 384 bits to 512 bits in increments of 8 bits if you have the Microsoft Base Cryptographic Provider installed. - Valid key sizes are dependent on the cryptographic service provider (CSP) that is used by the instance. Windows CSPs enable key sizes of 384 to 16384 bits for Windows versions prior to [!INCLUDE[win81](~/includes/win81-md.md)], and key sizes of 512 to 16384 bits for [!INCLUDE[win81](~/includes/win81-md.md)]. For more information, see [CryptGenKey](https://msdn.microsoft.com/library/aa379941\(v=vs.85\).aspx) function in the Windows documentation. + Valid key sizes are dependent on the cryptographic service provider (CSP) that is used by the instance. Windows CSPs enable key sizes of 384 to 16384 bits for Windows versions prior to [!INCLUDE[win81](~/includes/win81-md.md)], and key sizes of 512 to 16384 bits for [!INCLUDE[win81](~/includes/win81-md.md)]. For more information, see [CryptGenKey](/windows/win32/api/wincrypt/nf-wincrypt-cryptgenkey) function in the Windows documentation. The class does not allow you to change key sizes using the property. Any value written to this property will fail to update the property without error. To change the key size, use one of the constructor overloads. diff --git a/xml/System.Security.Permissions/HostProtectionAttribute.xml b/xml/System.Security.Permissions/HostProtectionAttribute.xml index 5cda6178450..2d11880c99c 100644 --- a/xml/System.Security.Permissions/HostProtectionAttribute.xml +++ b/xml/System.Security.Permissions/HostProtectionAttribute.xml @@ -77,7 +77,7 @@ ]]> Extending Metadata Using Attributes - Link Demands + Link Demands diff --git a/xml/System.Security/SecurityCriticalAttribute.xml b/xml/System.Security/SecurityCriticalAttribute.xml index 6c3778fd9bb..0109aebd504 100644 --- a/xml/System.Security/SecurityCriticalAttribute.xml +++ b/xml/System.Security/SecurityCriticalAttribute.xml @@ -63,8 +63,8 @@ - Security-Transparent Code, Level 1 - Security-Transparent Code, Level 2 + Security-Transparent Code, Level 1 + Security-Transparent Code, Level 2 diff --git a/xml/System.Security/SecuritySafeCriticalAttribute.xml b/xml/System.Security/SecuritySafeCriticalAttribute.xml index 4c11a88739a..ccf69019ea0 100644 --- a/xml/System.Security/SecuritySafeCriticalAttribute.xml +++ b/xml/System.Security/SecuritySafeCriticalAttribute.xml @@ -58,8 +58,8 @@ - Security-Transparent Code, Level 1 - Security-Transparent Code, Level 2 + Security-Transparent Code, Level 1 + Security-Transparent Code, Level 2 diff --git a/xml/System.Security/SecurityTransparentAttribute.xml b/xml/System.Security/SecurityTransparentAttribute.xml index c7f98a0f6a8..e7777a9be65 100644 --- a/xml/System.Security/SecurityTransparentAttribute.xml +++ b/xml/System.Security/SecurityTransparentAttribute.xml @@ -58,8 +58,8 @@ - Security-Transparent Code, Level 1 - Security-Transparent Code, Level 2 + Security-Transparent Code, Level 1 + Security-Transparent Code, Level 2 diff --git a/xml/System.ServiceModel/AuditLevel.xml b/xml/System.ServiceModel/AuditLevel.xml index 00df52393ef..533c17dbb6b 100644 --- a/xml/System.ServiceModel/AuditLevel.xml +++ b/xml/System.ServiceModel/AuditLevel.xml @@ -39,8 +39,8 @@ ]]> - Auditing Security Events - serviceSecurityAudit element + Auditing Security Events + serviceSecurityAudit element diff --git a/xml/System.ServiceModel/AuditLogLocation.xml b/xml/System.ServiceModel/AuditLogLocation.xml index 417a5efeb69..3c3ab43091e 100644 --- a/xml/System.ServiceModel/AuditLogLocation.xml +++ b/xml/System.ServiceModel/AuditLogLocation.xml @@ -46,8 +46,8 @@ - Auditing Security Events - serviceSecurityAudit element + Auditing Security Events + serviceSecurityAudit element diff --git a/xml/System.ServiceModel/DataContractFormatAttribute.xml b/xml/System.ServiceModel/DataContractFormatAttribute.xml index 67f9d9e464c..142ddf297a3 100644 --- a/xml/System.ServiceModel/DataContractFormatAttribute.xml +++ b/xml/System.ServiceModel/DataContractFormatAttribute.xml @@ -66,7 +66,7 @@ - Data Contract Serializer + Data Contract Serializer diff --git a/xml/System.ServiceModel/NetTcpBinding.xml b/xml/System.ServiceModel/NetTcpBinding.xml index 497f21b71ce..0532ba0d84a 100644 --- a/xml/System.ServiceModel/NetTcpBinding.xml +++ b/xml/System.ServiceModel/NetTcpBinding.xml @@ -230,7 +230,7 @@ ]]> - netTcpBinding Element + netTcpBinding Element diff --git a/xml/System.ServiceModel/ServiceAuthorizationManager.xml b/xml/System.ServiceModel/ServiceAuthorizationManager.xml index 94ab58d2527..9c9527240be 100644 --- a/xml/System.ServiceModel/ServiceAuthorizationManager.xml +++ b/xml/System.ServiceModel/ServiceAuthorizationManager.xml @@ -57,11 +57,11 @@ - Custom Authorization - How To: Create a Custom AuthorizationManager for a Service - How To: Create a Custom Authorization Policy - How To: Create a Custom Claim - How To: Compare Claims + Custom Authorization + How To: Create a Custom AuthorizationManager for a Service + How To: Create a Custom Authorization Policy + How To: Create a Custom Claim + How To: Compare Claims diff --git a/xml/System.ServiceModel/ServiceContractAttribute.xml b/xml/System.ServiceModel/ServiceContractAttribute.xml index 546a79813e3..c389cc9e0a8 100644 --- a/xml/System.ServiceModel/ServiceContractAttribute.xml +++ b/xml/System.ServiceModel/ServiceContractAttribute.xml @@ -104,11 +104,11 @@ ]]> - Defining Service Contracts - Hosting a Service - Service Creation Overview - Building a Client - Proxy Creation Overview + Defining Service Contracts + Hosting a Service + Service Creation Overview + Building a Client + Proxy Creation Overview diff --git a/xml/System.ServiceModel/ServiceKnownTypeAttribute.xml b/xml/System.ServiceModel/ServiceKnownTypeAttribute.xml index 0ec336e29ba..57721a2248e 100644 --- a/xml/System.ServiceModel/ServiceKnownTypeAttribute.xml +++ b/xml/System.ServiceModel/ServiceKnownTypeAttribute.xml @@ -70,7 +70,7 @@ - Data Contract Known Types + Data Contract Known Types diff --git a/xml/System.Web.UI.WebControls/DataList.xml b/xml/System.Web.UI.WebControls/DataList.xml index e2e0f0bb2b0..f57661bfb46 100644 --- a/xml/System.Web.UI.WebControls/DataList.xml +++ b/xml/System.Web.UI.WebControls/DataList.xml @@ -1519,7 +1519,7 @@ ASP.NET Web Page Code Model - How to: Consume Events in a Web Forms Application + How to: Consume Events in a Web Forms Application @@ -1569,7 +1569,7 @@ - How to: Consume Events in a Web Forms Application + How to: Consume Events in a Web Forms Application ASP.NET Web Page Code Model @@ -1618,7 +1618,7 @@ - How to: Consume Events in a Web Forms Application + How to: Consume Events in a Web Forms Application ASP.NET Web Page Code Model @@ -2091,7 +2091,7 @@ - How to: Consume Events in a Web Forms Application + How to: Consume Events in a Web Forms Application @@ -2183,7 +2183,7 @@ - How to: Consume Events in a Web Forms Application + How to: Consume Events in a Web Forms Application ASP.NET Web Page Code Model @@ -2245,7 +2245,7 @@ - How to: Consume Events in a Web Forms Application + How to: Consume Events in a Web Forms Application ASP.NET Web Page Code Model @@ -2305,7 +2305,7 @@ - How to: Consume Events in a Web Forms Application + How to: Consume Events in a Web Forms Application ASP.NET Web Page Code Model @@ -3569,7 +3569,7 @@ - How to: Consume Events in a Web Forms Application + How to: Consume Events in a Web Forms Application ASP.NET Web Page Code Model diff --git a/xml/System.Web.UI.WebControls/GridView.xml b/xml/System.Web.UI.WebControls/GridView.xml index 395becdac02..52fb46848f5 100644 --- a/xml/System.Web.UI.WebControls/GridView.xml +++ b/xml/System.Web.UI.WebControls/GridView.xml @@ -2053,9 +2053,9 @@ ## Examples The following example demonstrates how to use the property to specify the key field of the data source. In the example, the `DataKeyNames` attribute of the `GridView` element in markup specifies two key fields by using a comma to separate the names. To run this example, create a Web site that has the following: -- A connection to the AdventureWorksLT sample database and a connection string that is named `AdventureWorksLTConnectionString`. For information about how to set up the AdventureWorksLT sample database, see [How to: Set Up an AdventureWorksLT Sample Database for ASP.NET Development](https://msdn.microsoft.com/library/2baad633-9d63-49cc-a6b2-917cafd35356). +- A connection to the AdventureWorksLT sample database and a connection string that is named `AdventureWorksLTConnectionString`. For information about how to set up the AdventureWorksLT sample database, see [How to: Set Up an AdventureWorksLT Sample Database for ASP.NET Development](https://docs.microsoft.com/previous-versions/dd410121(v=vs.140)). -- A LINQ-to-SQL data context class that is named `AdventureWorksLTDataClassesDataContext`. The data context must have a class for the SalesOrderDetails table. For information about how to create LINQ-to-SQL classes, see [LINQ to SQL](https://msdn.microsoft.com/library/73d13345-eece-471a-af40-4cc7a2f11655). +- A LINQ-to-SQL data context class that is named `AdventureWorksLTDataClassesDataContext`. The data context must have a class for the SalesOrderDetails table. For information about how to create LINQ-to-SQL classes, see [LINQ to SQL](/dotnet/framework/data/adonet/sql/linq/). [!code-aspx-csharp[GridViewEdit#1](~/samples/snippets/csharp/VS_Snippets_WebNet/GridViewEdit/CS/editorders.aspx#1)] [!code-aspx-vb[GridViewEdit#1](~/samples/snippets/visualbasic/VS_Snippets_WebNet/GridViewEdit/VB/editorders.aspx#1)] @@ -3358,7 +3358,7 @@ When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - Walkthrough: Handling Events + Walkthrough: Handling Events diff --git a/xml/System.Web.UI.WebControls/ImageButton.xml b/xml/System.Web.UI.WebControls/ImageButton.xml index 8cff070b579..fa5c71a9fdc 100644 --- a/xml/System.Web.UI.WebControls/ImageButton.xml +++ b/xml/System.Web.UI.WebControls/ImageButton.xml @@ -354,7 +354,7 @@ Button Web Server Controls Overview - How to: Consume Events in a Web Forms Application + How to: Consume Events in a Web Forms Application @@ -410,7 +410,7 @@ Button Web Server Controls Content Map - How to: Consume Events in a Web Forms Application + How to: Consume Events in a Web Forms Application @@ -774,7 +774,7 @@ Button Web Server Controls Overview - How to: Consume Events in a Web Forms Application + How to: Consume Events in a Web Forms Application @@ -873,7 +873,7 @@ Button Web Server Controls Overview - How to: Consume Events in a Web Forms Application + How to: Consume Events in a Web Forms Application @@ -925,7 +925,7 @@ ]]> Button Web Server Controls Overview - How to: Consume Events in a Web Forms Application + How to: Consume Events in a Web Forms Application diff --git a/xml/System.Windows.Automation.Peers/AutomationControlType.xml b/xml/System.Windows.Automation.Peers/AutomationControlType.xml index b9665c15d3e..fdf3111cab3 100644 --- a/xml/System.Windows.Automation.Peers/AutomationControlType.xml +++ b/xml/System.Windows.Automation.Peers/AutomationControlType.xml @@ -17,8 +17,8 @@ Specifies the that is exposed to the UI Automation client. To be added. - UI Automation Control Types - UI Automation Control Types Overview + UI Automation Control Types + UI Automation Control Types Overview diff --git a/xml/System.Windows.Automation.Peers/AutomationEvents.xml b/xml/System.Windows.Automation.Peers/AutomationEvents.xml index 73b0a420040..6be84ac18f0 100644 --- a/xml/System.Windows.Automation.Peers/AutomationEvents.xml +++ b/xml/System.Windows.Automation.Peers/AutomationEvents.xml @@ -26,8 +26,8 @@ - UI Automation Events Overview - UI Automation Events for Clients + UI Automation Events Overview + UI Automation Events for Clients diff --git a/xml/System.Windows.Automation.Peers/AutomationPeer.xml b/xml/System.Windows.Automation.Peers/AutomationPeer.xml index 56083d0c0ea..ca0cbda9a8d 100644 --- a/xml/System.Windows.Automation.Peers/AutomationPeer.xml +++ b/xml/System.Windows.Automation.Peers/AutomationPeer.xml @@ -26,7 +26,7 @@ ]]> - UI Automation Overview + UI Automation Overview @@ -46,7 +46,7 @@ Provides initialization for base class values when they are called by the constructor of a derived class. To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -79,7 +79,7 @@ Gets or sets an that is reported to the automation client as a source for all the events that come from this . The that is the source of events. To be added. - UI Automation Overview + UI Automation Overview @@ -105,7 +105,7 @@ The accelerator key. To be added. A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -138,7 +138,7 @@ ]]> - UI Automation Overview + UI Automation Overview @@ -164,7 +164,7 @@ The string that contains the access key. To be added. A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview @@ -196,7 +196,7 @@ ]]> - UI Automation Overview + UI Automation Overview @@ -222,7 +222,7 @@ The control type. To be added. A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -248,7 +248,7 @@ When overridden in a derived class, is called by . The control type. To be added. - UI Automation Overview + UI Automation Overview @@ -282,7 +282,7 @@ A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview @@ -338,7 +338,7 @@ Gets the object that represents the screen coordinates of the element that is associated with the automation peer. The bounding rectangle. To be added. - UI Automation Overview + UI Automation Overview @@ -364,7 +364,7 @@ The bounding rectangle. To be added. A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview @@ -390,7 +390,7 @@ The collection of child elements. To be added. A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview @@ -415,7 +415,7 @@ When overridden in a derived class, is called by . The collection of child elements. To be added. - UI Automation Overview + UI Automation Overview @@ -441,7 +441,7 @@ The class name. To be added. A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview @@ -466,7 +466,7 @@ When overridden in a derived class, is called by . The class name. To be added. - UI Automation Overview + UI Automation Overview @@ -499,7 +499,7 @@ ]]> A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview @@ -524,7 +524,7 @@ When overridden in a derived class, is called by . A point within the clickable area of the element. To be added. - UI Automation Overview + UI Automation Overview @@ -604,7 +604,7 @@ ]]> A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview @@ -629,7 +629,7 @@ When overridden in a derived class, is called by . The help text. To be added. - UI Automation Overview + UI Automation Overview @@ -679,7 +679,7 @@ ]]> - UI Automation Overview + UI Automation Overview UI Automation Tree Overview @@ -713,7 +713,7 @@ ]]> A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview @@ -738,7 +738,7 @@ When overridden in a derived class, is called by . The status. To be added. - UI Automation Overview + UI Automation Overview @@ -771,7 +771,7 @@ ]]> A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview @@ -796,7 +796,7 @@ When overridden in a derived class, is called by . The kind of item. To be added. - UI Automation Overview + UI Automation Overview @@ -835,7 +835,7 @@ ]]> A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -861,7 +861,7 @@ When overridden in a derived class, is called by . The for the element that is targeted by the . To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -942,7 +942,7 @@ This method calls the derived implementation of The type of the control. To be added. A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -968,7 +968,7 @@ This method calls the derived implementation of When overridden in a derived class, is called by . The type of the control. To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1002,7 +1002,7 @@ This method calls the derived implementation of A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1037,7 +1037,7 @@ This method calls the derived implementation of - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1064,7 +1064,7 @@ This method calls the derived implementation of The orientation of the control. To be added. A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1090,7 +1090,7 @@ This method calls the derived implementation of When overridden in a derived class, is called by . The orientation of the control. To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1116,7 +1116,7 @@ This method calls the derived implementation of Gets the that is the parent of this . The parent automation peer. To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1145,7 +1145,7 @@ This method calls the derived implementation of When overridden in a derived class, gets the control pattern that is associated with the specified . The object that implements the pattern interface; if this peer does not support this interface. To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1319,7 +1319,7 @@ This method calls the derived implementation of if the element has keyboard focus; otherwise, . To be added. A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1346,7 +1346,7 @@ This method calls the derived implementation of if the element has keyboard focus; otherwise, . To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1380,7 +1380,7 @@ This method calls the derived implementation of - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1415,7 +1415,7 @@ This method calls the derived implementation of A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1442,7 +1442,7 @@ This method calls the derived implementation of if the element is a content element; otherwise, . To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1470,7 +1470,7 @@ This method calls the derived implementation of if the element is a control; otherwise, . To be added. A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1497,7 +1497,7 @@ This method calls the derived implementation of if the element is a control; otherwise, . To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1525,7 +1525,7 @@ This method calls the derived implementation of if the element supports interaction; otherwise, . To be added. A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1552,7 +1552,7 @@ This method calls the derived implementation of if the automation peer can receive and send events; otherwise, . To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1587,7 +1587,7 @@ This method calls the derived implementation of - UI Automation Overview + UI Automation Overview @@ -1614,7 +1614,7 @@ This method calls the derived implementation of if the element can accept keyboard focus; otherwise, . To be added. A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1641,7 +1641,7 @@ This method calls the derived implementation of if the element can accept keyboard focus; otherwise, . To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1676,7 +1676,7 @@ This method calls the derived implementation of A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1703,7 +1703,7 @@ This method calls the derived implementation of if the element is not on the screen; otherwise, . To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1731,7 +1731,7 @@ This method calls the derived implementation of if the element contains sensitive content such as a password; otherwise, . To be added. A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1758,7 +1758,7 @@ This method calls the derived implementation of if the element contains sensitive content; otherwise, . To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1787,7 +1787,7 @@ This method calls the derived implementation of To be added. A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1814,7 +1814,7 @@ This method calls the derived implementation of if the element is must be completed; otherwise, . To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1853,7 +1853,7 @@ This method calls the derived implementation of - UI Automation Overview + UI Automation Overview @@ -1881,7 +1881,7 @@ This method calls the derived implementation of Gets an for the specified proxy. An for the specified proxy. To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1910,7 +1910,7 @@ This method calls the derived implementation of Gets the for the specified . The proxy. To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -1940,7 +1940,7 @@ This method calls the derived implementation of To be added. is . - UI Automation Overview + UI Automation Overview @@ -1967,7 +1967,7 @@ This method calls the derived implementation of The event identifier. Raises an automation event. To be added. - UI Automation Overview + UI Automation Overview @@ -1998,7 +1998,7 @@ This method calls the derived implementation of The new value of the property. Raises an event to notify the automation client of a changed property value. To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -2035,7 +2035,7 @@ This method calls the derived implementation of - UI Automation Overview + UI Automation Overview UI Automation Control Patterns Overview Server-side UI Automation Provider Implementation @@ -2062,7 +2062,7 @@ This method calls the derived implementation of Sets the keyboard focus on the element that is associated with this automation peer. To be added. A public call to this method is currently in progress. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation @@ -2087,7 +2087,7 @@ This method calls the derived implementation of When overridden in a derived class, is called by . To be added. - UI Automation Overview + UI Automation Overview Server-side UI Automation Provider Implementation diff --git a/xml/System.Windows.Automation.Peers/ButtonAutomationPeer.xml b/xml/System.Windows.Automation.Peers/ButtonAutomationPeer.xml index 61b046ffdb0..a379c017d8a 100644 --- a/xml/System.Windows.Automation.Peers/ButtonAutomationPeer.xml +++ b/xml/System.Windows.Automation.Peers/ButtonAutomationPeer.xml @@ -98,7 +98,7 @@ Gets the name of the control that is associated with this [!INCLUDE[TLA2#tla_uiautomation](~/includes/tla2sharptla-uiautomation-md.md)] peer. A string that contains "Button". To be added. - UI Automation Control Types + UI Automation Control Types @@ -126,7 +126,7 @@ Gets the object that supports the specified control pattern of the element that is associated with this automation peer. If is , this method returns a pointer, otherwise this method returns . To be added. - UI Automation Control Types + UI Automation Control Types diff --git a/xml/System.Windows.Automation.Peers/DocumentAutomationPeer.xml b/xml/System.Windows.Automation.Peers/DocumentAutomationPeer.xml index 939cf822397..528b71a01b0 100644 --- a/xml/System.Windows.Automation.Peers/DocumentAutomationPeer.xml +++ b/xml/System.Windows.Automation.Peers/DocumentAutomationPeer.xml @@ -28,7 +28,7 @@ ]]> - UI Automation Support for the Document Control Type + UI Automation Support for the Document Control Type diff --git a/xml/System.Windows.Automation.Peers/SelectorAutomationPeer.xml b/xml/System.Windows.Automation.Peers/SelectorAutomationPeer.xml index b0f6249cdaa..98aa222a448 100644 --- a/xml/System.Windows.Automation.Peers/SelectorAutomationPeer.xml +++ b/xml/System.Windows.Automation.Peers/SelectorAutomationPeer.xml @@ -22,7 +22,7 @@ Exposes types to UI Automation. To be added. - UI Automation Overview + UI Automation Overview @@ -51,7 +51,7 @@ The that is associated with this . Initializes a new instance of the class. To be added. - UI Automation Overview + UI Automation Overview @@ -76,7 +76,7 @@ Gets the control type for the that is associated with this . This method is called by . The enumeration value. To be added. - UI Automation Overview + UI Automation Overview @@ -104,7 +104,7 @@ Gets the control pattern for the that is associated with this . If is , this method returns a pointer to the current instance; otherwise . To be added. - UI Automation Overview + UI Automation Overview UI Automation Control Patterns diff --git a/xml/System.Windows.Automation.Peers/SelectorItemAutomationPeer.xml b/xml/System.Windows.Automation.Peers/SelectorItemAutomationPeer.xml index 3ae866c9eeb..aa3375f7d50 100644 --- a/xml/System.Windows.Automation.Peers/SelectorItemAutomationPeer.xml +++ b/xml/System.Windows.Automation.Peers/SelectorItemAutomationPeer.xml @@ -22,7 +22,7 @@ Exposes the items in the collection of a to UI Automation. To be added. - UI Automation Overview + UI Automation Overview @@ -53,7 +53,7 @@ The that is associated with the that holds the collection. Provides initialization for base class values when they are called by the constructor of a derived class. To be added. - UI Automation Overview + UI Automation Overview @@ -81,7 +81,7 @@ Gets the control pattern that is associated with the specified . If is , this method returns the current instance of this . To be added. - UI Automation Overview + UI Automation Overview UI Automation Control Patterns Overview diff --git a/xml/System.Windows.Automation.Peers/SeparatorAutomationPeer.xml b/xml/System.Windows.Automation.Peers/SeparatorAutomationPeer.xml index 0c1fe2102bb..9f08f86c12a 100644 --- a/xml/System.Windows.Automation.Peers/SeparatorAutomationPeer.xml +++ b/xml/System.Windows.Automation.Peers/SeparatorAutomationPeer.xml @@ -18,7 +18,7 @@ Exposes types to UI Automation. To be added. - UI Automation Overview + UI Automation Overview @@ -47,7 +47,7 @@ The that is associated with this . Initializes a new instance of the class. To be added. - UI Automation Overview + UI Automation Overview @@ -72,7 +72,7 @@ Gets the control type for the that is associated with this . Called by . The enumeration value. To be added. - UI Automation Overview + UI Automation Overview @@ -97,7 +97,7 @@ Gets the name of the that is associated with this . Called by . A string that contains "Separator". To be added. - UI Automation Overview + UI Automation Overview diff --git a/xml/System.Windows.Automation/WindowPatternIdentifiers.xml b/xml/System.Windows.Automation/WindowPatternIdentifiers.xml index 4492a31b22e..b8f787867e7 100644 --- a/xml/System.Windows.Automation/WindowPatternIdentifiers.xml +++ b/xml/System.Windows.Automation/WindowPatternIdentifiers.xml @@ -28,7 +28,7 @@ UI Automation Control Patterns Overview UI Automation Providers Overview Support Control Patterns in a UI Automation Provider - Implementing the UI Automation Window Control Pattern + Implementing the UI Automation Window Control Pattern @@ -58,7 +58,7 @@ ]]> - Implementing the UI Automation Window Control Pattern + Implementing the UI Automation Window Control Pattern @@ -88,7 +88,7 @@ ]]> - Implementing the UI Automation Window Control Pattern + Implementing the UI Automation Window Control Pattern @@ -118,7 +118,7 @@ ]]> - Implementing the UI Automation Window Control Pattern + Implementing the UI Automation Window Control Pattern @@ -148,7 +148,7 @@ ]]> - Implementing the UI Automation Window Control Pattern + Implementing the UI Automation Window Control Pattern @@ -178,7 +178,7 @@ ]]> - Implementing the UI Automation Window Control Pattern + Implementing the UI Automation Window Control Pattern @@ -208,7 +208,7 @@ ]]> - Implementing the UI Automation Window Control Pattern + Implementing the UI Automation Window Control Pattern @@ -238,7 +238,7 @@ ]]> - Implementing the UI Automation Window Control Pattern + Implementing the UI Automation Window Control Pattern @@ -268,7 +268,7 @@ ]]> - Implementing the UI Automation Window Control Pattern + Implementing the UI Automation Window Control Pattern @@ -298,7 +298,7 @@ ]]> - Implementing the UI Automation Window Control Pattern + Implementing the UI Automation Window Control Pattern diff --git a/xml/System.Windows.Forms/BindingNavigator.xml b/xml/System.Windows.Forms/BindingNavigator.xml index 85db28b326f..a39fc5a7b02 100644 --- a/xml/System.Windows.Forms/BindingNavigator.xml +++ b/xml/System.Windows.Forms/BindingNavigator.xml @@ -79,7 +79,7 @@ ]]> - BindingNavigator Control (Windows Forms) + BindingNavigator Control (Windows Forms) diff --git a/xml/System.Windows.Forms/CheckBox.xml b/xml/System.Windows.Forms/CheckBox.xml index be320b05897..7b45ed1c892 100644 --- a/xml/System.Windows.Forms/CheckBox.xml +++ b/xml/System.Windows.Forms/CheckBox.xml @@ -75,7 +75,7 @@ ]]> - CheckBox Control (Windows Forms) + CheckBox Control (Windows Forms) diff --git a/xml/System.Windows.Forms/CheckedListBox.xml b/xml/System.Windows.Forms/CheckedListBox.xml index 82e7acdc4fd..d62b96af651 100644 --- a/xml/System.Windows.Forms/CheckedListBox.xml +++ b/xml/System.Windows.Forms/CheckedListBox.xml @@ -93,7 +93,7 @@ ]]> - CheckedListBox Control (Windows Forms) + CheckedListBox Control (Windows Forms) @@ -440,7 +440,8 @@ property should not be overridden and used to adjust the properties of your derived control. Properties such as the , , and should be set by the corresponding properties in your control such as , and . The should only be extended when you are wrapping a standard Windows control class or to set styles not provided by the Windows Forms namespace. For more information about creating control parameters, see the `CreateWindow` and `CreateWindowEx` functions and the `CREATESTRUCT` structure documentation in the Windows Platform SDK reference located in the MSDN Library at https://msdn.microsoft.com/library. + +The property should not be overridden and used to adjust the properties of your derived control. Properties such as the , , and should be set by the corresponding properties in your control such as , and . The should only be extended when you are wrapping a standard Windows control class or to set styles not provided by the Windows Forms namespace. For more information about creating control parameters, see the `CreateWindow` and `CreateWindowEx` functions and the `CREATESTRUCT` structure documentation in the Windows Platform SDK reference at . @@ -1794,7 +1795,8 @@ method to handle operating system messages identified in the structure. The WM_ACTIVATEAPP operating system message is handled in this example to know when another application is becoming active. Refer to the Platform SDK documentation reference located in the MSDN Library at https://msdn.microsoft.com/library to understand the available , , and values. Actual constant values can be found in the Windows.h header file included in the Platform SDK (Core SDK section) download, which is also available in the MSDN Library at https://msdn.microsoft.com/library. + +The following code example demonstrates overriding the method to handle operating system messages identified in the structure. The WM_ACTIVATEAPP operating system message is handled in this example to know when another application is becoming active. Refer to the Platform SDK documentation reference located at to understand the available , , and values. Actual constant values can be found in the Windows.h header file included in the Platform SDK (Core SDK section) download, which is also available at . [!code-cpp[System.Windows.Forms.Control.WndProc#1](~/samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.Control.WndProc/CPP/form1.cpp#1)] [!code-csharp[System.Windows.Forms.Control.WndProc#1](~/samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Control.WndProc/CS/form1.cs#1)] diff --git a/xml/System.Windows.Forms/Clipboard.xml b/xml/System.Windows.Forms/Clipboard.xml index 4783be70320..ed0fb8cee0c 100644 --- a/xml/System.Windows.Forms/Clipboard.xml +++ b/xml/System.Windows.Forms/Clipboard.xml @@ -64,7 +64,7 @@ - Additional Security Considerations in Windows Forms + Additional Security Considerations in Windows Forms diff --git a/xml/System.Windows.Forms/ComboBox.xml b/xml/System.Windows.Forms/ComboBox.xml index cd65299e0bc..2ab2e4c1b6f 100644 --- a/xml/System.Windows.Forms/ComboBox.xml +++ b/xml/System.Windows.Forms/ComboBox.xml @@ -3935,12 +3935,13 @@ ## Remarks All messages are sent to the method after getting filtered through the method. - The method corresponds exactly to the Windows `WindowProc` function. For more information about processing Windows messages, see the `WindowProc` function documentation in the Windows Platform SDK reference located in the MSDN library at https://msdn.microsoft.com/library. + The method corresponds exactly to the Windows `WindowProc` function. For more information about processing Windows messages, see the [WindowProc function](https://docs.microsoft.com/previous-versions/windows/desktop/legacy/ms633573(v=vs.85)) documentation in the Windows Platform SDK reference. ## Examples - The following code example demonstrates overriding the method to handle operating system messages identified in the structure. The WM_ACTIVATEAPP operating system message is handled in this example to know when another application is becoming active. Refer to the Platform SDK documentation reference located in the MSDN library at https://msdn.microsoft.com/library to understand the available , , and values. Actual constant values can be found in the Windows.h header file included in the Platform SDK (Core SDK section) download, which is also available in the MSDN library at https://msdn.microsoft.com/library. + +The following code example demonstrates overriding the method to handle operating system messages identified in the structure. The WM_ACTIVATEAPP operating system message is handled in this example to know when another application is becoming active. Refer to the Platform SDK documentation reference located at to understand the available , , and values. Actual constant values can be found in the Windows.h header file included in the Platform SDK (Core SDK section) download, which is also available at . [!code-cpp[System.Windows.Forms.Control.WndProc#1](~/samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.Control.WndProc/CPP/form1.cpp#1)] [!code-csharp[System.Windows.Forms.Control.WndProc#1](~/samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Control.WndProc/CS/form1.cs#1)] diff --git a/xml/System.Windows.Forms/DataGridViewButtonCell+DataGridViewButtonCellAccessibleObject.xml b/xml/System.Windows.Forms/DataGridViewButtonCell+DataGridViewButtonCellAccessibleObject.xml index 6c224a2c473..5203776ab7c 100644 --- a/xml/System.Windows.Forms/DataGridViewButtonCell+DataGridViewButtonCellAccessibleObject.xml +++ b/xml/System.Windows.Forms/DataGridViewButtonCell+DataGridViewButtonCellAccessibleObject.xml @@ -31,7 +31,7 @@ Occasionally, you might require more accessibility information or different accessibility actions to be included with your custom or . To customize accessibility, you can write your own class that derives from the or classes and override the method. For example, if you are writing a custom row header cell that implements unique custom actions, such as special hit testing within your cell, you should create a class that inherits from the class and override the method. - The exposes its data structure by using values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see "Exposing Data Tables through Microsoft Active Accessibility" in the MSDN Library at https://msdn.microsoft.com/library. + The exposes its data structure by using values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see [Exposing Data Tables through Microsoft Active Accessibility](https://docs.microsoft.com/previous-versions/windows/desktop/dnacc/exposing-data-tables-through-microsoft-active-accessibility). ]]> diff --git a/xml/System.Windows.Forms/DataGridViewButtonCell.xml b/xml/System.Windows.Forms/DataGridViewButtonCell.xml index a48c7979a72..e29b607139a 100644 --- a/xml/System.Windows.Forms/DataGridViewButtonCell.xml +++ b/xml/System.Windows.Forms/DataGridViewButtonCell.xml @@ -686,7 +686,7 @@ - Default Keyboard and Mouse Handling in the Windows Forms DataGridView Control + Default Keyboard and Mouse Handling in the Windows Forms DataGridView Control @@ -736,7 +736,7 @@ - Default Keyboard and Mouse Handling in the Windows Forms DataGridView Control + Default Keyboard and Mouse Handling in the Windows Forms DataGridView Control diff --git a/xml/System.Windows.Forms/DataGridViewButtonColumn.xml b/xml/System.Windows.Forms/DataGridViewButtonColumn.xml index 081c248d228..470e1768f7e 100644 --- a/xml/System.Windows.Forms/DataGridViewButtonColumn.xml +++ b/xml/System.Windows.Forms/DataGridViewButtonColumn.xml @@ -60,7 +60,7 @@ - How to: Disable Buttons in a Button Column in the Windows Forms DataGridView Control + How to: Disable Buttons in a Button Column in the Windows Forms DataGridView Control @@ -426,7 +426,7 @@ - How to: Disable Buttons in a Button Column in the Windows Forms DataGridView Control + How to: Disable Buttons in a Button Column in the Windows Forms DataGridView Control diff --git a/xml/System.Windows.Forms/DataGridViewCell+DataGridViewCellAccessibleObject.xml b/xml/System.Windows.Forms/DataGridViewCell+DataGridViewCellAccessibleObject.xml index f8dbc62f392..838e17682c8 100644 --- a/xml/System.Windows.Forms/DataGridViewCell+DataGridViewCellAccessibleObject.xml +++ b/xml/System.Windows.Forms/DataGridViewCell+DataGridViewCellAccessibleObject.xml @@ -36,7 +36,7 @@ Occasionally, you might require more accessibility information or different accessibility actions to be included with your custom or . To customize accessibility, you can write your own class that derives from the or classes and override the method. For example, if you are writing a custom row header cell that implements unique custom actions, such as special hit testing within your cell, you should create a class that inherits from the class and override the method. - The exposes its data structure by using values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see "Exposing Data Tables through Microsoft Active Accessibility" in the MSDN library at https://msdn.microsoft.com/library. + The exposes its data structure by using values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see [Exposing Data Tables through Microsoft Active Accessibility](https://docs.microsoft.com/previous-versions/windows/desktop/dnacc/exposing-data-tables-through-microsoft-active-accessibility). ]]> diff --git a/xml/System.Windows.Forms/DataGridViewCell.xml b/xml/System.Windows.Forms/DataGridViewCell.xml index a197e1348ae..be1a5e4940d 100644 --- a/xml/System.Windows.Forms/DataGridViewCell.xml +++ b/xml/System.Windows.Forms/DataGridViewCell.xml @@ -112,7 +112,7 @@ > [!NOTE] > To get or set the property, you must add a reference to the `Accessibility` assembly installed with the [!INCLUDE[dnprdnshort](~/includes/dnprdnshort-md.md)]. - For more information about accessible objects, see the "Active Accessibility" section of the MSDN Library at [https://msdn.microsoft.com/library](https://msdn.microsoft.com/library). + For more information about accessible objects, see [Active Accessibility](/windows/win32/winauto/microsoft-active-accessibility). ]]> @@ -3961,8 +3961,8 @@ - Nullable Types (C# Programming Guide) - Value Types that Might Not Have a Defined Value + Nullable Types (C# Programming Guide) + Nullable Value Types (Visual Basic) diff --git a/xml/System.Windows.Forms/DataGridViewCheckBoxCell+DataGridViewCheckBoxCellAccessibleObject.xml b/xml/System.Windows.Forms/DataGridViewCheckBoxCell+DataGridViewCheckBoxCellAccessibleObject.xml index 8ba48adfc85..b3219a062e0 100644 --- a/xml/System.Windows.Forms/DataGridViewCheckBoxCell+DataGridViewCheckBoxCellAccessibleObject.xml +++ b/xml/System.Windows.Forms/DataGridViewCheckBoxCell+DataGridViewCheckBoxCellAccessibleObject.xml @@ -31,7 +31,7 @@ Occasionally, you might require more accessibility information or different accessibility actions to be included with your custom or . To customize accessibility, you can write your own class that derives from the or classes and override the method. For example, if you are writing a custom row header cell that implements unique custom actions, such as special hit testing within your cell, you should create a class that inherits from the class and override the method. - The exposes its data structure by using values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see "Exposing Data Tables through Microsoft Active Accessibility" in the MSDN library at https://msdn.microsoft.com/library. + The exposes its data structure by using values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see [Exposing Data Tables through Microsoft Active Accessibility](https://docs.microsoft.com/previous-versions/windows/desktop/dnacc/exposing-data-tables-through-microsoft-active-accessibility). ]]> diff --git a/xml/System.Windows.Forms/DataGridViewCheckBoxCell.xml b/xml/System.Windows.Forms/DataGridViewCheckBoxCell.xml index 7606ec12657..fd4429b7106 100644 --- a/xml/System.Windows.Forms/DataGridViewCheckBoxCell.xml +++ b/xml/System.Windows.Forms/DataGridViewCheckBoxCell.xml @@ -1153,7 +1153,7 @@ - Default Keyboard and Mouse Handling in the Windows Forms DataGridView Control + Default Keyboard and Mouse Handling in the Windows Forms DataGridView Control @@ -1195,7 +1195,7 @@ - Default Keyboard and Mouse Handling in the Windows Forms DataGridView Control + Default Keyboard and Mouse Handling in the Windows Forms DataGridView Control diff --git a/xml/System.Windows.Forms/DataGridViewColumnHeaderCell+DataGridViewColumnHeaderCellAccessibleObject.xml b/xml/System.Windows.Forms/DataGridViewColumnHeaderCell+DataGridViewColumnHeaderCellAccessibleObject.xml index 6e395c05f0d..c7e8189b837 100644 --- a/xml/System.Windows.Forms/DataGridViewColumnHeaderCell+DataGridViewColumnHeaderCellAccessibleObject.xml +++ b/xml/System.Windows.Forms/DataGridViewColumnHeaderCell+DataGridViewColumnHeaderCellAccessibleObject.xml @@ -31,7 +31,7 @@ Occasionally, you might require more accessibility information or different accessibility actions to be included with your custom or . To customize accessibility, you can write your own class that derives from the or classes and override the method. For example, if you are writing a custom row header cell that implements unique custom actions, such as special hit testing within your cell, you should create a class that inherits from the class and override the method. - The exposes its data structure by using values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see "Exposing Data Tables through Microsoft Active Accessibility" in the MSDN library at https://msdn.microsoft.com/library. + The exposes its data structure by using values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see [Exposing Data Tables through Microsoft Active Accessibility](https://docs.microsoft.com/previous-versions/windows/desktop/dnacc/exposing-data-tables-through-microsoft-active-accessibility). ]]> diff --git a/xml/System.Windows.Forms/DataGridViewComboBoxCell.xml b/xml/System.Windows.Forms/DataGridViewComboBoxCell.xml index dcd5c7b3430..43f6a8e868d 100644 --- a/xml/System.Windows.Forms/DataGridViewComboBoxCell.xml +++ b/xml/System.Windows.Forms/DataGridViewComboBoxCell.xml @@ -49,7 +49,7 @@ - How to: Access Objects in a Windows Forms DataGridViewComboBoxCell Drop-Down List + How to: Access Objects in a Windows Forms DataGridViewComboBoxCell Drop-Down List @@ -901,7 +901,7 @@ For additional information, see [What's New in Accessibility in the .NET Framewo - Default Keyboard and Mouse Handling in the Windows Forms DataGridView Control + Default Keyboard and Mouse Handling in the Windows Forms DataGridView Control diff --git a/xml/System.Windows.Forms/DataGridViewComboBoxColumn.xml b/xml/System.Windows.Forms/DataGridViewComboBoxColumn.xml index 7bf3c6720d7..8097d61cac8 100644 --- a/xml/System.Windows.Forms/DataGridViewComboBoxColumn.xml +++ b/xml/System.Windows.Forms/DataGridViewComboBoxColumn.xml @@ -77,7 +77,7 @@ - How to: Access Objects in a Windows Forms DataGridViewComboBoxCell Drop-Down List + How to: Access Objects in a Windows Forms DataGridViewComboBoxCell Drop-Down List diff --git a/xml/System.Windows.Forms/DataGridViewImageCell+DataGridViewImageCellAccessibleObject.xml b/xml/System.Windows.Forms/DataGridViewImageCell+DataGridViewImageCellAccessibleObject.xml index fdf906d1347..df9ff14efbf 100644 --- a/xml/System.Windows.Forms/DataGridViewImageCell+DataGridViewImageCellAccessibleObject.xml +++ b/xml/System.Windows.Forms/DataGridViewImageCell+DataGridViewImageCellAccessibleObject.xml @@ -31,7 +31,7 @@ Occasionally, you might require more accessibility information or different accessibility actions to be included with your custom or . To customize accessibility, you can write your own class that derives from the or classes and override the method. For example, if you are writing a custom row header cell that implements unique custom actions, such as special hit testing within your cell, you should create a class that inherits from the class and override the method. - The exposes its data structure by using values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see "Exposing Data Tables through Microsoft Active Accessibility" in the MSDN library at https://msdn.microsoft.com/library. + The exposes its data structure by using values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see [Exposing Data Tables through Microsoft Active Accessibility](https://docs.microsoft.com/previous-versions/windows/desktop/dnacc/exposing-data-tables-through-microsoft-active-accessibility). ]]> diff --git a/xml/System.Windows.Forms/DataGridViewLinkCell+DataGridViewLinkCellAccessibleObject.xml b/xml/System.Windows.Forms/DataGridViewLinkCell+DataGridViewLinkCellAccessibleObject.xml index 723c0397154..1232b9a52fc 100644 --- a/xml/System.Windows.Forms/DataGridViewLinkCell+DataGridViewLinkCellAccessibleObject.xml +++ b/xml/System.Windows.Forms/DataGridViewLinkCell+DataGridViewLinkCellAccessibleObject.xml @@ -31,7 +31,7 @@ Occasionally, you might require more accessibility information or different accessibility actions to be included with your custom or . To customize accessibility, you can write your own class that derives from the or classes and override the method. For example, if you are writing a custom row header cell that implements unique custom actions, such as special hit testing within your cell, you should create a class that inherits from the class and override the method. - The exposes its data structure by using values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see "Exposing Data Tables through Microsoft Active Accessibility" in the MSDN library at https://msdn.microsoft.com/library. + The exposes its data structure by using values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see [Exposing Data Tables through Microsoft Active Accessibility](https://docs.microsoft.com/previous-versions/windows/desktop/dnacc/exposing-data-tables-through-microsoft-active-accessibility). ]]> diff --git a/xml/System.Windows.Forms/DataGridViewRow+DataGridViewRowAccessibleObject.xml b/xml/System.Windows.Forms/DataGridViewRow+DataGridViewRowAccessibleObject.xml index 6d820457d69..4219c2ab9c4 100644 --- a/xml/System.Windows.Forms/DataGridViewRow+DataGridViewRowAccessibleObject.xml +++ b/xml/System.Windows.Forms/DataGridViewRow+DataGridViewRowAccessibleObject.xml @@ -36,7 +36,7 @@ Occasionally, you might require more accessibility information or different accessibility actions to be included with your custom or . To customize accessibility, you can write your own class that derives from the or classes and override the method. For example, if you are writing a custom row header cell that implements unique custom actions, such as special hit testing within your cell, you should create a class that inherits from the class and override the method. - The exposes its data structure by using values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see "Exposing Data Tables through Microsoft Active Accessibility" in the MSDN library at https://msdn.microsoft.com/library. + The exposes its data structure by using values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see [Exposing Data Tables through Microsoft Active Accessibility](https://docs.microsoft.com/previous-versions/windows/desktop/dnacc/exposing-data-tables-through-microsoft-active-accessibility). ]]> diff --git a/xml/System.Windows.Forms/DataGridViewTextBoxCell.xml b/xml/System.Windows.Forms/DataGridViewTextBoxCell.xml index 8b8bd6f269a..533948693d0 100644 --- a/xml/System.Windows.Forms/DataGridViewTextBoxCell.xml +++ b/xml/System.Windows.Forms/DataGridViewTextBoxCell.xml @@ -416,7 +416,7 @@ For additional information, see [What's New in Accessibility in the .NET Framewo - Default Keyboard and Mouse Handling in the Windows Forms DataGridView Control + Default Keyboard and Mouse Handling in the Windows Forms DataGridView Control diff --git a/xml/System.Windows.Forms/DataGridViewTopLeftHeaderCell+DataGridViewTopLeftHeaderCellAccessibleObject.xml b/xml/System.Windows.Forms/DataGridViewTopLeftHeaderCell+DataGridViewTopLeftHeaderCellAccessibleObject.xml index c40056412ac..1e3375f2978 100644 --- a/xml/System.Windows.Forms/DataGridViewTopLeftHeaderCell+DataGridViewTopLeftHeaderCellAccessibleObject.xml +++ b/xml/System.Windows.Forms/DataGridViewTopLeftHeaderCell+DataGridViewTopLeftHeaderCellAccessibleObject.xml @@ -31,7 +31,7 @@ Occasionally, you might require more accessibility information or different accessibility actions to be included with your custom or . To customize accessibility, you can write your own class that derives from the or classes and override the method. For example, if you are writing a custom row header cell that implements unique custom actions, such as special hit testing within your cell, you should create a class that inherits from the class and override the method. - The exposes its data structure by using values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see "Exposing Data Tables through Microsoft Active Accessibility" in the MSDN library at https://msdn.microsoft.com/library. + The exposes its data structure by using values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see [Exposing Data Tables through Microsoft Active Accessibility](https://docs.microsoft.com/previous-versions/windows/desktop/dnacc/exposing-data-tables-through-microsoft-active-accessibility). ]]> diff --git a/xml/System.Windows.Forms/DataObject.xml b/xml/System.Windows.Forms/DataObject.xml index c6d5727dacb..ee73e78a946 100644 --- a/xml/System.Windows.Forms/DataObject.xml +++ b/xml/System.Windows.Forms/DataObject.xml @@ -148,7 +148,8 @@ when you use this constructor, or you can add data as an to provide multiple formats at once. If you are familiar with COM programming, you can also add a data object that implements the COM `IDataObject` interface. For more information, see `IDataObject` in the MSDN library at https://msdn.microsoft.com/library. + +You can add data in any format to the when you use this constructor, or you can add data as an to provide multiple formats at once. If you are familiar with COM programming, you can also add a data object that implements the COM `IDataObject` interface. For more information, see [IDataObject](/windows/win32/api/objidl/nn-objidl-idataobject). diff --git a/xml/System.Windows.Forms/HtmlWindow.xml b/xml/System.Windows.Forms/HtmlWindow.xml index 792f6b968c7..b8b6c49b0c3 100644 --- a/xml/System.Windows.Forms/HtmlWindow.xml +++ b/xml/System.Windows.Forms/HtmlWindow.xml @@ -39,8 +39,8 @@ ]]> - window Object - IHTMLWindow2 Interface + window Object + IHTMLWindow2 Interface @@ -74,7 +74,7 @@ ]]> - alert Method + alert Method @@ -151,7 +151,7 @@ ]]> - close Method + close Method @@ -216,7 +216,7 @@ The following example displays a - confirm Method + confirm Method @@ -245,7 +245,7 @@ The following example displays a A reference to the managed code that handles the event. Removes the named event handler. To be added. - detachEvent Method + detachEvent Method @@ -399,7 +399,7 @@ The following example displays a - onerror Event + onerror Event @@ -432,7 +432,7 @@ The following example displays a - focus Method + focus Method @@ -473,7 +473,7 @@ The following example displays a - frames Collection + frames Collection @@ -545,7 +545,7 @@ The following example displays a - onfocus Event + onfocus Event @@ -615,7 +615,7 @@ The following example displays a - closed Property + closed Property @@ -657,7 +657,7 @@ The following example displays a - onload Event + onload Event @@ -737,7 +737,7 @@ The following example displays a The code trying to execute this operation does not have permission to manipulate this window. - moveTo Method + moveTo Method @@ -799,7 +799,7 @@ The following example displays a Gets or sets the name of the window. A representing the name. To be added. - name Property + name Property @@ -842,7 +842,7 @@ The following example displays a - navigate Method + navigate Method @@ -1135,7 +1135,7 @@ The following example displays a - open Method + open Method @@ -1248,7 +1248,7 @@ The following example displays a - open Method + open Method @@ -1279,7 +1279,7 @@ The following example displays a - parent Property + parent Property @@ -1318,9 +1318,9 @@ The following example displays a - Windows Forms Coordinates - screenLeft Property - screenTop Property + Windows Forms Coordinates + screenLeft Property + screenTop Property @@ -1388,7 +1388,7 @@ The following example displays a - blur Method + blur Method @@ -1423,7 +1423,7 @@ The following example displays a - onresize Event + onresize Event @@ -1469,8 +1469,8 @@ The following example displays a - The window you are trying to resize is in a different domain than its parent window. This restriction is part of cross-frame scripting security; for more information, see [About Cross-Frame Scripting and Security](https://msdn.microsoft.com/library/ms533028.aspx). - resizeTo Method + The window you are trying to resize is in a different domain than its parent window. This restriction is part of cross-frame scripting security. + resizeTo Method @@ -1534,7 +1534,7 @@ The following example displays a - onscroll Event + onscroll Event @@ -1585,7 +1585,7 @@ The following example displays a - scrollTo Method + scrollTo Method @@ -1674,7 +1674,7 @@ The following example displays a - status Property + status Property @@ -1709,7 +1709,7 @@ The following example displays a - onunload Event + onunload Event @@ -1778,7 +1778,7 @@ The following example displays a - frameElement Property + frameElement Property diff --git a/xml/System.Windows.Forms/HtmlWindowCollection.xml b/xml/System.Windows.Forms/HtmlWindowCollection.xml index 8b66140b824..21cfc29596a 100644 --- a/xml/System.Windows.Forms/HtmlWindowCollection.xml +++ b/xml/System.Windows.Forms/HtmlWindowCollection.xml @@ -46,7 +46,7 @@ ]]> - IHTMLFramesCollection2 Interface + IHTMLFramesCollection2 Interface @@ -73,7 +73,7 @@ Gets the number of elements in the collection. The number of objects in the current . To be added. - length Property + length Property @@ -118,7 +118,7 @@ ]]> - item Method + item Method @@ -157,7 +157,7 @@ is greater than the number of items in the collection. - item Method + item Method @@ -194,7 +194,7 @@ is not the name of a object in the current document or in any of its children. - item Method + item Method diff --git a/xml/System.Windows.Forms/IDataGridViewEditingControl.xml b/xml/System.Windows.Forms/IDataGridViewEditingControl.xml index 477682c0ae3..642566c8a5f 100644 --- a/xml/System.Windows.Forms/IDataGridViewEditingControl.xml +++ b/xml/System.Windows.Forms/IDataGridViewEditingControl.xml @@ -54,7 +54,7 @@ - How to: Host Controls in Windows Forms DataGridView Cells + How to: Host Controls in Windows Forms DataGridView Cells diff --git a/xml/System/CLSCompliantAttribute.xml b/xml/System/CLSCompliantAttribute.xml index 778f81be453..5a3d5c2fca5 100644 --- a/xml/System/CLSCompliantAttribute.xml +++ b/xml/System/CLSCompliantAttribute.xml @@ -101,7 +101,7 @@ public int SetValue(UInt32 value); ]]> - Language Independence and Language-Independent Components + Language Independence and Language-Independent Components Extending Metadata Using Attributes diff --git a/xml/System/Console.xml b/xml/System/Console.xml index bd70449607e..07f0fce0707 100644 --- a/xml/System/Console.xml +++ b/xml/System/Console.xml @@ -316,7 +316,7 @@ > [!NOTE] > The method is not supported on the 64-bit editions of Windows Vista and Windows XP. - wraps a call to the Windows [Beep function](https://msdn.microsoft.com/library/windows/desktop/ms679277.aspx). Whether produces a sound on versions of Windows before Windows 7 depends on the presence of a 8254 programmable interval timer chip. Starting with Windows 7, it depends on the default sound device. + wraps a call to the Windows [Beep function](/windows/win32/api/utilapiset/nf-utilapiset-beep). Whether produces a sound on versions of Windows before Windows 7 depends on the presence of a 8254 programmable interval timer chip. Starting with Windows 7, it depends on the default sound device. @@ -379,7 +379,7 @@ wraps a call to the Windows [Beep function](https://msdn.microsoft.com/library/windows/desktop/ms679277.aspx). Whether produces a sound on versions of Windows before Windows 7 depends on the presence of a 8254 programmable interval timer chip. Starting with Windows 7, it depends on the default sound device. + wraps a call to the Windows [Beep function](/windows/win32/api/utilapiset/nf-utilapiset-beep). Whether produces a sound on versions of Windows before Windows 7 depends on the presence of a 8254 programmable interval timer chip. Starting with Windows 7, it depends on the default sound device. > [!NOTE] > The method is not supported on the 64-bit editions of Windows Vista and Windows XP. diff --git a/xml/System/Delegate.xml b/xml/System/Delegate.xml index 269ed25eeb3..d5f475f86b8 100644 --- a/xml/System/Delegate.xml +++ b/xml/System/Delegate.xml @@ -127,10 +127,10 @@ ]]> - Calling Synchronous Methods Asynchronously + Calling Synchronous Methods Asynchronously Delegates (C# Programming Guide) Delegates (Visual Basic) - How to: Define and Use Delegates (C++/CLI) + How to: Define and Use Delegates (C++/CLI) Handling and Raising Events diff --git a/xml/System/Double.xml b/xml/System/Double.xml index 2e96ee6757e..f9f3dbc17a1 100644 --- a/xml/System/Double.xml +++ b/xml/System/Double.xml @@ -541,13 +541,13 @@ ## Remarks The value of the property reflects the smallest positive value that is significant in numeric operations or comparisons when the value of the instance is zero. For example, the following code shows that zero and are considered to be unequal values, whereas zero and half the value of are considered to be equal. - [!code-csharp[System.Double.Epsilon#5](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Epsilon/cs/epsilon.cs#5)] - [!code-vb[System.Double.Epsilon#5](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Epsilon/vb/epsilon.vb#5)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Epsilon/cs/epsilon.cs" interactive="try-dotnet" id="Snippet5"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Epsilon/vb/epsilon.vb" id="Snippet5"::: More precisely, the floating point format consists of a sign, a 52-bit mantissa or significand, and an 11-bit exponent. As the following example shows, zero has an exponent of -1022 and a mantissa of 0. has an exponent of -1022 and a mantissa of 1. This means that is the smallest positive value greater than zero and represents the smallest possible value and the smallest possible increment for a whose exponent is -1022. - [!code-csharp[System.Double.Epsilon#6](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Epsilon/cs/epsilon1.cs#6)] - [!code-vb[System.Double.Epsilon#6](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Epsilon/vb/epsilon1.vb#6)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Epsilon/cs/epsilon1.cs" interactive="try-dotnet" id="Snippet6"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Epsilon/vb/epsilon1.vb" id="Snippet6"::: However, the property is not a general measure of precision of the type; it applies only to instances that have a value of zero or an exponent of -1022. @@ -638,21 +638,21 @@ ## Precision in Comparisons The method should be used with caution, because two apparently equivalent values can be unequal due to the differing precision of the two values. The following example reports that the value .333333 and the value returned by dividing 1 by 3 are unequal. - [!code-csharp[System.Double.Epsilon#1](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Epsilon/cs/Equals_25051.cs#1)] - [!code-vb[System.Double.Epsilon#1](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Epsilon/vb/Equals_25051.vb#1)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Epsilon/cs/Equals_25051.cs" interactive="try-dotnet-method" id="Snippet1"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Epsilon/vb/Equals_25051.vb" id="Snippet1"::: Rather than comparing for equality, one technique involves defining an acceptable relative margin of difference between two values (such as .001% of one of the values). If the absolute value of the difference between the two values is less than or equal to that margin, the difference is likely to be due to differences in precision and, therefore, the values are likely to be equal. The following example uses this technique to compare .33333 and 1/3, the two values that the previous code example found to be unequal. In this case, the values are equal. - [!code-csharp[System.Double.Epsilon#2](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Epsilon/cs/Equals_25051.cs#2)] - [!code-vb[System.Double.Epsilon#2](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Epsilon/vb/Equals_25051.vb#2)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Epsilon/cs/Equals_25051.cs" interactive="try-dotnet-method" id="Snippet2"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Epsilon/vb/Equals_25051.vb" id="Snippet2"::: > [!NOTE] > Because defines the minimum expression of a positive value whose range is near zero, the margin of difference between two similar values must be greater than . Typically, it is many times greater than . Because of this, we recommend that you do not use when comparing values for equality. A second technique involves comparing the difference between two floating-point numbers with some absolute value. If the difference is less than or equal to that absolute value, the numbers are equal. If it is greater, the numbers are not equal. One alternative is to arbitrarily select an absolute value. This is problematic, however, because an acceptable margin of difference depends on the magnitude of the values. A second alternative takes advantage of a design feature of the floating-point format: The difference between the integer representation of two floating-point values indicates the number of possible floating-point values that separates them. For example, the difference between 0.0 and is 1, because is the smallest representable value when working with a whose value is zero. The following example uses this technique to compare .33333 and 1/3, which are the two values that the previous code example with the method found to be unequal. Note that the example uses the method to convert a double-precision floating-point value to its integer representation. - [!code-csharp[System.Double.Equals#1](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.double.equals/cs/equalsabs1.cs#1)] - [!code-vb[System.Double.Equals#1](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.double.equals/vb/equalsabs1.vb#1)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.double.equals/cs/equalsabs1.cs" interactive="try-dotnet" id="Snippet1"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.double.equals/vb/equalsabs1.vb" id="Snippet1"::: The precision of floating-point numbers beyond the documented precision is specific to the implementation and version of the .NET Framework. Consequently, a comparison of two particular numbers might change between versions of the .NET Framework because the precision of the numbers' internal representation might change. @@ -663,8 +663,8 @@ Compiler overload resolution may account for an apparent difference in the behavior of the two method overloads. If an implicit conversion between the argument and a is defined and the argument is not typed as an , compilers may perform an implicit conversion and call the method. Otherwise, they call the method, which always returns if its argument is not a value. The following example illustrates the difference in behavior between the two method overloads. In the case of all primitive numeric types except for and in C#, the first comparison returns because the compiler automatically performs a widening conversion and calls the method, whereas the second comparison returns because the compiler calls the method. - [!code-csharp[System.Double.Equals#2](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.double.equals/cs/equalsoverl.cs#2)] - [!code-vb[System.Double.Equals#2](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.double.equals/vb/equalsoverl.vb#2)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.double.equals/cs/equalsoverl.cs" interactive="try-dotnet" id="Snippet2"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.double.equals/vb/equalsoverl.vb" id="Snippet2"::: @@ -718,8 +718,8 @@ ## Remarks The method should be used with caution, because two apparently equivalent values can be unequal due to the differing precision of the two values. The following example reports that the value .3333 and the returned by dividing 1 by 3 are unequal. - [!code-csharp[System.Double.Epsilon#3](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Epsilon/cs/Equals_25051.cs#3)] - [!code-vb[System.Double.Epsilon#3](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Epsilon/vb/Equals_25051.vb#3)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Epsilon/cs/Equals_25051.cs" interactive="try-dotnet-method" id="Snippet3"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Epsilon/vb/Equals_25051.vb" id="Snippet3"::: For alternatives to calling the method, see the documentation for the overload. @@ -735,8 +735,8 @@ Compiler overload resolution may account for an apparent difference in the behavior of the two method overloads. If an implicit conversion between the argument and a is defined and the argument is not typed as an , compilers may perform an implicit conversion and call the method. Otherwise, they call the method, which always returns if its argument is not a value. The following example illustrates the difference in behavior between the two method overloads. In the case of all primitive numeric types except for and in C#, the first comparison returns because the compiler automatically performs a widening conversion and calls the method, whereas the second comparison returns because the compiler calls the method. - [!code-csharp[System.Double.Equals#2](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.double.equals/cs/equalsoverl.cs#2)] - [!code-vb[System.Double.Equals#2](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.double.equals/vb/equalsoverl.vb#2)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.double.equals/cs/equalsoverl.cs" interactive="try-dotnet" id="Snippet2"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.double.equals/vb/equalsoverl.vb" id="Snippet2"::: @@ -1292,8 +1292,8 @@ The result of an operation that exceeds is . In the following example, results from addition, multiplication, and exponentiation operations when the result exceeds . - [!code-csharp[System.Double.MaxValue#1](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.double.maxvalue/cs/maxvalueex.cs#1)] - [!code-vb[System.Double.MaxValue#1](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.double.maxvalue/vb/maxvalueex.vb#1)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.double.maxvalue/cs/maxvalueex.cs" interactive="try-dotnet" id="Snippet1"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.double.maxvalue/vb/maxvalueex.vb" id="Snippet1"::: @@ -1353,18 +1353,17 @@ The result of an operation that is less than is . In the following example, results from subtraction and multiplication operations when the result is less than . - [!code-csharp[System.Double.MinValue#1](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.double.minvalue/cs/minvalueex.cs#1)] - [!code-vb[System.Double.MinValue#1](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.double.minvalue/vb/minvalueex.vb#1)] - + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.double.minvalue/cs/minvalueex.cs" interactive="try-dotnet" id="Snippet1"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.double.minvalue/vb/minvalueex.vb" id="Snippet1"::: ## Examples The following code example illustrates the use of : - [!code-cpp[Double Example#2](~/samples/snippets/cpp/VS_Snippets_CLR/Double Example/CPP/source.cpp#2)] - [!code-csharp[Double Example#2](~/samples/snippets/csharp/VS_Snippets_CLR/Double Example/CS/source.cs#2)] - [!code-vb[Double Example#2](~/samples/snippets/visualbasic/VS_Snippets_CLR/Double Example/VB/source.vb#2)] - + :::code language="cpp" source="~/samples/snippets/cpp/VS_Snippets_CLR/Double Example/CPP/source.cpp" id="Snippet2"::: + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR/Double Example/CS/source.cs" id="Snippet2"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR/Double Example/VB/source.vb" id="Snippet2"::: + ]]> @@ -1412,27 +1411,27 @@ ## Remarks A method or operator returns when the result of an operation is undefined. For example, the result of dividing zero by zero is , as the following example shows. (But note that dividing a non-zero number by zero returns either or , depending on the sign of the divisor.) - [!code-csharp[System.Double.NaN#1](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.double.nan/cs/nan1.cs#1)] - [!code-vb[System.Double.NaN#1](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.double.nan/vb/nan1.vb#1)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.double.nan/cs/nan1.cs" interactive="try-dotnet-method" id="Snippet1"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.double.nan/vb/nan1.vb" id="Snippet1"::: In addition, a method call with a value or an operation on a value returns , as the following example shows. - [!code-csharp[System.Double.NaN#2](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.double.nan/cs/nan1.cs#2)] - [!code-vb[System.Double.NaN#2](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.double.nan/vb/nan1.vb#2)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.double.nan/cs/nan1.cs" interactive="try-dotnet-method" id="Snippet2"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.double.nan/vb/nan1.vb" id="Snippet2"::: Use the method to determine whether a value is not a number. The operator considers two values to be unequal to one another. In general, operators cannot be used to compare with other values, although comparison methods (such as and ) can. The following example illustrates the difference in behavior between comparison operators and methods. - [!code-csharp[System.Double.NaN#4](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.double.nan/cs/double.nan4.cs#4)] - [!code-vb[System.Double.NaN#4](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.double.nan/vb/double.nan4.vb#4)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.double.nan/cs/double.nan4.cs" interactive="try-dotnet" id="Snippet4"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.double.nan/vb/double.nan4.vb" id="Snippet4"::: ## Examples The following example illustrates the use of : - [!code-cpp[System.Double#7](~/samples/snippets/cpp/VS_Snippets_CLR_System/system.Double/CPP/doublesample.cpp#7)] - [!code-csharp[System.Double#7](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double/CS/doublesample.cs#7)] - [!code-vb[System.Double#7](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double/VB/doublesample.vb#7)] + :::code language="cpp" source="~/samples/snippets/cpp/VS_Snippets_CLR_System/system.Double/CPP/doublesample.cpp" id="Snippet7"::: + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double/CS/doublesample.cs" interactive="try-dotnet-method" id="Snippet7"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double/VB/doublesample.vb" id="Snippet7"::: ]]> @@ -1901,8 +1900,8 @@ Ordinarily, if you pass the method a string that is created by calling the method, the original value is returned. However, on .NET Framework and on .NET Core 2.2 and earlier versions, the values may not be equal because of a loss of precision. In addition, attempting to parse the string representation of either or fails to round-trip. On .NET Framework and .NET Core 2.2 and previous versions, it throws an . The following example provides an illustration. - [!code-csharp[System.Double.Parse#3](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Parse/cs/parse2.cs#3)] - [!code-vb[System.Double.Parse#3](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Parse/vb/parse2.vb#3)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Parse/cs/parse2.cs" interactive="try-dotnet-method" id="Snippet3"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Parse/vb/parse2.vb" id="Snippet3"::: On .NET Framework and .NET Core 2.2 and earlier versions, if `s` is out of range of the data type, the method throws an . @@ -1913,9 +1912,9 @@ If a separator is encountered in the `s` parameter during a parse operation, and ## Examples The following example illustrates the use of the method. - [!code-cpp[Double Example#5](~/samples/snippets/cpp/VS_Snippets_CLR/Double Example/CPP/source.cpp#5)] - [!code-csharp[Double Example#5](~/samples/snippets/csharp/VS_Snippets_CLR/Double Example/CS/source.cs#5)] - [!code-vb[Double Example#5](~/samples/snippets/visualbasic/VS_Snippets_CLR/Double Example/VB/source.vb#5)] + :::code language="cpp" source="~/samples/snippets/cpp/VS_Snippets_CLR/Double Example/CPP/source.cpp" id="Snippet5"::: + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR/Double Example/CS/source.cs" id="Snippet5"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR/Double Example/VB/source.vb" id="Snippet5"::: ]]> @@ -2029,8 +2028,8 @@ If a separator is encountered in the `s` parameter during a parse operation, and Ordinarily, if you pass the method a string that is created by calling the method, the original value is returned. However, because of a loss of precision, the values may not be equal. In addition, attempting to parse the string representation of either or fails to round-trip. On .NET Framework and .NET Core 2.2 and previous versions, it throws an . On .NET Core 3.0 and later versions, it returns if you attempt to parse or if you attempt to parse . The following example provides an illustration. - [!code-csharp[System.Double.Parse#3](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Parse/cs/parse2.cs#3)] - [!code-vb[System.Double.Parse#3](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Parse/vb/parse2.vb#3)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Parse/cs/parse2.cs" interactive="try-dotnet-method" id="Snippet3"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Parse/vb/parse2.vb" id="Snippet3"::: On .NET Framework and .NET Core 2.2 and earlier versions, if `s` is out of range of the data type, the method throws an . @@ -2041,8 +2040,8 @@ If a separator is encountered in the `s` parameter during a parse operation, and ## Examples The following example uses the method to parse the string representations of values using the en-US culture. - [!code-csharp[System.Double.Parse#1](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Parse/cs/Parse.cs#1)] - [!code-vb[System.Double.Parse#1](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Parse/vb/Parse.vb#1)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Parse/cs/Parse.cs" id="Snippet1"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Parse/vb/Parse.vb" id="Snippet1"::: ]]> @@ -2136,8 +2135,8 @@ If a separator is encountered in the `s` parameter during a parse operation, and Ordinarily, if you pass the method a string that is created by calling the method, the original value is returned. However, because of a loss of precision, the values may not be equal. In addition, attempting to parse the string representation of either or fails to round-trip. On .NET Framework and .NET Core 2.2 and previous versions, it throws an . On .NET Core 3.0 and later versions, it returns if you attempt to parse or if you attempt to parse . The following example provides an illustration. - [!code-csharp[System.Double.Parse#3](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Parse/cs/parse2.cs#3)] - [!code-vb[System.Double.Parse#3](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Parse/vb/parse2.vb#3)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Parse/cs/parse2.cs" interactive="try-dotnet-method" id="Snippet3"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Parse/vb/parse2.vb" id="Snippet3"::: On .NET Framework and .NET Core 2.2 and earlier versions, if `s` is out of range of the data type, the method throws an . @@ -2318,8 +2317,8 @@ If `s` is out of range of the data type, the method returns Ordinarily, if you pass the method a string that is created by calling the method, the original value is returned. However, because of a loss of precision, the values may not be equal. In addition, attempting to parse the string representation of either or fails to round-trip. On .NET Framework and .NET Core 2.2 and previous versions, it throws an . On .NET Core 3.0 and later versions, it returns if you attempt to parse or if you attempt to parse . The following example provides an illustration. - [!code-csharp[System.Double.Parse#3](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Parse/cs/parse2.cs#3)] - [!code-vb[System.Double.Parse#3](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Parse/vb/parse2.vb#3)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Parse/cs/parse2.cs" interactive="try-dotnet-method" id="Snippet3"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Parse/vb/parse2.vb" id="Snippet3"::: On .NET Framework and .NET Core 2.2 and earlier versions, if `s` is out of range of the data type, the method throws an . @@ -2330,8 +2329,8 @@ If a separator is encountered in the `s` parameter during a parse operation, and ## Examples The following example illustrates the use of the method to assign several string representations of temperature values to a `Temperature` object. - [!code-csharp[System.Double.Parse#2](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Parse/cs/Parse3.cs#2)] - [!code-vb[System.Double.Parse#2](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Parse/vb/Parse3.vb#2)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.Parse/cs/Parse3.cs" interactive="try-dotnet" id="Snippet2"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.Parse/vb/Parse3.vb" id="Snippet2"::: ]]> @@ -2403,9 +2402,9 @@ If a separator is encountered in the `s` parameter during a parse operation, and ## Examples The following code example illustrates the use of : - [!code-cpp[System.Double#10](~/samples/snippets/cpp/VS_Snippets_CLR_System/system.Double/CPP/doublesample.cpp#10)] - [!code-csharp[System.Double#10](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double/CS/doublesample.cs#10)] - [!code-vb[System.Double#10](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double/VB/doublesample.vb#10)] + :::code language="cpp" source="~/samples/snippets/cpp/VS_Snippets_CLR_System/system.Double/CPP/doublesample.cpp" id="Snippet10"::: + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double/CS/doublesample.cs" interactive="try-dotnet-method" id="Snippet10"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double/VB/doublesample.vb" id="Snippet10"::: ]]> @@ -3394,8 +3393,8 @@ This member is an explicit interface member implementation. It can be used only ## Examples The following example uses the default method to display the string representations of a number of values. - [!code-csharp[System.Double.ToString#1](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.ToString/cs/ToString1.cs#1)] - [!code-vb[System.Double.ToString#1](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.ToString/vb/ToString1.vb#1)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.ToString/cs/ToString1.cs" interactive="try-dotnet-method" id="Snippet1"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.ToString/vb/ToString1.vb" id="Snippet1"::: The following example illustrates the use of . @@ -3505,8 +3504,8 @@ This member is an explicit interface member implementation. It can be used only ## Examples The following example displays the string representation of two values using objects that represent several different cultures. - [!code-csharp[System.Double.ToString#2](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.ToString/cs/ToString1.cs#2)] - [!code-vb[System.Double.ToString#2](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.ToString/vb/ToString1.vb#2)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.ToString/cs/ToString1.cs" interactive="try-dotnet-method" id="Snippet2"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.ToString/vb/ToString1.vb" id="Snippet2"::: The following example illustrates the use of , taking a and an as parameters. @@ -3612,8 +3611,8 @@ This member is an explicit interface member implementation. It can be used only In some cases, values formatted with the "R" standard numeric format string do not successfully round-trip if compiled using the or switches and run on 64-bit systems. To work around this problem, you can format values by using the "G17" standard numeric format string. The following example uses the "R" format string with a value that does not round-trip successfully, and also uses the "G17" format string to successfully round-trip the original value. - [!code-csharp[System.Double.ToString#6](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.ToString/cs/roundtripex2.cs#6)] - [!code-vb[System.Double.ToString#6](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.ToString/vb/roundtripex2.vb#6)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.ToString/cs/roundtripex2.cs" interactive="try-dotnet" id="Snippet6"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.ToString/vb/roundtripex2.vb" id="Snippet6"::: Formatting Types in .NET @@ -3704,9 +3703,9 @@ This member is an explicit interface member implementation. It can be used only ## Examples The following example displays a value using each of the supported standard numeric format specifiers for several different cultures. - [!code-cpp[System.Double.ToString#4](~/samples/snippets/cpp/VS_Snippets_CLR_System/system.Double.ToString/cpp/tostring1.cpp#4)] - [!code-csharp[System.Double.ToString#4](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.ToString/cs/ToString1.cs#4)] - [!code-vb[System.Double.ToString#4](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.ToString/vb/ToString1.vb#4)] + :::code language="cpp" source="~/samples/snippets/cpp/VS_Snippets_CLR_System/system.Double.ToString/cpp/tostring1.cpp" id="Snippet4"::: + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.ToString/cs/ToString1.cs" interactive="try-dotnet-method" id="Snippet4"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.ToString/vb/ToString1.vb" id="Snippet4"::: The following example illustrates the use of , taking a and an as parameters. @@ -3719,8 +3718,8 @@ This member is an explicit interface member implementation. It can be used only In some cases, values formatted with the "R" standard numeric format string do not successfully round-trip if compiled using the or switches and run on 64-bit systems. To work around this problem, you can format values by using the "G17" standard numeric format string. The following example uses the "R" format string with a value that does not round-trip successfully, and also uses the "G17" format string to successfully round-trip the original value. - [!code-csharp[System.Double.ToString#5](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.ToString/cs/roundtripex1.cs#5)] - [!code-vb[System.Double.ToString#5](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.ToString/vb/roundtripex1.vb#5)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.ToString/cs/roundtripex1.cs" interactive="try-dotnet" id="Snippet5"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.ToString/vb/roundtripex1.vb" id="Snippet5"::: Formatting Types in .NET @@ -3904,8 +3903,8 @@ This member is an explicit interface member implementation. It can be used only Ordinarily, if you pass the method a string that is created by calling the method, the original value is returned. However, because of a loss of precision, the values may not be equal. In addition, attempting to parse the string representation of either or fails to round-trip. On .NET Framework and .NET Core 2.2 and previous versions, it throws an . On .NET Core 3.0 and later versions, it returns if you attempt to parse or if you attempt to parse . The following example provides an illustration. - [!code-csharp[System.Double.TryParse#3](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.TryParse/cs/tryparse2.cs#3)] - [!code-vb[System.Double.TryParse#3](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.TryParse/vb/tryparse2.vb#3)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.TryParse/cs/tryparse2.cs" interactive="try-dotnet" id="Snippet3"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.TryParse/vb/tryparse2.vb" id="Snippet3"::: On .NET Framework and .NET Core 2.2 and earlier versions, if `s` is out of range of the data type, the method throws an . @@ -3916,8 +3915,8 @@ If a separator is encountered in the `s` parameter during a parse operation, and ## Examples The following example uses the method to convert the string representations of numeric values to values. It assumes that en-US is the current culture. - [!code-csharp[System.Double.TryParse#1](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.TryParse/cs/tryparse1a.cs#1)] - [!code-vb[System.Double.TryParse#1](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.TryParse/vb/tryparse1a.vb#1)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.TryParse/cs/tryparse1a.cs" interactive="try-dotnet" id="Snippet1"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.TryParse/vb/tryparse1a.vb" id="Snippet1"::: ]]> @@ -4082,8 +4081,8 @@ If a separator is encountered in the `s` parameter during a parse operation, and Ordinarily, if you pass the method a string that is created by calling the method, the original value is returned. However, because of a loss of precision, the values may not be equal. In addition, attempting to parse the string representation of either or fails to round-trip. On .NET Framework and .NET Core 2.2 and previous versions, it throws an . On .NET Core 3.0 and later versions, it returns if you attempt to parse or if you attempt to parse . The following example provides an illustration. - [!code-csharp[System.Double.TryParse#3](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.TryParse/cs/tryparse2.cs#3)] - [!code-vb[System.Double.TryParse#3](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.TryParse/vb/tryparse2.vb#3)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.TryParse/cs/tryparse2.cs" interactive="try-dotnet" id="Snippet3"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.TryParse/vb/tryparse2.vb" id="Snippet3"::: On .NET Framework and .NET Core 2.2 and earlier versions, if `s` is out of range of the data type, the method throws an . @@ -4094,8 +4093,8 @@ On .NET Core 3.0 and later versions, no exception is thrown when `s` is out of r ## Examples The following example demonstrates the use of the method to parse the string representation of numbers that have a particular style and are formatted using the conventions of a particular culture. - [!code-csharp[System.Double.TryParse#2](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.TryParse/cs/TryParse1.cs#2)] - [!code-vb[System.Double.TryParse#2](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.TryParse/vb/TryParse1.vb#2)] + :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.TryParse/cs/TryParse1.cs" interactive="try-dotnet-method" id="Snippet2"::: + :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.TryParse/vb/TryParse1.vb" id="Snippet2"::: ]]> diff --git a/xml/System/IObservable`1.xml b/xml/System/IObservable`1.xml index 5038eadf67f..cc8ef0d8634 100644 --- a/xml/System/IObservable`1.xml +++ b/xml/System/IObservable`1.xml @@ -92,7 +92,7 @@ ]]> - The Observer Design Pattern + The Observer Design Pattern diff --git a/xml/System/IObserver`1.xml b/xml/System/IObserver`1.xml index 1c710df5451..b73ee0ebbd3 100644 --- a/xml/System/IObserver`1.xml +++ b/xml/System/IObserver`1.xml @@ -199,7 +199,7 @@ ]]> - Observer Design Pattern Best Practices + Observer Design Pattern Best Practices diff --git a/xml/System/IndexOutOfRangeException.xml b/xml/System/IndexOutOfRangeException.xml index af173d82669..7188e1a8516 100644 --- a/xml/System/IndexOutOfRangeException.xml +++ b/xml/System/IndexOutOfRangeException.xml @@ -139,7 +139,7 @@ Using hard-coded index values to manipulate an array is likely to throw an exception if the index value is incorrect or invalid, or if the size of the array being manipulation is unexpected. To prevent an operation from throwing an exception, you can do the following: -- Iterate the elements of the array using the [foreach](https://msdn.microsoft.com/library/ttw7t8t6.aspx) statement (in C#) or the [For Each...Next](https://msdn.microsoft.com/library/5ebk1751.aspx) construct (in Visual Basic) instead of iterating elements by index. +- Iterate the elements of the array using the [foreach](/dotnet/csharp/language-reference/keywords/foreach-in) statement (in C#) or the [For Each...Next](/dotnet/visual-basic/language-reference/statements/for-each-next-statement) construct (in Visual Basic) instead of iterating elements by index. - Iterate the elements by index starting with the index returned by the method and ending with the index returned by the method. diff --git a/xml/System/Nullable.xml b/xml/System/Nullable.xml index cc8a2f55c87..ae78a3c6001 100644 --- a/xml/System/Nullable.xml +++ b/xml/System/Nullable.xml @@ -58,8 +58,8 @@ ]]> - Nullable Types (C# Programming Guide) - Nullable Value Types (Visual Basic) + Nullable Types (C# Programming Guide) + Nullable Value Types (Visual Basic) diff --git a/xml/System/Nullable`1.xml b/xml/System/Nullable`1.xml index 0a71b39a885..300ed46780b 100644 --- a/xml/System/Nullable`1.xml +++ b/xml/System/Nullable`1.xml @@ -91,8 +91,8 @@ ]]> - Nullable Types (C# Programming Guide) - Nullable Value Types (Visual Basic) + Nullable Types (C# Programming Guide) + Nullable Value Types (Visual Basic) diff --git a/xml/System/Object.xml b/xml/System/Object.xml index 672280ecfa7..0e9740344b8 100644 --- a/xml/System/Object.xml +++ b/xml/System/Object.xml @@ -541,7 +541,7 @@ and the interface. The is a wrapper class for a wait handle. - The following example uses the [dispose pattern](/dotnet/standard/garbage-collection/implementing-dispose) with safe handles instead of overriding the method. It defines a `FileAssociation` class that wraps registry information about the application that handles files with a particular file extension. The two registry handles returned as `out` parameters by Windows [RegOpenKeyEx](https://msdn.microsoft.com/library/windows/desktop/ms724897.aspx) function calls are passed to the constructor. The type's protected `Dispose` method then calls the `SafeRegistryHandle.Dispose` method to free these two handles. + The following example uses the [dispose pattern](/dotnet/standard/garbage-collection/implementing-dispose) with safe handles instead of overriding the method. It defines a `FileAssociation` class that wraps registry information about the application that handles files with a particular file extension. The two registry handles returned as `out` parameters by Windows [RegOpenKeyEx](/windows/win32/api/winreg/nf-winreg-regopenkeyexa) function calls are passed to the constructor. The type's protected `Dispose` method then calls the `SafeRegistryHandle.Dispose` method to free these two handles. [!code-csharp[System.Object.Finalize#2](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.object.finalize/cs/finalize_safe.cs#2)] [!code-vb[System.Object.Finalize#2](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.object.finalize/vb/finalize_safe.vb#2)] diff --git a/xml/System/OperatingSystem.xml b/xml/System/OperatingSystem.xml index 33efa7b2e1e..928a34beee0 100644 --- a/xml/System/OperatingSystem.xml +++ b/xml/System/OperatingSystem.xml @@ -64,7 +64,7 @@ ## Remarks The class contains information about an operating system. - For information about the current runtime operating system, retrieve the object returned by the property. For a list of Windows operating system versions and their corresponding version numbers returned by the and properties and the method, see [Operating System Version](https://msdn.microsoft.com/library/windows/desktop/ms724832.aspx) on the Windows Dev Center. + For information about the current runtime operating system, retrieve the object returned by the property. For a list of Windows operating system versions and their corresponding version numbers returned by the and properties and the method, see [Operating System Version](/windows/win32/sysinfo/operating-system-version). By design, the class is not a general purpose means of describing an operating system, and you cannot derive a more inclusive type from the class. If you need a type to contain other information about an operating system, create your own type, then include a field of type and any additional fields, properties, or methods that you require. @@ -392,7 +392,8 @@ is the same as the value returned by the method. However, an implementation of the .NET Framework for a different platform might return a more appropriate string for that platform. - See [Operating System Version](https://msdn.microsoft.com/library/windows/desktop/ms724832.aspx) on the Windows Dev Center for a list of Windows operating system versions and their corresponding version numbers. +For a list of Windows operating system versions and their corresponding version numbers, see [Operating System Version](/windows/win32/sysinfo/operating-system-version). diff --git a/xml/System/TimeoutException.xml b/xml/System/TimeoutException.xml index 01844aef43a..eaa1a798eb7 100644 --- a/xml/System/TimeoutException.xml +++ b/xml/System/TimeoutException.xml @@ -243,7 +243,7 @@ The class name is , or is zero (0). - Binary Serialization + Binary Serialization diff --git a/xml/System/Type.xml b/xml/System/Type.xml index 6160c66ce46..df692924b01 100644 --- a/xml/System/Type.xml +++ b/xml/System/Type.xml @@ -8984,7 +8984,7 @@ Type.GetType("System.Collections.Generic.Dictionary`2[System.String,[MyType,MyAs ## Examples - The following example uses the CLSID of the Microsoft Word [Application object](https://msdn.microsoft.com/vba/word-vba/articles/application-object-word) to retrieve a COM type that represents the Microsoft Word application. It then instantiates the type by calling the method, and closes it by calling the [Application.Quit](https://msdn.microsoft.com/VBA/Word-VBA/articles/application-quit-method-word) method. + The following example uses the CLSID of the Microsoft Word [Application object](/office/vba/api/word.application) to retrieve a COM type that represents the Microsoft Word application. It then instantiates the type by calling the method, and closes it by calling the [Application.Quit](/office/vba/api/word.application.quit(method)) method. [!code-csharp[System.Type.GetTypeFromCLSID#1](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.type.gettypefromclsid/cs/gettypefromclsid1.cs#1)] [!code-vb[System.Type.GetTypeFromCLSID#1](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.type.gettypefromclsid/vb/gettypefromclsid1.vb#1)] @@ -9073,7 +9073,7 @@ Type.GetType("System.Collections.Generic.Dictionary`2[System.String,[MyType,MyAs ## Examples - The following example uses the CLSID of the Microsoft Word [Application object](https://msdn.microsoft.com/vba/word-vba/articles/application-object-word) to retrieve a COM type that represents the Microsoft Word application. It then instantiates the type by calling the method, and closes it by calling the [Application.Quit](https://msdn.microsoft.com/VBA/Word-VBA/articles/application-quit-method-word) method. An exception is thrown if an error occurs while loading the type. + The following example uses the CLSID of the Microsoft Word [Application object](/office/vba/api/word.application) to retrieve a COM type that represents the Microsoft Word application. It then instantiates the type by calling the method, and closes it by calling the [Application.Quit](/office/vba/api/word.application.quit(method)) method. An exception is thrown if an error occurs while loading the type. [!code-csharp[System.Type.GetTypeFromCLSID#2](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.type.gettypefromclsid/cs/gettypefromclsid_ex2.cs#2)] [!code-vb[System.Type.GetTypeFromCLSID#2](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.type.gettypefromclsid/vb/gettypefromclsid_ex2.vb#2)] @@ -9153,7 +9153,7 @@ Type.GetType("System.Collections.Generic.Dictionary`2[System.String,[MyType,MyAs ## Examples - The following example uses the CLSID of the Microsoft Word [Application object](https://msdn.microsoft.com/vba/word-vba/articles/application-object-word) to retrieve a COM type that represents the Microsoft Word application from a server named computer17.central.contoso.com. It then instantiates the type by calling the method, and closes it by calling the [Application.Quit](https://msdn.microsoft.com/VBA/Word-VBA/articles/application-quit-method-word) method. + The following example uses the CLSID of the Microsoft Word [Application object](/office/vba/api/word.application) to retrieve a COM type that represents the Microsoft Word application from a server named computer17.central.contoso.com. It then instantiates the type by calling the method, and closes it by calling the [Application.Quit](/office/vba/api/word.application.quit(method)) method. [!code-csharp[System.Type.GetTypeFromCLSID#3](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.type.gettypefromclsid/cs/gettypefromclsid_ex3.cs#3)] [!code-vb[System.Type.GetTypeFromCLSID#3](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.type.gettypefromclsid/vb/gettypefromclsid_ex3.vb#3)] @@ -9242,7 +9242,7 @@ Type.GetType("System.Collections.Generic.Dictionary`2[System.String,[MyType,MyAs ## Examples - The following example uses the CLSID of the Microsoft Word [Application object](https://msdn.microsoft.com/vba/word-vba/articles/application-object-word) to retrieve a COM type that represents the Microsoft Word application from a server named computer17.central.contoso.com. It then instantiates the type by calling the method, and closes it by calling the [Application.Quit](https://msdn.microsoft.com/VBA/Word-VBA/articles/application-quit-method-word) method. An exception is thrown if an error occurs while loading the type. + The following example uses the CLSID of the Microsoft Word [Application object](/office/vba/api/word.application) to retrieve a COM type that represents the Microsoft Word application from a server named computer17.central.contoso.com. It then instantiates the type by calling the method, and closes it by calling the [Application.Quit](/office/vba/api/word.application.quit(method)) method. An exception is thrown if an error occurs while loading the type. [!code-csharp[System.Type.GetTypeFromCLSID#4](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.type.gettypefromclsid/cs/gettypefromclsid_ex4.cs#4)] [!code-vb[System.Type.GetTypeFromCLSID#4](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.type.gettypefromclsid/vb/gettypefromclsid_ex4.vb#4)] diff --git a/xml/System/Uri.xml b/xml/System/Uri.xml index d1acf3a3988..62f0393412b 100644 --- a/xml/System/Uri.xml +++ b/xml/System/Uri.xml @@ -241,8 +241,8 @@ Uri baseUri = new Uri(@"\\host\share\some\directory\name\"); - Changes to the System.Uri namespace in Version 2.0 - International Resource Identifier Support in System.UriSystem.Uri + Changes to the System.Uri namespace in Version 2.0 + International Resource Identifier Support in System.UriSystem.Uri Network Programming in the .NET Framework diff --git a/xml/System/WeakReference.xml b/xml/System/WeakReference.xml index 39f991d3b12..d40dda58b2f 100644 --- a/xml/System/WeakReference.xml +++ b/xml/System/WeakReference.xml @@ -75,7 +75,7 @@ ]]> - Weak References + Weak References @@ -221,7 +221,7 @@ - Weak References + Weak References @@ -438,7 +438,7 @@ - Weak References + Weak References @@ -506,7 +506,7 @@ The reference to the target object is invalid. This exception can be thrown while setting this property if the value is a null reference or if the object has been finalized during the set operation. - Weak References + Weak References @@ -556,7 +556,7 @@ ]]> - Weak References + Weak References