Remove .NET Framework remarks (System.Data*) (#12634)

Author: gewarren

xml/System.Data.Common/DBDataPermission.xml

@@ -247,14 +247,7 @@
         <param name="allowBlankPassword">
           <see langword="true" /> to indicate that a blank password is allowed; otherwise, <see langword="false" />.</param>
         <summary>Initializes a new instance of the <see langword="DBDataPermission" /> class with the specified <see cref="T:System.Security.Permissions.PermissionState" /> value, and a value indicating whether a blank password is allowed.</summary>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- The <xref:System.Security.Permissions.PermissionState> enumeration takes precedence over the <xref:System.Data.Common.DBDataPermission.AllowBlankPassword> property. Therefore, if you set <xref:System.Data.Common.DBDataPermission.AllowBlankPassword*> to `false`, you must also set <xref:System.Security.Permissions.PermissionState> to `None` to prevent a user from making a connection using a blank password.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <related type="Article" href="/dotnet/framework/data/adonet/ado-net-overview">ADO.NET Overview</related>
       </Docs>
     </Member>
@@ -298,22 +291,7 @@
         <param name="restrictions">String that identifies connection string parameters that are allowed or disallowed.</param>
         <param name="behavior">One of the <see cref="T:System.Data.KeyRestrictionBehavior" /> properties.</param>
         <summary>Adds access for the specified connection string to the existing state of the <see langword="DBDataPermission" />.</summary>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- This method can be useful when implementing:
-
-- A .NET framework data provider.
-
-- An API that must assert for data access permission.
-
-- An administrative tool or installation program that must modify security policy.
-
-- When more than one rule is specified, the more restrictive rule is selected.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <related type="Article" href="/dotnet/framework/data/adonet/ado-net-overview">ADO.NET Overview</related>
       </Docs>
     </Member>
@@ -351,14 +329,7 @@
         <summary>Gets a value indicating whether a blank password is allowed.</summary>
         <value>
           <see langword="true" /> if a blank password is allowed, otherwise, <see langword="false" />.</value>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- The <xref:System.Security.Permissions.PermissionState> enumeration takes precedence over the <xref:System.Data.Common.DBDataPermission.AllowBlankPassword> property. Therefore, if you set <xref:System.Data.Common.DBDataPermission.AllowBlankPassword*> to `false`, you must also set <xref:System.Security.Permissions.PermissionState> to `None` to prevent a user from making a connection using a blank password.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <related type="Article" href="/dotnet/framework/data/adonet/ado-net-overview">ADO.NET Overview</related>
       </Docs>
     </Member>
@@ -433,14 +404,7 @@
       <Docs>
         <summary>Creates and returns an identical copy of the current permission object.</summary>
         <returns>A copy of the current permission object.</returns>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- A copy of a permission object represents the same access to resources as the original permission object.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <related type="Article" href="/dotnet/framework/data/adonet/ado-net-overview">ADO.NET Overview</related>
       </Docs>
     </Member>
@@ -518,14 +482,7 @@
       <Docs>
         <param name="securityElement">The XML encoding to use to reconstruct the security object.</param>
         <summary>Reconstructs a security object with a specified state from an XML encoding.</summary>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- Custom code that extends security objects needs to implement the `ToXml` and `FromXml` methods to make the objects security encodable.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <related type="Article" href="/dotnet/framework/data/adonet/ado-net-overview">ADO.NET Overview</related>
       </Docs>
     </Member>
@@ -566,14 +523,7 @@
         <param name="target">A permission object to intersect with the current permission object. It must be of the same type as the current permission object.</param>
         <summary>Returns a new permission object representing the intersection of the current permission object and the specified permission object.</summary>
         <returns>A new permission object that represents the intersection of the current permission object and the specified permission object. This new permission object is a null reference (<see langword="Nothing" /> in Visual Basic) if the intersection is empty.</returns>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- The intersection of two permissions is a permission that describes the set of operations they both describe. Only a demand that passes both original permissions will pass the intersection.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">The <paramref name="target" /> parameter is not a null reference (<see langword="Nothing" /> in Visual Basic) and is not an instance of the same class as the current permission object.</exception>
         <related type="Article" href="/dotnet/framework/data/adonet/ado-net-overview">ADO.NET Overview</related>
       </Docs>
@@ -616,14 +566,7 @@
         <summary>Returns a value indicating whether the current permission object is a subset of the specified permission object.</summary>
         <returns>
           <see langword="true" /> if the current permission object is a subset of the specified permission object, otherwise <see langword="false" />.</returns>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- The current permission object is a subset of the specified permission object if the current permission object specifies a set of operations that is wholly contained by the specified permission object. For example, a permission that represents access to C:\example.txt is a subset of a permission that represents access to C:\\. If this method returns `true`, the current permission object represents no more access to the protected resource than does the specified permission object.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">The <paramref name="target" /> parameter is an object that is not of the same type as the current permission object.</exception>
         <related type="Article" href="/dotnet/framework/data/adonet/ado-net-overview">ADO.NET Overview</related>
       </Docs>
@@ -704,14 +647,7 @@
       <Docs>
         <summary>Creates an XML encoding of the security object and its current state.</summary>
         <returns>An XML encoding of the security object, including any state information.</returns>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- Custom code that extends security objects must implement the <xref:System.Data.Common.DBDataPermission.ToXml*> and <xref:System.Data.Common.DBDataPermission.FromXml*> methods to make the objects security encodable.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <related type="Article" href="/dotnet/framework/data/adonet/ado-net-overview">ADO.NET Overview</related>
       </Docs>
     </Member>
@@ -752,14 +688,7 @@
         <param name="target">A permission object to combine with the current permission object. It must be of the same type as the current permission object.</param>
         <summary>Returns a new permission object that is the union of the current and specified permission objects.</summary>
         <returns>A new permission object that represents the union of the current permission object and the specified permission object.</returns>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- The result of a call to <xref:System.Data.Common.DBDataPermission.Union*> is a permission that represents all the operations permitted by both the current permission object and the specified permission object. Any demand that passes either permission passes their union.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">The <paramref name="target" /> object is not the same type as the current permission object.</exception>
         <related type="Article" href="/dotnet/framework/data/adonet/ado-net-overview">ADO.NET Overview</related>
       </Docs>

xml/System.Data.Common/DBDataPermissionAttribute.xml

@@ -164,14 +164,7 @@
       <Docs>
         <summary>Gets or sets a permitted connection string.</summary>
         <value>A permitted connection string.</value>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- Multiple connection strings may be identified. You may also provide additional connection string restrictions using **KeyRestrictions**.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <related type="Article" href="/dotnet/framework/data/adonet/ado-net-overview">ADO.NET Overview</related>
       </Docs>
     </Member>
@@ -245,18 +238,7 @@
       <Docs>
         <summary>Gets or sets connection string parameters that are allowed or disallowed.</summary>
         <value>One or more connection string parameters that are allowed or disallowed.</value>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- Connection string parameters are identified in the form *\<parameter name>*=. Multiple parameters can be specified, delimited using a semicolon (;). The connection string parameters listed may be identified as either the only additional parameters allowed or additional parameters that are not allowed using the <xref:System.Data.Common.DBDataPermissionAttribute.KeyRestrictionBehavior> property.
-
- If no key restrictions are specified, and the <xref:System.Data.Common.DBDataPermissionAttribute.KeyRestrictionBehavior> property is set to `AllowOnly`, no additional connection string parameters are allowed.
-
- If no key restrictions are specified, and the <xref:System.Data.Common.DBDataPermissionAttribute.KeyRestrictionBehavior> property is set to `PreventUsage`, additional connection string parameters are allowed. If more than one rule is set for the same connection string, the more restrictive rule is selected during the permission check.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <related type="Article" href="/dotnet/framework/data/adonet/ado-net-overview">ADO.NET Overview</related>
       </Docs>
     </Member>

xml/System.Data.Common/DataAdapter.xml

@@ -182,7 +182,7 @@
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- This overload of the <xref:System.Data.Common.DataAdapter> constructor is designed for use by a .NET Framework data provider when implementing a similar constructor for use in a clone implementation.
+ This overload of the <xref:System.Data.Common.DataAdapter> constructor is designed for use by a .NET data provider when implementing a similar constructor for use in a clone implementation.
 
  ]]></format>
         </remarks>
