Skip to content

Commit bef247e

Browse files
authored
export content from msdn 10/10 (dotnet#1162)
* export content from msdn * fix broken link * remove <p>
1 parent 33bc17b commit bef247e

File tree

14 files changed

+378
-81
lines changed

14 files changed

+378
-81
lines changed

xml/System.Windows.Forms/Control+ControlCollection.xml

Lines changed: 31 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -996,6 +996,7 @@
996996
997997
]]></format>
998998
</remarks>
999+
<forInternalUseOnly />
9991000
</Docs>
10001001
</Member>
10011002
<Member MemberName="System.Collections.IList.Contains">
@@ -1020,9 +1021,17 @@
10201021
</Parameters>
10211022
<Docs>
10221023
<param name="control">To be added.</param>
1023-
<summary>To be added.</summary>
1024+
<summary>For a description of this member, see <see cref="M:System.Collections.IList.Contains(System.Object)" />.</summary>
10241025
<returns>To be added.</returns>
1025-
<remarks>To be added.</remarks>
1026+
<remarks>
1027+
<format type="text/markdown"><![CDATA[
1028+
1029+
## Remarks
1030+
This member is an explicit interface member implementation. It can be used only when the <xref:System.Windows.Forms.Control.ControlCollection> instance is cast to an <xref:System.Collections.IList> interface.
1031+
1032+
]]></format>
1033+
</remarks>
1034+
<forInternalUseOnly />
10261035
</Docs>
10271036
</Member>
10281037
<Member MemberName="System.Collections.IList.IndexOf">
@@ -1047,9 +1056,16 @@
10471056
</Parameters>
10481057
<Docs>
10491058
<param name="control">To be added.</param>
1050-
<summary>To be added.</summary>
1059+
<summary>For a description of this member, see <see cref="M:System.Collections.IList.IndexOf(System.Object)" />.</summary>
10511060
<returns>To be added.</returns>
1052-
<remarks>To be added.</remarks>
1061+
<remarks>
1062+
<format type="text/markdown"><![CDATA[
1063+
## Remarks
1064+
This member is an explicit interface member implementation. It can be used only when the <xref:System.Windows.Forms.Control.ControlCollection> instance is cast to an <xref:System.Collections.IList> interface.
1065+
1066+
]]></format>
1067+
</remarks>
1068+
<forInternalUseOnly />
10531069
</Docs>
10541070
</Member>
10551071
<Member MemberName="System.Collections.IList.Insert">
@@ -1076,8 +1092,15 @@
10761092
<Docs>
10771093
<param name="index">To be added.</param>
10781094
<param name="value">To be added.</param>
1079-
<summary>To be added.</summary>
1080-
<remarks>To be added.</remarks>
1095+
<summary>For a description of this member, see <see cref="M:System.Collections.IList.Insert(System.Int32,System.Object)" />.</summary>
1096+
<remarks>
1097+
<format type="text/markdown"><![CDATA[
1098+
## Remarks
1099+
This member is an explicit interface member implementation. It can be used only when the <xref:System.Windows.Forms.Control.ControlCollection> instance is cast to an <xref:System.Collections.IList> interface.
1100+
1101+
]]></format>
1102+
</remarks>
1103+
<forInternalUseOnly />
10811104
</Docs>
10821105
</Member>
10831106
<Member MemberName="System.Collections.IList.Remove">
@@ -1113,6 +1136,7 @@
11131136
11141137
]]></format>
11151138
</remarks>
1139+
<forInternalUseOnly />
11161140
</Docs>
11171141
</Member>
11181142
<Member MemberName="System.ICloneable.Clone">
@@ -1146,6 +1170,7 @@
11461170
11471171
]]></format>
11481172
</remarks>
1173+
<forInternalUseOnly />
11491174
</Docs>
11501175
</Member>
11511176
</Members>

xml/System.Windows.Ink/DrawingAttributes.xml

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<Type Name="DrawingAttributes" FullName="System.Windows.Ink.DrawingAttributes">
1+
<Type Name="DrawingAttributes" FullName="System.Windows.Ink.DrawingAttributes">
22
<TypeSignature Language="C#" Value="public class DrawingAttributes : System.ComponentModel.INotifyPropertyChanged" />
33
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit DrawingAttributes extends System.Object implements class System.ComponentModel.INotifyPropertyChanged" />
44
<TypeSignature Language="DocId" Value="T:System.Windows.Ink.DrawingAttributes" />
@@ -1176,8 +1176,9 @@
11761176
<ReturnType>System.ComponentModel.PropertyChangedEventHandler</ReturnType>
11771177
</ReturnValue>
11781178
<Docs>
1179-
<summary>To be added.</summary>
1179+
<summary>Occurs when the value of any <see cref="T:System.Windows.Ink.DrawingAttributes" /> property has changed.</summary>
11801180
<remarks>To be added.</remarks>
1181+
<forInternalUseOnly />
11811182
</Docs>
11821183
</Member>
11831184
<Member MemberName="Width">

