Skip to content

Commit c495944

Browse files
mairawRon Petrusha
mairaw
and
Ron Petrusha
authored
recover some content from msdn (#2406)
* recover some content from msdn * Apply suggestions from peer review Co-Authored-By: Ron Petrusha <[email protected]>
1 parent 3b3a576 commit c495944

File tree

7 files changed

+52
-26
lines changed

7 files changed

+52
-26
lines changed

‎xml/System.Data.Common/DataAdapter.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -580,7 +580,7 @@
580580
<format type="text/markdown"><![CDATA[
581581
582582
## Remarks
583-
See the remarks for `System.Data.Common.DataAdapter.Fill(System.Data.DataSet)` for additional information.
583+
See the remarks for <xref:System.Data.Common.DataAdapter.Fill(System.Data.DataSet)?displayProperty=nameWithType> for additional information.
584584
585585
]]></format>
586586
</remarks>

‎xml/System.Data.Common/DbDataAdapter.xml

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -862,10 +862,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
862862
<Parameter Name="dataReader" Type="System.Data.IDataReader" Index="1" FrameworkAlternate="netframework-1.1" />
863863
</Parameters>
864864
<Docs>
865-
<param name="dataTable">To be added.</param>
866-
<param name="dataReader">To be added.</param>
867-
<summary>To be added.</summary>
868-
<returns>To be added.</returns>
865+
<param name="dataTable">A <see cref="T:System.Data.DataTable" /> to fill with records and, if necessary, schema.</param>
866+
<param name="dataReader">The name of the <see cref="T:System.Data.IDataReader" />.</param>
867+
<summary>Adds or refreshes rows in a <see cref="T:System.Data.DataTable" /> to match those in the data source using the specified <see cref="T:System.Data.DataTable" /> and <see cref="T:System.Data.IDataReader" /> names.</summary>
868+
<returns>The number of rows successfully added to or refreshed in the <see cref="T:System.Data.DataTable" />. This does not include rows affected by statements that do not return rows.</returns>
869869
<remarks>To be added.</remarks>
870870
</Docs>
871871
</Member>
@@ -1159,13 +1159,13 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
11591159
<Parameter Name="maxRecords" Type="System.Int32" Index="4" FrameworkAlternate="netframework-1.1" />
11601160
</Parameters>
11611161
<Docs>
1162-
<param name="dataSet">To be added.</param>
1163-
<param name="srcTable">To be added.</param>
1164-
<param name="dataReader">To be added.</param>
1165-
<param name="startRecord">To be added.</param>
1166-
<param name="maxRecords">To be added.</param>
1167-
<summary>To be added.</summary>
1168-
<returns>To be added.</returns>
1162+
<param name="dataSet">A <see cref="T:System.Data.DataSet" /> to fill with records and, if necessary, schema.</param>
1163+
<param name="srcTable">The name of the <see cref="T:System.Data.DataTable" /> to use for table mapping.</param>
1164+
<param name="dataReader">The name of the <see cref="T:System.Data.IDataReader" />.</param>
1165+
<param name="startRecord">The zero-based record number to start with.</param>
1166+
<param name="maxRecords">The maximum number of records to retrieve.</param>
1167+
<summary>Adds or refreshes rows in a specified range in the <see cref="T:System.Data.DataSet" /> to match those in the data source using the <see cref="T:System.Data.DataSet" />, <see cref="T:System.Data.DataTable" />, and <see cref="T:System.Data.IDataReader" /> names.</summary>
1168+
<returns>The number of rows successfully added to or refreshed in the <see cref="T:System.Data.DataSet" />. This does not include rows affected by statements that do not return rows.</returns>
11691169
<remarks>To be added.</remarks>
11701170
</Docs>
11711171
</Member>

‎xml/System.Windows.Forms.Design/ComponentTray.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1173,8 +1173,8 @@
11731173
<Parameter Name="component" Type="System.Object" Index="0" FrameworkAlternate="netframework-1.1;netframework-2.0;netframework-3.0;netframework-3.5;netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8" />
11741174
</Parameters>
11751175
<Docs>
1176-
<param name="component">The <see cref="T:System.Object" /> to receive the extender properties.</param>
1177-
<param name="extendee">To be added.</param>
1176+
<param name="component">The object to receive the extender properties.</param>
1177+
<param name="extendee">The object to receive the extender properties.</param>
11781178
<summary>For a description of this member, see <see cref="M:System.ComponentModel.IExtenderProvider.CanExtend(System.Object)" />.</summary>
11791179
<returns>
11801180
<see langword="true" /> if this object can provide extender properties to the specified object; otherwise, <see langword="false" />.</returns>

‎xml/System.Windows.Xps/XpsDocumentWriter.xml

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -197,9 +197,23 @@
197197
<Parameter Name="documentPath" Type="System.String" />
198198
</Parameters>
199199
<Docs>
200-
<param name="documentPath">To be added.</param>
201-
<summary>To be added.</summary>
202-
<remarks>To be added.</remarks>
200+
<param name="documentPath">The path of the source document.</param>
201+
<summary>Synchronously writes a specified XPS document to the target <see cref="T:System.Windows.Xps.Packaging.XpsDocument" /> or <see cref="T:System.Printing.PrintQueue" />.</summary>
202+
<remarks>
203+
<format type="text/markdown"><![CDATA[
204+
205+
## Remarks
206+
207+
Although the <xref:System.Windows.Xps.XpsDocumentWriter> class has a singular name, an <xref:System.Windows.Xps.XpsDocumentWriter> can be one <xref:System.Windows.Documents.FixedDocument> or a set of multiple documents.
208+
This method adds the <xref:System.Windows.Documents.FixedDocument> elements in the source to the set of <xref:System.Windows.Documents.FixedDocument> elements in the target <xref:System.Windows.Xps.XpsDocumentWriter> or <xref:System.Printing.PrintQueue>.
209+
210+
This `Write` method will reserialize the specified XPS document, which will remove all content from the <xref:System.IO.Packaging.Package> that is not required to be preserved by the [XML Paper Specification](https://www.ecma-international.org/publications/standards/Ecma-388.htm).
211+
The reserialization will also remove all extensions from the <xref:System.Windows.Documents.FixedPage> markup, including any extended XPS content.
212+
213+
By design, this `Write` method does not raise the <xref:System.Windows.Xps.XpsDocumentWriter.WritingPrintTicketRequired> event.
214+
215+
]]></format>
216+
</remarks>
203217
</Docs>
204218
</Member>
205219
<Member MemberName="Write">
@@ -1681,4 +1695,4 @@
16811695
</Docs>
16821696
</Member>
16831697
</Members>
1684-
</Type>
1698+
</Type>

‎xml/System.Xml.Serialization/XmlMembersMapping.xml

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -138,9 +138,20 @@
138138
<ReturnType>System.String</ReturnType>
139139
</ReturnValue>
140140
<Docs>
141-
<summary>To be added.</summary>
142-
<value>To be added.</value>
143-
<remarks>To be added.</remarks>
141+
<summary>Gets the unqualified name of the XML Schema element that represents a SOAP message for which .NET type mapping information is being provided.</summary>
142+
<value>The unqualified name of the XML Schema element.</value>
143+
<remarks>
144+
<format type="text/markdown"><![CDATA[
145+
146+
## Remarks
147+
148+
A SOAP message is defined in a Web Services Description Language (WSDL) document using the **message** element.
149+
150+
See the <xref:System.Xml.Serialization.XmlMembersMapping> class for the conditions under which the `ElementName` property refers to a code entity defined in a Web service method (a parameter or return value) instead of to an extra parent or wrapper element.
151+
152+
]]></format>
153+
</remarks>
154+
<forInternalUseOnly />
144155
</Docs>
145156
</Member>
146157
<Member MemberName="Item">
@@ -321,4 +332,4 @@ A SOAP message is defined in a Web Services Description Language (WSDL) document
321332
</Docs>
322333
</Member>
323334
</Members>
324-
</Type>
335+
</Type>

‎xml/System.Xml.Serialization/XmlTypeMapping.xml

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -79,9 +79,10 @@
7979
<ReturnType>System.String</ReturnType>
8080
</ReturnValue>
8181
<Docs>
82-
<summary>To be added.</summary>
83-
<value>To be added.</value>
82+
<summary>Gets the name of the mapped element.</summary>
83+
<value>The name of the mapped element.</value>
8484
<remarks>To be added.</remarks>
85+
<forInternalUseOnly />
8586
</Docs>
8687
</Member>
8788
<Member MemberName="Namespace">

‎xml/System.Xml.XPath/XPathNavigator.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8848,8 +8848,8 @@ XPathNodeIterator ni = nav.Select(expr);
88488848
<ReturnType>System.String</ReturnType>
88498849
</ReturnValue>
88508850
<Docs>
8851-
<summary>To be added.</summary>
8852-
<value>To be added.</value>
8851+
<summary>When overridden in a derived class, gets the string value of the item.</summary>
8852+
<value>The string value of the item.</value>
88538853
<remarks>To be added.</remarks>
88548854
</Docs>
88558855
</Member>

0 commit comments

Comments
 (0)