diff --git a/xml/System/AppDomainSetup.xml b/xml/System/AppDomainSetup.xml index 29d8c62f572..3cece475cb0 100644 --- a/xml/System/AppDomainSetup.xml +++ b/xml/System/AppDomainSetup.xml @@ -848,7 +848,7 @@ System.Boolean - Gets or sets a value that indicates whether the [<publisherPolicy>](/dotnet/framework/configure-apps/file-schema/runtime/publisherpolicy-element) section of the configuration file is applied to an application domain. + Gets or sets a value that indicates whether the <publisherPolicy> section of the configuration file is applied to an application domain. if the section of the configuration file for an application domain is ignored; if the declared publisher policy is honored. diff --git a/xml/System/Char.xml b/xml/System/Char.xml index da722642abb..bf56a05bfe3 100644 --- a/xml/System/Char.xml +++ b/xml/System/Char.xml @@ -9009,7 +9009,7 @@ This member is an explicit interface member implementation. It can be used only ]]> - As explained in [Best Practices for Using Strings](/dotnet/standard/base-types/best-practices-strings), we recommend that you avoid calling character-casing and string-casing methods that substitute default values. Instead, you should call methods that require parameters to be explicitly specified. To convert a character to lowercase by using the casing conventions of the current culture, call the method overload with a value of for its parameter. + As explained in Best Practices for Using Strings, we recommend that you avoid calling character-casing and string-casing methods that substitute default values. Instead, you should call methods that require parameters to be explicitly specified. To convert a character to lowercase by using the casing conventions of the current culture, call the method overload with a value of for its parameter. @@ -9448,7 +9448,7 @@ This member is an explicit interface member implementation. It can be used only ]]> - As explained in [Best Practices for Using Strings](/dotnet/standard/base-types/best-practices-strings), we recommend that you avoid calling character-casing and string-casing methods that substitute default values. Instead, you should call methods that require parameters to be explicitly specified. To convert a character to uppercase by using the casing conventions of the current culture, call the method overload with a value of for its parameter. + As explained in Best Practices for Using Strings, we recommend that you avoid calling character-casing and string-casing methods that substitute default values. Instead, you should call methods that require parameters to be explicitly specified. To convert a character to uppercase by using the casing conventions of the current culture, call the method overload with a value of for its parameter. diff --git a/xml/System/Console.xml b/xml/System/Console.xml index 726489e7bf2..c218f978993 100644 --- a/xml/System/Console.xml +++ b/xml/System/Console.xml @@ -5377,7 +5377,7 @@ This method can be used to reacquire the standard output stream after it has bee or is . The format specification in is invalid. - This method is not called by C++ code. The C++ compiler resolves calls to [System.Console.Write](xref:System.Console.Write*) that include a string and a list of four or more object parameters as a call to . It resolves calls to [System.Console.Write](xref:System.Console.Write*) that include a string and an object array as a call to . + This method is not called by C++ code. The C++ compiler resolves calls to System.Console.Write that include a string and a list of four or more object parameters as a call to . It resolves calls to System.Console.Write that include a string and an object array as a call to . @@ -6946,7 +6946,7 @@ This method can be used to reacquire the standard output stream after it has bee or is . The format specification in is invalid. - This method is not called by C++ code. The C++ compiler resolves calls to [System.Console.WriteLine](xref:System.Console.WriteLine*) that include a string and a list of four or more object parameters as a call to . It resolves calls to [System.Console.WriteLine](xref:System.Console.WriteLine*) that include a string and an object array as a call to . + This method is not called by C++ code. The C++ compiler resolves calls to System.Console.WriteLine that include a string and a list of four or more object parameters as a call to . It resolves calls to System.Console.WriteLine that include a string and an object array as a call to . diff --git a/xml/System/DateTime.xml b/xml/System/DateTime.xml index 8932d765742..862ea1b696e 100644 --- a/xml/System/DateTime.xml +++ b/xml/System/DateTime.xml @@ -5729,7 +5729,7 @@ You can also download a complete set of `DateTime.Parse` examples, which are inc - A string that contains a date and time to convert. See [The string to parse](#StringToParse) for more information. + A string that contains a date and time to convert. See The string to parse for more information. Converts the string representation of a date and time to its equivalent by using the conventions of the current culture. An object that is equivalent to the date and time contained in . @@ -5884,8 +5884,8 @@ It handles the exception that is thrown when the m - A string that contains a date and time to convert. See [The string to parse](#StringToParse) for more information. - An object that supplies culture-specific format information about . See [Parsing and cultural conventions](#Culture) + A string that contains a date and time to convert. See The string to parse for more information. + An object that supplies culture-specific format information about . See Parsing and cultural conventions Converts the string representation of a date and time to its equivalent by using culture-specific format information. An object that is equivalent to the date and time contained in as specified by . @@ -5966,8 +5966,8 @@ The following example parses an array of date strings by using the conventions o - The memory span that contains the string to parse. See [The string to parse](#StringToParse) for more information. - An object that supplies culture-specific format information about . See [Parsing and cultural conventions](#Culture) + The memory span that contains the string to parse. See The string to parse for more information. + An object that supplies culture-specific format information about . See Parsing and cultural conventions A bitwise combination of the enumeration values that indicates the style elements that can be present in for the parse operation to succeed, and that defines how to interpret the parsed date in relation to the current time zone or the current date. A typical value to specify is . Converts a memory span that contains string representation of a date and time to its equivalent by using culture-specific format information and a formatting style. An object that is equivalent to the date and time contained in , as specified by and . @@ -6036,8 +6036,8 @@ The following example parses an array of date strings by using the conventions o - A string that contains a date and time to convert. See [The string to parse](#StringToParse) for more information. - An object that supplies culture-specific formatting information about . See [Parsing and cultural conventions](#Culture) + A string that contains a date and time to convert. See The string to parse for more information. + An object that supplies culture-specific formatting information about . See Parsing and cultural conventions A bitwise combination of the enumeration values that indicates the style elements that can be present in for the parse operation to succeed, and that defines how to interpret the parsed date in relation to the current time zone or the current date. A typical value to specify is . Converts the string representation of a date and time to its equivalent by using culture-specific format information and a formatting style. An object that is equivalent to the date and time contained in , as specified by and . diff --git a/xml/System/Delegate.xml b/xml/System/Delegate.xml index 1bee377ba17..be3f501f069 100644 --- a/xml/System/Delegate.xml +++ b/xml/System/Delegate.xml @@ -292,7 +292,7 @@ For examples, see [Supplemental API remarks for System.Delegate.CreateDelegate]( is . - is not a . See [Runtime Types in Reflection](/previous-versions/dotnet/netframework-4.0/ms172329(v=vs.100)). + is not a . See Runtime Types in Reflection). -or- @@ -731,7 +731,7 @@ For more information about this API, see [Supplemental API remarks for System.De -or- - is not a . See [Runtime Types in Reflection](/previous-versions/dotnet/netframework-4.0/ms172329(v=vs.100)). + is not a . See Runtime Types in Reflection). -or- @@ -739,7 +739,7 @@ For more information about this API, see [Supplemental API remarks for System.De -or- - is not a . See [Runtime Types in Reflection](/previous-versions/dotnet/netframework-4.0/ms172329(v=vs.100)). + is not a . See Runtime Types in Reflection). The method of is not found. The caller does not have the permissions necessary to access . @@ -825,7 +825,7 @@ For more information about this API, see [Supplemental API remarks for System.De -or- - is not a . See [Runtime Types in Reflection](/previous-versions/dotnet/netframework-4.0/ms172329(v=vs.100)). + is not a . See Runtime Types in Reflection). -or- @@ -833,7 +833,7 @@ For more information about this API, see [Supplemental API remarks for System.De -or- - is not a . See [Runtime Types in Reflection](/previous-versions/dotnet/netframework-4.0/ms172329(v=vs.100)). + is not a . See Runtime Types in Reflection). The method of is not found. The caller does not have the permissions necessary to access . @@ -918,7 +918,7 @@ For more information about this API, see [Supplemental API remarks for System.De -or- - is not a . See [Runtime Types in Reflection](/previous-versions/dotnet/netframework-4.0/ms172329(v=vs.100)). + is not a . See Runtime Types in Reflection). -or- @@ -1011,7 +1011,7 @@ For examples, see [Supplemental API remarks for System.Delegate.CreateDelegate]( -or- - is not a . See [Runtime Types in Reflection](/previous-versions/dotnet/netframework-4.0/ms172329(v=vs.100)). + is not a . See Runtime Types in Reflection). -or- @@ -1019,7 +1019,7 @@ For examples, see [Supplemental API remarks for System.Delegate.CreateDelegate]( -or- - is not a . See [Runtime Types in Reflection](/previous-versions/dotnet/netframework-4.0/ms172329(v=vs.100)). + is not a . See Runtime Types in Reflection). The method of is not found. The caller does not have the permissions necessary to access . @@ -1111,7 +1111,7 @@ For examples, see [Supplemental API remarks for System.Delegate.CreateDelegate]( -or- - is not a . See [Runtime Types in Reflection](/previous-versions/dotnet/netframework-4.0/ms172329(v=vs.100)). + is not a . See Runtime Types in Reflection). -or- @@ -1217,7 +1217,7 @@ For more information and examples, see [Supplemental API remarks for System.Dele -or- - is not a . See [Runtime Types in Reflection](/previous-versions/dotnet/netframework-4.0/ms172329(v=vs.100)). + is not a . See Runtime Types in Reflection). -or- @@ -1225,7 +1225,7 @@ For more information and examples, see [Supplemental API remarks for System.Dele -or- - is not a . See [Runtime Types in Reflection](/previous-versions/dotnet/netframework-4.0/ms172329(v=vs.100)). + is not a . See Runtime Types in Reflection). The method of is not found. The caller does not have the permissions necessary to access . @@ -1312,7 +1312,7 @@ For more information and examples, see [Supplemental API remarks for System.Dele -or- - is not a . See [Runtime Types in Reflection](/previous-versions/dotnet/netframework-4.0/ms172329(v=vs.100)). + is not a . See Runtime Types in Reflection). -or- @@ -1413,7 +1413,7 @@ For more information and examples, see [Supplemental API remarks for System.Dele -or- - is not a . See [Runtime Types in Reflection](/previous-versions/dotnet/netframework-4.0/ms172329(v=vs.100)). + is not a . See Runtime Types in Reflection). -or- @@ -1521,7 +1521,7 @@ For more information and examples, see [Supplemental API remarks for System.Dele -or- - is not a . See [Runtime Types in Reflection](/previous-versions/dotnet/netframework-4.0/ms172329(v=vs.100)). + is not a . See Runtime Types in Reflection). -or- @@ -1628,7 +1628,7 @@ For more information and examples, see [Supplemental API remarks for System.Dele -or- - is not a . See [Runtime Types in Reflection](/previous-versions/dotnet/netframework-4.0/ms172329(v=vs.100)). + is not a . See Runtime Types in Reflection). -or- diff --git a/xml/System/GC.xml b/xml/System/GC.xml index 574b7665a0a..d859dfcfff6 100644 --- a/xml/System/GC.xml +++ b/xml/System/GC.xml @@ -326,7 +326,7 @@ Skipping zero-initialization using this API only has a material performance bene ]]> - This member is not available when concurrent garbage collection is enabled. See the [<gcConcurrent>](/dotnet/framework/configure-apps/file-schema/runtime/gcconcurrent-element) runtime setting for information about how to disable concurrent garbage collection. + This member is not available when concurrent garbage collection is enabled. See the <gcConcurrent> runtime setting for information about how to disable concurrent garbage collection. Garbage Collection Notifications @@ -1958,7 +1958,7 @@ If `obj` does not have a finalizer or the GC has already signaled the finalizer - The amount of memory in bytes to allocate without triggering a garbage collection. It must be less than or equal to the size of an ephemeral segment. For information on the size of an ephemeral segment, see the "Ephemeral generations and segments" section in the [Fundamentals of Garbage Collection](/dotnet/standard/garbage-collection/fundamentals) article. + The amount of memory in bytes to allocate without triggering a garbage collection. It must be less than or equal to the size of an ephemeral segment. For information on the size of an ephemeral segment, see the "Ephemeral generations and segments" section in the Fundamentals of Garbage Collection article. Attempts to disallow garbage collection during the execution of a critical path if a specified amount of memory is available. if the runtime was able to commit the required amount of memory and the garbage collector is able to enter no GC region latency mode; otherwise, . @@ -2028,7 +2028,7 @@ If `obj` does not have a finalizer or the GC has already signaled the finalizer - The amount of memory in bytes to allocate without triggering a garbage collection. It must be less than or equal to the size of an ephemeral segment. For information on the size of an ephemeral segment, see the "Ephemeral generations and segments" section in the [Fundamentals of Garbage Collection](/dotnet/standard/garbage-collection/fundamentals) article. + The amount of memory in bytes to allocate without triggering a garbage collection. It must be less than or equal to the size of an ephemeral segment. For information on the size of an ephemeral segment, see the "Ephemeral generations and segments" section in the Fundamentals of Garbage Collection article. to omit a full blocking garbage collection if the garbage collector is initially unable to allocate bytes; otherwise, . Attempts to disallow garbage collection during the execution of a critical path if a specified amount of memory is available, and controls whether the garbage collector does a full blocking garbage collection if not enough memory is initially available. @@ -2102,7 +2102,7 @@ If `obj` does not have a finalizer or the GC has already signaled the finalizer - The amount of memory in bytes to allocate without triggering a garbage collection. - must be less than or equal to the size of an ephemeral segment. For information on the size of an ephemeral segment, see the "Ephemeral generations and segments" section in the [Fundamentals of Garbage Collection](/dotnet/standard/garbage-collection/fundamentals) article. + The amount of memory in bytes to allocate without triggering a garbage collection. - must be less than or equal to the size of an ephemeral segment. For information on the size of an ephemeral segment, see the "Ephemeral generations and segments" section in the Fundamentals of Garbage Collection article. The number of bytes in to use for large object heap (LOH) allocations. Attempts to disallow garbage collection during the execution of a critical path if a specified amount of memory is available for the large object heap and the small object heap. @@ -2174,7 +2174,7 @@ If `obj` does not have a finalizer or the GC has already signaled the finalizer - The amount of memory in bytes to allocate without triggering a garbage collection. - must be less than or equal to the size of an ephemeral segment. For information on the size of an ephemeral segment, see the "Ephemeral generations and segments" section in the [Fundamentals of Garbage Collection](/dotnet/standard/garbage-collection/fundamentals) article. + The amount of memory in bytes to allocate without triggering a garbage collection. - must be less than or equal to the size of an ephemeral segment. For information on the size of an ephemeral segment, see the "Ephemeral generations and segments" section in the Fundamentals of Garbage Collection article. The number of bytes in to use for large object heap (LOH) allocations. to omit a full blocking garbage collection if the garbage collector is initially unable to allocate the specified memory on the small object heap (SOH) and LOH; otherwise, . diff --git a/xml/System/GCMemoryInfo.xml b/xml/System/GCMemoryInfo.xml index 5e760339101..c3409a6717c 100644 --- a/xml/System/GCMemoryInfo.xml +++ b/xml/System/GCMemoryInfo.xml @@ -148,11 +148,11 @@ A garbage collection (GC) is identified by its , For example, the application has the following five objects: `| OBJ_A | OBJ_B | OBJ_C | OBJ_D | OBJ_E |` - + If `OBJ_B`, `OBJ_C`, and `OBJ_E` are garbage collected but the heap is not compacted, the resulting heap will look like the following: `| OBJ_A | F | OBJ_D |` - + The memory between `OBJ_A` and `OBJ_D`, which is marked `F`, is considered part of the `FragmentedBytes` and is used to allocate new objects. The memory after `OBJ_D` is not considered part of the `FragmentedBytes` but is also used to allocate new objects. @@ -316,7 +316,7 @@ The memory after `OBJ_D` is not considered part of the `FragmentedBytes` but is Gets the physical memory load when the last garbage collection occurred. The physical memory load, in bytes, when the last garbage collection occurred. - On Windows, memory load is a field in the [MEMORYSTATUS structure](/windows/win32/api/winbase/ns-winbase-memorystatus). It's a number between 0 and 100 that specifies the approximate percentage of physical memory that's in use (0 indicates no memory use and 100 indicates full memory use). Corresponding information is given on other operating systems. + On Windows, memory load is a field in the MEMORYSTATUS structure. It's a number between 0 and 100 that specifies the approximate percentage of physical memory that's in use (0 indicates no memory use and 100 indicates full memory use). Corresponding information is given on other operating systems. Data is only brought into physical memory on first touch. If you allocated a big object but haven't actually used it, most of its memory isn't in physical memory. In this case, the allocation won't affect the memory load significantly. @@ -343,7 +343,7 @@ The memory after `OBJ_D` is not considered part of the `FragmentedBytes` but is Gets the durations of the pauses when all managed threads are suspended. A timespan representing the pause durations. - For blocking GCs, there is one pause. Pauses for background GC are illustrated at [Background workstation vs. server GC](/dotnet/standard/garbage-collection/background-gc#background-workstation-vs-server-gc). + For blocking GCs, there is one pause. Pauses for background GC are illustrated at Background workstation vs. server GC. diff --git a/xml/System/IAsyncResult.xml b/xml/System/IAsyncResult.xml index 2d915e3c918..42539a02208 100644 --- a/xml/System/IAsyncResult.xml +++ b/xml/System/IAsyncResult.xml @@ -56,34 +56,34 @@ Represents the status of an asynchronous operation. - interface is implemented by classes containing methods that can operate asynchronously. It is the return type of methods that initiate an asynchronous operation, such as , and it is passed to methods that conclude an asynchronous operation, such as . objects are also passed to methods invoked by delegates when an asynchronous operation completes. - - An object that supports the interface stores state information for an asynchronous operation and provides a synchronization object to allow threads to be signaled when the operation completes. - + interface is implemented by classes containing methods that can operate asynchronously. It is the return type of methods that initiate an asynchronous operation, such as , and it is passed to methods that conclude an asynchronous operation, such as . objects are also passed to methods invoked by delegates when an asynchronous operation completes. + + An object that supports the interface stores state information for an asynchronous operation and provides a synchronization object to allow threads to be signaled when the operation completes. + > [!NOTE] -> The class is the implementation of that is returned by the `BeginInvoke` method when you use a delegate to call a method asynchronously. - - For a detailed description of how the interface is used, see the [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously) topic. - - - -## Examples - The following example demonstrates how to use the property to get a , and how to wait for an asynchronous call on a delegate. The is signaled when the asynchronous call completes, and you can wait for it by calling the method. - - The example consists of two classes: the class that contains the method that is called asynchronously, and the class that contains the `Main` method that makes the call. - - For more information and more examples of calling methods asynchronously by using delegates, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously). - +> The class is the implementation of that is returned by the `BeginInvoke` method when you use a delegate to call a method asynchronously. + + For a detailed description of how the interface is used, see the [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously) topic. + + + +## Examples + The following example demonstrates how to use the property to get a , and how to wait for an asynchronous call on a delegate. The is signaled when the asynchronous call completes, and you can wait for it by calling the method. + + The example consists of two classes: the class that contains the method that is called asynchronously, and the class that contains the `Main` method that makes the call. + + For more information and more examples of calling methods asynchronously by using delegates, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously). + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/AsyncDelegateExamples/cpp/TestMethod.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System/IAsyncResult/Overview/TestMethod.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/TestMethod.vb" id="Snippet1"::: + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/TestMethod.vb" id="Snippet1"::: :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/AsyncDelegateExamples/cpp/waithandle.cpp" id="Snippet3"::: :::code language="csharp" source="~/snippets/csharp/System/IAsyncResult/Overview/waithandle.cs" id="Snippet3"::: -:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/WaitHandle.vb" id="Snippet3"::: - +:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/WaitHandle.vb" id="Snippet3"::: + ]]> @@ -141,27 +141,27 @@ Gets a user-defined object that qualifies or contains information about an asynchronous operation. A user-defined object that qualifies or contains information about an asynchronous operation. - property is used to pass information to a callback method. The last parameter of the `BeginInvoke` method call is a format string, which the callback method uses to format an output message. - - The example consists of two classes: the class that contains the method that is called asynchronously, and the class that contains the `Main` method that makes the call. - - For more information about how this callback example works, and more examples of calling methods asynchronously by using delegates, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously). - + property is used to pass information to a callback method. The last parameter of the `BeginInvoke` method call is a format string, which the callback method uses to format an output message. + + The example consists of two classes: the class that contains the method that is called asynchronously, and the class that contains the `Main` method that makes the call. + + For more information about how this callback example works, and more examples of calling methods asynchronously by using delegates, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously). + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/AsyncDelegateExamples/cpp/TestMethod.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System/IAsyncResult/Overview/TestMethod.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/TestMethod.vb" id="Snippet1"::: + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/TestMethod.vb" id="Snippet1"::: :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/AsyncDelegateExamples/cpp/callback.cpp" id="Snippet5"::: :::code language="csharp" source="~/snippets/csharp/System/IAsyncResult/Overview/callback.cs" id="Snippet5"::: -:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/callback.vb" id="Snippet5"::: - +:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/callback.vb" id="Snippet5"::: + ]]> @@ -215,29 +215,29 @@ Gets a that is used to wait for an asynchronous operation to complete. A that is used to wait for an asynchronous operation to complete. - until the operation concludes. The return value can be used to perform a , , or operation. - - The common language runtime supplies a number of waitable objects, such as , , and , all of which mirror Win32 synchronization primitives. - - - -## Examples - The following example demonstrates how to use the property to get a , and how to wait for an asynchronous call on a delegate. The is signaled when the asynchronous call completes, and you can wait for it by calling the method. - - The example consists of two classes: the class that contains the method that is called asynchronously, and the class that contains the `Main` method that makes the call. - - For more information and more examples of calling methods asynchronously by using delegates, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously). - + until the operation concludes. The return value can be used to perform a , , or operation. + + The common language runtime supplies a number of waitable objects, such as , , and , all of which mirror Win32 synchronization primitives. + + + +## Examples + The following example demonstrates how to use the property to get a , and how to wait for an asynchronous call on a delegate. The is signaled when the asynchronous call completes, and you can wait for it by calling the method. + + The example consists of two classes: the class that contains the method that is called asynchronously, and the class that contains the `Main` method that makes the call. + + For more information and more examples of calling methods asynchronously by using delegates, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously). + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/AsyncDelegateExamples/cpp/TestMethod.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System/IAsyncResult/Overview/TestMethod.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/TestMethod.vb" id="Snippet1"::: + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/TestMethod.vb" id="Snippet1"::: :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/AsyncDelegateExamples/cpp/waithandle.cpp" id="Snippet3"::: :::code language="csharp" source="~/snippets/csharp/System/IAsyncResult/Overview/waithandle.cs" id="Snippet3"::: -:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/WaitHandle.vb" id="Snippet3"::: - +:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/WaitHandle.vb" id="Snippet3"::: + ]]> @@ -292,15 +292,15 @@ if the asynchronous operation completed synchronously; otherwise, . - delegate, it is probable that the thread that initiated the asynchronous operation is the current thread. - + delegate, it is probable that the thread that initiated the asynchronous operation is the current thread. + ]]> - Most implementers of the interface will not use this property and should return . Beginning with the .NET Framework 4.5, a task that is created with the method will not complete if this property is not implemented correctly. See [Application Compatibility in 4.5](/dotnet/framework/migration-guide/application-compatibility-in-the-net-framework-4-5). + Most implementers of the interface will not use this property and should return . Beginning with the .NET Framework 4.5, a task that is created with the method will not complete if this property is not implemented correctly. See Application Compatibility in 4.5. Use this property to determine if the asynchronous operation completed synchronously. For example, this property can return for an asynchronous I/O operation if the I/O request was small. @@ -350,27 +350,27 @@ if the operation is complete; otherwise, . - property of the to discover when an asynchronous call completes. In this case, the asynchronous call is made by using the `BeginInvoke` method of a delegate. You might use the property to poll for completion when making the asynchronous call from a thread that services the user interface. Polling for completion allows the calling thread to continue executing while the asynchronous call executes on a thread. - - The example consists of two classes: the class that contains the method that is called asynchronously, and the class that contains the `Main` method that makes the call. - - For more information and more examples of calling methods asynchronously by using delegates, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously). - + property of the to discover when an asynchronous call completes. In this case, the asynchronous call is made by using the `BeginInvoke` method of a delegate. You might use the property to poll for completion when making the asynchronous call from a thread that services the user interface. Polling for completion allows the calling thread to continue executing while the asynchronous call executes on a thread. + + The example consists of two classes: the class that contains the method that is called asynchronously, and the class that contains the `Main` method that makes the call. + + For more information and more examples of calling methods asynchronously by using delegates, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously). + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/AsyncDelegateExamples/cpp/TestMethod.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System/IAsyncResult/Overview/TestMethod.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/TestMethod.vb" id="Snippet1"::: + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/TestMethod.vb" id="Snippet1"::: :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/AsyncDelegateExamples/cpp/polling.cpp" id="Snippet4"::: :::code language="csharp" source="~/snippets/csharp/System/IAsyncResult/Overview/polling.cs" id="Snippet4"::: -:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/polling.vb" id="Snippet4"::: - +:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/polling.vb" id="Snippet4"::: + ]]> diff --git a/xml/System/IFormattable.xml b/xml/System/IFormattable.xml index 0b11a567cfd..c189c2825e3 100644 --- a/xml/System/IFormattable.xml +++ b/xml/System/IFormattable.xml @@ -56,58 +56,58 @@ Provides functionality to format the value of an object into a string representation. - interface converts an object to its string representation based on a format string and a format provider. - - A format string typically defines the general appearance of an object. For example, the .NET Framework supports the following: - -- Standard format strings for formatting enumeration values (see [Enumeration Format Strings](/dotnet/standard/base-types/enumeration-format-strings)). - -- Standard and custom format strings for formatting numeric values (see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings) and [Custom Numeric Format Strings](/dotnet/standard/base-types/custom-numeric-format-strings)). - -- Standard and custom format strings for formatting date and time values (see [Standard Date and Time Format Strings](/dotnet/standard/base-types/standard-date-and-time-format-strings) and [Custom Date and Time Format Strings](/dotnet/standard/base-types/custom-date-and-time-format-strings)). - -- Standard and custom format strings for formatting time intervals (see [Standard TimeSpan Format Strings](/dotnet/standard/base-types/standard-timespan-format-strings) and [Custom TimeSpan Format Strings](/dotnet/standard/base-types/custom-timespan-format-strings)). - - You can also define your own format strings to support formatting of your application-defined types. - - A format provider returns a formatting object that typically defines the symbols used in converting an object to its string representation. For example, when you convert a number to a currency value, a format provider defines the currency symbol that appears in the result string. The .NET Framework defines three format providers: - -- The class, which returns either a object for formatting numeric values, or a object for formatting date and time values. - -- The class, which returns an instance of itself for formatting numeric values. - -- The class, which returns an instance of itself for formatting date and time values. - - In addition, you can define your own custom format providers to supply culture-specific, profession-specific, or industry-specific information used in formatting. For more information about implementing custom formatting by using a custom format provider, see . - - The interface defines a single method, , that supplies formatting services for the implementing type. The method can be called directly. In addition, it is called automatically by the and methods, and by methods that use the [composite formatting feature](/dotnet/standard/base-types/composite-formatting) in the .NET Framework. Such methods include , , and , among others. The method is called for each format item in the method's format string. - - The interface is implemented by the base data types. - - - -## Examples - The following example defines a `Temperature` class that implements the interface. The class supports four format specifiers: "G" and "C", which indicate that the temperature is to be displayed in Celsius; "F", which indicates that the temperature is to be displayed in Fahrenheit; and "K", which indicates that the temperature is to be displayed in Kelvin. In addition, the implementation also can handle a format string that is `null` or empty. The other two `ToString` methods defined by the `Temperature` class simply wrap a call to the implementation. - + interface converts an object to its string representation based on a format string and a format provider. + + A format string typically defines the general appearance of an object. For example, the .NET Framework supports the following: + +- Standard format strings for formatting enumeration values (see [Enumeration Format Strings](/dotnet/standard/base-types/enumeration-format-strings)). + +- Standard and custom format strings for formatting numeric values (see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings) and [Custom Numeric Format Strings](/dotnet/standard/base-types/custom-numeric-format-strings)). + +- Standard and custom format strings for formatting date and time values (see [Standard Date and Time Format Strings](/dotnet/standard/base-types/standard-date-and-time-format-strings) and [Custom Date and Time Format Strings](/dotnet/standard/base-types/custom-date-and-time-format-strings)). + +- Standard and custom format strings for formatting time intervals (see [Standard TimeSpan Format Strings](/dotnet/standard/base-types/standard-timespan-format-strings) and [Custom TimeSpan Format Strings](/dotnet/standard/base-types/custom-timespan-format-strings)). + + You can also define your own format strings to support formatting of your application-defined types. + + A format provider returns a formatting object that typically defines the symbols used in converting an object to its string representation. For example, when you convert a number to a currency value, a format provider defines the currency symbol that appears in the result string. The .NET Framework defines three format providers: + +- The class, which returns either a object for formatting numeric values, or a object for formatting date and time values. + +- The class, which returns an instance of itself for formatting numeric values. + +- The class, which returns an instance of itself for formatting date and time values. + + In addition, you can define your own custom format providers to supply culture-specific, profession-specific, or industry-specific information used in formatting. For more information about implementing custom formatting by using a custom format provider, see . + + The interface defines a single method, , that supplies formatting services for the implementing type. The method can be called directly. In addition, it is called automatically by the and methods, and by methods that use the [composite formatting feature](/dotnet/standard/base-types/composite-formatting) in the .NET Framework. Such methods include , , and , among others. The method is called for each format item in the method's format string. + + The interface is implemented by the base data types. + + + +## Examples + The following example defines a `Temperature` class that implements the interface. The class supports four format specifiers: "G" and "C", which indicate that the temperature is to be displayed in Celsius; "F", which indicates that the temperature is to be displayed in Fahrenheit; and "K", which indicates that the temperature is to be displayed in Kelvin. In addition, the implementation also can handle a format string that is `null` or empty. The other two `ToString` methods defined by the `Temperature` class simply wrap a call to the implementation. + :::code language="csharp" source="~/snippets/csharp/System/IFormattable/Overview/example1.cs" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System/IFormattable/Overview/example1.fs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.iformattable/vb/example1.vb" id="Snippet1"::: - - The following example then calls the implementation either directly or by using a composite format string. - + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.iformattable/vb/example1.vb" id="Snippet1"::: + + The following example then calls the implementation either directly or by using a composite format string. + :::code language="csharp" source="~/snippets/csharp/System/IFormattable/Overview/example1.cs" id="Snippet2"::: :::code language="fsharp" source="~/snippets/fsharp/System/IFormattable/Overview/example1.fs" id="Snippet2"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.iformattable/vb/example1.vb" id="Snippet2"::: - + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.iformattable/vb/example1.vb" id="Snippet2"::: + ]]> - Classes that require more control over the formatting of strings than provides should implement . - - A class that implements must support the "G" (general) format specifier. Besides the "G" specifier, the class can define the list of format specifiers that it supports. In addition, the class must be prepared to handle a format specifier that is . For more information about formatting and formatting codes, see [Formatting Types](/dotnet/standard/base-types/formatting-types) + Classes that require more control over the formatting of strings than provides should implement . + + A class that implements must support the "G" (general) format specifier. Besides the "G" specifier, the class can define the list of format specifiers that it supports. In addition, the class must be prepared to handle a format specifier that is . For more information about formatting and formatting codes, see Formatting Types @@ -159,60 +159,60 @@ - The format to use. - - -or- - + The format to use. + + -or- + A null reference ( in Visual Basic) to use the default format defined for the type of the implementation. - The provider to use to format the value. - - -or- - + The provider to use to format the value. + + -or- + A null reference ( in Visual Basic) to obtain the numeric format information from the current locale setting of the operating system. Formats the value of the current instance using the specified format. The value of the current instance in the specified format. - method converts a value to a string representation that can be expressed in multiple ways. Its precise format depends on specific symbols or a specified order defined by specific cultures, professions, or industries. You can call the method directly. It is also called automatically by the and methods, and by methods that use the composite formatting feature in the .NET Framework, such as , , and . (For more information, see [Composite Formatting](/dotnet/standard/base-types/composite-formatting).) - - Composite formatting methods call the method once for each format item in a format string. The parameters passed to the method depend on the specific formatting method that is called and on the content of the format item, as follows: - -- If the format item does not include a format string (for example, if the format item is simply `{0}`), it is passed `null` as the value of the parameter. - -- If the format item includes a format string (for example, `{0:G}`), that format string is passed as the value of the parameter. - -- If the original method call does not include an parameter, is passed as the value of the parameter. - -- If the original method call includes an parameter, the provider that is supplied in the method call is passed as the value of the parameter. - + method converts a value to a string representation that can be expressed in multiple ways. Its precise format depends on specific symbols or a specified order defined by specific cultures, professions, or industries. You can call the method directly. It is also called automatically by the and methods, and by methods that use the composite formatting feature in the .NET Framework, such as , , and . (For more information, see [Composite Formatting](/dotnet/standard/base-types/composite-formatting).) + + Composite formatting methods call the method once for each format item in a format string. The parameters passed to the method depend on the specific formatting method that is called and on the content of the format item, as follows: + +- If the format item does not include a format string (for example, if the format item is simply `{0}`), it is passed `null` as the value of the parameter. + +- If the format item includes a format string (for example, `{0:G}`), that format string is passed as the value of the parameter. + +- If the original method call does not include an parameter, is passed as the value of the parameter. + +- If the original method call includes an parameter, the provider that is supplied in the method call is passed as the value of the parameter. + > [!NOTE] -> An object's implementation is called by composite formatting methods only if they are not passed an format provider, or if the method of the custom format provider returns `null`. - - The .NET Framework includes three format providers, all of which implement the interface: - -- supplies numeric formatting information, such as the characters to use for decimal and group separators, and the spelling and placement of currency symbols in monetary values. - -- supplies date-related and time-related formatting information, such as the position of the month, the day, and the year in a date pattern. - -- contains the default formatting information in a specific culture, including the numeric format information, and date-related and time-related formatting information. - - In addition, you can define your own custom format provider. - - - -## Examples - The following example demonstrates a `Temperature` class that implements the method. This code example is part of a larger example provided for the class. - +> An object's implementation is called by composite formatting methods only if they are not passed an format provider, or if the method of the custom format provider returns `null`. + + The .NET Framework includes three format providers, all of which implement the interface: + +- supplies numeric formatting information, such as the characters to use for decimal and group separators, and the spelling and placement of currency symbols in monetary values. + +- supplies date-related and time-related formatting information, such as the position of the month, the day, and the year in a date pattern. + +- contains the default formatting information in a specific culture, including the numeric format information, and date-related and time-related formatting information. + + In addition, you can define your own custom format provider. + + + +## Examples + The following example demonstrates a `Temperature` class that implements the method. This code example is part of a larger example provided for the class. + :::code language="csharp" source="~/snippets/csharp/System/IFormattable/Overview/example1.cs" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System/IFormattable/Overview/example1.fs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.iformattable/vb/example1.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.iformattable/vb/example1.vb" id="Snippet1"::: + ]]> - The method must support the "G" (general) format specifier. Besides the "G" specifier, the class can define the list of format specifiers that it supports. In addition, the class must be prepared to handle a format specifier that is . For more information about formatting and formatting codes, see [Formatting Types](/dotnet/standard/base-types/formatting-types). + The method must support the "G" (general) format specifier. Besides the "G" specifier, the class can define the list of format specifiers that it supports. In addition, the class must be prepared to handle a format specifier that is . For more information about formatting and formatting codes, see Formatting Types. diff --git a/xml/System/Object.xml b/xml/System/Object.xml index 2aace726a4a..28adbcaed81 100644 --- a/xml/System/Object.xml +++ b/xml/System/Object.xml @@ -422,7 +422,7 @@ For an additional example that overrides the me - If two objects compare as equal, the method for each object must return the same value. However, if two objects do not compare as equal, the methods for the two objects do not have to return different values. -- The method for an object must consistently return the same hash code as long as there is no modification to the object state that determines the return value of the object's [System.Object.Equals](xref:System.Object.Equals*) method. Note that this is true only for the current execution of an application, and that a different hash code can be returned if the application is run again. +- The method for an object must consistently return the same hash code as long as there is no modification to the object state that determines the return value of the object's System.Object.Equals method. Note that this is true only for the current execution of an application, and that a different hash code can be returned if the application is run again. - For the best performance, a hash function should generate an even distribution for all input, including input that is heavily clustered. An implication is that small modifications to object state should result in large modifications to the resulting hash code for best hash table performance. diff --git a/xml/System/String.xml b/xml/System/String.xml index c3eed2639ef..90a84fda696 100644 --- a/xml/System/String.xml +++ b/xml/System/String.xml @@ -4704,7 +4704,7 @@ The following example defines a `StripEndTags` method that uses the is . - As explained in [Best Practices for Using Strings](/dotnet/standard/base-types/best-practices-strings), we recommend that you avoid calling string comparison methods that substitute default values and instead call methods that require parameters to be explicitly specified. To determine whether a string ends with a particular substring by using the string comparison rules of the current culture, signal your intention explicitly by calling the method overload with a value of for its parameter. If you don't need linguistic-aware comparison, consider using . + As explained in Best Practices for Using Strings, we recommend that you avoid calling string comparison methods that substitute default values and instead call methods that require parameters to be explicitly specified. To determine whether a string ends with a particular substring by using the string comparison rules of the current culture, signal your intention explicitly by calling the method overload with a value of for its parameter. If you don't need linguistic-aware comparison, consider using . @@ -5348,7 +5348,7 @@ The following example compares three sets of strings by using each member of the Converts the value of objects to strings based on the formats specified and inserts them into another string. -If you are new to the `String.Format` method, see [Get started with the String.Format method](/dotnet/fundamentals/runtime-libraries/system-string-format#get-started-with-the-stringformat-method) for a quick overview. +If you are new to the `String.Format` method, see Get started with the String.Format method for a quick overview. For more information about this API, see Supplemental API remarks for String.Format. Formatting Types in .NET Composite Formatting @@ -5417,7 +5417,7 @@ If you are new to the `String.Format` method, see [Get started with the String.F - A [composite format string](/dotnet/standard/base-types/composite-formatting). + A composite format string. The object to format. Replaces one or more format items in a string with the string representation of a specified object. A copy of in which any format items are replaced by the string representation of . @@ -5523,7 +5523,7 @@ The index of a format item is not zero. - A [composite format string](/dotnet/standard/base-types/composite-formatting). + A composite format string. An object array that contains zero or more objects to format. Replaces the format item in a specified string with the string representation of a corresponding object in a specified array. A copy of in which the format items have been replaced by the string representation of the corresponding objects in . @@ -5693,7 +5693,7 @@ The index of a format item is less than zero, or greater than or equal to the le An object that supplies culture-specific formatting information. - A [composite format string](/dotnet/standard/base-types/composite-formatting). + A composite format string. The object to format. Replaces the format item or items in a specified string with the string representation of the corresponding object. A parameter supplies culture-specific formatting information. A copy of in which the format item or items have been replaced by the string representation of . @@ -5797,7 +5797,7 @@ The index of a format item is not zero. An object that supplies culture-specific formatting information. - A [composite format string](/dotnet/standard/base-types/composite-formatting). + A composite format string. An object array that contains zero or more objects to format. Replaces the format items in a string with the string representations of corresponding objects in a specified array. A parameter supplies culture-specific formatting information. A copy of in which the format items have been replaced by the string representation of the corresponding objects in . @@ -6095,7 +6095,7 @@ The index of a format item is less than zero, or greater than or equal to the le - A [composite format string](/dotnet/standard/base-types/composite-formatting). + A composite format string. The first object to format. The second object to format. Replaces the format items in a string with the string representation of two specified objects. @@ -6201,7 +6201,7 @@ The index of a format item is not zero or one. An object that supplies culture-specific formatting information. - A [composite format string](/dotnet/standard/base-types/composite-formatting). + A composite format string. The first object to format. The second object to format. Replaces the format items in a string with the string representation of two specified objects. A parameter supplies culture-specific formatting information. @@ -6290,7 +6290,7 @@ The index of a format item is not zero or one. - A [composite format string](/dotnet/standard/base-types/composite-formatting). + A composite format string. The first object to format. The second object to format. The third object to format. @@ -6391,7 +6391,7 @@ The index of a format item is less than zero, or greater than two. An object that supplies culture-specific formatting information. - A [composite format string](/dotnet/standard/base-types/composite-formatting). + A composite format string. The first object to format. The second object to format. The third object to format. @@ -7222,7 +7222,7 @@ The following example uses the method to determi is . - As explained in [Best Practices for Using Strings](/dotnet/standard/base-types/best-practices-strings), we recommend that you avoid calling string comparison methods that substitute default values and instead call methods that require parameters to be explicitly specified. To find the first index of a substring within a string instance by using the comparison rules of the current culture, signal your intention explicitly by calling the method overload with a value of for its `comparisonType` parameter. If you don't need linguistic-aware comparison, consider using . + As explained in Best Practices for Using Strings, we recommend that you avoid calling string comparison methods that substitute default values and instead call methods that require parameters to be explicitly specified. To find the first index of a substring within a string instance by using the comparison rules of the current culture, signal your intention explicitly by calling the method overload with a value of for its `comparisonType` parameter. If you don't need linguistic-aware comparison, consider using . @@ -7441,7 +7441,7 @@ The following example searches for all occurrences of a specified string within is less than 0 (zero) or greater than the length of this string. - As explained in [Best Practices for Using Strings](/dotnet/standard/base-types/best-practices-strings), we recommend that you avoid calling string comparison methods that substitute default values and instead call methods that require parameters to be explicitly specified. To find the first index of a substring that occurs after a particular character position by using the comparison rules of the current culture, signal your intention explicitly by calling the method overload with a value of for its `comparisonType` parameter. If you don't need linguistic-aware comparison, consider using . + As explained in Best Practices for Using Strings, we recommend that you avoid calling string comparison methods that substitute default values and instead call methods that require parameters to be explicitly specified. To find the first index of a substring that occurs after a particular character position by using the comparison rules of the current culture, signal your intention explicitly by calling the method overload with a value of for its `comparisonType` parameter. If you don't need linguistic-aware comparison, consider using . @@ -7716,7 +7716,7 @@ The following example finds the index of all occurrences of the string "he" with is greater than the length of this string minus . - As explained in [Best Practices for Using Strings](/dotnet/standard/base-types/best-practices-strings), we recommend that you avoid calling string comparison methods that substitute default values and instead call methods that require parameters to be explicitly specified. To use the comparison rules of the current culture to perform this operation, signal your intention explicitly by calling the method overload with a value of for its `comparisonType` parameter. If you don't need linguistic-aware comparison, consider using . + As explained in Best Practices for Using Strings, we recommend that you avoid calling string comparison methods that substitute default values and instead call methods that require parameters to be explicitly specified. To use the comparison rules of the current culture to perform this operation, signal your intention explicitly by calling the method overload with a value of for its `comparisonType` parameter. If you don't need linguistic-aware comparison, consider using . @@ -9886,7 +9886,7 @@ The following example removes opening and closing HTML tags from a string if the is . - As explained in [Best Practices for Using Strings](/dotnet/standard/base-types/best-practices-strings), we recommend that you avoid calling string comparison methods that substitute default values and instead call methods that require parameters to be explicitly specified. To find the last index of a substring within a string instance by using the comparison rules of the current culture, signal your intention explicitly by calling the method overload with a value of for its parameter. If you don't need linguistic-aware comparison, consider using . + As explained in Best Practices for Using Strings, we recommend that you avoid calling string comparison methods that substitute default values and instead call methods that require parameters to be explicitly specified. To find the last index of a substring within a string instance by using the comparison rules of the current culture, signal your intention explicitly by calling the method overload with a value of for its parameter. If you don't need linguistic-aware comparison, consider using . @@ -10048,7 +10048,7 @@ The following example finds the index of all occurrences of a string in target s The current instance equals , and is less than -1 or greater than zero. - As explained in [Best Practices for Using Strings](/dotnet/standard/base-types/best-practices-strings), we recommend that you avoid calling string comparison methods that substitute default values and instead call methods that require parameters to be explicitly specified. To find the index of a substring that precedes a particular character position by using the comparison rules of the current culture, signal your intention explicitly by calling the method overload with a value of for its parameter. If you don't need linguistic-aware comparison, consider using . + As explained in Best Practices for Using Strings, we recommend that you avoid calling string comparison methods that substitute default values and instead call methods that require parameters to be explicitly specified. To find the index of a substring that precedes a particular character position by using the comparison rules of the current culture, signal your intention explicitly by calling the method overload with a value of for its parameter. If you don't need linguistic-aware comparison, consider using . @@ -10340,7 +10340,7 @@ The current instance equals and and is greater than 1. - As explained in [Best Practices for Using Strings](/dotnet/standard/base-types/best-practices-strings), we recommend that you avoid calling string comparison methods that substitute default values and instead call methods that require parameters to be explicitly specified. To perform this operation by using the comparison rules of the current culture, signal your intention explicitly by calling the method overload with a value of for its parameter. If you don't need linguistic-aware comparison, consider using . + As explained in Best Practices for Using Strings, we recommend that you avoid calling string comparison methods that substitute default values and instead call methods that require parameters to be explicitly specified. To perform this operation by using the comparison rules of the current culture, signal your intention explicitly by calling the method overload with a value of for its parameter. If you don't need linguistic-aware comparison, consider using . @@ -13408,7 +13408,7 @@ The following example defines a `StripStartTags` method that uses the is . - As explained in [Best Practices for Using Strings](/dotnet/standard/base-types/best-practices-strings), we recommend that you avoid calling string comparison methods that substitute default values and instead call methods that require parameters to be explicitly specified. To determine whether a string begins with a particular substring by using the string comparison rules of the current culture, signal your intention explicitly by calling the method overload with a value of for its parameter. If you don't need linguistic-aware comparison, consider using . + As explained in Best Practices for Using Strings, we recommend that you avoid calling string comparison methods that substitute default values and instead call methods that require parameters to be explicitly specified. To determine whether a string begins with a particular substring by using the string comparison rules of the current culture, signal your intention explicitly by calling the method overload with a value of for its parameter. If you don't need linguistic-aware comparison, consider using . @@ -15462,7 +15462,7 @@ The following example converts several mixed case strings to lowercase. ]]> - As explained in [Best Practices for Using Strings](/dotnet/standard/base-types/best-practices-strings), we recommend that you avoid calling string casing methods that substitute default values and instead call methods that require parameters to be explicitly specified. To convert a character to lowercase by using the casing conventions of the current culture, signal your intention explicitly by calling the method overload with a value of for its parameter. If you don't need linguistic-aware comparison, consider using . + As explained in Best Practices for Using Strings, we recommend that you avoid calling string casing methods that substitute default values and instead call methods that require parameters to be explicitly specified. To convert a character to lowercase by using the casing conventions of the current culture, signal your intention explicitly by calling the method overload with a value of for its parameter. If you don't need linguistic-aware comparison, consider using . @@ -15858,7 +15858,7 @@ The following example calls the method to conver ]]> - As explained in [Best Practices for Using Strings](/dotnet/standard/base-types/best-practices-strings), we recommend that you avoid calling string casing methods that substitute default values and instead call methods that require parameters to be explicitly specified. To convert a string to uppercase by using the casing conventions of the current culture, signal your intention explicitly by calling the method overload with a value of for its parameter. If you don't need linguistic-aware comparison, consider using . + As explained in Best Practices for Using Strings, we recommend that you avoid calling string casing methods that substitute default values and instead call methods that require parameters to be explicitly specified. To convert a string to uppercase by using the casing conventions of the current culture, signal your intention explicitly by calling the method overload with a value of for its parameter. If you don't need linguistic-aware comparison, consider using .