@@ -625,7 +625,7 @@
  You can use the <xref:System.Data.Common.DataAdapter.Fill*> method multiple times on the same <xref:System.Data.DataTable>. If a primary key exists, incoming rows are merged with matching rows that already exist. If no primary key exists, incoming rows are appended to the <xref:System.Data.DataTable>.
 
 > [!NOTE]
->  When handling batch SQL statements that return multiple results, the implementation of <xref:System.Data.Common.DbDataAdapter.FillSchema*> for the .NET Framework Data Provider for OLE DB retrieves schema information for only the first result. To retrieve schema information for multiple results, use <xref:System.Data.Common.DbDataAdapter.Fill*> with the <xref:System.Data.MissingSchemaAction> set to `AddWithKey`.
+>  When handling batch SQL statements that return multiple results, the implementation of <xref:System.Data.Common.DbDataAdapter.FillSchema*> for the .NET Data Provider for OLE DB retrieves schema information for only the first result. To retrieve schema information for multiple results, use <xref:System.Data.Common.DbDataAdapter.Fill*> with the <xref:System.Data.MissingSchemaAction> set to `AddWithKey`.
 
  ]]></format>
         </remarks>
@@ -1023,7 +1023,7 @@ If a unique clustered index is defined on a column or columns in a SQL Server ta
  <xref:System.Data.Common.DataAdapter.FillSchema*> does not return any rows. Use the <xref:System.Data.Common.DataAdapter.Fill*> method to add rows to a <xref:System.Data.DataTable>.
 
 > [!NOTE]
