Skip to content

recover some content from msdn #2406

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
May 10, 2019
Merged

recover some content from msdn #2406

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ca38ac9
recover some content from msdn
mairaw May 6, 2019
8eaeafe
Apply suggestions from peer review
mairaw May 10, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion xml/System.Data.Common/DataAdapter.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -580,7 +580,7 @@
<format type="text/markdown"><![CDATA[

## Remarks
See the remarks for `System.Data.Common.DataAdapter.Fill(System.Data.DataSet)` for additional information.
See the remarks for <xref:System.Data.Common.DataAdapter.Fill(System.Data.DataSet)?displayProperty=nameWithType> for additional information.

]]></format>
</remarks>
Expand Down
22 changes: 11 additions & 11 deletions xml/System.Data.Common/DbDataAdapter.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -862,10 +862,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
<Parameter Name="dataReader" Type="System.Data.IDataReader" Index="1" FrameworkAlternate="netframework-1.1" />
</Parameters>
<Docs>
<param name="dataTable">To be added.</param>
<param name="dataReader">To be added.</param>
<summary>To be added.</summary>
<returns>To be added.</returns>
<param name="dataTable">A <see cref="T:System.Data.DataTable" /> to fill with records and, if necessary, schema.</param>
<param name="dataReader">The name of the <see cref="T:System.Data.IDataReader" />.</param>
<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>
<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>
<remarks>To be added.</remarks>
</Docs>
</Member>
Expand Down Expand Up @@ -1159,13 +1159,13 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
<Parameter Name="maxRecords" Type="System.Int32" Index="4" FrameworkAlternate="netframework-1.1" />
</Parameters>
<Docs>
<param name="dataSet">To be added.</param>
<param name="srcTable">To be added.</param>
<param name="dataReader">To be added.</param>
<param name="startRecord">To be added.</param>
<param name="maxRecords">To be added.</param>
<summary>To be added.</summary>
<returns>To be added.</returns>
<param name="dataSet">A <see cref="T:System.Data.DataSet" /> to fill with records and, if necessary, schema.</param>
<param name="srcTable">The name of the <see cref="T:System.Data.DataTable" /> to use for table mapping.</param>
<param name="dataReader">The name of the <see cref="T:System.Data.IDataReader" />.</param>
<param name="startRecord">The zero-based record number to start with.</param>
<param name="maxRecords">The maximum number of records to retrieve.</param>
<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>
<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>
<remarks>To be added.</remarks>
</Docs>
</Member>
Expand Down
4 changes: 2 additions & 2 deletions xml/System.Windows.Forms.Design/ComponentTray.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1173,8 +1173,8 @@
<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" />
</Parameters>
<Docs>
<param name="component">The <see cref="T:System.Object" /> to receive the extender properties.</param>
<param name="extendee">To be added.</param>
<param name="component">The object to receive the extender properties.</param>
<param name="extendee">The object to receive the extender properties.</param>
<summary>For a description of this member, see <see cref="M:System.ComponentModel.IExtenderProvider.CanExtend(System.Object)" />.</summary>
<returns>
<see langword="true" /> if this object can provide extender properties to the specified object; otherwise, <see langword="false" />.</returns>
Expand Down
22 changes: 18 additions & 4 deletions xml/System.Windows.Xps/XpsDocumentWriter.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -197,9 +197,23 @@
<Parameter Name="documentPath" Type="System.String" />
</Parameters>
<Docs>
<param name="documentPath">To be added.</param>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<param name="documentPath">The path of the source document.</param>
<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>
<remarks>
<format type="text/markdown"><![CDATA[

## Remarks

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.
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>.

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).
The reserialization will also remove all extensions from the <xref:System.Windows.Documents.FixedPage> markup, including any extended XPS content.

By design, this `Write` method does not raise the <xref:System.Windows.Xps.XpsDocumentWriter.WritingPrintTicketRequired> event.

]]></format>
</remarks>
</Docs>
</Member>
<Member MemberName="Write">
Expand Down Expand Up @@ -1681,4 +1695,4 @@
</Docs>
</Member>
</Members>
</Type>
</Type>
19 changes: 15 additions & 4 deletions xml/System.Xml.Serialization/XmlMembersMapping.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -138,9 +138,20 @@
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<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>
<value>The unqualified name of the XML Schema element.</value>
<remarks>
<format type="text/markdown"><![CDATA[

## Remarks

A SOAP message is defined in a Web Services Description Language (WSDL) document using the **message** element.

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.

]]></format>
</remarks>
<forInternalUseOnly />
</Docs>
</Member>
<Member MemberName="Item">
Expand Down Expand Up @@ -321,4 +332,4 @@ A SOAP message is defined in a Web Services Description Language (WSDL) document
</Docs>
</Member>
</Members>
</Type>
</Type>
5 changes: 3 additions & 2 deletions xml/System.Xml.Serialization/XmlTypeMapping.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,9 +79,10 @@
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<summary>Gets the name of the mapped element.</summary>
<value>The name of the mapped element.</value>
<remarks>To be added.</remarks>
<forInternalUseOnly />
</Docs>
</Member>
<Member MemberName="Namespace">
Expand Down
4 changes: 2 additions & 2 deletions xml/System.Xml.XPath/XPathNavigator.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8848,8 +8848,8 @@ XPathNodeIterator ni = nav.Select(expr);
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<summary>When overridden in a derived class, gets the string value of the item.</summary>
<value>The string value of the item.</value>
<remarks>To be added.</remarks>
</Docs>
</Member>
Expand Down