xml/System.Windows.Ink/Stroke.xml

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<Type Name="Stroke" FullName="System.Windows.Ink.Stroke">
1+
<Type Name="Stroke" FullName="System.Windows.Ink.Stroke">
22
<TypeSignature Language="C#" Value="public class Stroke : System.ComponentModel.INotifyPropertyChanged" />
33
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit Stroke extends System.Object implements class System.ComponentModel.INotifyPropertyChanged" />
44
<TypeSignature Language="DocId" Value="T:System.Windows.Ink.Stroke" />
@@ -1615,8 +1615,9 @@
16151615
<ReturnType>System.ComponentModel.PropertyChangedEventHandler</ReturnType>
16161616
</ReturnValue>
16171617
<Docs>
1618-
<summary>To be added.</summary>
1618+
<summary>Occurs when the value of any <see cref="T:System.Windows.Ink.Stroke" /> property has changed.</summary>
16191619
<remarks>To be added.</remarks>
1620+
<forInternalUseOnly />
16201621
</Docs>
16211622
</Member>
16221623
<Member MemberName="Transform">

xml/System.Windows.Ink/StrokeCollection.xml

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<Type Name="StrokeCollection" FullName="System.Windows.Ink.StrokeCollection">
1+
<Type Name="StrokeCollection" FullName="System.Windows.Ink.StrokeCollection">
22
<TypeSignature Language="C#" Value="public class StrokeCollection : System.Collections.ObjectModel.Collection&lt;System.Windows.Ink.Stroke&gt;, System.Collections.Specialized.INotifyCollectionChanged, System.ComponentModel.INotifyPropertyChanged" />
33
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit StrokeCollection extends System.Collections.ObjectModel.Collection`1&lt;class System.Windows.Ink.Stroke&gt; implements class System.Collections.Specialized.INotifyCollectionChanged, class System.ComponentModel.INotifyPropertyChanged" />
44
<TypeSignature Language="DocId" Value="T:System.Windows.Ink.StrokeCollection" />
@@ -1628,8 +1628,9 @@
16281628
<ReturnType>System.Collections.Specialized.NotifyCollectionChangedEventHandler</ReturnType>
16291629
</ReturnValue>
16301630
<Docs>
1631-
<summary>To be added.</summary>
1631+
<summary>Occurs when the <see cref="T:System.Windows.Ink.StrokeCollection" /> changes.</summary>
16321632
<remarks>To be added.</remarks>
1633+
<forInternalUseOnly />
16331634
</Docs>
16341635
</Member>
16351636
<Member MemberName="System.ComponentModel.INotifyPropertyChanged.PropertyChanged">
@@ -1649,8 +1650,9 @@
16491650
<ReturnType>System.ComponentModel.PropertyChangedEventHandler</ReturnType>
16501651
</ReturnValue>
16511652
<Docs>
1652-
<summary>To be added.</summary>
1653+
<summary>Occurs when the value of any <see cref="T:System.Windows.Ink.StrokeCollection" /> property has changed.</summary>
16531654
<remarks>To be added.</remarks>
1655+
<forInternalUseOnly />
16541656
</Docs>
16551657
</Member>
16561658
<Member MemberName="Transform">

xml/System.Windows.Input/CanExecuteChangedEventManager.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<Type Name="CanExecuteChangedEventManager" FullName="System.Windows.Input.CanExecuteChangedEventManager">
1+
<Type Name="CanExecuteChangedEventManager" FullName="System.Windows.Input.CanExecuteChangedEventManager">
22
<TypeSignature Language="C#" Value="public class CanExecuteChangedEventManager : System.Windows.WeakEventManager" />
33
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit CanExecuteChangedEventManager extends System.Windows.WeakEventManager" />
44
<TypeSignature Language="DocId" Value="T:System.Windows.Input.CanExecuteChangedEventManager" />
@@ -74,8 +74,8 @@
7474
</ReturnValue>
7575
<Parameters />
7676
<Docs>
77-
<summary>To be added.</summary>
78-
<returns>To be added.</returns>
77+
<summary>Returns a new object to contain listeners to the <see cref="E:System.Windows.Input.ICommand.CanExecuteChanged" /> event.</summary>
78+
<returns>A new object to contain listeners to the <see cref="E:System.Windows.Input.ICommand.CanExecuteChanged" /> event.</returns>
7979
<remarks>To be added.</remarks>
8080
</Docs>
8181
</Member>

xml/System.Windows.Media.Animation/Timeline.xml

Lines changed: 21 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -869,8 +869,27 @@
869869
<AssemblyVersion>3.0.0.0</AssemblyVersion>
870870
</AssemblyInfo>
871871
<Docs>
872-
<summary>To be added.</summary>
873-
<remarks>To be added.</remarks>
872+
<summary>Gets or sets the desired frame rate for this timeline and its child timelines.</summary>
873+
<remarks>
874+
<format type="text/markdown"><![CDATA[
875+
876+
## Remarks
877+
Use this property to define a specific frame rate at which animations should run.  This is a guideline only, and is not a guaranteed value. This property has two primary uses:
878+
879+
- Limiting the amount of processing resources for slow-moving, background type animations that do not require a high degree of fidelity. This can be achieved by setting a small frame rate value on the timeline.
880+
881+
- Reducing the visual impact of tearing on fast-moving horizontal animations. This can be achieved by setting a high frame rate value on the timeline.
882+
883+
This property may only be set on a root timeline.
884+
885+
## Examples
886+
The following example uses the DesiredFrameRate property to limit several animations to 10 frames per second.
887+
888+
[!code-xaml[timingbehaviors_snip#GraphicsMMDesiredFrameRateExample](~/samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/DesiredFrameRateExample.xaml#GraphicsMMDesiredFrameRateExample)]
889+
890+
]]></format>
891+
</remarks>
892+
<related type="Article" href="~/docs/framework/wpf/graphics-multimedia/animation-overview.md">Animation Overview</related>
874893
</Docs>
875894
</Member>
876895
<Member MemberName="DesiredFrameRateProperty">

xml/System.Windows.Media.Media3D/Viewport2DVisual3D.xml

Lines changed: 15 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<Type Name="Viewport2DVisual3D" FullName="System.Windows.Media.Media3D.Viewport2DVisual3D">
1+
<Type Name="Viewport2DVisual3D" FullName="System.Windows.Media.Media3D.Viewport2DVisual3D">
22
<TypeSignature Language="C#" Value="public sealed class Viewport2DVisual3D : System.Windows.Media.Media3D.Visual3D" />
33
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit Viewport2DVisual3D extends System.Windows.Media.Media3D.Visual3D" />
44
<TypeSignature Language="DocId" Value="T:System.Windows.Media.Media3D.Viewport2DVisual3D" />
@@ -36,7 +36,6 @@
3636
3737
[!code-xaml[Viewport2DVisual3DExample#Viewport3D](~/samples/snippets/csharp/VS_Snippets_Wpf/Viewport2DVisual3DExample/CS/window1.xaml#viewport3d)]
3838
39-
For the complete sample, see [Interactive 2-D on 3-D Sample](https://go.microsoft.com/fwlink/?LinkID=160007).
4039
4140
]]></format>
4241
</remarks>
@@ -154,7 +153,6 @@
154153
155154
[!code-xaml[Viewport2DVisual3DExample#Viewport3D](~/samples/snippets/csharp/VS_Snippets_Wpf/Viewport2DVisual3DExample/CS/window1.xaml#viewport3d)]
156155
157-
For the complete sample, see [Interactive 2-D on 3-D Sample](https://go.microsoft.com/fwlink/?LinkID=160007).
158156
159157
]]></format>
160158
</remarks>
@@ -259,8 +257,20 @@
259257
<AssemblyVersion>3.0.0.0</AssemblyVersion>
260258
</AssemblyInfo>
261259
<Docs>
262-
<summary>To be added.</summary>
263-
<remarks>To be added.</remarks>
260+
<summary>Gets or sets a value that specifies whether a material should be interactive.</summary>
261+
<remarks>
262+
<format type="text/markdown"><![CDATA[
263+
264+
## Remarks
265+
You must set the `IsVisualHostMaterial` attached property on the material on which you wish to have the 2-D visual placed.
266+
267+
## Examples
268+
The following example shows how to specify the material where the 2-D visual (the button) should be placed by setting the <xref:System.Windows.Media.Media3D.Viewport2DVisual3D.Material> property and also setting the `IsVisualHostMaterial` attached property to `true`:
269+
270+
[!code-xaml[Viewport2DVisual3DExample#Viewport3D](~/samples/snippets/csharp/VS_Snippets_Wpf/Viewport2DVisual3DExample/CS/window1.xaml#viewport3d)]
271+
272+
]]></format>
273+
</remarks>
264274
</Docs>
265275
</Member>
266276
<Member MemberName="IsVisualHostMaterialProperty">
@@ -325,7 +335,6 @@
325335
326336
[!code-xaml[Viewport2DVisual3DExample#Viewport3D](~/samples/snippets/csharp/VS_Snippets_Wpf/Viewport2DVisual3DExample/CS/window1.xaml#viewport3d)]
327337
328-
For the complete sample, see [Interactive 2-D on 3-D Sample](https://go.microsoft.com/fwlink/?LinkID=160007).
329338
330339
]]></format>
331340
</remarks>
@@ -427,8 +436,6 @@
427436
428437
[!code-xaml[Viewport2DVisual3DExample#Viewport3D](~/samples/snippets/csharp/VS_Snippets_Wpf/Viewport2DVisual3DExample/CS/window1.xaml#viewport3d)]
429438
430-
For the complete sample, see [Interactive 2-D on 3-D Sample](https://go.microsoft.com/fwlink/?LinkID=160007).
431-
432439
]]></format>
433440
</remarks>
434441
</Docs>

xml/System.Workflow.ComponentModel.Serialization/WorkflowMarkupSerializationManager.xml

Lines changed: 22 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<Type Name="WorkflowMarkupSerializationManager" FullName="System.Workflow.ComponentModel.Serialization.WorkflowMarkupSerializationManager">
1+
<Type Name="WorkflowMarkupSerializationManager" FullName="System.Workflow.ComponentModel.Serialization.WorkflowMarkupSerializationManager">
22
<TypeSignature Language="C#" Value="public class WorkflowMarkupSerializationManager : IServiceProvider, System.ComponentModel.Design.Serialization.IDesignerSerializationManager" />
33
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit WorkflowMarkupSerializationManager extends System.Object implements class System.ComponentModel.Design.Serialization.IDesignerSerializationManager, class System.IServiceProvider" />
44
<TypeSignature Language="DocId" Value="T:System.Workflow.ComponentModel.Serialization.WorkflowMarkupSerializationManager" />
@@ -516,8 +516,15 @@
516516
<ReturnType>System.ComponentModel.Design.Serialization.ResolveNameEventHandler</ReturnType>
517517
</ReturnValue>
518518
<Docs>
519-
<summary>To be added.</summary>
520-
<remarks>To be added.</remarks>
519+
<summary>Occurs when <see cref="M:System.Workflow.ComponentModel.Serialization.WorkflowMarkupSerializationManager.System#ComponentModel#Design#Serialization#IDesignerSerializationManager#GetName(System.Object)" /> cannot locate the specified name in the serialization manager's name table.</summary>
520+
<remarks>
521+
<format type="text/markdown"><![CDATA[
522+
523+
## Remarks
524+
This event provides a way for a serializer to create an object on demand, so that the serializer does not have to order object creation by dependency. The delegate for this event is cleared immediately after serialization or deserialization is complete.
525+
526+
]]></format>
527+
</remarks>
521528
</Docs>
522529
</Member>
523530
<Member MemberName="System.ComponentModel.Design.Serialization.IDesignerSerializationManager.SerializationComplete">
@@ -537,8 +544,17 @@
537544
<ReturnType>System.EventHandler</ReturnType>
538545
</ReturnValue>
539546
<Docs>
540-
<summary>To be added.</summary>
541-
<remarks>To be added.</remarks>
547+
<summary>Occurs when serialization is complete.</summary>
548+
<remarks>
549+
<format type="text/markdown"><![CDATA[
550+
551+
## Remarks
552+
This event is raised when serialization or deserialization is complete.
553+
554+
Generally, serialization code is written to emit serialization data and does not typically require state-related checking and processing. If it is necessary to maintain state data throughout serialization, data can be set and accessed by a serializer, which can listen to the <xref:System.Workflow.ComponentModel.Serialization.WorkflowMarkupSerializationManager.System%23ComponentModel%23Design%23Serialization%23IDesignerSerializationManager%23SerializationComplete> event, and clear the data after serialization. Restoring the proper state after serialization is important because serializers can be reused during serialization, and leftover state data or open streams might not be correct.
555+
556+
]]></format>
557+
</remarks>
542558
</Docs>
543559
</Member>
544560
<Member MemberName="System.ComponentModel.Design.Serialization.IDesignerSerializationManager.SetName">
@@ -575,4 +591,4 @@
575591
</Docs>
576592
</Member>
577593
</Members>
578-
</Type>
594+
</Type>

xml/System.Xml.Schema/XmlSchemaDatatype.xml

Lines changed: 26 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<Type Name="XmlSchemaDatatype" FullName="System.Xml.Schema.XmlSchemaDatatype">
1+
<Type Name="XmlSchemaDatatype" FullName="System.Xml.Schema.XmlSchemaDatatype">
22
<TypeSignature Language="C#" Value="public abstract class XmlSchemaDatatype" />
33
<TypeSignature Language="ILAsm" Value=".class public auto ansi abstract beforefieldinit XmlSchemaDatatype extends System.Object" />
44
<TypeSignature Language="DocId" Value="T:System.Xml.Schema.XmlSchemaDatatype" />
@@ -327,12 +327,31 @@
327327
<Parameter Name="nsmgr" Type="System.Xml.XmlNamespaceManager" />
328328
</Parameters>
329329
<Docs>
330-
<param name="s">To be added.</param>
331-
<param name="nameTable">To be added.</param>
332-
<param name="nsmgr">To be added.</param>
333-
<summary>To be added.</summary>
334-
<returns>To be added.</returns>
335-
<remarks>To be added.</remarks>
330+
<param name="s">The string to validate against the simple type.</param>
331+
<param name="nameTable">The <see cref="T:System.Xml.XmlNameTable" /> to use for atomization while parsing the string if this <see cref="T:System.Xml.Schema.XmlSchemaDatatype" /> object represents the xs:NCName type.</param>
332+
<param name="nsmgr">The <see cref="T:System.Xml.XmlNamespaceManager" /> object to use while parsing the string if this <see cref="T:System.Xml.Schema.XmlSchemaDatatype" /> object represents the xs:QName type.</param>
333+
<summary>When overridden in a derived class, validates the specified string against a built-in or user-defined simple type.</summary>
334+
<returns>An <see cref="T:System.Object" /> that can be safely cast to the type that is returned by the <see cref="P:System.Xml.Schema.XmlSchemaDatatype.ValueType" /> property.</returns>
335+
<remarks>
336+
<format type="text/markdown"><![CDATA[
337+
338+
## Remarks
339+
The <xref:System.Xml.Schema.XmlSchemaDatatype.ParseValue%2A> method validates the specified string against a built-in or user-defined simple type. For example, if this <xref:System.Xml.Schema.XmlSchemaDatatype> represents the type xs:date, then an instance of <xref:System.DateTime> is returned.
340+
341+
The following are the steps performed during the <xref:System.Xml.Schema.XmlSchemaDatatype.ParseValue%2A> method's validation process.
342+
343+
1. Convert the specified string to its corresponding Common Language Runtime (CLR) type.
344+
345+
2. Verify that the value does not violate any facets that are defined for the simple type.
346+
347+
The converted value is then returned as an <xref:System.Object> and can be cast safely to the type that is returned by the <xref:System.Xml.Schema.XmlSchemaDatatype.ValueType> property.
348+
349+
When the <xref:System.Xml.Schema.XmlSchemaDatatype> object represents a list type, the input string value is converted to a list of one or more objects. When the <xref:System.Xml.Schema.XmlSchemaDatatype> object represents a list type, an attempt is made to parse the input value as a member type of the union. If the parse attempt fails, then the conversion is attempted with the next member of the union until the parse is successful or there are no other member types to parse. If the parse is unsuccessful, an exception is thrown.
350+
351+
]]></format>
352+
</remarks>
353+
<exception cref="T:System.Xml.Schema.XmlSchemaValidationException">The input value is not a valid instance of this W3C XML Schema type.</exception>
354+
<exception cref="T:System.ArgumentNullException">The value to parse cannot be null (Nothing in Visual Basic).</exception>
336355
</Docs>
337356
</Member>
338357
<Member MemberName="TokenizedType">

0 commit comments

Comments
 (0)