->  When handling batch SQL statements that return multiple results, the implementation of <xref:System.Data.Common.DbDataAdapter.FillSchema*> for the .NET Framework Data Provider for OLE DB retrieves schema information for only the first result. To retrieve schema information for multiple results, use <xref:System.Data.Common.DbDataAdapter.Fill*> with the <xref:System.Data.MissingSchemaAction> set to `AddWithKey`.
+>  When handling batch SQL statements that return multiple results, the implementation of <xref:System.Data.Common.DbDataAdapter.FillSchema*> for the .NET Data Provider for OLE DB retrieves schema information for only the first result. To retrieve schema information for multiple results, use <xref:System.Data.Common.DbDataAdapter.Fill*> with the <xref:System.Data.MissingSchemaAction> set to `AddWithKey`.
 
  ]]></format>
         </remarks>
@@ -1852,7 +1852,7 @@ If a unique clustered index is defined on a column or columns in a SQL Server ta
 
  It should be noted that these statements are not performed as a batch process; each row is updated individually. An application can call the <xref:System.Data.DataSet.GetChanges*> method in situations where you must control the sequence of statement types (for example, INSERT before UPDATE). For more information, see [Updating Data Sources with DataAdapters](/dotnet/framework/data/adonet/updating-data-sources-with-dataadapters).
 
- If INSERT, UPDATE, or DELETE statements have not been specified, the <xref:System.Data.Common.DataAdapter.Update*> method generates an exception. However, you can create a <xref:System.Data.SqlClient.SqlCommandBuilder> or <xref:System.Data.OleDb.OleDbCommandBuilder> object to automatically generate SQL statements for single-table updates if you set the `SelectCommand` property of a .NET Framework data provider. Then, any additional SQL statements that you do not set are generated by the **CommandBuilder**. This generation logic requires key column information to be present in the <xref:System.Data.DataSet>. For more information see [Generating Commands with CommandBuilders](/dotnet/framework/data/adonet/generating-commands-with-commandbuilders).
+ If INSERT, UPDATE, or DELETE statements have not been specified, the <xref:System.Data.Common.DataAdapter.Update*> method generates an exception. However, you can create a <xref:System.Data.SqlClient.SqlCommandBuilder> or <xref:System.Data.OleDb.OleDbCommandBuilder> object to automatically generate SQL statements for single-table updates if you set the `SelectCommand` property of a .NET data provider. Then, any additional SQL statements that you do not set are generated by the **CommandBuilder**. This generation logic requires key column information to be present in the <xref:System.Data.DataSet>. For more information see [Generating Commands with CommandBuilders](/dotnet/framework/data/adonet/generating-commands-with-commandbuilders).
 
  The <xref:System.Data.Common.DataAdapter.Update*> method retrieves rows from the table listed in the first mapping before performing an update. The <xref:System.Data.Common.DataAdapter.Update*> then refreshes the row using the value of the <xref:System.Data.IDbCommand.UpdatedRowSource> property. Any additional rows returned are ignored.
 

xml/System.Data.Common/DbCommand.xml

@@ -2175,7 +2175,7 @@
       </ReturnValue>
       <Docs>
         <summary>Gets or sets the <see cref="P:System.Data.Common.DbCommand.DbTransaction" /> within which this <see cref="T:System.Data.Common.DbCommand" /> object executes.</summary>
-        <value>The transaction within which a <see langword="Command" /> object of a .NET Framework data provider executes. The default value is a null reference (<see langword="Nothing" /> in Visual Basic).</value>
+        <value>The transaction within which a <see langword="Command" /> object of a .NET data provider executes. The default value is a null reference (<see langword="Nothing" /> in Visual Basic).</value>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
@@ -2244,7 +2244,7 @@
       </ReturnValue>
       <Docs>
         <summary>Gets or sets the <see cref="T:System.Data.Common.DbTransaction" /> within which this <see cref="T:System.Data.Common.DbCommand" /> object executes.</summary>
-        <value>The transaction within which a command object of a .NET Framework data provider executes. The default value is a null reference (<see langword="Nothing" /> in Visual Basic).</value>
+        <value>The transaction within which a command object of a .NET data provider executes. The default value is a null reference (<see langword="Nothing" /> in Visual Basic).</value>
         <remarks>To be added.</remarks>
         <related type="Article" href="/dotnet/framework/data/adonet/ado-net-overview">ADO.NET Overview</related>
       </Docs>