Skip to content

Commit 6a66270

Browse files
authored
Replace sensitive language where possible (dotnet#7412)
1 parent 452b9ef commit 6a66270

File tree

33 files changed

+63
-72
lines changed

33 files changed

+63
-72
lines changed

xml/System.ComponentModel.Design/DesignSurface.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@
6767
|Service|Description|
6868
|-------------|-----------------|
6969
|<xref:System.ComponentModel.Design.IComponentChangeService>|Raises events as changes are made to components.|
70-
|<xref:System.ComponentModel.Design.IDesignerHost>|Controls access to types, services, and transactions. Master interface for designers.|
70+
|<xref:System.ComponentModel.Design.IDesignerHost>|Controls access to types, services, and transactions. Primary interface for designers.|
7171
|<xref:System.ComponentModel.IContainer>|Owns the set of components that are being designed. Each designer has an <xref:System.ComponentModel.IContainer> that owns the components.|
7272
|<xref:System.ComponentModel.Design.IServiceContainer>|Derives from <xref:System.IServiceProvider> and provides a way to add and remove services from the designer.|
7373

xml/System.ComponentModel/INestedContainer.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@
4747
## Remarks
4848
The <xref:System.ComponentModel.INestedContainer> interface adds the concept of an owning component to the <xref:System.ComponentModel.IContainer> interface. A nested container is an object that logically, but not necessarily visually, contains zero or more child components and is owned by some parent component. For visual containment, the owning component is often another container.
4949
50-
Nested containers allow sections of a control to be designable, without requiring an explicit serialized member variable or a custom serializer for each subcontrol. Instead, the form designer maintains one master container of components. Each component's site may have a nested container that provides a place to put extra components. When a component is sited in a nested container, the name it receives is a combination of its given name and its owning component's name. Additionally, components added to a nested container have full access to the services of the parent container, and the nested container provides the same behavior of the parent with respect to adding new components. The nested container will create the designer for each component it contains, thereby enabling design-time support. Because standard code serializers do not look at nested containers, these components are only serialized if a path to them can be obtained by walking the components in the primary container.
50+
Nested containers allow sections of a control to be designable, without requiring an explicit serialized member variable or a custom serializer for each subcontrol. Instead, the form designer maintains one primary container of components. Each component's site may have a nested container that provides a place to put extra components. When a component is sited in a nested container, the name it receives is a combination of its given name and its owning component's name. Additionally, components added to a nested container have full access to the services of the parent container, and the nested container provides the same behavior of the parent with respect to adding new components. The nested container will create the designer for each component it contains, thereby enabling design-time support. Because standard code serializers do not look at nested containers, these components are only serialized if a path to them can be obtained by walking the components in the primary container.
5151
5252
Nested containers can be found by querying a component's site for services of type <xref:System.ComponentModel.INestedContainer>.
5353

xml/System.Data.Common/DataAdapter.xml

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1214,7 +1214,7 @@ If a unique clustered index is defined on a column or columns in a SQL Server ta
12141214
<format type="text/markdown"><![CDATA[
12151215
12161216
## Remarks
1217-
The <xref:System.Data.Common.DataAdapter.TableMappings%2A> property provides the master mapping between the returned records and the <xref:System.Data.DataSet>.
1217+
The <xref:System.Data.Common.DataAdapter.TableMappings%2A> property provides the primary mapping between the returned records and the <xref:System.Data.DataSet>.
12181218
12191219
12201220
@@ -1592,15 +1592,15 @@ If a unique clustered index is defined on a column or columns in a SQL Server ta
15921592
<ReturnType>System.Data.ITableMappingCollection</ReturnType>
15931593
</ReturnValue>
15941594
<Docs>
1595-
<summary>Indicates how a source table is mapped to a dataset table.</summary>
1596-
<value>A collection that provides the master mapping between the returned records and the <see cref="T:System.Data.DataSet" />. The default value is an empty collection.</value>
1595+
<summary>Gets a collection that indicates how a source table is mapped to a dataset table.</summary>
1596+
<value>A collection that provides the primary mapping between the returned records and the <see cref="T:System.Data.DataSet" />. The default value is an empty collection.</value>
15971597
<remarks>
15981598
<format type="text/markdown"><![CDATA[
15991599
16001600
## Remarks
16011601
This member is an explicit interface member implementation. It can be used only when the <xref:System.Data.Common.DataAdapter> instance is cast to an <xref:System.Data.IDataAdapter> interface.
16021602
1603-
Fore more information, see <xref:System.Data.IDataAdapter.TableMappings%2A>.
1603+
For more information, see <xref:System.Data.IDataAdapter.TableMappings%2A>.
16041604
16051605
]]></format>
16061606
</remarks>
@@ -1649,15 +1649,13 @@ If a unique clustered index is defined on a column or columns in a SQL Server ta
16491649
<ReturnType>System.Data.Common.DataTableMappingCollection</ReturnType>
16501650
</ReturnValue>
16511651
<Docs>
1652-
<summary>Gets a collection that provides the master mapping between a source table and a <see cref="T:System.Data.DataTable" />.</summary>
1653-
<value>A collection that provides the master mapping between the returned records and the <see cref="T:System.Data.DataSet" />. The default value is an empty collection.</value>
1652+
<summary>Gets a collection that provides the primary mapping between a source table and a <see cref="T:System.Data.DataTable" />.</summary>
1653+
<value>A collection that provides the primary mapping between the returned records and the <see cref="T:System.Data.DataSet" />. The default value is an empty collection.</value>
16541654
<remarks>
16551655
<format type="text/markdown"><![CDATA[
16561656
16571657
## Remarks
1658-
When reconciling changes, the <xref:System.Data.Common.DataAdapter> uses the <xref:System.Data.Common.DataTableMappingCollection> collection to associate the column names used by the data source with the column names used by the <xref:System.Data.DataSet>.
1659-
1660-
1658+
When reconciling changes, the <xref:System.Data.Common.DataAdapter> uses the <xref:System.Data.Common.DataTableMappingCollection> collection to associate the column names used by the data source with the column names used by the <xref:System.Data.DataSet>.
16611659
16621660
## Examples
16631661
The following example uses a derived class, <xref:System.Data.OleDb.OleDbDataAdapter>, to add <xref:System.Data.Common.DataTableMapping> objects to its <xref:System.Data.Common.DataAdapter.TableMappings%2A> collection and display a list of those mapped source tables. This example assumes that an <xref:System.Data.OleDb.OleDbDataAdapter> has already been created.

xml/System.Data.Common/DataTableMapping.xml

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -56,9 +56,7 @@
5656
<format type="text/markdown"><![CDATA[
5757
5858
## Remarks
59-
A <xref:System.Data.Common.DataTableMapping> provides a master mapping between the data returned from a query against a data source, and a <xref:System.Data.DataTable>. The <xref:System.Data.Common.DataTableMapping> name can be passed in place of the <xref:System.Data.DataTable> name to the `Fill` method of the **DataAdapter**. For more information, see [DataAdapter DataTable and DataColumn Mappings](/dotnet/framework/data/adonet/dataadapter-datatable-and-datacolumn-mappings).
60-
61-
59+
A <xref:System.Data.Common.DataTableMapping> provides a primary mapping between the data returned from a query against a data source, and a <xref:System.Data.DataTable>. The <xref:System.Data.Common.DataTableMapping> name can be passed in place of the <xref:System.Data.DataTable> name to the `Fill` method of the **DataAdapter**. For more information, see [DataAdapter DataTable and DataColumn Mappings](/dotnet/framework/data/adonet/dataadapter-datatable-and-datacolumn-mappings).
6260
6361
## Examples
6462
The following example creates a <xref:System.Data.Common.DataTableMapping> object and adds it to a <xref:System.Data.Common.DataTableMappingCollection>. It then informs the user that the mapping was added to the collection and displays the parent mapping.

xml/System.Data.SqlClient/SqlColumnEncryptionCngProvider.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -182,7 +182,7 @@
182182
<param name="masterKeyPath">The complete path of an asymmetric key. The path format is specific to a key store provider.</param>
183183
<param name="allowEnclaveComputations">A Boolean that indicates if this key can be sent to the trusted enclave.</param>
184184
<param name="signature">The master key metadata signature.</param>
185-
<summary>This function must be implemented by the corresponding Key Store providers. This function should use an asymmetric key identified by a key path and verify the masterkey metadata consisting of (masterKeyPath, allowEnclaveComputations, providerName).</summary>
185+
<summary>This function must be implemented by the corresponding Key Store providers. This function should use an asymmetric key identified by a key path and verify the master key metadata consisting of (masterKeyPath, allowEnclaveComputations, providerName).</summary>
186186
<returns>A Boolean that indicates if the master key metadata can be verified based on the provided signature.</returns>
187187
<remarks>To be added.</remarks>
188188
</Docs>

xml/System.Data.SqlClient/SqlColumnEncryptionCspProvider.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -182,7 +182,7 @@
182182
<param name="masterKeyPath">The complete path of an asymmetric key. The path format is specific to a key store provider.</param>
183183
<param name="allowEnclaveComputations">A boolean that indicates if this key can be sent to the trusted enclave.</param>
184184
<param name="signature">Master key metadata signature.</param>
185-
<summary>This function must be implemented by the corresponding Key Store providers. This function should use an asymmetric key identified by a key path and sign the masterkey metadata consisting of (masterKeyPath, allowEnclaveComputations, providerName).</summary>
185+
<summary>This function must be implemented by the corresponding Key Store providers. This function should use an asymmetric key identified by a key path and sign the master key metadata consisting of (masterKeyPath, allowEnclaveComputations, providerName).</summary>
186186
<returns>A Boolean that indicates if the master key metadata can be verified based on the provided signature.</returns>
187187
<remarks>To be added.</remarks>
188188
</Docs>

xml/System.Data/IDataAdapter.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -335,7 +335,7 @@ private static void GetParameters(string connectionString)
335335
<format type="text/markdown"><![CDATA[
336336
337337
## Remarks
338-
The <xref:System.Data.IDataAdapter.TableMappings%2A> property provides the master mapping between the returned records and the <xref:System.Data.DataSet>.
338+
The <xref:System.Data.IDataAdapter.TableMappings%2A> property provides the primary mapping between the returned records and the <xref:System.Data.DataSet>.
339339
340340
]]></format>
341341
</remarks>
@@ -414,8 +414,8 @@ private static void GetParameters(string connectionString)
414414
<ReturnType>System.Data.ITableMappingCollection</ReturnType>
415415
</ReturnValue>
416416
<Docs>
417-
<summary>Indicates how a source table is mapped to a dataset table.</summary>
418-
<value>A collection that provides the master mapping between the returned records and the <see cref="T:System.Data.DataSet" />. The default value is an empty collection.</value>
417+
<summary>Gets a collection that indicates how a source table is mapped to a dataset table.</summary>
418+
<value>A collection that provides the primary mapping between the returned records and the <see cref="T:System.Data.DataSet" />. The default value is an empty collection.</value>
419419
<remarks>
420420
<format type="text/markdown"><![CDATA[
421421

xml/System.Diagnostics.Tracing/EventCounter.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@
6464
6565
## Remarks
6666
67-
For an example of how to use the <xref:System.Diagnostics.Tracing.EventCounter> class, see [Introduction Tutorial: How to measure performance for very frequent events using EventCounters](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Diagnostics.Tracing/documentation/EventCounterTutorial.md).
67+
For an example of how to use the <xref:System.Diagnostics.Tracing.EventCounter> class, see [Introduction Tutorial: How to measure performance for very frequent events using EventCounters](https://github.com/dotnet/runtime/blob/main/src/libraries/System.Diagnostics.Tracing/documentation/EventCounterTutorial.md).
6868
6969
]]></format>
7070
</remarks>
@@ -211,7 +211,7 @@ After being disposed, this counter will stop reporting values. If an <xref:Syste
211211
<format type="text/markdown"><![CDATA[
212212
## Remarks
213213
214-
For an example of how to use the <xref:System.Diagnostics.Tracing.EventCounter.WriteMetric(System.Single)> method, see [Introduction Tutorial: How to measure performance for very frequent events using EventCounters](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Diagnostics.Tracing/documentation/EventCounterTutorial.md).
214+
For an example of how to use the <xref:System.Diagnostics.Tracing.EventCounter.WriteMetric(System.Single)> method, see [Introduction Tutorial: How to measure performance for very frequent events using EventCounters](https://github.com/dotnet/runtime/blob/main/src/libraries/System.Diagnostics.Tracing/documentation/EventCounterTutorial.md).
215215
216216
]]></format>
217217
</remarks>
@@ -257,7 +257,7 @@ After being disposed, this counter will stop reporting values. If an <xref:Syste
257257
<format type="text/markdown"><![CDATA[
258258
## Remarks
259259
260-
For an example of how to use the <xref:System.Diagnostics.Tracing.EventCounter.WriteMetric(System.Single)> method, see the [Introduction Tutorial: How to measure performance for very frequent events using EventCounters](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Diagnostics.Tracing/documentation/EventCounterTutorial.md) topic.
260+
For an example of how to use the <xref:System.Diagnostics.Tracing.EventCounter.WriteMetric(System.Single)> method, see the [Introduction Tutorial: How to measure performance for very frequent events using EventCounters](https://github.com/dotnet/runtime/blob/main/src/libraries/System.Diagnostics.Tracing/documentation/EventCounterTutorial.md) topic.
261261
262262
]]></format>
263263
</remarks>

xml/System.Diagnostics/Activity.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -661,7 +661,7 @@ Normally if the <xref:System.Diagnostics.Activity.ParentId> is defined, its form
661661
662662
## Remarks
663663
664-
An ID has a hierarchical structure: `root-id.id1_id2.id3_`. The ID is generated when <xref:System.Diagnostics.Activity.Start> is called by appending a suffix to the `Activity.Parent.Id` or the <xref:System.Diagnostics.Activity.ParentId>. An <xref:System.Diagnostics.Activity> has no ID until it starts. For more information, see [Id Format](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Diagnostics.DiagnosticSource/src/ActivityUserGuide.md#id-format).
664+
An ID has a hierarchical structure: `root-id.id1_id2.id3_`. The ID is generated when <xref:System.Diagnostics.Activity.Start> is called by appending a suffix to the `Activity.Parent.Id` or the <xref:System.Diagnostics.Activity.ParentId>. An <xref:System.Diagnostics.Activity> has no ID until it starts. For more information, see [Id Format](https://github.com/dotnet/runtime/blob/main/src/libraries/System.Diagnostics.DiagnosticSource/src/ActivityUserGuide.md#id-format).
665665
666666
]]></format>
667667
</remarks>
@@ -858,7 +858,7 @@ An operation name is the *coarsest* name that is useful for grouping/filtering.
858858
859859
If the parent for this <xref:System.Diagnostics.Activity> comes from outside the process, the <xref:System.Diagnostics.Activity> does not have a parent but *may* have a parent ID (which was deserialized from the parent).
860860
861-
This property value can be `null` if this is a root <xref:System.Diagnostics.Activity> (that is, it has no <xref:System.Diagnostics.Activity.Parent>). For more information, see [ID format](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Diagnostics.DiagnosticSource/src/ActivityUserGuide.md#id-format).
861+
This property value can be `null` if this is a root <xref:System.Diagnostics.Activity> (that is, it has no <xref:System.Diagnostics.Activity.Parent>). For more information, see [ID format](https://github.com/dotnet/runtime/blob/main/src/libraries/System.Diagnostics.DiagnosticSource/src/ActivityUserGuide.md#id-format).
862862
863863
]]></format>
864864
</remarks>
@@ -948,7 +948,7 @@ If the <xref:System.Diagnostics.Activity.ParentId?displayProperty=nameWithType>
948948
949949
## Remarks
950950
951-
The root ID is a substring from the <xref:System.Diagnostics.Activity.Id> or the <xref:System.Diagnostics.Activity.ParentId>) between '|' (or the beginning) and the first `.`. Filtering by root ID allows you to find all activities involved in operation processing. For more information, see [ID Format](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Diagnostics.DiagnosticSource/src/ActivityUserGuide.md#id-format).
951+
The root ID is a substring from the <xref:System.Diagnostics.Activity.Id> or the <xref:System.Diagnostics.Activity.ParentId>) between '|' (or the beginning) and the first `.`. Filtering by root ID allows you to find all activities involved in operation processing. For more information, see [ID Format](https://github.com/dotnet/runtime/blob/main/src/libraries/System.Diagnostics.DiagnosticSource/src/ActivityUserGuide.md#id-format).
952952
953953
]]></format>
954954
</remarks>

xml/System.Diagnostics/DiagnosticListener.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@
3737
3838
`DiagnosticListener` is a NotificationSource, which means the returned result can be used to log notifications, but it also has a <xref:System.Diagnostics.DiagnosticListener.Subscribe%2A> method so notifications can be forwarded arbitrarily. Thus, its job is to forward things from the producer to all the listeners (multi-casting). Generally, you should not be making your own <xref:System.Diagnostics.DiagnosticListener> but use the default, so that notifications are as public as possible.
3939
40-
For more information on the <xref:System.Diagnostics.DiagnosticSource> and <xref:System.Diagnostics.DiagnosticListener> classes, see [DiagnosticSource User's Guide](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Diagnostics.DiagnosticSource/src/DiagnosticSourceUsersGuide.md).
40+
For more information on the <xref:System.Diagnostics.DiagnosticSource> and <xref:System.Diagnostics.DiagnosticListener> classes, see [DiagnosticSource User's Guide](https://github.com/dotnet/runtime/blob/main/src/libraries/System.Diagnostics.DiagnosticSource/src/DiagnosticSourceUsersGuide.md).
4141
4242
]]></format>
4343
</remarks>

0 commit comments

Comments
 (0)