From 36f88fc5b6012d76f309ed3259b0428f8cffaf19 Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Fri, 27 May 2022 17:25:12 -0700
Subject: [PATCH 1/2] clean up whitespace; add missing words
---
.../HttpClientBuilderExtensions.xml | 3 +-
.../FixedLengthString.xml | 2 +-
xml/Microsoft.VisualBasic/Interaction.xml | 4 +-
.../FileDialogCustomPlaces.xml | 2 +-
.../ValidationSettings.xml | 2 +-
.../NativeActivityContext.xml | 2 +-
.../CompilerParameters.xml | 2 +-
xml/System.Collections.Generic/HashSet`1.xml | 2 +-
xml/System.Collections.Generic/List`1.xml | 2 +-
.../IImmutableList`1.xml | 2 +-
.../ImmutableList`1.xml | 4 +-
.../ImmutableSortedSet`1.xml | 2 +-
.../DesignerActionList.xml | 4 +-
.../DesignerActionUIService.xml | 2 +-
.../MaskedTextResultHint.xml | 2 +-
.../PropertyFilterOptions.xml | 2 +-
xml/System.Configuration/Configuration.xml | 2 +-
.../ConnectionStringsSection.xml | 2 +-
xml/System.Configuration/OverrideMode.xml | 2 +-
.../DbLimitExpression.xml | 2 +-
xml/System.Data.Metadata.Edm/GlobalItem.xml | 2 +-
.../StoreGeneratedPattern.xml | 2 +-
.../EntityCollection`1.xml | 2 +-
xml/System.Data.Objects/ObjectQuery`1.xml | 4 +-
.../OracleParameter.xml | 2 +-
.../SqlParameterCollection.xml | 2 +-
xml/System.Data/DataSetDateTime.xml | 2 +-
.../SymMethod.xml | 2 +-
.../EventListener.xml | 2 +-
.../EventSource.xml | 2 +-
xml/System.Diagnostics/Debug.xml | 32 +++++-----
xml/System.Diagnostics/Debugger.xml | 2 +-
xml/System.Diagnostics/EventLog.xml | 2 +-
xml/System.Diagnostics/Process.xml | 2 +-
xml/System.Diagnostics/Trace.xml | 32 +++++-----
xml/System.Diagnostics/TraceListener.xml | 2 +-
.../DirectoryAttribute.xml | 4 +-
.../DirectoryAttributeCollection.xml | 2 +-
.../LdapConnection.xml | 2 +-
.../ActiveDirectorySecurity.xml | 2 +-
.../DirectorySynchronization.xml | 4 +-
.../AdjustableArrowCap.xml | 4 +-
.../CustomLineCap.xml | 2 +-
xml/System.Drawing.Drawing2D/GraphicsPath.xml | 60 +++++++++----------
.../GraphicsPathIterator.xml | 16 ++---
.../LinearGradientBrush.xml | 18 +++---
xml/System.Drawing.Drawing2D/Matrix.xml | 18 +++---
.../PathGradientBrush.xml | 10 ++--
xml/System.Drawing.Drawing2D/RegionData.xml | 4 +-
.../ImageAttributes.xml | 16 ++---
xml/System.Drawing.Imaging/ImageCodecInfo.xml | 2 +-
.../InstalledFontCollection.xml | 2 +-
xml/System.Drawing/Bitmap.xml | 16 ++---
xml/System.Drawing/ColorTranslator.xml | 12 ++--
xml/System.Drawing/Font.xml | 16 ++---
xml/System.Drawing/FontFamily.xml | 18 +++---
xml/System.Drawing/Graphics.xml | 6 +-
xml/System.Drawing/Icon.xml | 2 +-
xml/System.Drawing/Pen.xml | 18 +++---
xml/System.Drawing/Rectangle.xml | 6 +-
xml/System.Drawing/RectangleF.xml | 2 +-
xml/System.Drawing/Region.xml | 28 ++++-----
xml/System.Drawing/StringFormat.xml | 10 ++--
xml/System.Drawing/TextureBrush.xml | 20 +++----
xml/System.Globalization/CultureInfo.xml | 2 +-
.../DateTimeFormatInfo.xml | 4 +-
xml/System.Globalization/IdnMapping.xml | 2 +-
xml/System.Globalization/UnicodeCategory.xml | 2 +-
xml/System.IO.Compression/DeflateStream.xml | 2 +-
xml/System.IO.Compression/GZipStream.xml | 2 +-
.../ZipFileExtensions.xml | 2 +-
.../KerberosSecurityTokenProvider.xml | 2 +-
.../SamlSecurityTokenHandler.xml | 2 +-
xml/System.Management/CompletedEventArgs.xml | 2 +-
xml/System.Messaging/Trustee.xml | 2 +-
.../CacheControlHeaderValue.xml | 2 +-
xml/System.Net.WebSockets/ClientWebSocket.xml | 2 +-
xml/System.Net/CookieCollection.xml | 6 +-
xml/System.Net/FileWebRequest.xml | 2 +-
xml/System.Net/FileWebResponse.xml | 2 +-
xml/System.Net/HttpWebRequest.xml | 2 +-
xml/System.Numerics/Vector`1.xml | 4 +-
.../PrintSystemTypeProperty.xml | 2 +-
xml/System.Printing/OutputQuality.xml | 2 +-
xml/System.Reflection.Emit/FieldBuilder.xml | 2 +-
.../PEReaderExtensions.xml | 6 +-
.../CustomAttributeNamedArgument.xml | 2 +-
.../CustomAttributeTypedArgument.xml | 2 +-
xml/System.Reflection/TypeDelegator.xml | 2 +-
xml/System.Resources/ResXDataNode.xml | 2 +-
xml/System.Resources/ResXResourceReader.xml | 2 +-
xml/System.Resources/ResourceManager.xml | 2 +-
xml/System.Resources/ResourceSet.xml | 2 +-
.../MemoryCacheElement.xml | 2 +-
.../InstancePersistenceException.xml | 2 +-
.../CollectionsMarshal.xml | 2 +-
.../NativeLibrary.xml | 2 +-
.../RuntimeEnvironment.xml | 7 +--
.../_EnumBuilder.xml | 2 +-
.../_MemberInfo.xml | 2 +-
.../AssemblyDependencyResolver.xml | 3 +-
.../ISerializationSurrogate.xml | 6 +-
.../Pkcs9SigningTime.xml | 2 +-
xml/System.Security.Cryptography/AesCng.xml | 8 +--
.../DataProtector.xml | 2 +-
xml/System.Security.Cryptography/ECCurve.xml | 2 +-
.../TripleDESCng.xml | 8 +--
.../PublisherMembershipCondition.xml | 2 +-
.../AllowPartiallyTrustedCallersAttribute.xml | 2 +-
xml/System.Security/NamedPermissionSet.xml | 2 +-
xml/System.Security/PermissionSet.xml | 10 ++--
.../SendMessageChannelCacheElement.xml | 2 +-
.../IWorkflowInstanceManagement.xml | 2 +-
.../SslStreamSecurityBindingElement.xml | 2 +-
.../StreamUpgradeBindingElement.xml | 4 +-
.../IDispatchMessageInspector.xml | 12 ++--
.../MessageFilter.xml | 2 +-
.../MessageFilterTable`1.xml | 2 +-
.../XPathMessageFilterTable`1.xml | 2 +-
.../RegisterInfo.xml | 2 +-
...onateOnSerializingReplyMessageProperty.xml | 4 +-
.../AtomPub10ServiceDocumentFormatter.xml | 2 +-
.../SyndicationFeed.xml | 4 +-
.../SyndicationItem.xml | 6 +-
.../DnsEndpointIdentity.xml | 2 +-
.../ServiceInstaller.xml | 2 +-
.../FragmentState.xml | 2 +-
xml/System.Text.RegularExpressions/Regex.xml | 4 +-
xml/System.Text/Encoding.xml | 4 +-
xml/System.Threading.Tasks/Parallel.xml | 8 +--
xml/System.Threading.Tasks/Task.xml | 18 +++---
xml/System.Threading.Tasks/Task`1.xml | 8 +--
xml/System.Threading/EventWaitHandle.xml | 2 +-
xml/System.Timers/ElapsedEventArgs.xml | 4 +-
xml/System.Timers/Timer.xml | 8 +--
.../ConditionedActivityGroup.xml | 2 +-
xml/System.Xaml/XamlMember.xml | 12 ++--
xml/System.Xaml/XamlXmlWriter.xml | 2 +-
xml/System.Xml.Schema/XmlSchema.xml | 2 +-
xml/System.Xml.Schema/XmlValueGetter.xml | 2 +-
...ationSection+DateTimeSerializationMode.xml | 2 +-
xml/System.Xml.XPath/XPathNavigator.xml | 2 +-
xml/System.Xml/XmlDictionaryReader.xml | 2 +-
xml/System/ArgumentOutOfRangeException.xml | 2 +-
xml/System/Array.xml | 38 ++++++------
xml/System/ArraySegment`1.xml | 2 +-
xml/System/Convert.xml | 6 +-
xml/System/Environment.xml | 2 +-
xml/System/Exception.xml | 2 +-
xml/System/InvalidOperationException.xml | 2 +-
xml/System/MemberAccessException.xml | 2 +-
xml/System/Type.xml | 46 +++++++-------
xml/System/TypeAccessException.xml | 2 +-
xml/ns-System.AddIn.Pipeline.xml | 2 +-
xml/ns-System.Diagnostics.PerformanceData.xml | 4 +-
155 files changed, 419 insertions(+), 422 deletions(-)
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