diff --git a/xml/Microsoft.Extensions.DependencyInjection/HttpClientBuilderExtensions.xml b/xml/Microsoft.Extensions.DependencyInjection/HttpClientBuilderExtensions.xml index 31eb3443382..f51d8f531ee 100644 --- a/xml/Microsoft.Extensions.DependencyInjection/HttpClientBuilderExtensions.xml +++ b/xml/Microsoft.Extensions.DependencyInjection/HttpClientBuilderExtensions.xml @@ -611,8 +611,7 @@ The type of the . The handler type must be registered as a transient service. The . - Configures the primary from the dependency injection container - for a named . + Configures the primary from the dependency injection container for a named . An that can be used to configure the client. diff --git a/xml/Microsoft.VisualBasic.Compatibility.VB6/FixedLengthString.xml b/xml/Microsoft.VisualBasic.Compatibility.VB6/FixedLengthString.xml index a35316141f0..4395e9d3f03 100644 --- a/xml/Microsoft.VisualBasic.Compatibility.VB6/FixedLengthString.xml +++ b/xml/Microsoft.VisualBasic.Compatibility.VB6/FixedLengthString.xml @@ -39,7 +39,7 @@ ```vb Private Sub DemoFixedLengthString() - ' Declare a string that has a length of 7 characters and assign the + ' Declare a string that has a length of 7 characters and assign the ' initial string. The additional 5 positions will be padded with ' spaces. Dim fixedString As New FixedLengthString(7, "He") diff --git a/xml/Microsoft.VisualBasic/Interaction.xml b/xml/Microsoft.VisualBasic/Interaction.xml index d58455fcdb6..14712fa0e47 100644 --- a/xml/Microsoft.VisualBasic/Interaction.xml +++ b/xml/Microsoft.VisualBasic/Interaction.xml @@ -1052,7 +1052,7 @@ drawObj.SaveAs("C:\Drawings\sample.drw") Registry settings that are to be accessed from a non-interactive process (such as Mtx.exe) should be stored under either the `HKEY_LOCAL_MACHINE\Software\` or the `HKEY_USER\DEFAULT\Software` registry keys. - `GetSetting` requires `Read` . + `GetSetting` requires `Read` . @@ -1413,7 +1413,7 @@ drawObj.SaveAs("C:\Drawings\sample.drw") Registry settings that are to be accessed from a non-interactive process (such as Mtx.exe) should be stored under either the `HKEY_LOCAL_MACHINE\Software\` or the `HKEY_USER\DEFAULT\Software` registry keys. - `SaveSetting` requires `Write` and `Create` . + `SaveSetting` requires `Write` and `Create` . ## Examples The following example first uses the `SaveSetting` function to make entries in the Windows registry for the `MyApp` application, and then uses the `DeleteSetting` function to remove them. diff --git a/xml/Microsoft.Win32/FileDialogCustomPlaces.xml b/xml/Microsoft.Win32/FileDialogCustomPlaces.xml index 8c2b57dcd1b..c0b248eaef4 100644 --- a/xml/Microsoft.Win32/FileDialogCustomPlaces.xml +++ b/xml/Microsoft.Win32/FileDialogCustomPlaces.xml @@ -174,7 +174,7 @@ Gets the Favorites folder for the current user. - The Favorites folder for the current user. + The Favorites folder for the current user. System.Collections.Generic.IDictionary<System.Type,System.Collections.Generic.IList<System.Activities.Validation.Constraint>> - Gets a dictionary of type-constraint pairs. Each additional constraint added to the dictionary will be applied to every activity of the specify type in the workflow to validate. + Gets a dictionary of type-constraint pairs. Each additional constraint added to the dictionary will be applied to every activity of the specify type in the workflow to validate. A dictionary type list of constraints and types. To be added. diff --git a/xml/System.Activities/NativeActivityContext.xml b/xml/System.Activities/NativeActivityContext.xml index 4a3bebf0136..2cfed7d6e15 100644 --- a/xml/System.Activities/NativeActivityContext.xml +++ b/xml/System.Activities/NativeActivityContext.xml @@ -1697,7 +1697,7 @@ The data that is carried into an activity. The data that is carried into an activity. The data that is carried into an activity. - The data that is carried into an activity. + The data that is carried into an activity. The data that is carried into an activity. The data that is carried into an activity. The data that is carried into an activity. diff --git a/xml/System.CodeDom.Compiler/CompilerParameters.xml b/xml/System.CodeDom.Compiler/CompilerParameters.xml index e51084af498..e605fe1e949 100644 --- a/xml/System.CodeDom.Compiler/CompilerParameters.xml +++ b/xml/System.CodeDom.Compiler/CompilerParameters.xml @@ -428,7 +428,7 @@ Specifies an evidence object that represents the security policy permissions to grant the compiled assembly. - An object that represents the security policy permissions to grant the compiled assembly. + An object that represents the security policy permissions to grant the compiled assembly. To be added. diff --git a/xml/System.Collections.Generic/HashSet`1.xml b/xml/System.Collections.Generic/HashSet`1.xml index 12ee41ffa3a..5bd5ad2f35b 100644 --- a/xml/System.Collections.Generic/HashSet`1.xml +++ b/xml/System.Collections.Generic/HashSet`1.xml @@ -2007,7 +2007,7 @@ ## Examples - The following example creates two disparate objects and compares them to each another. Initially, the two sets are not equal, which is demonstrated by using the method. The `allNumbers` object is then modified, after which the sets are equal. + The following example creates two disparate objects and compares them to each another. Initially, the two sets are not equal, which is demonstrated by using the method. The `allNumbers` object is then modified, after which the sets are equal. :::code language="csharp" source="~/snippets/csharp/System.Collections.Generic/HashSetT/IsProperSubsetOf/Program.cs" interactive="try-dotnet-method" id="Snippet02"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Collections.Generic.HashSet_boolMethods/vb/Program.vb" id="Snippet02"::: diff --git a/xml/System.Collections.Generic/List`1.xml b/xml/System.Collections.Generic/List`1.xml index fd1d77d3bb0..ed480fb7611 100644 --- a/xml/System.Collections.Generic/List`1.xml +++ b/xml/System.Collections.Generic/List`1.xml @@ -887,7 +887,7 @@ is always greater than or equal to . If exceeds while adding elements, the capacity is increased by automatically reallocating the internal array before copying the old elements and adding the new elements. - If the capacity is significantly larger than the count and you want to reduce the memory used by the , you can decrease capacity by calling the method or by setting the property explicitly to a lower value. When the value of is set explicitly, the internal array is also reallocated to accommodate the specified capacity, and all the elements are copied. + If the capacity is significantly larger than the count and you want to reduce the memory used by the , you can decrease capacity by calling the method or by setting the property explicitly to a lower value. When the value of is set explicitly, the internal array is also reallocated to accommodate the specified capacity, and all the elements are copied. Retrieving the value of this property is an O(1) operation; setting the property is an O(*n*) operation, where *n* is the new capacity. diff --git a/xml/System.Collections.Immutable/IImmutableList`1.xml b/xml/System.Collections.Immutable/IImmutableList`1.xml index ad9dd10dc7a..07db92b8a60 100644 --- a/xml/System.Collections.Immutable/IImmutableList`1.xml +++ b/xml/System.Collections.Immutable/IImmutableList`1.xml @@ -83,7 +83,7 @@ For information on creating an `IImmutableList` implementation, see The object to add to the list. - Makes a copy of the list, and adds the specified object to the end of the copied list. + Makes a copy of the list, and adds the specified object to the end of the copied list. A new list with the object added. To be added. diff --git a/xml/System.Collections.Immutable/ImmutableList`1.xml b/xml/System.Collections.Immutable/ImmutableList`1.xml index 9f90e846539..de5d075debc 100644 --- a/xml/System.Collections.Immutable/ImmutableList`1.xml +++ b/xml/System.Collections.Immutable/ImmutableList`1.xml @@ -221,7 +221,7 @@ The object to locate. The value can be null for reference types. - The comparer implementation to use when comparing elements or null to use the default comparer. + The comparer implementation to use when comparing elements or null to use the default comparer. Searches the entire sorted list for an element using the specified comparer and returns the zero-based index of the element. The zero-based index of item in the sorted List, if item is found; otherwise, a negative number that is the bitwise complement of the index of the next element that is larger than item or, if there is no larger element, the bitwise complement of . To be added. @@ -1865,7 +1865,7 @@ - The implementation to use when comparing elements, or to use the default comparer (). + The implementation to use when comparing elements, or to use the default comparer (). Sorts the elements in the entire immutable list using the specified comparer. The sorted list. To be added. diff --git a/xml/System.Collections.Immutable/ImmutableSortedSet`1.xml b/xml/System.Collections.Immutable/ImmutableSortedSet`1.xml index 9ae4ba67883..8ed9645042e 100644 --- a/xml/System.Collections.Immutable/ImmutableSortedSet`1.xml +++ b/xml/System.Collections.Immutable/ImmutableSortedSet`1.xml @@ -1559,7 +1559,7 @@ This member is an explicit interface member implementation. It can be used only The zero-based index of the item to remove. - Removes the item at the specified index. + Removes the item at the specified index. is the base class, derived from by component developers in order to populate a smart tag panel. A smart tag panel represents the menu-like user interface (UI) for smart tags. - This derived class may implement the `virtual` method to return a collection of objects derived from . These objects represent the smart tag panel items. Each item is displayed in the panel according to its type. For example, a is displayed as a static text label. Active panel items, represented by the and types, have a corresponding publicly accessible property or method, respectively, that implements the functionality for that item. + This derived class may implement the `virtual` method to return a collection of objects derived from . These objects represent the smart tag panel items. Each item is displayed in the panel according to its type. For example, a is displayed as a static text label. Active panel items, represented by the and types, have a corresponding publicly accessible property or method, respectively, that implements the functionality for that item. For more information about how to add items to the smart tag panel, see the method. @@ -274,7 +274,7 @@ method is implemented to return, in the expected display order, a collection of objects derived from the class. These items can be of the following specific types. + The `virtual` method is implemented to return, in the expected display order, a collection of objects derived from the class. These items can be of the following specific types. |Type|Description| |----------|-----------------| diff --git a/xml/System.ComponentModel.Design/DesignerActionUIService.xml b/xml/System.ComponentModel.Design/DesignerActionUIService.xml index ea2f9cc8111..fff7d003386 100644 --- a/xml/System.ComponentModel.Design/DesignerActionUIService.xml +++ b/xml/System.ComponentModel.Design/DesignerActionUIService.xml @@ -232,7 +232,7 @@ method updates the internal `DesignerAction`, as well as the smart tag panel. + The method updates the internal `DesignerAction` , as well as the smart tag panel. diff --git a/xml/System.ComponentModel/MaskedTextResultHint.xml b/xml/System.ComponentModel/MaskedTextResultHint.xml index 68abe2089d1..a887f3ad9d5 100644 --- a/xml/System.ComponentModel/MaskedTextResultHint.xml +++ b/xml/System.ComponentModel/MaskedTextResultHint.xml @@ -228,7 +228,7 @@ -51 - Operation did not succeed. The program encountered an input character that was not valid. For more information about characters that are not valid, see the method. + Operation did not succeed. The program encountered an input character that was not valid. For more information about characters that are not valid, see the method. diff --git a/xml/System.ComponentModel/PropertyFilterOptions.xml b/xml/System.ComponentModel/PropertyFilterOptions.xml index de291ac4031..aff66ffe09c 100644 --- a/xml/System.ComponentModel/PropertyFilterOptions.xml +++ b/xml/System.ComponentModel/PropertyFilterOptions.xml @@ -179,7 +179,7 @@ 8 - Return any property that is valid on the object in the current scope. + Return any property that is valid on the object in the current scope. diff --git a/xml/System.Configuration/Configuration.xml b/xml/System.Configuration/Configuration.xml index c5e54bbf5a4..f15be031751 100644 --- a/xml/System.Configuration/Configuration.xml +++ b/xml/System.Configuration/Configuration.xml @@ -752,7 +752,7 @@ Note: If you use a static method that takes a path ## Remarks The method persists configuration settings in the object based on the `saveMode` and `forceSaveAll` parameters. - If a configuration file does not exist at the physical location represented by the property, a new configuration file will be created to contain any settings that are different from the inherited configuration. + If a configuration file does not exist at the physical location represented by the property, a new configuration file will be created to contain any settings that are different from the inherited configuration. If the configuration file has changed since this object was created, a run-time error occurs. diff --git a/xml/System.Configuration/ConnectionStringsSection.xml b/xml/System.Configuration/ConnectionStringsSection.xml index af800191806..065d0b50991 100644 --- a/xml/System.Configuration/ConnectionStringsSection.xml +++ b/xml/System.Configuration/ConnectionStringsSection.xml @@ -30,7 +30,7 @@ class allows you to programmatically modify the `connectionStrings` section of the configuration file. The connection strings are provided as a of `add` configuration elements. + The class allows you to programmatically modify the `connectionStrings` section of the configuration file. The connection strings are provided as a of `add` configuration elements. diff --git a/xml/System.Configuration/OverrideMode.xml b/xml/System.Configuration/OverrideMode.xml index 8e9a106bfb2..21a44b53bec 100644 --- a/xml/System.Configuration/OverrideMode.xml +++ b/xml/System.Configuration/OverrideMode.xml @@ -28,7 +28,7 @@ enumeration values to set the property of the class. You set this property in order to programmatically specify override behavior of a configuration element or group. To declaratively set the override behavior for all configuration elements inside a element, use the `allowOverride` attribute. The property gives you more granular control over the elements inside a `location` element. + Use the enumeration values to set the property of the class. You set this property in order to programmatically specify override behavior of a configuration element or group. To declaratively set the override behavior for all configuration elements inside a `location` element, use the `allowOverride` attribute. The property gives you more granular control over the elements inside a `location` element. ]]> diff --git a/xml/System.Data.Common.CommandTrees/DbLimitExpression.xml b/xml/System.Data.Common.CommandTrees/DbLimitExpression.xml index 10d2fd22c89..f1491b067b8 100644 --- a/xml/System.Data.Common.CommandTrees/DbLimitExpression.xml +++ b/xml/System.Data.Common.CommandTrees/DbLimitExpression.xml @@ -20,7 +20,7 @@ can be applied to any with a collection result type, including . provides the equivalent of the Top operation. It does not require an ordering operation to have been performed on its input. It has two `Expression` properties, and , that specify the collection and the number of rows to return respectively. also has a `Boolean` property that controls whether rows equal in rank to the final row are returned. defaults to `false`. + A can be applied to any with a collection result type, including . provides the equivalent of the Top operation. It does not require an ordering operation to have been performed on its input. It has two `Expression` properties, and , that specify the collection and the number of rows to return respectively. also has a `Boolean` property that controls whether rows equal in rank to the final row are returned. defaults to `false`. ]]> diff --git a/xml/System.Data.Metadata.Edm/GlobalItem.xml b/xml/System.Data.Metadata.Edm/GlobalItem.xml index a23cf49d861..022fa9f00fb 100644 --- a/xml/System.Data.Metadata.Edm/GlobalItem.xml +++ b/xml/System.Data.Metadata.Edm/GlobalItem.xml @@ -15,7 +15,7 @@ - Represents the base item class for all the conceptual model types and entity containers. + Represents the base item class for all the conceptual model types and entity containers. System.Enum - Represents an enumeration that specifies three options indicating whether the column in the store schema definition language (SSDL) (.ssdl) needs a value during insert and update operations. ADO.NET reads the value of the column and then stores it in-memory cache. + Represents an enumeration that specifies three options indicating whether the column in the store schema definition language (SSDL) (.ssdl) needs a value during insert and update operations. ADO.NET reads the value of the column and then stores it in-memory cache. To be added. diff --git a/xml/System.Data.Objects.DataClasses/EntityCollection`1.xml b/xml/System.Data.Objects.DataClasses/EntityCollection`1.xml index cf2ffced28a..76a9cd74bce 100644 --- a/xml/System.Data.Objects.DataClasses/EntityCollection`1.xml +++ b/xml/System.Data.Objects.DataClasses/EntityCollection`1.xml @@ -477,7 +477,7 @@ ## Examples - This example is based on a modified version of the [School Model](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb896300(v=vs.100)). This version supports table-per-type inheritance with `Course` as an abstract type. Complete the walkthrough to modify the School model to support the table-per-type inheritance example used in this topic. + This example is based on a modified version of the [School Model](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb896300(v=vs.100)). This version supports table-per-type inheritance with `Course` as an abstract type. Complete the walkthrough to modify the School model to support the table-per-type inheritance example used in this topic. This example shows how to use to filter objects in an and bind only to objects of a specific type. For a complete version of this example, see [How to: Bind Controls to Derived Types](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/dd283135(v=vs.100)). diff --git a/xml/System.Data.Objects/ObjectQuery`1.xml b/xml/System.Data.Objects/ObjectQuery`1.xml index 6bb1e6bf5c2..9582baf2e84 100644 --- a/xml/System.Data.Objects/ObjectQuery`1.xml +++ b/xml/System.Data.Objects/ObjectQuery`1.xml @@ -769,12 +769,12 @@ The method can only be applied The number of results to skip. This must be either a constant or a parameter reference. An optional set of query parameters that should be in scope when parsing. Orders the query results by the specified criteria and skips a specified number of results. - A new instance that is equivalent to the original instance with both ORDER BY and [SKIP](/dotnet/framework/data/adonet/ef/language-reference/skip-entity-sql) applied. + A new instance that is equivalent to the original instance with both ORDER BY and SKIP applied. method cannot be used after the method. When you use after , it functions like the [LIMIT](/dotnet/framework/data/adonet/ef/language-reference/limit-entity-sql) statement of an clause. + The method cannot be used after the method. When you use after , it functions like the [LIMIT](/dotnet/framework/data/adonet/ef/language-reference/limit-entity-sql) statement of an `ORDER BY` clause. diff --git a/xml/System.Data.OracleClient/OracleParameter.xml b/xml/System.Data.OracleClient/OracleParameter.xml index 39e203f7409..ada3d4c1cce 100644 --- a/xml/System.Data.OracleClient/OracleParameter.xml +++ b/xml/System.Data.OracleClient/OracleParameter.xml @@ -1284,7 +1284,7 @@ public void CreateOracleParameter() The , , and properties of a parameter can be inferred by setting Value. Therefore, you are not required to specify them. However, they are not exposed in property settings. For example, if the size of the parameter has been inferred, Size does not contain inferred value after statement execution. - The `InputOutput`, `Output`, and `ReturnValue` values used by the Value property will be Microsoft .NET Framework data types, unless the input value was an Oracle data type (for example, or ). This does not apply to REF CURSOR, BFILE, or LOB data types. + The `InputOutput`, `Output`, and `ReturnValue` values used by the Value property will be Microsoft .NET Framework data types, unless the input value was an Oracle data type (for example, or ). This does not apply to REF CURSOR, BFILE, or LOB data types. The property is overwritten by the **Update** method. diff --git a/xml/System.Data.SqlClient/SqlParameterCollection.xml b/xml/System.Data.SqlClient/SqlParameterCollection.xml index 9a8477e3c5b..b9368526c03 100644 --- a/xml/System.Data.SqlClient/SqlParameterCollection.xml +++ b/xml/System.Data.SqlClient/SqlParameterCollection.xml @@ -630,7 +630,7 @@ parameters.Add("@pname", Convert.ToInt32(0)); ## Remarks replaces the `SqlParameterCollection.Add` method that takes a and an . The overload of `Add` that takes a string and an object was deprecated because of possible ambiguity with the `SqlParameterCollection.Add` overload that takes a and a enumeration value where passing an integer with the string could be interpreted as being either the parameter value or the corresponding value. Use whenever you want to add a parameter by specifying its name and value. - For `Xml` enumeration values, you can use a string, an XML value, an derived type instance, or a object. + For `Xml` enumeration values, you can use a string, an XML value, an derived type instance, or a object. diff --git a/xml/System.Data/DataSetDateTime.xml b/xml/System.Data/DataSetDateTime.xml index b949241b4c9..28c2f2a1feb 100644 --- a/xml/System.Data/DataSetDateTime.xml +++ b/xml/System.Data/DataSetDateTime.xml @@ -41,7 +41,7 @@ ## Remarks cannot be set on non- columns. Setting the property with the default value UnspecifiedLocal on non- columns is permitted. Modifying the column data type from to any other type resets the to the default value UnspecifiedLocal. - Checking schema for merging, Relations, and ForeignKeyConstraints can be performed between columns with matching properties. Otherwise the columns should be considered as non-matching on schema. The only exception is between Unspecified and UnspecifiedLocal. It is permitted to have a relation or a `ForeignKeyConstraint` between two `DateTime` columns with one in `Unspecified` and other in `UnspecifiedLocal`. + Checking schema for merging, Relations, and ForeignKeyConstraints can be performed between columns with matching properties. Otherwise the columns should be considered as non-matching on schema. The only exception is between Unspecified and UnspecifiedLocal. It is permitted to have a relation or a `ForeignKeyConstraint` between two `DateTime` columns with one in `Unspecified` and other in `UnspecifiedLocal` . ]]> diff --git a/xml/System.Diagnostics.SymbolStore/SymMethod.xml b/xml/System.Diagnostics.SymbolStore/SymMethod.xml index edf57b7ce3e..44837ba6b7f 100644 --- a/xml/System.Diagnostics.SymbolStore/SymMethod.xml +++ b/xml/System.Diagnostics.SymbolStore/SymMethod.xml @@ -486,7 +486,7 @@ Use the method to relea An array in which to store the IL offsets from the beginning of the method for the sequence points. - An array in which to store the documents in which the sequence points are located. + An array in which to store the documents in which the sequence points are located. An array in which to store the lines in the documents at which the sequence points are located. An array in which to store the columns in the documents at which the sequence points are located. The array of lines in the documents at which the sequence points end. diff --git a/xml/System.Diagnostics.Tracing/EventListener.xml b/xml/System.Diagnostics.Tracing/EventListener.xml index 6fd6c01edcc..ee819c4c7db 100644 --- a/xml/System.Diagnostics.Tracing/EventListener.xml +++ b/xml/System.Diagnostics.Tracing/EventListener.xml @@ -466,7 +466,7 @@ identifies an event source that is suitable for indexing an array. This integer is unique within the application domain. An event listener might find it useful to store additional information about each event source that is connected to it. The value returned by allows this extra information to be efficiently stored in a expandable array such as `List`. + The value returned by identifies an event source that is suitable for indexing an array. This integer is unique within the application domain. An event listener might find it useful to store additional information about each event source that is connected to it. The value returned by allows this extra information to be efficiently stored in an expandable array such as `List`. ]]> diff --git a/xml/System.Diagnostics.Tracing/EventSource.xml b/xml/System.Diagnostics.Tracing/EventSource.xml index 397855a01ac..8dd80e8393b 100644 --- a/xml/System.Diagnostics.Tracing/EventSource.xml +++ b/xml/System.Diagnostics.Tracing/EventSource.xml @@ -787,7 +787,7 @@ The following example shows an implementation of - Allows the object to attempt to free resources and perform other cleanup operations before the object is reclaimed by garbage collection. + Allows the object to attempt to free resources and perform other cleanup operations before the object is reclaimed by garbage collection. To be added. diff --git a/xml/System.Diagnostics/Debug.xml b/xml/System.Diagnostics/Debug.xml index 74a04081035..c8b82488fd0 100644 --- a/xml/System.Diagnostics/Debug.xml +++ b/xml/System.Diagnostics/Debug.xml @@ -1693,7 +1693,7 @@ End of list of errors The following example creates a named `generalSwitch`. This switch is set outside of the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message on the same line as the first message. A line terminator follows the second message. @@ -1774,7 +1774,7 @@ The following example creates a named `gen The following example creates a named `generalSwitch`. This switch is set outside of the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message on the same line as the first message. A line terminator follows the second message. @@ -1859,7 +1859,7 @@ The following example creates a named `gen The following example creates a named `generalSwitch`. This switch is set outside of the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message on the same line as the first message. A line terminator follows the second message. @@ -1944,7 +1944,7 @@ The following example creates a named `gen The following example creates a named `generalSwitch`. This switch is set outside of the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message on the same line as the first message. A line terminator follows the second message. @@ -2109,7 +2109,7 @@ This overload was introduced in .NET 6 to improve performance. In comparison to The following example creates a named `generalSwitch`. This switch is set outside of the code sample. - If the switch is set to the `Error` or higher, the example outputs the first name of the value parameter to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first name of the value parameter to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs a message on the same line as the first message. A line terminator follows the second message. @@ -2208,7 +2208,7 @@ Debug.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range"); The following example creates a named `generalSwitch`. This switch is set outside of the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information about adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information about adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message on the same line as the first message. A line terminator follows the second message. @@ -2384,7 +2384,7 @@ This overload was introduced in .NET 6 to improve performance. In comparison to The following example creates a named `generalSwitch`. This switch is set outside of the code sample. - If the switch is set to the `Verbose`, the example outputs the name of the `myObject` and the `category` to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Verbose`, the example outputs the name of the `myObject` and the `category` to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Error` or higher, the example outputs the second error message on the same line as the first message. A line terminator follows the second message. @@ -2487,7 +2487,7 @@ Debug.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range"); The following example creates a named `generalSwitch`. This switch is set outside of the code sample. - If the switch is set to the `Verbose`, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Verbose`, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Error` or higher, the example outputs the second error message on the same line as the first message. A line terminator follows the second message. @@ -2596,7 +2596,7 @@ Debug.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range"); The following example creates a named `generalSwitch`. This switch is set outside of the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the name of the object on the same line as the first message. A line terminator follows the second message. @@ -2678,7 +2678,7 @@ The following example creates a named `gen The following example creates a named `generalSwitch`. This switch is set outside of the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message on the same line as the first message. A line terminator follows the second message. @@ -2763,7 +2763,7 @@ The following example creates a named `gen The following example creates a named `generalSwitch`. This switch is set outside of the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message on the same line as the first message. The second message is followed by a line terminator. @@ -2921,7 +2921,7 @@ The following example creates a named `gen The following example creates a named `generalSwitch`. This switch is set outside of the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message and the `category` on the same line as the first message. A line terminator follows the second message. @@ -3083,7 +3083,7 @@ This overload was introduced in .NET 6 to improve performance. In comparison to The following example creates a named `generalSwitch`. This switch is set outside of the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the name of the object on the same line as the first message. A line terminator follows the second message. @@ -3183,7 +3183,7 @@ Debug.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range") The following example creates a named `generalSwitch`. This switch is set outside of the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information about adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information about adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message on the same line as the first message. A line terminator follows the second message. @@ -3358,7 +3358,7 @@ This overload was introduced in .NET 6 to improve performance. In comparison to The following example creates a named `generalSwitch`. This switch is set outside of the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message on the same line as the first message. A line terminator follows the second message. @@ -3461,7 +3461,7 @@ Debug.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range") The following example creates a named `generalSwitch`. This switch is set outside of the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message and the `category` on the same line as the first message. A line terminator follows the second message. diff --git a/xml/System.Diagnostics/Debugger.xml b/xml/System.Diagnostics/Debugger.xml index 0e66a4a4885..97ba816da18 100644 --- a/xml/System.Diagnostics/Debugger.xml +++ b/xml/System.Diagnostics/Debugger.xml @@ -151,7 +151,7 @@ If no debugger is attached, users are asked if they want to attach a debugger. If users say yes, the debugger is started. If a debugger is attached, the debugger is signaled with a user breakpoint event, and the debugger suspends execution of the process just as if a debugger breakpoint had been hit. > [!WARNING] -> Starting with .NET Framework 4, the runtime no longer exercises tight control of launching the debugger for the method, but instead reports an error to the Windows Error Reporting (WER) subsystem. WER provides many settings to customize the problem reporting experience, so a lot of factors will influence the way WER responds to an error such as operating system version, process, session, user, machine and domain. If you're having unexpected results when calling the method, check the WER settings on your machine. For more information on how to customize WER, see [WER Settings](/windows/win32/wer/wer-settings). If you want to ensure the debugger is launched regardless of the WER settings, be sure to call the method instead. +> Starting with .NET Framework 4, the runtime no longer exercises tight control of launching the debugger for the method, but instead reports an error to the Windows Error Reporting (WER) subsystem. WER provides many settings to customize the problem reporting experience, so a lot of factors will influence the way WER responds to an error such as operating system version, process, session, user, machine and domain. If you're having unexpected results when calling the method, check the WER settings on your machine. For more information on how to customize WER, see [WER Settings](/windows/win32/wer/wer-settings). If you want to ensure the debugger is launched regardless of the WER settings, be sure to call the method instead. diff --git a/xml/System.Diagnostics/EventLog.xml b/xml/System.Diagnostics/EventLog.xml index 229b9d8ccd8..271eb9e92e7 100644 --- a/xml/System.Diagnostics/EventLog.xml +++ b/xml/System.Diagnostics/EventLog.xml @@ -649,7 +649,7 @@ ## Remarks Use this overload to configure a new source for writing entries to an event log on the local computer or a remote computer. It is not necessary to use this method to read from an event log. - The method uses the input `sourceData`, and properties to create registry values on the target computer for the new source and its associated event log. A new source name cannot match an existing source name or an existing event log name on the target computer. If the property is not set, the source is registered for the Application event log. If the is not set, the source is registered on the local computer. + The method uses the input `sourceData` , and properties to create registry values on the target computer for the new source and its associated event log. A new source name cannot match an existing source name or an existing event log name on the target computer. If the property is not set, the source is registered for the Application event log. If the is not set, the source is registered on the local computer. > [!NOTE] > To create an event source in Windows Vista and later or Windows Server 2003, you must have administrative privileges. diff --git a/xml/System.Diagnostics/Process.xml b/xml/System.Diagnostics/Process.xml index 54b3b91cd38..a0c4d0afdb7 100644 --- a/xml/System.Diagnostics/Process.xml +++ b/xml/System.Diagnostics/Process.xml @@ -197,7 +197,7 @@ When the property is set to its default value, `true`, you can start applications and documents in a way that is similar to using the `Run` dialog box of the Windows `Start` menu. When is `false`, you can start only executables. - Any executable file that you can call from the command line can be started in one of two ways: by setting the appropriate members of the property and calling the method with no parameters, or by passing the appropriate parameter to the `static` member. + Any executable file that you can call from the command line can be started in one of two ways: by setting the appropriate members of the property and calling the method with no parameters, or by passing the appropriate parameter to the `static` member. You can create a component by using the constructor, one of the static overloads, or any of the , , or methods. After you have done so, you have a view into the associated process. This is not a dynamic view that updates itself automatically when the process properties have changed in memory. Instead, you must call for the component to update the property information in your application. diff --git a/xml/System.Diagnostics/Trace.xml b/xml/System.Diagnostics/Trace.xml index fc2941448de..96f28312a0f 100644 --- a/xml/System.Diagnostics/Trace.xml +++ b/xml/System.Diagnostics/Trace.xml @@ -1769,7 +1769,7 @@ End of list of errors ## Examples The following example creates a named `generalSwitch`. This switch is set outside the code sample. - If the switch is set to the `Error` or higher, the example outputs the first name of the `value` parameter to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first name of the `value` parameter to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs a message on the same line as the first message. The second message is followed by a line terminator. @@ -1852,7 +1852,7 @@ End of list of errors ## Examples The following example creates a named `generalSwitch`. This switch is set outside the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message on the same line as the first message. A line terminator follows the second message. @@ -1939,7 +1939,7 @@ End of list of errors ## Examples The following example creates a named `generalSwitch`. This switch is set outside the code sample. - If the switch is set to the `Verbose`, the example outputs the name of the `myObject` and the `category` to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Verbose`, the example outputs the name of the `myObject` and the `category` to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Error` or higher, the example outputs the second error message on the same line as the first message. The second message is followed by a line terminator. @@ -2026,7 +2026,7 @@ End of list of errors ## Examples The following example creates a named `generalSwitch`. This switch is set outside the code sample. - If the switch is set to the `Verbose`, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Verbose`, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Error` or higher, the example outputs the second error message on the same line as the first message. The second message is followed by a line terminator. @@ -2117,7 +2117,7 @@ End of list of errors ## Examples The following example creates a named `generalSwitch`. This switch is set outside the code sample. - If the switch is set to the `Error` or higher, the example outputs the first name of the value parameter to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first name of the value parameter to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs a message on the same line as the first message. The second message is followed by a line terminator. @@ -2214,7 +2214,7 @@ Trace.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range"); ## Examples The following example creates a named `generalSwitch`. This switch is set outside the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message on the same line as the first message. The second message is followed by a line terminator. @@ -2315,7 +2315,7 @@ Trace.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range"); ## Examples The following example creates a named `generalSwitch`. This switch is set outside the code sample. - If the switch is set to the `Verbose`, the example outputs the name of the `myObject` and the `category` to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Verbose`, the example outputs the name of the `myObject` and the `category` to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Error` or higher, the example outputs the second error message on the same line as the first message. The second message is followed by a line terminator. @@ -2416,7 +2416,7 @@ Trace.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range"); ## Examples The following example creates a named `generalSwitch`. This switch is set outside the code sample. - If the switch is set to the `Verbose`, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Verbose`, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Error` or higher, the example outputs the second error message on the same line as the first message. The second message is followed by a line terminator. @@ -2520,7 +2520,7 @@ Trace.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range"); ## Examples The following example creates a named `generalSwitch`. This switch is set outside the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the name of the object on the same line as the first message. The second message is followed by a line terminator. @@ -2598,7 +2598,7 @@ Trace.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range"); ## Examples The following example creates a named `generalSwitch`. This switch is set outside the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message on the same line as the first message. The second message is followed by a line terminator. @@ -2680,7 +2680,7 @@ Trace.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range"); ## Examples The following example creates a named `generalSwitch`. This switch is set outside the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message on the same line as the first message. The second message is followed by a line terminator. @@ -2762,7 +2762,7 @@ Trace.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range"); ## Examples The following example creates a named `generalSwitch`. This switch is set outside the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message and the `category` on the same line as the first message. The second message is followed by a line terminator. @@ -2853,7 +2853,7 @@ Trace.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range"); ## Examples The following example creates a named `generalSwitch`. This switch is set outside the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the name of the object on the same line as the first message. The second message is followed by a line terminator. @@ -2950,7 +2950,7 @@ Trace.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range") ## Examples The following example creates a named `generalSwitch`. This switch is set outside the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message on the same line as the first message. The second message is followed by a line terminator. @@ -3051,7 +3051,7 @@ Trace.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range") ## Examples The following example creates a named `generalSwitch`. This switch is set outside the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message on the same line as the first message. The second message is followed by a line terminator. @@ -3152,7 +3152,7 @@ Trace.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range") ## Examples The following example creates a named `generalSwitch`. This switch is set outside the code sample. - If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. + If the switch is set to the `Error` or higher, the example outputs the first error message to the . For information on adding a listener to the collection, see the class. Then, if the is set to `Verbose`, the example outputs the second error message and the `category` on the same line as the first message. The second message is followed by a line terminator. diff --git a/xml/System.Diagnostics/TraceListener.xml b/xml/System.Diagnostics/TraceListener.xml index 41eac7ceb81..de163c6c054 100644 --- a/xml/System.Diagnostics/TraceListener.xml +++ b/xml/System.Diagnostics/TraceListener.xml @@ -1572,7 +1572,7 @@ > [!IMPORTANT] > This method is not intended to be called directly by application code but by members of the , , and classes to write trace data to output. - The method is used for the correlation of related traces. The method calls the method to process the call, with the eventType level set to and the `relatedActivityId` as a string appended to the message. + The method is used for the correlation of related traces. The method calls the method to process the call, with the eventType level set to and the `relatedActivityId` as a string appended to the message. ]]> diff --git a/xml/System.DirectoryServices.Protocols/DirectoryAttribute.xml b/xml/System.DirectoryServices.Protocols/DirectoryAttribute.xml index c1e27c8000c..90f1a20eafd 100644 --- a/xml/System.DirectoryServices.Protocols/DirectoryAttribute.xml +++ b/xml/System.DirectoryServices.Protocols/DirectoryAttribute.xml @@ -275,7 +275,7 @@ The method adds an array of values to the attribute. To be added. - is not a byte[][], string[], or Uri[]. + is not a byte[][], string[], or Uri[]. contains a null reference ( in Visual Basic). @@ -469,7 +469,7 @@ contains a null reference ( in Visual Basic). - is less than zero, or is greater than the number of elements in the object. + is less than zero, or is greater than the number of elements in the object. diff --git a/xml/System.DirectoryServices.Protocols/DirectoryAttributeCollection.xml b/xml/System.DirectoryServices.Protocols/DirectoryAttributeCollection.xml index 8320ef56686..69eb1a1ffd1 100644 --- a/xml/System.DirectoryServices.Protocols/DirectoryAttributeCollection.xml +++ b/xml/System.DirectoryServices.Protocols/DirectoryAttributeCollection.xml @@ -252,7 +252,7 @@ is a null reference ( in Visual Basic) or specifies a modification operation other than Add. - is less than zero, or is greater than the number of elements in the object. + is less than zero, or is greater than the number of elements in the object. diff --git a/xml/System.DirectoryServices.Protocols/LdapConnection.xml b/xml/System.DirectoryServices.Protocols/LdapConnection.xml index d8ff313e2a5..0539a281359 100644 --- a/xml/System.DirectoryServices.Protocols/LdapConnection.xml +++ b/xml/System.DirectoryServices.Protocols/LdapConnection.xml @@ -608,7 +608,7 @@ is null ( in Visual Basic). Request is of type DsmlAuthRequest. - The error code returned by LDAP does not map to a the enumeration error code. + The error code returned by LDAP does not map to a enumeration error code. The server returned a object with an error. diff --git a/xml/System.DirectoryServices/ActiveDirectorySecurity.xml b/xml/System.DirectoryServices/ActiveDirectorySecurity.xml index 00861e2abe0..c6a1c36bdb9 100644 --- a/xml/System.DirectoryServices/ActiveDirectorySecurity.xml +++ b/xml/System.DirectoryServices/ActiveDirectorySecurity.xml @@ -682,7 +682,7 @@ is used to replace all access rules that match a particular SID and access control type (Allow or Deny) in an object's DACL, all rules in that DACL with an SID and type that match the SID and access control type contained in the `rule` object are replaced. Using this method, the developer can replace any Allow rules for that SID on that object without affecting existing Deny rules, or replace all Deny rules for that SID on that object without affecting existing Allow rules. To replace all rules for that object pertaining to the specified SID, regardless of type, use instead. + When is used to replace all access rules that match a particular SID and access control type (Allow or Deny) in an object's DACL, all rules in that DACL with an SID and type that match the SID and access control type contained in the `rule` object are replaced. Using this method, the developer can replace any Allow rules for that SID on that object without affecting existing Deny rules, or replace all Deny rules for that SID on that object without affecting existing Allow rules. To replace all rules for that object pertaining to the specified SID, regardless of type, use instead. ]]> diff --git a/xml/System.DirectoryServices/DirectorySynchronization.xml b/xml/System.DirectoryServices/DirectorySynchronization.xml index 0f4904be3de..22a5d3668eb 100644 --- a/xml/System.DirectoryServices/DirectorySynchronization.xml +++ b/xml/System.DirectoryServices/DirectorySynchronization.xml @@ -59,8 +59,8 @@ fmt.Serialize(myStream, src.DirectorySynchronization); myStream.Close(); -// At some point in time, we wake up and read by de-serializing the dirSync cookie, -// and resume the dirSync +// At some point in time, we wake up and read by deserializing the dirSync cookie, +// and resume the dirSync FileStream myStream = FileCreate("dirsync.data"); BinaryFormatter fmt = new BinaryFormatter(); DirectorySynchronization dirSync = fmt.Deserialize(myStream); diff --git a/xml/System.Drawing.Drawing2D/AdjustableArrowCap.xml b/xml/System.Drawing.Drawing2D/AdjustableArrowCap.xml index d42431acd02..1f69f49e6a6 100644 --- a/xml/System.Drawing.Drawing2D/AdjustableArrowCap.xml +++ b/xml/System.Drawing.Drawing2D/AdjustableArrowCap.xml @@ -89,7 +89,7 @@ `e`, an event object. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates an object named `myArrow`. @@ -144,7 +144,7 @@ `e`, an event object. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates an object named `myArrow`. diff --git a/xml/System.Drawing.Drawing2D/CustomLineCap.xml b/xml/System.Drawing.Drawing2D/CustomLineCap.xml index 101791b1b94..38af75132ba 100644 --- a/xml/System.Drawing.Drawing2D/CustomLineCap.xml +++ b/xml/System.Drawing.Drawing2D/CustomLineCap.xml @@ -346,7 +346,7 @@ `e`, an event object. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a custom line cap by using the object. diff --git a/xml/System.Drawing.Drawing2D/GraphicsPath.xml b/xml/System.Drawing.Drawing2D/GraphicsPath.xml index 47caca76060..896f7c05f20 100644 --- a/xml/System.Drawing.Drawing2D/GraphicsPath.xml +++ b/xml/System.Drawing.Drawing2D/GraphicsPath.xml @@ -350,7 +350,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a rectangle, from which the arc is defined. @@ -721,7 +721,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a path. @@ -866,7 +866,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates an array of seven points (representing two connected Bézier curves). @@ -1083,7 +1083,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates an array of six points (representing a cardinal spline). @@ -1406,7 +1406,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates an array of four points (representing a cardinal spline). @@ -1526,7 +1526,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: Creates a bounding rectangle that defines an ellipse. @@ -1840,7 +1840,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code creates a path, adds three lines that form a triangle, and then draws the path to the screen. + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code creates a path, adds three lines that form a triangle, and then draws the path to the screen. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.Drawing2D.ClassicGraphicsPathExamples/CPP/form1.cpp" id="Snippet7"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing.Drawing2D/GraphicsPath/AddArc/form1.cs" id="Snippet7"::: @@ -1955,7 +1955,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates an array of four points that describe a triangle. @@ -2060,7 +2060,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates two paths one a right-side-up triangle and the other an up-side-down triangle. @@ -2189,7 +2189,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code creates a graphics path, adds the pie shape, and then draws the path to the screen. + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code creates a graphics path, adds the pie shape, and then draws the path to the screen. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.Drawing2D.ClassicGraphicsPathExamples/CPP/form1.cpp" id="Snippet10"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing.Drawing2D/GraphicsPath/AddArc/form1.cs" id="Snippet10"::: @@ -2308,7 +2308,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates an array of points that defines a polygon. @@ -2418,7 +2418,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a path. @@ -2523,7 +2523,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a path. @@ -2639,7 +2639,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a path. @@ -2862,7 +2862,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a path. @@ -2920,7 +2920,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a path. @@ -2976,7 +2976,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a path. @@ -3028,7 +3028,7 @@ `e`, an event object. The code creates a triangle by creating a new path, starting a figure, adding two intersecting lines to the figure, and then closing the figure to form a triangle. The path is then drawn to the screen. + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code creates a triangle by creating a new path, starting a figure, adding two intersecting lines to the figure, and then closing the figure to form a triangle. The path is then drawn to the screen. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.Drawing2D.ClassicGraphicsPathExamples/CPP/form1.cpp" id="Snippet18"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing.Drawing2D/GraphicsPath/AddArc/form1.cs" id="Snippet18"::: @@ -3292,7 +3292,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a graphics path and a translation matrix. @@ -3369,7 +3369,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a graphics path. @@ -3542,7 +3542,7 @@ `e`, an event object. The code creates a path, adds a line to the path, and then gets the last point in the path. + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code creates a path, adds a line to the path, and then gets the last point in the path. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.Drawing2D.ClassicGraphicsPathExamples/CPP/form1.cpp" id="Snippet21"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing.Drawing2D/GraphicsPath/AddArc/form1.cs" id="Snippet21"::: @@ -3939,7 +3939,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event. The code performs the following actions: - Creates a path. @@ -4368,7 +4368,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a path and adds an ellipse to the path. @@ -4626,7 +4626,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a path. @@ -4684,7 +4684,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a path and adds several primitives to the path. @@ -4743,7 +4743,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code creates a path and adds several primitives to the path separated by markers, and draws the path to the screen. + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code creates a path and adds several primitives to the path separated by markers, and draws the path to the screen. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.Drawing2D.ClassicGraphicsPathExamples/CPP/form1.cpp" id="Snippet26"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing.Drawing2D/GraphicsPath/AddArc/form1.cs" id="Snippet26"::: @@ -4794,7 +4794,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a path. @@ -4854,7 +4854,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a path and adds an ellipse to the path. @@ -5090,7 +5090,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a path and adds a rectangle to the path. @@ -5263,7 +5263,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a path and adds two ellipses to the path. diff --git a/xml/System.Drawing.Drawing2D/GraphicsPathIterator.xml b/xml/System.Drawing.Drawing2D/GraphicsPathIterator.xml index 8d5a71ae665..36d0e1cd094 100644 --- a/xml/System.Drawing.Drawing2D/GraphicsPathIterator.xml +++ b/xml/System.Drawing.Drawing2D/GraphicsPathIterator.xml @@ -125,7 +125,7 @@ ## Examples - The following example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a graphics path. @@ -265,7 +265,7 @@ `e`, an event object. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a graphics path. @@ -366,7 +366,7 @@ ## Examples - The following example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a object, `myPath`. @@ -438,7 +438,7 @@ ## Examples - The following example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a object. @@ -509,7 +509,7 @@ ## Examples - The following example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a object. @@ -575,7 +575,7 @@ `e`, an event object. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a object. @@ -650,7 +650,7 @@ `e`, an event object. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a object. @@ -716,7 +716,7 @@ `e`, an event object. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a object. diff --git a/xml/System.Drawing.Drawing2D/LinearGradientBrush.xml b/xml/System.Drawing.Drawing2D/LinearGradientBrush.xml index b22a5a1642f..bc2775b353c 100644 --- a/xml/System.Drawing.Drawing2D/LinearGradientBrush.xml +++ b/xml/System.Drawing.Drawing2D/LinearGradientBrush.xml @@ -44,7 +44,7 @@ [!INCLUDE[System.Drawing.Common note](~/includes/system-drawing-common.md)] ## Examples - The following example creates a horizontal ; the color components change linearly as you move from a horizontal coordinate of 0 to a horizontal coordinate of 200. For example, a point whose first coordinate is halfway between 0 and 200 will have a blue component that is halfway between 0 and 255. This example is designed for use with Windows Forms. The following code example is designed for use with Windows Forms, and it requires the `e`, which is a parameter of . + The following example creates a horizontal ; the color components change linearly as you move from a horizontal coordinate of 0 to a horizontal coordinate of 200. For example, a point whose first coordinate is halfway between 0 and 200 will have a blue component that is halfway between 0 and 255. This example is designed for use with Windows Forms. The following code example is designed for use with Windows Forms, and it requires the `e`, which is a parameter of . :::code language="csharp" source="~/snippets/csharp/System.Drawing.Drawing2D/LinearGradientBrush/Overview/Class1.cs" id="Snippet21"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/VB/Class1.vb" id="Snippet21"::: @@ -521,7 +521,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a new . @@ -760,7 +760,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a new . @@ -860,7 +860,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a new . @@ -981,7 +981,7 @@ `e`, an event object. The code + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code - Creates a new . @@ -1102,7 +1102,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a new . @@ -1229,7 +1229,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a new . @@ -1356,7 +1356,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a new . @@ -1527,7 +1527,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a new . diff --git a/xml/System.Drawing.Drawing2D/Matrix.xml b/xml/System.Drawing.Drawing2D/Matrix.xml index ea1396b0f19..3f4de427611 100644 --- a/xml/System.Drawing.Drawing2D/Matrix.xml +++ b/xml/System.Drawing.Drawing2D/Matrix.xml @@ -730,7 +730,7 @@ Matrix myMatrix = new Matrix(3, 5, 1, 2, 2, 4); ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates three matrices. @@ -865,7 +865,7 @@ Matrix myMatrix = new Matrix(3, 5, 1, 2, 2, 4); ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a scaling matrix. @@ -992,7 +992,7 @@ Matrix myMatrix = new Matrix(3, 5, 1, 2, 2, 4); `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Draws a rectangle to the screen prior to applying a rotation transform (the blue rectangle). @@ -1117,7 +1117,7 @@ Matrix myMatrix = new Matrix(3, 5, 1, 2, 2, 4); `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Draws a rectangle to the screen prior to applying a rotation transform (the blue rectangle). @@ -1238,7 +1238,7 @@ Matrix myMatrix = new Matrix(3, 5, 1, 2, 2, 4); `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Draws a rectangle to the screen prior to applying a scaling transform (the blue rectangle). @@ -1311,7 +1311,7 @@ Matrix myMatrix = new Matrix(3, 5, 1, 2, 2, 4); ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following action: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following action: - Draws a rectangle to the screen, using a green pen, prior to applying a scaling transform. @@ -1429,7 +1429,7 @@ Matrix myMatrix = new Matrix(3, 5, 1, 2, 2, 4); `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates an array of points that form a rectangle. @@ -1540,7 +1540,7 @@ Matrix myMatrix = new Matrix(3, 5, 1, 2, 2, 4); `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates an array of points that form a rectangle. @@ -1708,7 +1708,7 @@ Matrix myMatrix = new Matrix(3, 5, 1, 2, 2, 4); `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Draws a rectangle to the screen prior to applying a translate transform (the blue rectangle). diff --git a/xml/System.Drawing.Drawing2D/PathGradientBrush.xml b/xml/System.Drawing.Drawing2D/PathGradientBrush.xml index b62b6bc47e1..20c0c0c1279 100644 --- a/xml/System.Drawing.Drawing2D/PathGradientBrush.xml +++ b/xml/System.Drawing.Drawing2D/PathGradientBrush.xml @@ -568,7 +568,7 @@ `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a graphics path and adds a rectangle to it. @@ -773,7 +773,7 @@ PathGradientBrush pgBrush = new PathGradientBrush(myPath); `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a graphics path and adds a rectangle to it. @@ -898,7 +898,7 @@ PathGradientBrush pgBrush = new PathGradientBrush(myPath); `e`, an event object. The code + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code - Creates a graphics path and adds a rectangle to it. @@ -1033,7 +1033,7 @@ PathGradientBrush pgBrush = new PathGradientBrush(myPath); ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a graphics path and adds a rectangle to it. @@ -1170,7 +1170,7 @@ PathGradientBrush pgBrush = new PathGradientBrush(myPath); ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, an event object. The code performs the following actions: - Creates a graphics path and adds a rectangle to it. diff --git a/xml/System.Drawing.Drawing2D/RegionData.xml b/xml/System.Drawing.Drawing2D/RegionData.xml index 9fbb8ef0992..fd1d27a9324 100644 --- a/xml/System.Drawing.Drawing2D/RegionData.xml +++ b/xml/System.Drawing.Drawing2D/RegionData.xml @@ -31,7 +31,7 @@ `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: - Creates a rectangle and draw its to the screen in black. @@ -94,7 +94,7 @@ ## Examples -- The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Paint` event handler. The code example demonstrates how to use the from one object to set the for another . +- The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Paint` event handler. The code example demonstrates how to use the from one object to set the for another . :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.MiscExamples/CPP/form1.cpp" id="Snippet13"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/Bitmap/.ctor/form12.cs" id="Snippet13"::: diff --git a/xml/System.Drawing.Imaging/ImageAttributes.xml b/xml/System.Drawing.Imaging/ImageAttributes.xml index 88d6e87f87a..5a992fccd90 100644 --- a/xml/System.Drawing.Imaging/ImageAttributes.xml +++ b/xml/System.Drawing.Imaging/ImageAttributes.xml @@ -1195,7 +1195,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: 1. Creates a single-element array that holds red as the old color and green as the new color. @@ -1330,7 +1330,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: 1. Opens an that uses the file Circle.bmp and draws it to the screen. @@ -1582,7 +1582,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: 1. Creates a rectangle image that has all the color values set to 128, producing a rectangle that is filled with a solid medium-gray color. The code then draws this rectangle image to the screen. @@ -1784,7 +1784,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. In addition, you need to change the image file path to a path and image name valid on your system. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. In addition, you need to change the image file path to a path and image name valid on your system. The code performs the following actions: 1. Opens an that uses the file Camera.jpg and draws it to the screen using the default value for gamma. @@ -1914,7 +1914,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: 1. Opens an that uses the file Camera.jpg. @@ -2311,7 +2311,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: 1. Creates an image (a red circle), saves it as Circle2.jpg, opens that image, and draws it to the screen. @@ -2444,7 +2444,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: 1. Opens an and draws it to the screen. @@ -2567,7 +2567,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: 1. Opens an from the Circle3.jpg file (a small, red-filled circle) and draws it to the screen. diff --git a/xml/System.Drawing.Imaging/ImageCodecInfo.xml b/xml/System.Drawing.Imaging/ImageCodecInfo.xml index eb57b49b733..90887a74b5d 100644 --- a/xml/System.Drawing.Imaging/ImageCodecInfo.xml +++ b/xml/System.Drawing.Imaging/ImageCodecInfo.xml @@ -418,7 +418,7 @@ `e`, which is a parameter of the event handler. The code uses the method to retrieve all the codec information for all installed image encoders and codecs, and then draws all the information about each codec to the screen. + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code uses the method to retrieve all the codec information for all installed image encoders and codecs, and then draws all the information about each codec to the screen. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.Imaging.ClassicImageCodecExample/cpp/form1.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing.Imaging/ImageCodecInfo/GetImageEncoders/form1.cs" id="Snippet1"::: diff --git a/xml/System.Drawing.Text/InstalledFontCollection.xml b/xml/System.Drawing.Text/InstalledFontCollection.xml index fbbecddc479..54bc0ded156 100644 --- a/xml/System.Drawing.Text/InstalledFontCollection.xml +++ b/xml/System.Drawing.Text/InstalledFontCollection.xml @@ -40,7 +40,7 @@ ## Examples The following example shows how to get a list of fonts that support the regular . - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. :::code language="csharp" source="~/snippets/csharp/System.Drawing/Bitmap/SetResolution/Form1.cs" id="Snippetinstalledfonts"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Misc3/VB/Form1.vb" id="Snippetinstalledfonts"::: diff --git a/xml/System.Drawing/Bitmap.xml b/xml/System.Drawing/Bitmap.xml index f473262ca5c..cd9eb9d8fc3 100644 --- a/xml/System.Drawing/Bitmap.xml +++ b/xml/System.Drawing/Bitmap.xml @@ -701,7 +701,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a from a file. @@ -764,7 +764,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a from a file. @@ -821,7 +821,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Gets the handle to an existing icon image. @@ -1057,7 +1057,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -1116,7 +1116,7 @@ `e`, which is a parameter of the event handler. The code gets the color of a pixel in a bitmap, and then fills a rectangle with that color. + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code gets the color of a pixel in a bitmap, and then fills a rectangle with that color. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicBitmapExamples/CPP/form1.cpp" id="Snippet7"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/Bitmap/Clone/form1.cs" id="Snippet7"::: @@ -1319,7 +1319,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code makes the system default transparent color transparent for `myBitmap`, and then draws the to the screen. + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code makes the system default transparent color transparent for `myBitmap`, and then draws the to the screen. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicBitmapExamples/CPP/form1.cpp" id="Snippet8"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/Bitmap/Clone/form1.cs" id="Snippet8"::: @@ -1373,7 +1373,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Gets the color of a pixel in a . @@ -1437,7 +1437,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . diff --git a/xml/System.Drawing/ColorTranslator.xml b/xml/System.Drawing/ColorTranslator.xml index b2808cfc412..2f4946ea26b 100644 --- a/xml/System.Drawing/ColorTranslator.xml +++ b/xml/System.Drawing/ColorTranslator.xml @@ -93,7 +93,7 @@ ## Examples - The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code translates an HTML color name to a structure, and then uses that color to fill a rectangle. + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code translates an HTML color name to a structure, and then uses that color to fill a rectangle. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicColorTranslatorExamples/CPP/form1.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/ColorTranslator/FromHtml/form1.cs" id="Snippet1"::: @@ -147,7 +147,7 @@ `e`, which is a parameter of the event handler. The code translates an OLE color value to a structure, and then uses that color to fill a rectangle. + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code translates an OLE color value to a structure, and then uses that color to fill a rectangle. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicColorTranslatorExamples/CPP/form1.cpp" id="Snippet2"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/ColorTranslator/FromHtml/form1.cs" id="Snippet2"::: @@ -205,7 +205,7 @@ `e`, which is a parameter of the event handler. The code translates a Windows color value to a structure, and then uses that color to fill a rectangle. + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code translates a Windows color value to a structure, and then uses that color to fill a rectangle. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicColorTranslatorExamples/CPP/form1.cpp" id="Snippet3"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/ColorTranslator/FromHtml/form1.cs" id="Snippet3"::: @@ -262,7 +262,7 @@ ## Examples - The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code translates a structure to a string representation of an HTML color, and then shows a message box with the resulting string. + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code translates a structure to a string representation of an HTML color, and then shows a message box with the resulting string. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicColorTranslatorExamples/CPP/form1.cpp" id="Snippet4"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/ColorTranslator/FromHtml/form1.cs" id="Snippet4"::: @@ -314,7 +314,7 @@ `e`, which is a parameter of the event handler. The code translates a structure to an integer that represents an OLE color, and then shows a message box with the resulting string. + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code translates a structure to an integer that represents an OLE color, and then shows a message box with the resulting string. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicColorTranslatorExamples/CPP/form1.cpp" id="Snippet5"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/ColorTranslator/FromHtml/form1.cs" id="Snippet5"::: @@ -372,7 +372,7 @@ `e`, which is a parameter of the event handler. The code translates a structure to an integer that represents a Windows color, and then shows a message box with the resulting string. + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code translates a structure to an integer that represents a Windows color, and then shows a message box with the resulting string. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicColorTranslatorExamples/CPP/form1.cpp" id="Snippet6"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/ColorTranslator/FromHtml/form1.cs" id="Snippet6"::: diff --git a/xml/System.Drawing/Font.xml b/xml/System.Drawing/Font.xml index 9693303116a..873470f3baf 100644 --- a/xml/System.Drawing/Font.xml +++ b/xml/System.Drawing/Font.xml @@ -238,7 +238,7 @@ ## Examples - The following code example demonstrates how to use the constructor. This example is designed to be used with a Windows Form and requires a `e`, which is a parameter of the event. + The following code example demonstrates how to use the constructor. This example is designed to be used with a Windows Form and requires a `e`, which is a parameter of the event. :::code language="csharp" source="~/snippets/csharp/System.Drawing/Bitmap/SetResolution/Form1.cs" id="Snippetconstructfontwithstring"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Misc3/VB/Form1.vb" id="Snippetconstructfontwithstring"::: @@ -849,7 +849,7 @@ `e`, which is a parameter of the event handler. The code clones a and draws text with that font. + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code clones a and draws text with that font. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicFontsExamples/CPP/form1.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/Font/Clone/form1.cs" id="Snippet1"::: @@ -954,7 +954,7 @@ `e`, which is a parameter of the event handler. The code creates two objects and then tests whether they are equivalent. + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code creates two objects and then tests whether they are equivalent. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicFontsExamples/CPP/form1.cpp" id="Snippet2"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/Font/Clone/form1.cs" id="Snippet2"::: @@ -1130,7 +1130,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Gets a handle to a GDI font. @@ -1411,7 +1411,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -1532,7 +1532,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -2188,7 +2188,7 @@ ## Examples - The following code example creates a and then gets a handle to that . The example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. + The following code example creates a and then gets a handle to that . The example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicFontsExamples/CPP/form1.cpp" id="Snippet6"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/Font/Clone/form1.cs" id="Snippet6"::: @@ -2340,7 +2340,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . diff --git a/xml/System.Drawing/FontFamily.xml b/xml/System.Drawing/FontFamily.xml index 905ceb6ad21..f69791cb220 100644 --- a/xml/System.Drawing/FontFamily.xml +++ b/xml/System.Drawing/FontFamily.xml @@ -283,7 +283,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates two objects. @@ -513,7 +513,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -568,7 +568,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -628,7 +628,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -729,7 +729,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -783,7 +783,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -843,7 +843,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -898,7 +898,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -993,7 +993,7 @@ `e`, which is a parameter of the event handler. The code creates a and draws a string representation of the font family to the screen. + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code creates a and draws a string representation of the font family to the screen. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicFontFamilyExamples/CPP/form1.cpp" id="Snippet10"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/FontFamily/Equals/form1.cs" id="Snippet10"::: diff --git a/xml/System.Drawing/Graphics.xml b/xml/System.Drawing/Graphics.xml index dbcec2bd62e..73a58fe3884 100644 --- a/xml/System.Drawing/Graphics.xml +++ b/xml/System.Drawing/Graphics.xml @@ -4827,7 +4827,7 @@ The number of points in the array should be a multiple of 3 plus 1 because the f ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Pa` event handler. The code first defines a callback method for the delegate; the definition is simplistic and merely tests to see whether the method calls it with a null `callBackData` parameter. The main body of the example performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Pa` event handler. The code first defines a callback method for the delegate; the definition is simplistic and merely tests to see whether the method calls it with a null `callBackData` parameter. The main body of the example performs the following actions: - Creates an instance of the callback method. @@ -15689,7 +15689,7 @@ The number of points in the array should be a multiple of 3 plus 1 because the f ## Examples The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler, as well as `thisForm`, the for the example. The code performs the following actions: -- Creates a temporary from the `thisForm` of the example. +- Creates a temporary from the `thisForm` of the example. - Sets the clipping region of the temporary to a small square. @@ -15936,7 +15936,7 @@ The number of points in the array should be a multiple of 3 plus 1 because the f ## Examples The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler, as well as `thisForm`, the for the example. The code performs the following actions: -- Creates a temporary from the `thisForm` of the example. +- Creates a temporary from the `thisForm` of the example. - Sets the clipping region of the temporary to a small square. diff --git a/xml/System.Drawing/Icon.xml b/xml/System.Drawing/Icon.xml index 9e4475f9265..055ca055ccd 100644 --- a/xml/System.Drawing/Icon.xml +++ b/xml/System.Drawing/Icon.xml @@ -753,7 +753,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . diff --git a/xml/System.Drawing/Pen.xml b/xml/System.Drawing/Pen.xml index 1796f35bf18..43938be7d8c 100644 --- a/xml/System.Drawing/Pen.xml +++ b/xml/System.Drawing/Pen.xml @@ -406,7 +406,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -1047,7 +1047,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -1109,7 +1109,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -1201,7 +1201,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -1278,7 +1278,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -1342,7 +1342,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -1416,7 +1416,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: Creates a . @@ -1475,7 +1475,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a . @@ -1534,7 +1534,7 @@ `e`, which is a parameter of the event handler. The code creates a and sets it to draw arrow anchor caps at the beginning of lines: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code creates a and sets it to draw arrow anchor caps at the beginning of lines: :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicPenExamples/CPP/form1.cpp" id="Snippet9"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/Pen/Clone/form1.cs" id="Snippet9"::: diff --git a/xml/System.Drawing/Rectangle.xml b/xml/System.Drawing/Rectangle.xml index 0f20d713e22..d7bc01dac05 100644 --- a/xml/System.Drawing/Rectangle.xml +++ b/xml/System.Drawing/Rectangle.xml @@ -87,7 +87,7 @@ ![Pens](~/add/media/pens1.gif "Pens") - The example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. + The example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. :::code language="csharp" source="~/snippets/csharp/System.Drawing/Rectangle/Overview/Class1.cs" id="Snippet21"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingAPen/VB/Class1.vb" id="Snippet21"::: @@ -874,7 +874,7 @@ ## Examples - The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code creates a and enlarges it by 50 units in both axes. The rectangle is drawn to screen before inflation (black) and after inflation (red). + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code creates a and enlarges it by 50 units in both axes. The rectangle is drawn to screen before inflation (black) and after inflation (red). :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicRectangleExamples/CPP/form1.cpp" id="Snippet2"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/Rectangle/Inflate/form1.cs" id="Snippet2"::: @@ -1003,7 +1003,7 @@ ## Examples - The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code creates a and enlarges it by 50 units in both axes. Notice that the resulting rectangle (red) is 150 units in both axes. + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code creates a and enlarges it by 50 units in both axes. Notice that the resulting rectangle (red) is 150 units in both axes. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicRectangleExamples/CPP/form1.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/Rectangle/Inflate/form1.cs" id="Snippet1"::: diff --git a/xml/System.Drawing/RectangleF.xml b/xml/System.Drawing/RectangleF.xml index 87f2634f787..abaef256f11 100644 --- a/xml/System.Drawing/RectangleF.xml +++ b/xml/System.Drawing/RectangleF.xml @@ -1004,7 +1004,7 @@ `e`, an event object. The code creates two objects and draws them to the screen in black and red. Notice that they have to be converted to objects for drawing purposes. Then the code creates a third using the method, converts it to a , and draws it to the screen in blue. Notice the third (blue) rectangle is the area of overlap of the other two rectangles: + This example is designed for use with Windows Forms, and it requires `e`, an event object. The code creates two objects and draws them to the screen in black and red. Notice that they have to be converted to objects for drawing purposes. Then the code creates a third using the method, converts it to a , and draws it to the screen in blue. Notice the third (blue) rectangle is the area of overlap of the other two rectangles: :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicRectangleFExamples/CPP/form1.cpp" id="Snippet2"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/RectangleF/Inflate/form1.cs" id="Snippet2"::: diff --git a/xml/System.Drawing/Region.xml b/xml/System.Drawing/Region.xml index f686a711a92..0e8d50d1411 100644 --- a/xml/System.Drawing/Region.xml +++ b/xml/System.Drawing/Region.xml @@ -50,7 +50,7 @@ [!INCLUDE[System.Drawing.Common note](~/includes/system-drawing-common.md)] ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code example demonstrates how to use the from one object to set the for another . + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code example demonstrates how to use the from one object to set the for another . :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.MiscExamples/CPP/form1.cpp" id="Snippet13"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/Bitmap/.ctor/form12.cs" id="Snippet13"::: @@ -361,7 +361,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a rectangle and draws it to the screen in black. @@ -467,7 +467,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a rectangle and draws it to the screen in black. @@ -526,7 +526,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a rectangle and draws it to the screen in black @@ -798,7 +798,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a rectangle and draws it to the screen in black @@ -985,7 +985,7 @@ ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a and adds an ellipse to it. @@ -1089,12 +1089,12 @@ class allows you to define a custom shape. The shape can be made up of lines, polygons, and curves. describes the shape contained in this . + The class allows you to define a custom shape. The shape can be made up of lines, polygons, and curves. describes the shape contained in this . ## Examples - The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code example demonstrates how to use the from one object to set the for another . + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code example demonstrates how to use the from one object to set the for another . :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.MiscExamples/CPP/form1.cpp" id="Snippet13"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/Bitmap/.ctor/form12.cs" id="Snippet13"::: @@ -1275,7 +1275,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates the first rectangle and draws it to the screen in black. @@ -1640,7 +1640,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates the first rectangle and draws it to the screen in blue. @@ -2413,7 +2413,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a rectangle and draws it to the screen in blue. @@ -2485,7 +2485,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates a rectangle and draws it to the screen in blue. @@ -2684,7 +2684,7 @@ `e`. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`. The code performs the following actions: - Creates the first rectangle and draws it to the screen in black. @@ -2885,7 +2885,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following code example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Creates the first rectangle and draws it to the screen in black. diff --git a/xml/System.Drawing/StringFormat.xml b/xml/System.Drawing/StringFormat.xml index ca5b5086dd9..c80d54e07f0 100644 --- a/xml/System.Drawing/StringFormat.xml +++ b/xml/System.Drawing/StringFormat.xml @@ -667,7 +667,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Sets the tab stops of the . @@ -820,7 +820,7 @@ `e`, which is a parameter of the event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Sets, for the , the language to be used and the substitution method to be used. @@ -880,7 +880,7 @@ ## Examples - The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Sets the character ranges of the . @@ -949,7 +949,7 @@ ## Examples - The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Sets the tab stops of the . @@ -1005,7 +1005,7 @@ ## Examples - The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the event handler. The code performs the following actions: - Converts a object to a string. diff --git a/xml/System.Drawing/TextureBrush.xml b/xml/System.Drawing/TextureBrush.xml index 5ccb48220d4..dde7684de61 100644 --- a/xml/System.Drawing/TextureBrush.xml +++ b/xml/System.Drawing/TextureBrush.xml @@ -410,7 +410,7 @@ `e`, which is a parameter of the `Paint` event handler. The code creates a object and an exact copy of that texture brush, and then uses the copy to fill a rectangle on the screen. + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Paint` event handler. The code creates a object and an exact copy of that texture brush, and then uses the copy to fill a rectangle on the screen. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicTextureBrushExamples/CPP/form1.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/TextureBrush/Clone/form1.cs" id="Snippet1"::: @@ -510,7 +510,7 @@ ## Examples - The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: - Creates a object. @@ -572,7 +572,7 @@ ## Examples - The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: - Creates a object. @@ -624,7 +624,7 @@ `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: - Creates a object. @@ -696,7 +696,7 @@ `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: - Creates a object. @@ -751,7 +751,7 @@ `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: - Creates a object. @@ -821,7 +821,7 @@ `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: - Creates a object. @@ -878,7 +878,7 @@ `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: - Creates a object. @@ -994,7 +994,7 @@ `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: - Creates a object. @@ -1051,7 +1051,7 @@ `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: + The following example is designed for use with Windows Forms, and it requires `e`, which is a parameter of the `Paint` event handler. The code performs the following actions: - Creates a object. diff --git a/xml/System.Globalization/CultureInfo.xml b/xml/System.Globalization/CultureInfo.xml index 3488e52d549..a10bdda75c5 100644 --- a/xml/System.Globalization/CultureInfo.xml +++ b/xml/System.Globalization/CultureInfo.xml @@ -1408,7 +1408,7 @@ The following example demonstrates how to change the property for the current application domain if the property value is not `null`. +- By using the culture defined by the property for the current application domain if the property value is not `null`. - By using the system's default culture. On systems that use the Windows operating system, the common language runtime calls the Windows `GetUserDefaultUILanguage` function to set the current UI culture. `GetUserDefaultUILanguage` returns the default UI culture set by the user. If the user has not set a default UI language, it returns the culture originally installed on the system. diff --git a/xml/System.Globalization/DateTimeFormatInfo.xml b/xml/System.Globalization/DateTimeFormatInfo.xml index 94434223c2a..26af1a6990b 100644 --- a/xml/System.Globalization/DateTimeFormatInfo.xml +++ b/xml/System.Globalization/DateTimeFormatInfo.xml @@ -303,7 +303,7 @@ - You can use the class to define either a custom culture (a culture that has a unique name and that supplements existing cultures) or a replacement culture (one that is used instead of a specific culture). You can save and access this culture programmatically as you would any object supported by the .NET Framework. -- If the result string is not culture-sensitive and doesn't follow a predefined format, you can use a custom date and time format string. For example, if you are serializing date and time data in the format YYYYMMDDHHmmss, you can generate the result string by passing the custom format string to the method, and you can convert the result string back to a value by calling the method. +- If the result string is not culture-sensitive and doesn't follow a predefined format, you can use a custom date and time format string. For example, if you are serializing date and time data in the format YYYYMMDDHHmmss, you can generate the result string by passing the custom format string to the method, and you can convert the result string back to a value by calling the method. ### Changing the short date pattern The following example changes the format of a result string produced by the "d" (short date) standard format string. It changes the associated property for the en-US or English (United States) culture from its default of "M/d/yyyy" to "yyyy'-"MM"-"dd" and uses the "d" standard format string to display the date both before and after the property is changed. @@ -377,7 +377,7 @@ The following sections discuss these two operations in greater detail. ### Parsing user strings - When you parse date and time strings input by the user, you should always instantiate a object that reflects the user's cultural settings, including any customizations the user may have made. Otherwise, the date and time object may have incorrect values. For information about how to instantiate a object that reflects user cultural customizations, see the [DateTimeFormatInfo and dynamic data](#dynamic) section. + When you parse date and time strings input by the user, you should always instantiate a object that reflects the user's cultural settings, including any customizations the user may have made. Otherwise, the date and time object may have incorrect values. For information about how to instantiate a object that reflects user cultural customizations, see the [DateTimeFormatInfo and dynamic data](#dynamic) section. The following example illustrates the difference between a parsing operation that reflects user cultural settings and one that does not. In this case, the default system culture is en-US, but the user has used Control Panel, **Region and Language** to change the short date pattern from its default of "M/d/yyyy" to "yy/MM/dd". When the user enters a string that reflects user settings, and the string is parsed by a object that also reflects user settings (overrides), the parsing operation returns a correct result. However, when the string is parsed by a object that reflects standard en-US cultural settings, the parsing method throws a exception because it interprets 14 as the number of the month, not the last two digits of the year. diff --git a/xml/System.Globalization/IdnMapping.xml b/xml/System.Globalization/IdnMapping.xml index d2f6c596043..0f459b3157c 100644 --- a/xml/System.Globalization/IdnMapping.xml +++ b/xml/System.Globalization/IdnMapping.xml @@ -466,7 +466,7 @@ The string to convert, which consists of one or more domain name labels delimited with label separators. A zero-based offset into that specifies the start of the substring. The number of characters to convert in the substring that starts at the position specified by in the string. - Encodes the specified number of characters in a substring of domain name labels that include Unicode characters outside the US-ASCII character range. The substring is converted to a string of displayable Unicode characters in the US-ASCII character range and is formatted according to the IDNA standard. + Encodes the specified number of characters in a substring of domain name labels that include Unicode characters outside the US-ASCII character range. The substring is converted to a string of displayable Unicode characters in the US-ASCII character range and is formatted according to the IDNA standard. The equivalent of the substring specified by the , , and parameters, consisting of displayable Unicode characters in the US-ASCII character range (U+0020 to U+007E) and formatted according to the IDNA standard. A user-provided object that distinguishes this particular asynchronous read request from other requests. A user-provided object that distinguishes this particular asynchronous read request from other requests. Begins an asynchronous read operation. (Consider using the method instead.) - An object that represents the asynchronous read operation, which could still be pending. + An object that represents the asynchronous read operation, which could still be pending. A user-provided object that distinguishes this particular asynchronous write request from other requests. A user-provided object that distinguishes this particular asynchronous write request from other requests. Begins an asynchronous write operation. (Consider using the method instead.) - An object that represents the asynchronous write operation, which could still be pending. + An object that represents the asynchronous write operation, which could still be pending. has been compressed usi The zip archive entry to extract a file from. - The path of the file to create from the contents of the entry. You can specify either a relative or an absolute path. A relative path is interpreted as relative to the current working directory. + The path of the file to create from the contents of the entry. You can specify either a relative or an absolute path. A relative path is interpreted as relative to the current working directory. Extracts an entry in the zip archive to a file. `Identification`. The current context of the calling thread () is used as a client identity. + This constructor sets the impersonation level that is allowed by a client to `Identification`. The current context of the calling thread () is used as a client identity. ]]> diff --git a/xml/System.IdentityModel.Tokens/SamlSecurityTokenHandler.xml b/xml/System.IdentityModel.Tokens/SamlSecurityTokenHandler.xml index 59935ab2240..91e24d8df47 100644 --- a/xml/System.IdentityModel.Tokens/SamlSecurityTokenHandler.xml +++ b/xml/System.IdentityModel.Tokens/SamlSecurityTokenHandler.xml @@ -1587,7 +1587,7 @@ An XML reader positioned at a saml:DoNotCacheCondition element. - Reads a saml:DoNotCacheCondition element from the specified XML reader. + Reads a saml:DoNotCacheCondition element from the specified XML reader. The that was read. To be added. diff --git a/xml/System.Management/CompletedEventArgs.xml b/xml/System.Management/CompletedEventArgs.xml index 7fa3739107a..1335b4a5170 100644 --- a/xml/System.Management/CompletedEventArgs.xml +++ b/xml/System.Management/CompletedEventArgs.xml @@ -56,7 +56,7 @@ ## Remarks ## Property Value - A value indicating the status of the operation. + A value indicating the status of the operation. ## .NET Framework Security Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see [Using Libraries from Partially Trusted Code](/dotnet/framework/misc/using-libraries-from-partially-trusted-code). diff --git a/xml/System.Messaging/Trustee.xml b/xml/System.Messaging/Trustee.xml index 42ee82ddb8d..73ceeeeb06d 100644 --- a/xml/System.Messaging/Trustee.xml +++ b/xml/System.Messaging/Trustee.xml @@ -234,7 +234,7 @@ before you use this instance of to set permissions, but is optional. If you leave `null`, the local computer is used to look up the account you specify in the property. + You must specify a value for before you use this instance of to set permissions, but is optional. If you leave `null`, the local computer is used to look up the account you specify in the property. ]]> diff --git a/xml/System.Net.Http.Headers/CacheControlHeaderValue.xml b/xml/System.Net.Http.Headers/CacheControlHeaderValue.xml index 0bcdbf05dff..249cab99f56 100644 --- a/xml/System.Net.Http.Headers/CacheControlHeaderValue.xml +++ b/xml/System.Net.Http.Headers/CacheControlHeaderValue.xml @@ -372,7 +372,7 @@ ## Remarks This property represents the "min-fresh" directive in a cache-control header field on an HTTP request. - The property indicates that the HTTP client is willing to accept a response whose freshness lifetime is no less than its current age plus the freshness lifetime specified time in seconds. The client wants a response that will still be fresh for at least the current age plus the freshness lifetime. + The property indicates that the HTTP client is willing to accept a response whose freshness lifetime is no less than its current age plus the freshness lifetime specified time in seconds. The client wants a response that will still be fresh for at least the current age plus the freshness lifetime. ]]> diff --git a/xml/System.Net.WebSockets/ClientWebSocket.xml b/xml/System.Net.WebSockets/ClientWebSocket.xml index ef4ecca8bc2..69ff217f5f8 100644 --- a/xml/System.Net.WebSockets/ClientWebSocket.xml +++ b/xml/System.Net.WebSockets/ClientWebSocket.xml @@ -368,7 +368,7 @@ The URI of the WebSocket server to connect to. - A cancellation token used to propagate notification that the operation should be canceled. + A cancellation token used to propagate notification that the operation should be canceled. Connect to a WebSocket server as an asynchronous operation. The task object representing the asynchronous operation. diff --git a/xml/System.Net/CookieCollection.xml b/xml/System.Net/CookieCollection.xml index a7b1de79cd8..7de794212c3 100644 --- a/xml/System.Net/CookieCollection.xml +++ b/xml/System.Net/CookieCollection.xml @@ -272,7 +272,7 @@ is read from the `cookies` parameter and added to the current instance. + Each is read from the `cookies` parameter and added to the current instance. ]]> @@ -431,7 +431,7 @@ The comparison for is case-sensitive. `array` parameter must be one-dimensional with zero-based indexing. + The `array` parameter must be one-dimensional with zero-based indexing. ]]> @@ -1062,7 +1062,7 @@ The comparison for is case-sensitive. `array` parameter must be one-dimensional with zero-based indexing. + The `array` parameter must be one-dimensional with zero-based indexing. ]]> diff --git a/xml/System.Net/FileWebRequest.xml b/xml/System.Net/FileWebRequest.xml index 73da90644d5..c77edfa8856 100644 --- a/xml/System.Net/FileWebRequest.xml +++ b/xml/System.Net/FileWebRequest.xml @@ -55,7 +55,7 @@ class implements the `abstract` base class for Uniform Resource Identifiers (URIs) that use the `file://` scheme to request local files. + The class implements the `abstract` base class for Uniform Resource Identifiers (URIs) that use the `file://` scheme to request local files. Do not use the constructor. Use the method to initialize new instances of the class. If the URI scheme is `file://`, the method returns a object. diff --git a/xml/System.Net/FileWebResponse.xml b/xml/System.Net/FileWebResponse.xml index 13fda53d8ef..e471739e103 100644 --- a/xml/System.Net/FileWebResponse.xml +++ b/xml/System.Net/FileWebResponse.xml @@ -63,7 +63,7 @@ class implements the `abstract` base class to return file system resources for the class. + The class implements the `abstract` base class to return file system resources for the class. Client applications do not create instances directly; instead, they are created by calling the method on a instance. diff --git a/xml/System.Net/HttpWebRequest.xml b/xml/System.Net/HttpWebRequest.xml index c77d0ae668f..600d1d8e7b6 100644 --- a/xml/System.Net/HttpWebRequest.xml +++ b/xml/System.Net/HttpWebRequest.xml @@ -3950,7 +3950,7 @@ The GetHashCode method returns a hash code of the web request. This value can be Gets or sets a value that indicates whether to send an Authorization header with the request. - to send an HTTP Authorization header with requests after authentication has taken place; otherwise, . The default is . + to send an HTTP Authorization header with requests after authentication has taken place; otherwise, . The default is . - A or that defines the format of individual elements. + The format of individual elements. Returns the string representation of this vector using the specified format string to format individual elements. The string representation of the current instance. @@ -2272,7 +2272,7 @@ The type `T` can be any of the following numeric types: - A or that defines the format of individual elements. + The format of individual elements. A format provider that supplies culture-specific formatting information. Returns the string representation of this vector using the specified format string to format individual elements and the specified format provider to define culture-specific formatting. The string representation of the current instance. diff --git a/xml/System.Printing.IndexedProperties/PrintSystemTypeProperty.xml b/xml/System.Printing.IndexedProperties/PrintSystemTypeProperty.xml index 26ec7b14323..b2e97463884 100644 --- a/xml/System.Printing.IndexedProperties/PrintSystemTypeProperty.xml +++ b/xml/System.Printing.IndexedProperties/PrintSystemTypeProperty.xml @@ -172,7 +172,7 @@ A pointer to the that is converted. Provides implicit conversion to a value from a pointer to a . - A converted Type value form a PrintSystemTypeProperty object. + The converted type. To be added. diff --git a/xml/System.Printing/OutputQuality.xml b/xml/System.Printing/OutputQuality.xml index 6fa2d30f5f1..eb285494cad 100644 --- a/xml/System.Printing/OutputQuality.xml +++ b/xml/System.Printing/OutputQuality.xml @@ -38,7 +38,7 @@ ## Notes on OutputQuality.Photographic Starting with the .NET Framework 4.6.1, the output quality obtained with the Photographic value is improved (compared to previous versions of the .NET Framework) when printing to a GDI-based printer and when running on Windows 7 and earlier versions of the Windows operating system. - Producing documents with better output quality requires larger print spooler files and longer wait times. If these side effects are undesirable, you can instead use the High value. + Producing documents with better output quality requires larger print spooler files and longer wait times. If these side effects are undesirable, you can instead use the High value. diff --git a/xml/System.Reflection.Emit/FieldBuilder.xml b/xml/System.Reflection.Emit/FieldBuilder.xml index c894652b548..b89cf2908fd 100644 --- a/xml/System.Reflection.Emit/FieldBuilder.xml +++ b/xml/System.Reflection.Emit/FieldBuilder.xml @@ -1054,7 +1054,7 @@ For information on how to format `binaryAttribute`, see the metadata specificati `obj`. If the field is static, `obj` will be ignored. For non-static fields, `obj` should be an instance of a class that inherits or declares the field. + This method will assign the `val` parameter to the field reflected by this instance on `obj`. If the field is static, `obj` will be ignored. For non-static fields, `obj` should be an instance of a class that inherits or declares the field. The new value is passed as an . For example, if the field's type is Boolean, an instance of with the appropriate Boolean value is passed. Before setting the value, checks to see if the user has access permission. diff --git a/xml/System.Reflection.Metadata/PEReaderExtensions.xml b/xml/System.Reflection.Metadata/PEReaderExtensions.xml index 2a3932c0f83..5395fb5fe99 100644 --- a/xml/System.Reflection.Metadata/PEReaderExtensions.xml +++ b/xml/System.Reflection.Metadata/PEReaderExtensions.xml @@ -109,9 +109,9 @@ The caller must keep the al The current instance. - An enumeration value indicating the metadata reading configuration. - Gets a metadata reader with the specified metadata reading configuration from a . - A metadata reader with the specified metadata reading configuration. + An enumeration value indicating the metadata reading configuration. + Gets a metadata reader with the specified metadata reading configuration from a . + A metadata reader with the specified metadata reading configuration. [!IMPORTANT] > Whether an argument is named or positional, you must access its type and value by using the structure. - To create instances of the class, use the `static` factory method. + To create instances of the class, use the `static` factory method. diff --git a/xml/System.Reflection/CustomAttributeTypedArgument.xml b/xml/System.Reflection/CustomAttributeTypedArgument.xml index 863de26a35c..b626dd50df1 100644 --- a/xml/System.Reflection/CustomAttributeTypedArgument.xml +++ b/xml/System.Reflection/CustomAttributeTypedArgument.xml @@ -85,7 +85,7 @@ If an argument is an array of values, the property of the that represents the argument returns a generic of objects. Each object in the collection represents the corresponding element of the array. - To create instances of the class, use the `static` factory method. + To create instances of the class, use the `static` factory method. diff --git a/xml/System.Reflection/TypeDelegator.xml b/xml/System.Reflection/TypeDelegator.xml index 8dd297969c4..05c3249d5ff 100644 --- a/xml/System.Reflection/TypeDelegator.xml +++ b/xml/System.Reflection/TypeDelegator.xml @@ -60,7 +60,7 @@ ## Remarks Derive from this type and override only those members you have to provide customization in, plus any members that are required by your program and not already implemented by . - derives from and implements most of the properties and methods of . For each member it implements, automatically delegates to the corresponding member of an internal object, which is supplied as an argument to the constructor. This internal object is exposed to deriving classes by the `protected` field. + derives from and implements most of the properties and methods of . For each member it implements, automatically delegates to the corresponding member of an internal object, which is supplied as an argument to the constructor. This internal object is exposed to deriving classes by the `protected` field. > [!NOTE] > Some members of have implementations even though the members themselves are simply inherited from . In these cases, the implementation is provided by an overridden `protected` method that has a name that ends in "Impl". For example, the implementation for all overloads of the method is supplied by the overridden method. The implementation for inherited properties such as and is provided by the overridden method. diff --git a/xml/System.Resources/ResXDataNode.xml b/xml/System.Resources/ResXDataNode.xml index 926591a28d8..eeb4607aa4a 100644 --- a/xml/System.Resources/ResXDataNode.xml +++ b/xml/System.Resources/ResXDataNode.xml @@ -506,7 +506,7 @@ - An object to populate with data. + An object to populate with data. The destination for this serialization. Populates a object with the data needed to serialize the target object. diff --git a/xml/System.Resources/ResXResourceReader.xml b/xml/System.Resources/ResXResourceReader.xml index 002adcb64fc..a10b7332d24 100644 --- a/xml/System.Resources/ResXResourceReader.xml +++ b/xml/System.Resources/ResXResourceReader.xml @@ -68,7 +68,7 @@ ## Examples - The following example demonstrates how to use a to iterate through the resources in a .resx file. First, the `rsxr` is created for the file `items.resx`. Next, the method is used to create an to iterate through the resources and display the contents to the console. + The following example demonstrates how to use a to iterate through the resources in a .resx file. First, the `rsxr` is created for the file `items.resx`. Next, the method is used to create an to iterate through the resources and display the contents to the console. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Resources.ResXResourceReader Example/CPP/resxresourcereader.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Resources/ResXResourceReader/Overview/resxresourcereader.cs" id="Snippet1"::: diff --git a/xml/System.Resources/ResourceManager.xml b/xml/System.Resources/ResourceManager.xml index bc69f977a86..be5461db0af 100644 --- a/xml/System.Resources/ResourceManager.xml +++ b/xml/System.Resources/ResourceManager.xml @@ -1678,7 +1678,7 @@ csc GetStream.cs /resource:AppResources.resources The name of a resource. - An object that specifies the culture to use for the resource lookup. If is , the culture for the current thread is used. + The culture to use for the resource lookup. If is , the culture for the current thread is used. Returns an unmanaged memory stream object from the specified resource, using the specified culture. An unmanaged memory stream object that represents a resource. diff --git a/xml/System.Resources/ResourceSet.xml b/xml/System.Resources/ResourceSet.xml index 9ee060e7cf5..f29d5d3c1ca 100644 --- a/xml/System.Resources/ResourceSet.xml +++ b/xml/System.Resources/ResourceSet.xml @@ -622,7 +622,7 @@ ## Examples - The following example demonstrates how to create a `rs` for the file `items.resources`. Next, the method is used to create an for `rs`. The iterates through `rs` and displays the contents to the console. + The following example demonstrates how to create a `rs` for the file `items.resources`. Next, the method is used to create an for `rs`. The iterates through `rs` and displays the contents to the console. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Resources.ResourceSet.GetEnumerator/CPP/getenumerator.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Resources/ResourceSet/.ctor/getenumerator.cs" id="Snippet1"::: diff --git a/xml/System.Runtime.Caching.Configuration/MemoryCacheElement.xml b/xml/System.Runtime.Caching.Configuration/MemoryCacheElement.xml index d930174ed5f..55f1d511c83 100644 --- a/xml/System.Runtime.Caching.Configuration/MemoryCacheElement.xml +++ b/xml/System.Runtime.Caching.Configuration/MemoryCacheElement.xml @@ -19,7 +19,7 @@ class defines a element that you can use to configure the cache. Multiple instances of the class can be used in a single application. Each `memoryCache` element in the configuration file can contain settings for a named instance. + The class defines a `memoryCache` element that you can use to configure the cache. Multiple instances of the class can be used in a single application. Each `memoryCache` element in the configuration file can contain settings for a named instance. The `memoryCache` element requires a `namedCaches` child element. To define named configurations of the cache in addition to the default configuration, you can add `namedCaches` elements. For more information about how to add named cache configurations, see [<namedCaches> Element (Cache Settings)](/dotnet/framework/configure-apps/file-schema/runtime/namedcaches-element-cache-settings). diff --git a/xml/System.Runtime.DurableInstancing/InstancePersistenceException.xml b/xml/System.Runtime.DurableInstancing/InstancePersistenceException.xml index f8d33141bb1..89befebb283 100644 --- a/xml/System.Runtime.DurableInstancing/InstancePersistenceException.xml +++ b/xml/System.Runtime.DurableInstancing/InstancePersistenceException.xml @@ -128,7 +128,7 @@ - The information about the current exception. + The information about the current exception. The contextual information about the source or destination. Initializes an instance of the class using the serialized information and the context information. To be added. diff --git a/xml/System.Runtime.InteropServices/CollectionsMarshal.xml b/xml/System.Runtime.InteropServices/CollectionsMarshal.xml index de5c959ea39..a8e33ad343e 100644 --- a/xml/System.Runtime.InteropServices/CollectionsMarshal.xml +++ b/xml/System.Runtime.InteropServices/CollectionsMarshal.xml @@ -84,7 +84,7 @@ The key used for lookup. When this method returns, contains if already existed in the dictionary, and if a new entry was added. Gets a reference to a in the specified dictionary, adding a new entry with a default value if the key does not exist. - A reference to a in the specified dictionary. + A reference to a in the specified dictionary. on the calling assembly, if any are present, are used. This method does not invoke the resolver registered using +Given a library name, this method searches specific paths based on the runtime configuration, input parameters, and attributes of the calling assembly. If the `searchPath` parameter is non-null, the flags in this enumeration are used. Otherwise, the flags specified by the on the calling assembly, if any are present, are used. This method does not invoke the resolver registered using method. Starting with .NET 5, this method does invoke the method and the event. ]]> diff --git a/xml/System.Runtime.InteropServices/RuntimeEnvironment.xml b/xml/System.Runtime.InteropServices/RuntimeEnvironment.xml index 268af6e09ce..e473648d73a 100644 --- a/xml/System.Runtime.InteropServices/RuntimeEnvironment.xml +++ b/xml/System.Runtime.InteropServices/RuntimeEnvironment.xml @@ -258,10 +258,9 @@ Reserved for future use. Must be IID_NULL. - An array of names to be mapped. + An array of names to be mapped. The count of the names to be mapped. The locale context in which to interpret the names. An array allocated by the caller that receives the identifiers corresponding to the names. diff --git a/xml/System.Runtime.InteropServices/_MemberInfo.xml b/xml/System.Runtime.InteropServices/_MemberInfo.xml index 9f1c34e80e9..05b7c98e679 100644 --- a/xml/System.Runtime.InteropServices/_MemberInfo.xml +++ b/xml/System.Runtime.InteropServices/_MemberInfo.xml @@ -283,7 +283,7 @@ Reserved for future use. Must be IID_NULL. - An array of names to be mapped. + An array of names to be mapped. The count of the names to be mapped. The locale context in which to interpret the names. An array allocated by the caller that receives the identifiers corresponding to the names. diff --git a/xml/System.Runtime.Loader/AssemblyDependencyResolver.xml b/xml/System.Runtime.Loader/AssemblyDependencyResolver.xml index 6e5f0ca5098..9565ef27a39 100644 --- a/xml/System.Runtime.Loader/AssemblyDependencyResolver.xml +++ b/xml/System.Runtime.Loader/AssemblyDependencyResolver.xml @@ -71,7 +71,8 @@ The path to the component or plugin's managed entry point. Initializes a new instance of the class with a path to a component's assembly. - `componentAssemblyPath` can be a relative or an absolute path. The assembly must have an accompanying deps.json file in the same directory that describes the assembly's dependencies. This file is output during the build process. + + can be a relative or an absolute path. The assembly must have an accompanying deps.json file in the same directory that describes the assembly's dependencies. This file is output during the build process. diff --git a/xml/System.Runtime.Serialization/ISerializationSurrogate.xml b/xml/System.Runtime.Serialization/ISerializationSurrogate.xml index c1d5352501c..2a94b8b6b8c 100644 --- a/xml/System.Runtime.Serialization/ISerializationSurrogate.xml +++ b/xml/System.Runtime.Serialization/ISerializationSurrogate.xml @@ -95,9 +95,9 @@ `info` parameter. + Extracts data from object `obj` and stores it in the `info` parameter. - Having located the surrogate, this method stores information on the object `obj` in the `info` parameter. This information describes its view of that object, including the object's fields, properties, and current values. The might correspond to the actual object, or it can be a synthesized view of the surrogate. + Having located the surrogate, this method stores information on the object `obj` in the `info` parameter. This information describes its view of that object, including the object's fields, properties, and current values. The might correspond to the actual object, or it can be a synthesized view of the surrogate. ]]> @@ -160,7 +160,7 @@ method is called during deserialization. With this method, you can take the empty `obj` that has already been created, and enter `info` data into that object. Constructors are not invoked during deserialization of information and reconstruction of the object. + The method is called during deserialization. With this method, you can take the empty `obj` that has already been created, and enter `info` data into that object. Constructors are not invoked during deserialization of information and reconstruction of the object. ]]> diff --git a/xml/System.Security.Cryptography.Pkcs/Pkcs9SigningTime.xml b/xml/System.Security.Cryptography.Pkcs/Pkcs9SigningTime.xml index 057dd220602..4f017b9c6fa 100644 --- a/xml/System.Security.Cryptography.Pkcs/Pkcs9SigningTime.xml +++ b/xml/System.Security.Cryptography.Pkcs/Pkcs9SigningTime.xml @@ -27,7 +27,7 @@ - The class defines the signing date and time of a signature. A object can be used as an authenticated attribute of a object when an authenticated date and time are to accompany a digital signature. + Defines the signing date and time of a signature. A object can be used as an authenticated attribute of a object when an authenticated date and time are to accompany a digital signature. overload with the same signature. > [!NOTE] -> If you've created the object using an existing persisted key and you want to make use of that key when decrypting the message, you want to set the property and then call the parameterless overload instead; otherwise, using this method will create an ephemeral key as specified by the `rgbKey` parameter. +> If you've created the object using an existing persisted key and you want to make use of that key when decrypting the message, you want to set the property and then call the parameterless overload instead; otherwise, using this method will create an ephemeral key as specified by the `rgbKey` parameter. ]]> @@ -454,7 +454,7 @@ This method decrypts an encrypted message created using the overload with the same signature to decrypt the result of this method. +Use this method to encrypt a message and then use the overload with the same signature to decrypt the result of this method. ]]> @@ -509,10 +509,10 @@ Use this method to encrypt a message and then use the overload with the same signature to decrypt the result of this method. + Use this method to encrypt a message and then use the overload with the same signature to decrypt the result of this method. > [!NOTE] -> If you've created the object using an existing persisted key and you want to make use of that key when encrypting the message, you want to set the property and then call the parameterless overload instead; otherwise, using this method will create an ephemeral key as specified by the `rgbKey` parameter. +> If you've created the object using an existing persisted key and you want to make use of that key when encrypting the message, you want to set the property and then call the parameterless overload instead; otherwise, using this method will create an ephemeral key as specified by the `rgbKey` parameter. ]]> diff --git a/xml/System.Security.Cryptography/DataProtector.xml b/xml/System.Security.Cryptography/DataProtector.xml index 10cce6a9adb..5d26d400de0 100644 --- a/xml/System.Security.Cryptography/DataProtector.xml +++ b/xml/System.Security.Cryptography/DataProtector.xml @@ -21,7 +21,7 @@ ## Remarks This class protects stored data from viewing and tampering. The access to the protected data is obtained by creating an instance of this class and using the exact purpose strings that were used to protect the data. The caller does not need a key to either protect or unprotect the data. The key is provided by the encryption algorithm. - Derived classes must override the and methods, which the base class calls back into. They must also override the method, which can always return `true` with a potential small loss of efficiency when applications refresh their database of stored cipher text. Derived classes should provide a constructor that calls the base class constructor, which sets the , , and properties. + Derived classes must override the and methods, which the base class calls back into. They must also override the method, which can always return `true` with a potential small loss of efficiency when applications refresh their database of stored cipher text. Derived classes should provide a constructor that calls the base class constructor, which sets the , , and properties. diff --git a/xml/System.Security.Cryptography/ECCurve.xml b/xml/System.Security.Cryptography/ECCurve.xml index bb83d7d1249..3900c2d51ee 100644 --- a/xml/System.Security.Cryptography/ECCurve.xml +++ b/xml/System.Security.Cryptography/ECCurve.xml @@ -552,7 +552,7 @@ Gets a value that indicates whether the curve type indicates a named curve. - if the curve is a named curve; if the curve is an implicit or an explicit curve (either prime or characteristic 2). + if the curve is a named curve; if the curve is an implicit or an explicit curve (either prime or characteristic 2). To be added. diff --git a/xml/System.Security.Cryptography/TripleDESCng.xml b/xml/System.Security.Cryptography/TripleDESCng.xml index 98ad8d0167d..5f3df9b7aad 100644 --- a/xml/System.Security.Cryptography/TripleDESCng.xml +++ b/xml/System.Security.Cryptography/TripleDESCng.xml @@ -390,7 +390,7 @@ This method decrypts an encrypted message created using the overload with the same signature. > [!NOTE] -> If you've created the object using an existing persisted key and you want to make use of that key when decrypting the message, you want to set the property and then call the parameterless overload instead; otherwise, using this method will create an ephemeral key as specified by the `rgbKey` parameter. +> If you've created the object using an existing persisted key and you want to make use of that key when decrypting the message, you want to set the property and then call the parameterless overload instead; otherwise, using this method will create an ephemeral key as specified by the `rgbKey` parameter. ]]> @@ -461,7 +461,7 @@ overload with the same signature to decrypt the result of this method. + Use this method to encrypt a message and then use the overload with the same signature to decrypt the result of this method. ]]> @@ -516,10 +516,10 @@ overload with the same signature to decrypt the result of this method. + Use this method to encrypt a message and then use the overload with the same signature to decrypt the result of this method. > [!NOTE] -> If you've created the object using an existing persisted key and you want to make use of that key when encrypting the message, you want to set the property and then call the parameterless overload instead; otherwise, using this method will create an ephemeral key as specified by the `rgbKey` parameter. +> If you've created the object using an existing persisted key and you want to make use of that key when encrypting the message, you want to set the property and then call the parameterless overload instead; otherwise, using this method will create an ephemeral key as specified by the `rgbKey` parameter. ]]> diff --git a/xml/System.Security.Policy/PublisherMembershipCondition.xml b/xml/System.Security.Policy/PublisherMembershipCondition.xml index e9870fa7ede..dbaa444b846 100644 --- a/xml/System.Security.Policy/PublisherMembershipCondition.xml +++ b/xml/System.Security.Policy/PublisherMembershipCondition.xml @@ -61,7 +61,7 @@ ## Remarks A code assembly satisfies a publisher membership condition if that code is signed by the specified software publisher. - By default, code access security (CAS) does not check for evidence. Unless your computer has a custom code group based on the class, you can improve performance by bypassing Authenticode signature verification. This is accomplished by configuring the runtime to not provide evidence for CAS. For more information about how to configure this option and which applications can use it, see the element. + By default, code access security (CAS) does not check for evidence. Unless your computer has a custom code group based on the class, you can improve performance by bypassing Authenticode signature verification. This is accomplished by configuring the runtime to not provide evidence for CAS. For more information about how to configure this option and which applications can use it, see the \ element. ]]> diff --git a/xml/System.Security/AllowPartiallyTrustedCallersAttribute.xml b/xml/System.Security/AllowPartiallyTrustedCallersAttribute.xml index 72ac428b7c3..1f847c5a5eb 100644 --- a/xml/System.Security/AllowPartiallyTrustedCallersAttribute.xml +++ b/xml/System.Security/AllowPartiallyTrustedCallersAttribute.xml @@ -67,7 +67,7 @@ By default, if a strong-named, assembly does not explicitly apply this attribute at the assembly level, it can be called only by other assemblies that are granted full trust. This restriction is enforced by placing a for `FullTrust` on every public or protected method on every publicly accessible class in the assembly. Assemblies that are intended to be called by partially trusted code can declare their intent through the use of . An example of the declaration in C# is `[assembly:AllowPartiallyTrustedCallers]`; an example in Visual Basic is ``. > [!CAUTION] -> The presence of this assembly-level attribute prevents the default behavior of placing `FullTrust` security checks, and makes the assembly callable from any other (partially or fully trusted) assembly. +> The presence of this assembly-level attribute prevents the default behavior of placing `FullTrust` security checks, and makes the assembly callable from any other (partially or fully trusted) assembly. When the APTCA attribute is present, all other security checks function as intended, including any class-level or method-level declarative security attributes that are present. This attribute blocks only the implicit, fully trusted caller demand. diff --git a/xml/System.Security/NamedPermissionSet.xml b/xml/System.Security/NamedPermissionSet.xml index 1bb8d1df769..92c9a768f1f 100644 --- a/xml/System.Security/NamedPermissionSet.xml +++ b/xml/System.Security/NamedPermissionSet.xml @@ -178,7 +178,7 @@ interface. The named permission set will contain all built-in permissions as well as all custom permissions. All permissions will have an `Unrestricted`. Permissions that do not implement , such as identity permissions, will be empty instances. + A named permission set in an unrestricted state effectively contains all permissions that implement the interface. The named permission set will contain all built-in permissions as well as all custom permissions. All permissions will have an `Unrestricted` . Permissions that do not implement , such as identity permissions, will be empty instances. ]]> diff --git a/xml/System.Security/PermissionSet.xml b/xml/System.Security/PermissionSet.xml index 0fe64de76d4..489d042f3c3 100644 --- a/xml/System.Security/PermissionSet.xml +++ b/xml/System.Security/PermissionSet.xml @@ -263,7 +263,7 @@ , the new permission is the union of the existing permission object and the specified permission object. For example, if a permission that implements is added to an , the resulting union is the original `Unrestricted`. + If a permission of the same type as the added permission already exists in the , the new permission is the union of the existing permission object and the specified permission object. For example, if a permission that implements is added to an , the resulting union is the original `Unrestricted` . @@ -332,7 +332,7 @@ ## Remarks The method is the implementation for the method. - If a permission of the same type as the added permission already exists in the , the new permission is the union of the existing permission object and the specified permission object. For example, if a permission that implements is added to an , the resulting union is the original `Unrestricted`. + If a permission of the same type as the added permission already exists in the , the new permission is the union of the existing permission object and the specified permission object. For example, if a permission that implements is added to an , the resulting union is the original `Unrestricted` . ]]> @@ -1171,7 +1171,7 @@ . Although an `Unrestricted` effectively contains all permissions, it does not have any actual instances to return. + The method returns `null` for an `Unrestricted` . Although an `Unrestricted` effectively contains all permissions, it does not have any actual instances to return. ]]> @@ -1224,7 +1224,7 @@ ## Remarks The method is the implementation for the method. - The method returns `null` for an `Unrestricted`. Although an `Unrestricted` effectively contains all permissions, it does not have any actual instances to return. + The method returns `null` for an `Unrestricted` . Although an `Unrestricted` effectively contains all permissions, it does not have any actual instances to return. ]]> @@ -1596,7 +1596,7 @@ effectively contains all permissions that implement the interface. + An `Unrestricted` effectively contains all permissions that implement the interface. diff --git a/xml/System.ServiceModel.Activities.Configuration/SendMessageChannelCacheElement.xml b/xml/System.ServiceModel.Activities.Configuration/SendMessageChannelCacheElement.xml index 83b9da311fb..07267f4cd3f 100644 --- a/xml/System.ServiceModel.Activities.Configuration/SendMessageChannelCacheElement.xml +++ b/xml/System.ServiceModel.Activities.Configuration/SendMessageChannelCacheElement.xml @@ -37,7 +37,7 @@ - Creates a new instance of the class. + Creates a new instance of the class. To be added. diff --git a/xml/System.ServiceModel.Activities/IWorkflowInstanceManagement.xml b/xml/System.ServiceModel.Activities/IWorkflowInstanceManagement.xml index e9b42e875de..ab86ddb8eef 100644 --- a/xml/System.ServiceModel.Activities/IWorkflowInstanceManagement.xml +++ b/xml/System.ServiceModel.Activities/IWorkflowInstanceManagement.xml @@ -553,7 +553,7 @@ diff --git a/xml/System.ServiceModel.Channels/SslStreamSecurityBindingElement.xml b/xml/System.ServiceModel.Channels/SslStreamSecurityBindingElement.xml index 1264d481e59..3207c2090b9 100644 --- a/xml/System.ServiceModel.Channels/SslStreamSecurityBindingElement.xml +++ b/xml/System.ServiceModel.Channels/SslStreamSecurityBindingElement.xml @@ -596,7 +596,7 @@ namespace ServiceNamespace The type of the object to get. A . Gets a specified object from the . - The object of type from the , or if the object is not found. + The object of type from the , or if the object is not found. `abstract` class. + This method is called when opening the client channel factory and provides a custom implementation of the `abstract` class. The parameter enables reacting to other elements in the channel stack. @@ -156,7 +156,7 @@ `abstract` class. + This method is called when opening the service and provides a custom implementation of the `abstract` class. The parameter enables reacting to other elements in the channel stack. diff --git a/xml/System.ServiceModel.Dispatcher/IDispatchMessageInspector.xml b/xml/System.ServiceModel.Dispatcher/IDispatchMessageInspector.xml index 4779c3fddd6..5e65cef2d7c 100644 --- a/xml/System.ServiceModel.Dispatcher/IDispatchMessageInspector.xml +++ b/xml/System.ServiceModel.Dispatcher/IDispatchMessageInspector.xml @@ -43,12 +43,12 @@ [!code-csharp[Interceptors#7](~/snippets/csharp/VS_Snippets_CFX/interceptors/cs/interceptors.cs#7)] [!code-vb[Interceptors#7](~/snippets/visualbasic/VS_Snippets_CFX/interceptors/vb/interceptors.vb#7)] - The following code example shows the implementation of an that adds the `Inspector` to the collection. + The following code example shows the implementation of an that adds the `Inspector` to the collection. [!code-csharp[Interceptors#8](~/snippets/csharp/VS_Snippets_CFX/interceptors/cs/insertingbehaviors.cs#8)] [!code-vb[Interceptors#8](~/snippets/visualbasic/VS_Snippets_CFX/interceptors/vb/insertingbehaviors.vb#8)] - The following code example shows the use of an application configuration file to load the service behavior that inserts the `Inspector`. + The following code example shows the use of an application configuration file to load the service behavior that inserts the `Inspector` . [!code-xml[Interceptors#9](~/snippets/csharp/VS_Snippets_CFX/interceptors/cs/hostapplication.exe.config#9)] @@ -104,12 +104,12 @@ [!code-csharp[Interceptors#7](~/snippets/csharp/VS_Snippets_CFX/interceptors/cs/interceptors.cs#7)] [!code-vb[Interceptors#7](~/snippets/visualbasic/VS_Snippets_CFX/interceptors/vb/interceptors.vb#7)] - The following code example shows the implementation of an that adds the `Inspector` to the collection. + The following code example shows the implementation of an that adds the `Inspector` to the collection. [!code-csharp[Interceptors#8](~/snippets/csharp/VS_Snippets_CFX/interceptors/cs/insertingbehaviors.cs#8)] [!code-vb[Interceptors#8](~/snippets/visualbasic/VS_Snippets_CFX/interceptors/vb/insertingbehaviors.vb#8)] - The following code example shows the use of an application configuration file to load the service behavior that inserts the `Inspector`. + The following code example shows the use of an application configuration file to load the service behavior that inserts the `Inspector` . [!code-xml[Interceptors#9](~/snippets/csharp/VS_Snippets_CFX/interceptors/cs/hostapplication.exe.config#9)] @@ -159,12 +159,12 @@ [!code-csharp[Interceptors#7](~/snippets/csharp/VS_Snippets_CFX/interceptors/cs/interceptors.cs#7)] [!code-vb[Interceptors#7](~/snippets/visualbasic/VS_Snippets_CFX/interceptors/vb/interceptors.vb#7)] - The following code example shows the implementation of an that adds the `Inspector` to the collection. + The following code example shows the implementation of an that adds the `Inspector` to the collection. [!code-csharp[Interceptors#8](~/snippets/csharp/VS_Snippets_CFX/interceptors/cs/insertingbehaviors.cs#8)] [!code-vb[Interceptors#8](~/snippets/visualbasic/VS_Snippets_CFX/interceptors/vb/insertingbehaviors.vb#8)] - The following code example shows the use of an application configuration file to load the service behavior that inserts the `Inspector`. + The following code example shows the use of an application configuration file to load the service behavior that inserts the `Inspector` . [!code-xml[Interceptors#9](~/snippets/csharp/VS_Snippets_CFX/interceptors/cs/hostapplication.exe.config#9)] diff --git a/xml/System.ServiceModel.Dispatcher/MessageFilter.xml b/xml/System.ServiceModel.Dispatcher/MessageFilter.xml index 161d6213055..dc96ed94e5b 100644 --- a/xml/System.ServiceModel.Dispatcher/MessageFilter.xml +++ b/xml/System.ServiceModel.Dispatcher/MessageFilter.xml @@ -49,7 +49,7 @@ The criteria used by a filter cannot be changed once the filter is constructed because the filter tables have no way to detect a change. The only way to modify the criteria of a filter is to construct a new one and delete the existing filter. - The following classes implement the `abstract` class: + The following classes implement the `abstract` class: - uses an XPath 1.0 expression to specify the criteria for a match. diff --git a/xml/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml b/xml/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml index dbba89db989..48913626c3c 100644 --- a/xml/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml +++ b/xml/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml @@ -984,7 +984,7 @@ ## Remarks Use this method when more than one filter is expected to match the buffered message and only the `FilterData` is required. - The `FilterData` of the matching objects are stored in the `results`. + The `FilterData` of the matching objects are stored in the `results` . This method implements . diff --git a/xml/System.ServiceModel.Dispatcher/XPathMessageFilterTable`1.xml b/xml/System.ServiceModel.Dispatcher/XPathMessageFilterTable`1.xml index ea8fe3b7937..b86c156b670 100644 --- a/xml/System.ServiceModel.Dispatcher/XPathMessageFilterTable`1.xml +++ b/xml/System.ServiceModel.Dispatcher/XPathMessageFilterTable`1.xml @@ -1104,7 +1104,7 @@ ## Remarks Use this method when more than one filter is expected to match the buffered message and only the filter data is required. - The filter data of the matching objects are stored in the `results`. + The filter data of the matching objects are stored in the `results` . This method implements . diff --git a/xml/System.ServiceModel.PeerResolvers/RegisterInfo.xml b/xml/System.ServiceModel.PeerResolvers/RegisterInfo.xml index 3f162813a42..7647b194ec7 100644 --- a/xml/System.ServiceModel.PeerResolvers/RegisterInfo.xml +++ b/xml/System.ServiceModel.PeerResolvers/RegisterInfo.xml @@ -21,7 +21,7 @@ - Defines the peer registration information to be supplied to a peer resolver service. + Defines the peer registration information to be supplied to a peer resolver service. When this method returns, contains the property extracted from the message. Gets the property from the specified message. - if the property was found; otherwise, . + if the property was found; otherwise, . To be added. @@ -197,7 +197,7 @@ When this method returns, contains the property extracted from the message. Gets the property from the specified object. - if the property was found; otherwise, . + if the property was found; otherwise, . To be added. diff --git a/xml/System.ServiceModel.Syndication/AtomPub10ServiceDocumentFormatter.xml b/xml/System.ServiceModel.Syndication/AtomPub10ServiceDocumentFormatter.xml index f53debdb281..9df8ecd9e4c 100644 --- a/xml/System.ServiceModel.Syndication/AtomPub10ServiceDocumentFormatter.xml +++ b/xml/System.ServiceModel.Syndication/AtomPub10ServiceDocumentFormatter.xml @@ -525,7 +525,7 @@ - The XML writer written to by the formatter. + The XML writer written to by the formatter. Writes a object associated with the formatter to a specified XML writer. To be added. diff --git a/xml/System.ServiceModel.Syndication/SyndicationFeed.xml b/xml/System.ServiceModel.Syndication/SyndicationFeed.xml index 6071c6c4a10..82655ce0e24 100644 --- a/xml/System.ServiceModel.Syndication/SyndicationFeed.xml +++ b/xml/System.ServiceModel.Syndication/SyndicationFeed.xml @@ -55,7 +55,7 @@ |`Description`|A `` element.| |`ElementExtensions`|Each element in the collection is written within the `` element.| |`Generator`|A `` element.| -|`Id`|An ``element.| +|`Id`|An `` element.| |`ImageUri`|A `` element.| |`Items`|An `` element for each in the collection.| |`Language`|Not serialized.| @@ -1737,7 +1737,7 @@ property is written to an ``element. + When serialized to Atom 1.0, the property is written to an `` element. When serialized to RSS 2.0, the property is written to a `` element. diff --git a/xml/System.ServiceModel.Syndication/SyndicationItem.xml b/xml/System.ServiceModel.Syndication/SyndicationItem.xml index 287c91f5b2a..6645005076a 100644 --- a/xml/System.ServiceModel.Syndication/SyndicationItem.xml +++ b/xml/System.ServiceModel.Syndication/SyndicationItem.xml @@ -49,9 +49,9 @@ |------------------------------|---------------------| ||Attribute in the `` element.| ||An `` element for each author in the collection.| -||A`` element.| -||A`` element.| -||A`` element for each contributor in the collection.| +||A `` element.| +||A `` element.| +||A `` element for each contributor in the collection.| ||A`` element.| ||Element in the `` element.| ||An `` element.| diff --git a/xml/System.ServiceModel/DnsEndpointIdentity.xml b/xml/System.ServiceModel/DnsEndpointIdentity.xml index e635dc9c98b..51d8036613f 100644 --- a/xml/System.ServiceModel/DnsEndpointIdentity.xml +++ b/xml/System.ServiceModel/DnsEndpointIdentity.xml @@ -38,7 +38,7 @@ diff --git a/xml/System.ServiceProcess/ServiceInstaller.xml b/xml/System.ServiceProcess/ServiceInstaller.xml index 89e806469b2..b2dfc7337c1 100644 --- a/xml/System.ServiceProcess/ServiceInstaller.xml +++ b/xml/System.ServiceProcess/ServiceInstaller.xml @@ -521,7 +521,7 @@ ## Remarks A service can require other services to be running before it can start. The information from this property is written to a key in the registry. When the user (or the system, in the case of automatic startup) tries to run the service, the Service Control Manager (SCM) verifies that each of the services in the array has already been started. - If any service in the array is not running then, the SCM tries to start them. This includes services with `Manual`. + If any service in the array is not running then, the SCM tries to start them. This includes services with `Manual` . If any service upon which this service depends fails to start, this service will not start. An exception is not thrown if the system is not started because there is no exception handling at the system level to detect this. Decide how to handle service start failures and implement this in your code. Typically, a dialog appears to the user at startup if a service fails to start. diff --git a/xml/System.Speech.Synthesis.TtsEngine/FragmentState.xml b/xml/System.Speech.Synthesis.TtsEngine/FragmentState.xml index 7941f3e8645..abaac3b54fa 100644 --- a/xml/System.Speech.Synthesis.TtsEngine/FragmentState.xml +++ b/xml/System.Speech.Synthesis.TtsEngine/FragmentState.xml @@ -103,7 +103,7 @@ - If negative a member of the enumeration - If the value specified by the `action` argument is not `emphasis` argument must be of type . + If the value specified by the `action` argument is not , the `emphasis` argument must be of type . If the value of the `duration` argument and The property or the object specified by the `prosody` argument differ, the value on the object is used. diff --git a/xml/System.Text.RegularExpressions/Regex.xml b/xml/System.Text.RegularExpressions/Regex.xml index 5745fb1b38d..afa1a023faa 100644 --- a/xml/System.Text.RegularExpressions/Regex.xml +++ b/xml/System.Text.RegularExpressions/Regex.xml @@ -4681,7 +4681,7 @@ Allows an to attempt to free resources and perfor - The replacement string results from conditional processing. - The method is equivalent to calling the method and passing the first `count` objects in the returned collection to the `evaluator` delegate. + The method is equivalent to calling the method and passing the first `count` objects in the returned collection to the `evaluator` delegate. The regular expression is the pattern defined by the constructor for the current object. @@ -5099,7 +5099,7 @@ Allows an to attempt to free resources and perfor - The replacement string results from conditional processing. - The method is equivalent to calling the method and passing the first `count` objects in the returned collection to the `evaluator` delegate. + The method is equivalent to calling the method and passing the first `count` objects in the returned collection to the `evaluator` delegate. The regular expression is the pattern defined by the constructor for the current object. diff --git a/xml/System.Text/Encoding.xml b/xml/System.Text/Encoding.xml index a310dd855fe..654eda384c2 100644 --- a/xml/System.Text/Encoding.xml +++ b/xml/System.Text/Encoding.xml @@ -518,7 +518,7 @@ The following table lists the encodings supported by .NET. It lists each encodin Gets an encoding for the ASCII (7-bit) character set. - An encoding for the ASCII (7-bit) character set. + An encoding for the ASCII (7-bit) character set. Gets an encoding for the UTF-32 format using the little endian byte order. - An encoding object for the UTF-32 format using the little endian byte order. + An encoding object for the UTF-32 format using the little endian byte order. The end index, exclusive. The delegate that is invoked once per iteration. Executes a loop in which iterations may run in parallel and the state of the loop can be monitored and manipulated. - A structure that contains information about which portion of the loop completed. + A structure that contains information about which portion of the loop completed. An object that configures the behavior of this operation. The delegate that is invoked once per iteration. Executes a loop in which iterations may run in parallel and loop options can be configured. - A structure that contains information about which portion of the loop completed. + A structure that contains information about which portion of the loop completed. The delegate that is invoked once per iteration. The delegate that performs a final action on the local state of each task. Executes a loop with thread-local data in which iterations may run in parallel, and the state of the loop can be monitored and manipulated. - A structure that contains information about which portion of the loop completed. + A structure that contains information about which portion of the loop completed. An object that configures the behavior of this operation. The delegate that is invoked once per iteration. Executes a ( in Visual Basic) operation on a in which iterations may run in parallel, loop options can be configured, and the state of the loop can be monitored and manipulated. - A structure that contains information about which portion of the loop completed. + A structure that contains information about which portion of the loop completed. and methods. If the token's property is `true` or becomes `true` while the method is executing, the method throws an . + You can also supply a cancellation token by calling the and methods. If the token's property is `true` or becomes `true` while the method is executing, the method throws an . In some cases, you may want to wait for the first of a series of executing tasks to complete, but don't care which task it is. For this purpose, you can call one of the overloads of the method. The following example creates three tasks, each of which sleeps for an interval determined by a random number generator. The method waits for the first task to complete. The example then displays information about the status of all three tasks. @@ -1212,7 +1212,7 @@ End Class will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled. + The returned will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled. ]]> @@ -1330,7 +1330,7 @@ End Class will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled. + The returned will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled. ]]> @@ -1498,7 +1498,7 @@ End Sub will not be scheduled for execution until the current task has completed. If the criteria specified through the `continuationOptions` parameter are not met, the continuation task will be canceled instead of scheduled. + The returned will not be scheduled for execution until the current task has completed. If the criteria specified through the `continuationOptions` parameter are not met, the continuation task will be canceled instead of scheduled. ]]> @@ -1626,7 +1626,7 @@ End Sub will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled. + The returned will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled. ]]> @@ -1877,7 +1877,7 @@ End Sub will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled. + The returned will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled. ]]> @@ -2003,7 +2003,7 @@ End Sub will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled. + The returned will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled. ]]> @@ -2150,7 +2150,7 @@ End Sub will not be scheduled for execution until the current task has completed. If the criteria specified through the `continuationOptions` parameter are not met, the continuation task will be canceled instead of scheduled. + The returned will not be scheduled for execution until the current task has completed. If the criteria specified through the `continuationOptions` parameter are not met, the continuation task will be canceled instead of scheduled. ]]> @@ -3518,7 +3518,7 @@ Starting in .NET 6, for some `T` types and some result values, this method may r The work to execute asynchronously. - Queues the specified work to run on the thread pool and returns a proxy for the task returned by . + Queues the specified work to run on the thread pool and returns a proxy for the task returned by . A task that represents a proxy for the task returned by . will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled. + The returned will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled. ]]> @@ -1272,7 +1272,7 @@ For operations that do not return a value, you use the will not be scheduled for execution until the current task has completed. If the criteria specified through the `continuationOptions` parameter are not met, the continuation task will be canceled instead of scheduled. + The returned will not be scheduled for execution until the current task has completed. If the criteria specified through the `continuationOptions` parameter are not met, the continuation task will be canceled instead of scheduled. ]]> @@ -1800,7 +1800,7 @@ For operations that do not return a value, you use the will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled. + The returned will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled. ]]> @@ -1947,7 +1947,7 @@ For operations that do not return a value, you use the will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled. + The returned will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled. The `continuationFunction`, when executed, should return a . This task's completion state will be transferred to the task returned from the call. diff --git a/xml/System.Threading/EventWaitHandle.xml b/xml/System.Threading/EventWaitHandle.xml index 4919b977350..927ace59cec 100644 --- a/xml/System.Threading/EventWaitHandle.xml +++ b/xml/System.Threading/EventWaitHandle.xml @@ -550,7 +550,7 @@ There was some other error. The `HResult` property may provide more information. The name of the synchronization object to be opened and shared with other processes. The name is case-sensitive. Opens the specified named synchronization event, if it already exists. - An object that represents the named system event. + An object that represents the named system event. object that fires its event every two seconds (2000 milliseconds), sets up an event handler for the event, and starts the timer. The event handler displays the value of the property each time it is raised. + The following example instantiates a object that fires its event every two seconds (2000 milliseconds), sets up an event handler for the event, and starts the timer. The event handler displays the value of the property each time it is raised. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.timers.timer/cpp/timer1.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Timers/ElapsedEventArgs/Overview/timer1.cs" id="Snippet1"::: @@ -101,7 +101,7 @@ ## Examples - The following example instantiates a object that fires its event every two seconds (2000 milliseconds), sets up an event handler for the event, and starts the timer. The event handler displays the value of the property each time it is raised. + The following example instantiates a object that fires its event every two seconds (2000 milliseconds), sets up an event handler for the event, and starts the timer. The event handler displays the value of the property each time it is raised. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.timers.timer/cpp/timer1.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Timers/ElapsedEventArgs/Overview/timer1.cs" id="Snippet1"::: diff --git a/xml/System.Timers/Timer.xml b/xml/System.Timers/Timer.xml index 74d4df26a6b..28743437e76 100644 --- a/xml/System.Timers/Timer.xml +++ b/xml/System.Timers/Timer.xml @@ -92,7 +92,7 @@ For a list of default property values for an instance of , see the constructor. > [!TIP] -> Be aware that .NET includes four classes named `Timer`, each of which offers different functionality: +> .NET includes four classes named `Timer`, each of which offers different functionality: > > - (this topic): fires an event at regular intervals. The class is intended for use as a server-based or service component in a multithreaded environment; it has no user interface and is not visible at runtime. > - : executes a single callback method on a thread pool thread at regular intervals. The callback method is defined when the timer is instantiated and cannot be changed. Like the class, this class is intended for use as a server-based or service component in a multithreaded environment; it has no user interface and is not visible at runtime. @@ -100,7 +100,7 @@ > - (.NET Framework only): an ASP.NET component that performs asynchronous or synchronous web page postbacks at a regular interval. ## Examples - The following example instantiates a `System.Timers.Timer` object that fires its event every two seconds (2,000 milliseconds), sets up an event handler for the event, and starts the timer. The event handler displays the value of the property each time it is raised. + The following example instantiates a `System.Timers.Timer` object that fires its event every two seconds (2,000 milliseconds), sets up an event handler for the event, and starts the timer. The event handler displays the value of the property each time it is raised. :::code language="csharp" source="~/snippets/csharp/System.Timers/ElapsedEventArgs/Overview/timer2a.cs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.timers.timer/vb/timer2a.vb" id="Snippet2"::: @@ -619,7 +619,7 @@ > Some visual designers, such as those in Microsoft Visual Studio, set the property to `true` when inserting a new . ## Examples - The following example instantiates a object that fires its event every two seconds (2000 milliseconds), sets up an event handler for the event, and starts the timer. The event handler displays the value of the property each time it is raised. + The following example instantiates a object that fires its event every two seconds (2000 milliseconds), sets up an event handler for the event, and starts the timer. The event handler displays the value of the property each time it is raised. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.timers.timer/cpp/timer1.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Timers/ElapsedEventArgs/Overview/timer1.cs" id="Snippet1"::: @@ -955,7 +955,7 @@ > The signal to raise the event is always queued for execution on a thread, so the event-handling method might run on one thread at the same time that a call to the method runs on another thread. This might result in the event being raised after the method is called. The second code example in the Examples section shows one way to work around this race condition. ## Examples - The following example instantiates a `System.Timers.Timer` object that fires its event every two seconds (2,000 milliseconds), sets up an event handler for the event, and starts the timer. The event handler displays the value of the property each time it is raised. When the user presses the Enter key, the application calls the method before terminating the application. + The following example instantiates a `System.Timers.Timer` object that fires its event every two seconds (2,000 milliseconds), sets up an event handler for the event, and starts the timer. The event handler displays the value of the property each time it is raised. When the user presses the Enter key, the application calls the method before terminating the application. :::code language="csharp" source="~/snippets/csharp/System.Timers/ElapsedEventArgs/Overview/timer2a.cs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.timers.timer/vb/timer2a.vb" id="Snippet2"::: diff --git a/xml/System.Workflow.Activities/ConditionedActivityGroup.xml b/xml/System.Workflow.Activities/ConditionedActivityGroup.xml index 050e917957d..773242cda98 100644 --- a/xml/System.Workflow.Activities/ConditionedActivityGroup.xml +++ b/xml/System.Workflow.Activities/ConditionedActivityGroup.xml @@ -471,7 +471,7 @@ to `null`, which means the `BookingCAG` class never completes. This code example is part of the ConditionedActivityGroup SDK Sample from the SimpleCAGWorkflow.Designer.cs file. For more information, see [Using ConditionedActivityGroup](https://msdn.microsoft.com/library/5a0b7e9e-def5-46b2-acbb-0005e1aff984). + The following code example shows how to set the to `null`, which means the `BookingCAG` class never completes. This code example is part of the ConditionedActivityGroup SDK Sample from the SimpleCAGWorkflow.Designer.cs file. For more information, see [Using ConditionedActivityGroup](https://msdn.microsoft.com/library/5a0b7e9e-def5-46b2-acbb-0005e1aff984). :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wf_samples/cs/snippets11.cs" id="Snippet159"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/wf_samples/vb/snippets11.vb" id="Snippet159"::: diff --git a/xml/System.Xaml/XamlMember.xml b/xml/System.Xaml/XamlMember.xml index 5647347dd4d..2761e0110b2 100644 --- a/xml/System.Xaml/XamlMember.xml +++ b/xml/System.Xaml/XamlMember.xml @@ -42,13 +42,11 @@ For a load path that involves , such a member cannot be written into an object graph. Using the .NET Framework XAML services implementation, the call throws a when the relevant reports `true` for . - You should not construct a that has a value of `true` for unless your implementation can handle the exceptions from , or you have other ways to adjust the behavior. For example, one or more of the following might be true of your implementation: + You should not construct a that has a value of `true` for unless your implementation can handle the exceptions from , or you have other ways to adjust the behavior. For example, one or more of the following might be true of your implementation: -- The XAML schema context is available later. - -- You use a member invoker pattern. - -- You deliberately override in a custom XAML writer. +- The XAML schema context is available later. +- You use a member invoker pattern. +- You deliberately override in a custom XAML writer. ]]> @@ -290,7 +288,7 @@ For a load path that involves , such a member cannot be written into an object graph. Using the .NET Framework XAML Services implementation, the call throws a when the relevant reports `true` for . - You should not construct a with `true` unless your implementation can handle the exceptions from , or you have other ways to adjust the behavior. For example, one or more of the following might be true of your implementation: + You should not construct a with `true` unless your implementation can handle the exceptions from , or you have other ways to adjust the behavior. For example, one or more of the following might be true of your implementation: - The XAML schema context is available later. diff --git a/xml/System.Xaml/XamlXmlWriter.xml b/xml/System.Xaml/XamlXmlWriter.xml index f334e1114a8..9e48bf6e8af 100644 --- a/xml/System.Xaml/XamlXmlWriter.xml +++ b/xml/System.Xaml/XamlXmlWriter.xml @@ -31,7 +31,7 @@ The XAML namespace writing behavior of is complex and is not limited to explicit calls to . Instead, other `Write` calls, such as , might require that the namespace declaration be written at particular points in the node structure. The XAML writer either generates a prefix by its own logic, or uses information from the service to determine a preferred prefix. Also, explicit calls might defer or might return nothing if the XAML namespace declaration is already applicable and declared elsewhere. ## Write Method Exceptions - Exceptions thrown by the `Write` methods are typically either or . + Exceptions thrown by the `Write` methods are typically either or . An often indicates that a XAML reader passed an invalid node structure into the XAML node stream. In this case the node structure is invalid for reasons that are not related to validation of a XAML schema or a XAML schema context. Rather, the node stream is invalid in its basic form. For example, if a faulty XAML reader implementation generated a XAML node stream that contained two consecutive `StartObject` nodes, the attempt to call the second would throw an . All XAML writers would consider such an operation to be invalid. Another example of an is when XAML namespace information is unavailable through the XAML schema context that applies to the current node stream position. diff --git a/xml/System.Xml.Schema/XmlSchema.xml b/xml/System.Xml.Schema/XmlSchema.xml index 6e38784a9cf..f07f99db65e 100644 --- a/xml/System.Xml.Schema/XmlSchema.xml +++ b/xml/System.Xml.Schema/XmlSchema.xml @@ -1187,7 +1187,7 @@ schema.Includes.Add(include); The supplied data stream. The validation event handler that receives information about XML Schema syntax errors. - Reads an XML Schema from the supplied stream. + Reads an XML Schema from the supplied stream. The object representing the XML Schema. To be added. An is raised if no is specified. diff --git a/xml/System.Xml.Schema/XmlValueGetter.xml b/xml/System.Xml.Schema/XmlValueGetter.xml index 663cb969ea3..d91a8868720 100644 --- a/xml/System.Xml.Schema/XmlValueGetter.xml +++ b/xml/System.Xml.Schema/XmlValueGetter.xml @@ -45,7 +45,7 @@ `delegate` is useful if the CLR value of an attribute, text, or white space node is already available, and avoids the cost of converting it to a `string` and then reparsing it again for validation. + An `delegate` is useful if the CLR value of an attribute, text, or white space node is already available, and avoids the cost of converting it to a `string` and then reparsing it again for validation. For more information about the class, see the [XmlSchemaValidator Push-Based Validation](/dotnet/standard/data/xml/xmlschemavalidator-push-based-validation) topic, or the class reference documentation. diff --git a/xml/System.Xml.Serialization.Configuration/DateTimeSerializationSection+DateTimeSerializationMode.xml b/xml/System.Xml.Serialization.Configuration/DateTimeSerializationSection+DateTimeSerializationMode.xml index 901d45a8280..e568454c032 100644 --- a/xml/System.Xml.Serialization.Configuration/DateTimeSerializationSection+DateTimeSerializationMode.xml +++ b/xml/System.Xml.Serialization.Configuration/DateTimeSerializationSection+DateTimeSerializationMode.xml @@ -23,7 +23,7 @@ In versions 1.0 and 1.1 of .NET Framework, as well as in versions 2.0 and later when this property is set to `Local`, objects are always formatted as the local time. That is, local time zone information is always included with the serialized data. Set this property to `Local` to ensure compatibility with older versions of the .NET Framework. - In versions 2.0 and later of the .NET Framework, with this property set to `Roundtrip` objects are examined to determine whether they are in the local, UTC or an unspecified time zone, and are serialized in such a way that this information is preserved. This is the default behavior and is recommended for all new applications that do not communicate with older versions of the framework. + In versions 2.0 and later of the .NET Framework, with this property set to `Roundtrip` objects are examined to determine whether they are in the local, UTC or an unspecified time zone, and are serialized in such a way that this information is preserved. This is the default behavior and is recommended for all new applications that do not communicate with older versions of the framework. ]]> diff --git a/xml/System.Xml.XPath/XPathNavigator.xml b/xml/System.Xml.XPath/XPathNavigator.xml index 4f5bf727800..ace9aa6d37f 100644 --- a/xml/System.Xml.XPath/XPathNavigator.xml +++ b/xml/System.Xml.XPath/XPathNavigator.xml @@ -7738,7 +7738,7 @@ navigator.PrependChildElement(navigator.Prefix, "pages", LookupNamespaceURI(navi , , or on nodes with a non-`null`. If the current node is not one of the above node types, or if the instance does not report schema information, the property returns `null`. + Schema information can be set on , , or on nodes with a non-`null` . If the current node is not one of the above node types, or if the instance does not report schema information, the property returns `null`. ]]> diff --git a/xml/System.Xml/XmlDictionaryReader.xml b/xml/System.Xml/XmlDictionaryReader.xml index 0907474c0c2..eab94f09c5a 100644 --- a/xml/System.Xml/XmlDictionaryReader.xml +++ b/xml/System.Xml/XmlDictionaryReader.xml @@ -1110,7 +1110,7 @@ . The message is of the specified MIME type. If `contentType` is `null`, the Content-Type MIME header must be present in the message. + This method reads from a buffer with a specified offset and count, using one of the character encodings specified by `encodings`, an array of instances of . The message is of the specified MIME type. If `contentType` is `null`, the Content-Type MIME header must be present in the message. ]]> diff --git a/xml/System/ArgumentOutOfRangeException.xml b/xml/System/ArgumentOutOfRangeException.xml index 17487c8b561..5e266c2788f 100644 --- a/xml/System/ArgumentOutOfRangeException.xml +++ b/xml/System/ArgumentOutOfRangeException.xml @@ -226,7 +226,7 @@ The conditions in which an exception i - Ensure that shared state (that is, resources that can be accessed by multiple threads) is accessed in a thread-safe way, so that only one thread at a time has exclusive access to the resources. A large number of classes, such as , , , and , are available to synchronize access to resources. For more information, see [Threading](/dotnet/standard/threading/). In addition, language support is available through the [lock](/dotnet/csharp/language-reference/keywords/lock-statement) statement in C# and the [SyncLock](/dotnet/visual-basic/language-reference/statements/synclock-statement) construct in Visual Basic. - The following example addresses the and the other issues from the previous example. It replaces the object with a object to ensure that access to the collection is thread-safe, uses a object to ensure that the application thread continues only after other threads have executed, and uses a lock to ensure that only one thread can access the `msg` variable at a time. + The following example addresses the and the other issues from the previous example. It replaces the object with a object to ensure that access to the collection is thread-safe, uses a object to ensure that the application thread continues only after other threads have executed, and uses a lock to ensure that only one thread can access the `msg` variable at a time. :::code language="csharp" source="~/snippets/csharp/System/ArgumentOutOfRangeException/Overview/Race2.cs" id="Snippet12"::: :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/System.ArgumentOutOfRangeException/fs/Race2.fs" id="Snippet12"::: diff --git a/xml/System/Array.xml b/xml/System/Array.xml index 0a3155acbf6..c1c06581081 100644 --- a/xml/System/Array.xml +++ b/xml/System/Array.xml @@ -5799,7 +5799,7 @@ This method is an O(`n`) operation, where `n` is the of `array`. - In .NET Framework 2.0 and later versions, this method uses the and methods of the to determine whether the specified by the `value` parameter exists. In earlier versions of .NET Framework, this determination was made by using the and methods of the `value` itself. + In .NET Framework 2.0 and later versions, this method uses the and methods of the to determine whether the specified by the `value` parameter exists. In earlier versions of .NET Framework, this determination was made by using the and methods of the `value` itself. methods of the `item` parameter on the objects in the collection. @@ -5887,7 +5887,7 @@ This method is an O(`n`) operation, where `n` is the number of elements from the beginning of `array` to `startIndex`. - In .NET Framework 2.0 and later versions, this method uses the and methods of the to determine whether the specified by the `value` parameter exists. In earlier versions of .NET Framework, this determination was made by using the and methods of the `value` itself. + In .NET Framework 2.0 and later versions, this method uses the and methods of the to determine whether the specified by the `value` parameter exists. In earlier versions of .NET Framework, this determination was made by using the and methods of the `value` itself. ## Examples The following code example shows how to determine the index of the last occurrence of a specified element in an array. @@ -5981,7 +5981,7 @@ This method is an O(`n`) operation, where `n` is `count`. - In .NET Framework 2.0 and later versions, this method uses the and methods of the to determine whether the specified by the `value` parameter exists. In earlier versions of .NET Framework, this determination was made by using the and methods of the `value` itself. + In .NET Framework 2.0 and later versions, this method uses the and methods of the to determine whether the specified by the `value` parameter exists. In earlier versions of .NET Framework, this determination was made by using the and methods of the `value` itself. ## Examples The following code example shows how to determine the index of the last occurrence of a specified element in an array. Note that the method is a backward search; therefore, `count` must be less than or equal to (`startIndex` minus the lower bound of the array plus 1). @@ -7714,9 +7714,9 @@ int[,,] TDArray = new int[1,1,1]; has a corresponding item in the `items`. When a key is repositioned during the sorting, the corresponding item in the `items` is similarly repositioned. Therefore, the `items` is sorted according to the arrangement of the corresponding keys in the `keys`. + Each key in the `keys` has a corresponding item in the `items` . When a key is repositioned during the sorting, the corresponding item in the `items` is similarly repositioned. Therefore, the `items` is sorted according to the arrangement of the corresponding keys in the `keys` . - Each key in the `keys` must implement the interface to be capable of comparisons with every other key. + Each key in the `keys` must implement the interface to be capable of comparisons with every other key. You can sort if there are more items than keys, but the items that have no corresponding keys will not be sorted. You cannot sort if there are more keys than items; doing this throws an . @@ -7939,9 +7939,9 @@ This method is an O(`n` log `n`) operation, where `n` is the has a corresponding item in the `items`. When a key is repositioned during the sorting, the corresponding item in the `items` is similarly repositioned. Therefore, the `items` is sorted according to the arrangement of the corresponding keys in the `keys`. + Each key in the `keys` has a corresponding item in the `items` . When a key is repositioned during the sorting, the corresponding item in the `items` is similarly repositioned. Therefore, the `items` is sorted according to the arrangement of the corresponding keys in the `keys` . - If `comparer` is `null`, each key in the `keys` must implement the interface to be capable of comparisons with every other key. + If `comparer` is `null`, each key in the `keys` must implement the interface to be capable of comparisons with every other key. You can sort if there are more items than keys, but the items that have no corresponding keys will not be sorted. You cannot sort if there are more keys than items; doing this throws an . @@ -8169,9 +8169,9 @@ This method is an O(`n` log `n`) operation, where `n` is the has a corresponding item in the `items`. When a key is repositioned during the sorting, the corresponding item in the `items` is similarly repositioned. Therefore, the `items` is sorted according to the arrangement of the corresponding keys in the `keys`. + Each key in the `keys` has a corresponding item in the `items` . When a key is repositioned during the sorting, the corresponding item in the `items` is similarly repositioned. Therefore, the `items` is sorted according to the arrangement of the corresponding keys in the `keys` . - Each key within the specified range of elements in the `keys` must implement the interface to be capable of comparisons with every other key. + Each key within the specified range of elements in the `keys` must implement the interface to be capable of comparisons with every other key. You can sort if there are more items than keys, but the items that have no corresponding keys will not be sorted. You cannot sort if there are more keys than items; doing this throws an . @@ -8430,9 +8430,9 @@ This method is an O(`n` log `n`) operation, where `n` is the has a corresponding item in the `items`. When a key is repositioned during the sorting, the corresponding item in the `items` is similarly repositioned. Therefore, the `items` is sorted according to the arrangement of the corresponding keys in the `keys`. + Each key in the `keys` has a corresponding item in the `items` . When a key is repositioned during the sorting, the corresponding item in the `items` is similarly repositioned. Therefore, the `items` is sorted according to the arrangement of the corresponding keys in the `keys` . - If `comparer` is `null`, each key within the specified range of elements in the `keys` must implement the interface to be capable of comparisons with every other key. + If `comparer` is `null`, each key within the specified range of elements in the `keys` must implement the interface to be capable of comparisons with every other key. You can sort if there are more items than keys, but the items that have no corresponding keys will not be sorted. You cannot sort if there are more keys than items; doing this throws an . @@ -9112,9 +9112,9 @@ This method is an O(`n` log `n`) operation, where `n` is the has a corresponding item in the `items`. When a key is repositioned during the sorting, the corresponding item in the `items` is similarly repositioned. Therefore, the `items` is sorted according to the arrangement of the corresponding keys in the `keys`. + Each key in the `keys` has a corresponding item in the `items` . When a key is repositioned during the sorting, the corresponding item in the `items` is similarly repositioned. Therefore, the `items` is sorted according to the arrangement of the corresponding keys in the `keys` . - Each key in the `keys` must implement the generic interface to be capable of comparisons with every other key. + Each key in the `keys` must implement the generic interface to be capable of comparisons with every other key. You can sort if there are more items than keys, but the items that have no corresponding keys will not be sorted. You cannot sort if there are more keys than items; doing this throws an . @@ -9234,9 +9234,9 @@ This method is an O(`n` log `n`) operation, where `n` is the has a corresponding item in the `items`. When a key is repositioned during the sorting, the corresponding item in the `items` is similarly repositioned. Therefore, the `items` is sorted according to the arrangement of the corresponding keys in the `keys`. + Each key in the `keys` has a corresponding item in the `items` . When a key is repositioned during the sorting, the corresponding item in the `items` is similarly repositioned. Therefore, the `items` is sorted according to the arrangement of the corresponding keys in the `keys` . - If `comparer` is `null`, each key in the `keys` must implement the generic interface to be capable of comparisons with every other key. + If `comparer` is `null`, each key in the `keys` must implement the generic interface to be capable of comparisons with every other key. You can sort if there are more items than keys, but the items that have no corresponding keys will not be sorted. You cannot sort if there are more keys than items; doing this throws an . @@ -9364,9 +9364,9 @@ This method is an O(`n` log `n`) operation, where `n` is the has a corresponding item in the `items`. When a key is repositioned during the sorting, the corresponding item in the `items` is similarly repositioned. Therefore, the `items` is sorted according to the arrangement of the corresponding keys in the `keys`. + Each key in the `keys` has a corresponding item in the `items` . When a key is repositioned during the sorting, the corresponding item in the `items` is similarly repositioned. Therefore, the `items` is sorted according to the arrangement of the corresponding keys in the `keys` . - Each key within the specified range of elements in the `keys` must implement the generic interface to be capable of comparisons with every other key. + Each key within the specified range of elements in the `keys` must implement the generic interface to be capable of comparisons with every other key. You can sort if there are more items than keys, but the items that have no corresponding keys will not be sorted. You cannot sort if there are more keys than items; doing this throws an . @@ -9505,9 +9505,9 @@ This method is an O(`n` log `n`) operation, where `n` is the has a corresponding item in the `items`. When a key is repositioned during the sorting, the corresponding item in the `items` is similarly repositioned. Therefore, the `items` is sorted according to the arrangement of the corresponding keys in the `keys`. + Each key in the `keys` has a corresponding item in the `items` . When a key is repositioned during the sorting, the corresponding item in the `items` is similarly repositioned. Therefore, the `items` is sorted according to the arrangement of the corresponding keys in the `keys` . - If `comparer` is `null`, each key within the specified range of elements in the `keys` must implement the generic interface to be capable of comparisons with every other key. + If `comparer` is `null`, each key within the specified range of elements in the `keys` must implement the generic interface to be capable of comparisons with every other key. You can sort if there are more items than keys, but the items that have no corresponding keys will not be sorted. You cannot sort if there are more keys than items; doing this throws an . diff --git a/xml/System/ArraySegment`1.xml b/xml/System/ArraySegment`1.xml index 47d74d20012..a40b90f4ee2 100644 --- a/xml/System/ArraySegment`1.xml +++ b/xml/System/ArraySegment`1.xml @@ -908,7 +908,7 @@ The underlying array of is - The structure on the left side of the equality operator. + The structure on the left side of the equality operator. The structure on the right side of the equality operator. Indicates whether two structures are equal. diff --git a/xml/System/Convert.xml b/xml/System/Convert.xml index 03a7946d926..98d992b7257 100644 --- a/xml/System/Convert.xml +++ b/xml/System/Convert.xml @@ -141,7 +141,7 @@ - - The parameter can supply culture-specific formatting information to assist the conversion process. However, it is ignored by most of the base type conversion methods. It is used only by the following base type conversion methods. If a `null` argument is passed to these methods, the object that represents the current culture is used. + The parameter can supply culture-specific formatting information to assist the conversion process. However, it is ignored by most of the base type conversion methods. It is used only by the following base type conversion methods. If a `null` argument is passed to these methods, the object that represents the current culture is used. - By methods that convert a value to a numeric type. The parameter is used by the overload that has parameters of type and . It is also used by the overload that has parameters of type and if the object's run-time type is a . @@ -588,7 +588,7 @@ The method does not support the conversion of `value` to a custom type. To perform such a conversion, call the method. - The `provider` parameter is an implementation that supplies formatting information for the conversion. Whether and how this parameter is used depends on the underlying implementation. If `value` is a base data type, `provider` is used only for the following conversions. If a `null` argument is passed to these methods, the object that represents the current culture is used. + The `provider` parameter is an implementation that supplies formatting information for the conversion. Whether and how this parameter is used depends on the underlying implementation. If `value` is a base data type, `provider` is used only for the following conversions. If a `null` argument is passed to these methods, the object that represents the current culture is used. - Conversion from a number to a string, or from a string to a number. `provider` must be a object, a object, or a custom implementation that returns a object. However, because the method performs the conversion using the default "G" format specifier, the `provider` parameter has no effect if `value` or the target type is an unsigned integer. @@ -1365,7 +1365,7 @@ > [!IMPORTANT] > The method is designed to process a single byte array that contains all the data to be encoded. To encode data from a stream, use the class. - Ordinarily, the method is not used to round-trip a UUEncoded (base-64 encoded) string. That is, if you decode a string by calling the method, then encode the returned byte array by calling the method, the resulting string will not necessarily be identical to the original string. The string will round-trip only if the original string is a valid base-64 encoded string. + Ordinarily, the method is not used to round-trip a UUEncoded (base-64 encoded) string. That is, if you decode a string by calling the method, then encode the returned byte array by calling the method, the resulting string will not necessarily be identical to the original string. The string will round-trip only if the original string is a valid base-64 encoded string. diff --git a/xml/System/Environment.xml b/xml/System/Environment.xml index 0c268923a5f..16c437347cf 100644 --- a/xml/System/Environment.xml +++ b/xml/System/Environment.xml @@ -125,7 +125,7 @@ ## Remarks This property provides access to the program name and any arguments specified on the command line when the current process was started. - The program name can include path information, but is not required to do so. Use the method to retrieve the command-line information parsed and stored in an array of strings. + The program name can include path information, but is not required to do so. Use the method to retrieve the command-line information parsed and stored in an array of strings. The maximum size of the command-line buffer is not set to a specific number of characters; it varies depending on the Windows operating system that is running on the computer. diff --git a/xml/System/Exception.xml b/xml/System/Exception.xml index e85d40cfa44..420b6f0ed33 100644 --- a/xml/System/Exception.xml +++ b/xml/System/Exception.xml @@ -1237,7 +1237,7 @@ Stack Trace: :::code language="csharp" source="~/snippets/csharp/System/Exception/SerializeObjectState/example2.cs" id="Snippet1"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.exception.serializeobjectstate/vb/example2.vb" id="Snippet1"::: - The `BadDivisionException` exception is thrown when a floating-point division by zero occurs. During the first division by zero, the example instantiates a `BadDivisionException` object, serializes it, and throws the exception. When subsequent divisions by zero occur, the example deserializes the previously serialized object, reserializes it, and throws the exception. To provide for object serialization, deserialization, reserialization, and deserialization, the example adds the event handler both in the `BadDivisionException` class constructor and in the implementation. + The `BadDivisionException` exception is thrown when a floating-point division by zero occurs. During the first division by zero, the example instantiates a `BadDivisionException` object, serializes it, and throws the exception. When subsequent divisions by zero occur, the example deserializes the previously serialized object, reserializes it, and throws the exception. To provide for object serialization, deserialization, reserialization, and deserialization, the example adds the event handler both in the `BadDivisionException` class constructor and in the implementation. ]]> diff --git a/xml/System/InvalidOperationException.xml b/xml/System/InvalidOperationException.xml index b998fe1af31..9e458679c23 100644 --- a/xml/System/InvalidOperationException.xml +++ b/xml/System/InvalidOperationException.xml @@ -255,7 +255,7 @@ The , overload to determine whether a sequence contains any elements. +- If your failure to check for an empty sequence was inadvertent, you can call one of the overloads of the overload to determine whether a sequence contains any elements. > [!TIP] > Calling the method before generating a sequence can improve performance if the data to be processed might contain a large number of elements or if operation that generates the sequence is expensive. diff --git a/xml/System/MemberAccessException.xml b/xml/System/MemberAccessException.xml index 4e3b7741142..0d4223d734c 100644 --- a/xml/System/MemberAccessException.xml +++ b/xml/System/MemberAccessException.xml @@ -69,7 +69,7 @@ of the classes, of the class, and of the class. - Apps compiled by using the .NET Native tool chain may throw a exception at runtime. is an internal-only exception type derived from . The exception indicates that metadata needed for the successful execution of an app is not present at runtime. You should not use a `try`/`catch` block to handle the exception. Instead, you should determine what metadata is missing and modify your app's to ensure that it is present at runtime. + Apps compiled by using the .NET Native tool chain may throw a [MissingRuntimeArtifactException](/windows/uwp/dotnet-native/missingruntimeartifactexception-class-net-native) exception at run time. `MissingRuntimeArtifactException` is an internal-only exception type derived from . The exception indicates that metadata needed for the successful execution of an app is not present at run time. You should not use a `try`/`catch` block to handle the exception. Instead, you should determine what metadata is missing and modify your app's runtime directives file to ensure that it is present at run time. uses the HRESULT COR_E_MEMBERACCESS, that has the value 0x8013151A. diff --git a/xml/System/Type.xml b/xml/System/Type.xml index 931d47b6927..88ecefc8e62 100644 --- a/xml/System/Type.xml +++ b/xml/System/Type.xml @@ -1553,7 +1553,7 @@ For the `FindMembers` method to successfully retrieve member information, the `b See for more information. -To get the class initializer (static constructor) using this method, you must specify | (`Or` in Visual Basic). You can also get the class initializer using the property. +To get the class initializer (static constructor) using this method, you must specify | (` Or ` in Visual Basic). You can also get the class initializer using the property. If the current represents a type parameter of a generic type or generic method, processes any members declared by the class constraint and the interface constraints of the type parameter. @@ -2076,7 +2076,7 @@ The `filter` argument can be a custom delegate of type , and specify | (`Or` in Visual Basic). You can also get the class initializer using the property. + This method overload looks for public instance constructors and cannot be used to obtain a class initializer (static constructor). To get a class initializer, use an overload that takes , and specify | (` Or ` in Visual Basic). You can also get the class initializer using the property. If the requested constructor is non-public, this method returns `null`. @@ -2246,7 +2246,7 @@ The `filter` argument can be a custom delegate of type for more information. - To get the class initializer (static constructor) using this method overload, you must specify | (`Or` in Visual Basic). You can also get the class initializer using the property. + To get the class initializer (static constructor) using this method overload, you must specify | (` Or ` in Visual Basic). You can also get the class initializer using the property. > [!NOTE] > You cannot omit parameters when looking up constructors and methods. You can only omit parameters when invoking. @@ -2382,7 +2382,7 @@ The `filter` argument can be a custom delegate of type for more information. - To get the class initializer (static constructor) using this method, you must specify | (`Or` in Visual Basic). You can also get the class initializer using the property. + To get the class initializer (static constructor) using this method, you must specify | (` Or ` in Visual Basic). You can also get the class initializer using the property. The following table shows what members of a base class are returned by the `Get` methods when reflecting on a type. @@ -2682,7 +2682,7 @@ False 3. Custom attributes are not part of the common type system. - This method overload calls the method overload, with | (`Or` in Visual Basic). It will not find class initializers (static constructor). To find class initializers, use an overload that takes , and specify | (`Or` in Visual Basic). You can also get the class initializer using the property. + This method overload calls the method overload, with | (` Or ` in Visual Basic). It will not find class initializers (static constructor). To find class initializers, use an overload that takes , and specify | (` Or ` in Visual Basic). You can also get the class initializer using the property. If the current represents a constructed generic type, this method returns the objects with the type parameters replaced by the appropriate type arguments. For example, if class `C` has a constructor `C(T t1)` (`Sub New(ByVal t1 As T)` in Visual Basic), calling on `C` returns a that represents `C(int t1)` in C# (`Sub New(ByVal t1 As Integer)` in Visual Basic). @@ -3193,7 +3193,7 @@ If the current represents a generic type parameter, the | | (in Visual Basic, combine the values using `Or`) to get it. + An event is considered public to reflection if it has at least one method or accessor that is public. Otherwise the event is considered private, and you must use | | (in Visual Basic, combine the values using ` Or `) to get it. The search for `name` is case-sensitive. The search includes public static and public instance events. @@ -3315,7 +3315,7 @@ If the current represents a generic type parameter, the for more information. - An event is considered public to reflection if it has at least one method or accessor that is public. Otherwise the event is considered private, and you must use | | (in Visual Basic, combine the values using `Or`) to get it. + An event is considered public to reflection if it has at least one method or accessor that is public. Otherwise the event is considered private, and you must use | | (in Visual Basic, combine the values using ` Or `) to get it. If the current represents a constructed generic type, this method returns the with the type parameters replaced by the appropriate type arguments. @@ -3405,7 +3405,7 @@ If the current represents a generic type parameter, the | | (in Visual Basic, combine the values using `Or`) to get it. + An event is considered public to reflection if it has at least one method or accessor that is public. Otherwise the event is considered private, and you must use | | (in Visual Basic, combine the values using ` Or `) to get it. The method does not return events in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which events are returned, because that order varies. @@ -3528,7 +3528,7 @@ If the current represents a generic type parameter, the for more information. - An event is considered public to reflection if it has at least one method or accessor that is public. Otherwise the event is considered private, and you must use | | (in Visual Basic, combine the values using `Or`) to get it. + An event is considered public to reflection if it has at least one method or accessor that is public. Otherwise the event is considered private, and you must use | | (in Visual Basic, combine the values using ` Or `) to get it. If the current represents a constructed generic type, this method returns the objects with the type parameters replaced by the appropriate type arguments. @@ -4690,7 +4690,7 @@ The current instance or argument is an open ge The method does not return members in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which members are returned, because that order varies. - This method overload will not find class initializers (static constructor). To find class initializers, use an overload that takes , and specify | (`Or` in Visual Basic). You can also get the class initializer using the property. + This method overload will not find class initializers (static constructor). To find class initializers, use an overload that takes , and specify | (` Or ` in Visual Basic). You can also get the class initializer using the property. The following table shows what members of a base class are returned by the `Get` methods when reflecting on a type. @@ -4825,7 +4825,7 @@ The current instance or argument is an open ge See for more information. - To get the class initializer (static constructor) using this method overload, you must specify "static constructor" for `name`, and | (`Or` in Visual Basic) for `bindingAttr`. You can also get the class initializer using the property. + To get the class initializer (static constructor) using this method overload, you must specify "static constructor" for `name`, and | (` Or ` in Visual Basic) for `bindingAttr`. You can also get the class initializer using the property. If the current represents a constructed generic type, this method returns the with the type parameters replaced by the appropriate type arguments. @@ -4943,7 +4943,7 @@ The current instance or argument is an open ge See for more information. - To get the class initializer (static constructor) using this method overload, you must specify "static constructor" for `name`, for `type`, and | (`Or` in Visual Basic) for `bindingAttr`. You can also get the class initializer using the property. + To get the class initializer (static constructor) using this method overload, you must specify "static constructor" for `name`, for `type`, and | (` Or ` in Visual Basic) for `bindingAttr`. You can also get the class initializer using the property. If the current represents a constructed generic type, this method returns the with the type parameters replaced by the appropriate type arguments. @@ -5051,7 +5051,7 @@ Members include properties, methods, constructors, fields, events, and nested ty The method does not return members in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which members are returned, because that order varies. - This method overload calls the method overload, with | | (`Or``Or` in Visual Basic). It will not find class initializers (static constructors). To find class initializers, call the overload, and specify | (`Or` in Visual Basic). You can also get the class initializer using the property. + This method overload calls the method overload, with | | (` Or `` Or ` in Visual Basic). It will not find class initializers (static constructors). To find class initializers, call the overload, and specify | (` Or ` in Visual Basic). You can also get the class initializer using the property. The following table shows what members of a base class are returned by the `Get` methods when reflecting on a type. @@ -5182,7 +5182,7 @@ See for more The method does not return members in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which members are returned, because that order varies. - To get the class initializer (static constructor) using this method overload, you must specify | (`Or` in Visual Basic). You can also get the class initializer using the property. + To get the class initializer (static constructor) using this method overload, you must specify | (` Or ` in Visual Basic). You can also get the class initializer using the property. If the current represents a constructed generic type, this method returns the objects with the type parameters replaced by the appropriate type arguments. @@ -5326,7 +5326,7 @@ This method can be used to find a constructed generic member given a member from You can do one of the following to retrieve a specific method: -- Call the method and specify a `bindingAttr` argument that uniquely identifies the method. For example, if the exception is thrown because a type has a static and an instance overload, you can specify a `bindingAttr` argument of `Or`. +- Call the method and specify a `bindingAttr` argument that uniquely identifies the method. For example, if the exception is thrown because a type has a static and an instance overload, you can specify a `bindingAttr` argument of ` Or `. - Call an overload of the method that includes a `types` parameter which defines the types of the method's parameters. @@ -7233,7 +7233,7 @@ If the current represents a type parameter in the definition ## Remarks Calling this overload is equivalent to calling the overload with a `bindingAttr` argument equal to `BindingFlags.Instance | BindingFlags.Static | BindingFlags.Public` in C# and `BindingFlags.Instance Or BindingFlags.Static Or BindingFlags.Public` in Visual Basic. It returns all public instance and static properties, both those defined by the type represented by the current object as well as those inherited from its base types. - A property is considered public to reflection if it has at least one accessor that is public. Otherwise the property is considered private, and you must use | | (in Visual Basic, combine the values using `Or`) to get it. + A property is considered public to reflection if it has at least one accessor that is public. Otherwise the property is considered private, and you must use | | (in Visual Basic, combine the values using ` Or `) to get it. The method does not return properties in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which properties are returned, because that order varies. @@ -7454,7 +7454,7 @@ The method does not return properties in a p ## Remarks The search for `name` is case-sensitive. The search includes public static and public instance properties. - A property is considered public to reflection if it has at least one accessor that is public. Otherwise the property is considered private, and you must use | | (in Visual Basic, combine the values using `Or`) to get it. + A property is considered public to reflection if it has at least one accessor that is public. Otherwise the property is considered private, and you must use | | (in Visual Basic, combine the values using ` Or `) to get it. If the current represents a constructed generic type, this method returns the with the type parameters replaced by the appropriate type arguments. @@ -7561,7 +7561,7 @@ The method does not return properties in a p | | (in Visual Basic, combine the values using `Or`) to get it. + A property is considered public to reflection if it has at least one accessor that is public. Otherwise the property is considered private, and you must use | | (in Visual Basic, combine the values using ` Or `) to get it. The following filter flags can be used to define which properties to include in the search: @@ -7679,7 +7679,7 @@ The method does not return properties in a p | | (in Visual Basic, combine the values using `Or`) to get it. + A property is considered public to reflection if it has at least one accessor that is public. Otherwise the property is considered private, and you must use | | (in Visual Basic, combine the values using ` Or `) to get it. The search for `name` is case-sensitive. The search includes public static and public instance properties. @@ -7778,7 +7778,7 @@ The method does not return properties in a p | | (in Visual Basic, combine the values using `Or`) to get it. + A property is considered public to reflection if it has at least one accessor that is public. Otherwise the property is considered private, and you must use | | (in Visual Basic, combine the values using ` Or `) to get it. The search for `name` is case-sensitive. The search includes public static and public instance properties. @@ -7886,7 +7886,7 @@ The method does not return properties in a p | | (in Visual Basic, combine the values using `Or`) to get it. + A property is considered public to reflection if it has at least one accessor that is public. Otherwise the property is considered private, and you must use | | (in Visual Basic, combine the values using ` Or `) to get it. The search for `name` is case-sensitive. The search includes public static and public instance properties. @@ -7986,7 +7986,7 @@ The method does not return properties in a p | | (in Visual Basic, combine the values using `Or`) to get it. + A property is considered public to reflection if it has at least one accessor that is public. Otherwise the property is considered private, and you must use | | (in Visual Basic, combine the values using ` Or `) to get it. Although the default binder does not process (the `modifiers` parameter), you can use the abstract class to write a custom binder that does process `modifiers`. `ParameterModifier` is only used when calling through COM interop, and only parameters that are passed by reference are handled. @@ -8117,7 +8117,7 @@ The method does not return properties in a p | | (in Visual Basic, combine the values using `Or`) to get it. + A property is considered public to reflection if it has at least one accessor that is public. Otherwise the property is considered private, and you must use | | (in Visual Basic, combine the values using ` Or `) to get it. Although the default binder does not process (the `modifiers` parameter), you can use the abstract class to write a custom binder that does process `modifiers`. `ParameterModifier` is only used when calling through COM interop, and only parameters that are passed by reference are handled. diff --git a/xml/System/TypeAccessException.xml b/xml/System/TypeAccessException.xml index e728dfce2e1..ed6930cb834 100644 --- a/xml/System/TypeAccessException.xml +++ b/xml/System/TypeAccessException.xml @@ -55,7 +55,7 @@ Similarly, is thrown for a dynamic method that uses an internal type from another assembly. A method might not have access to its containing type, its return type, or one of its parameter types. - Apps compiled by using the .NET Native tool chain may throw a exception at runtime. is an internal-only exception type derived from . The exception indicates that metadata needed for the successful execution of an app is not present at runtime. You should not use a `try`/`catch` block to handle the exception. Instead, you should determine what metadata is missing and modify your app's to ensure that it is present at runtime. + Apps compiled by using the .NET Native tool chain may throw a [MissingMetadataException](/windows/uwp/dotnet-native/missingmetadataexception-class-net-native) exception at run time. `MissingMetadataException` is an internal-only exception type derived from . The exception indicates that metadata needed for the successful execution of an app is not present at run time. You should not use a `try`/`catch` block to handle the exception. Instead, you should determine what metadata is missing and modify your app's runtime directives file to ensure that it is present at run time. ]]> diff --git a/xml/ns-System.AddIn.Pipeline.xml b/xml/ns-System.AddIn.Pipeline.xml index eb03e852977..3b8a5de812a 100644 --- a/xml/ns-System.AddIn.Pipeline.xml +++ b/xml/ns-System.AddIn.Pipeline.xml @@ -1,6 +1,6 @@ - Provides classes for constructing the communication pipeline between a host application and an add-in. + Provides classes for constructing the communication pipeline between a host application and an add-in. To be added. diff --git a/xml/ns-System.Diagnostics.PerformanceData.xml b/xml/ns-System.Diagnostics.PerformanceData.xml index abaed6aa210..007770cfc35 100644 --- a/xml/ns-System.Diagnostics.PerformanceData.xml +++ b/xml/ns-System.Diagnostics.PerformanceData.xml @@ -202,7 +202,7 @@ using System.Diagnostics.PerformanceData; switch (e.KeyData) { case Keys.A : - // In the .NET 3.5 Framework, you had to use the + // In the .NET 3.5 Framework, you had to use the // Value property to set and increment the counter // value. Beginning with the .NET 4.0 Framework, // the Value property is safe to use in a multi- @@ -240,4 +240,4 @@ using System.Diagnostics.PerformanceData; ]]> - \ No newline at end of file +