system.xaml

Author: gewarren

xml/System.Xaml.Schema/XamlTypeInvoker.xml

@@ -169,7 +169,7 @@
 
  Internally, the base implementation calls <see cref="P:System.Xaml.XamlType.IsCollection" />, and throws if the result is <see langword="false" />.
 
- The base implementation does not necessarily use its own <see cref="M:System.Xaml.Schema.XamlTypeInvoker.GetAddMethod(System.Xaml.XamlType)" /> implementation. First, a cast of <paramref name="instance" /> to <see cref="T:System.Collections.IList" /> is attempted. If this succeeds, a call to <see cref="M:System.Collections.IList.Add(System.Object)" /> is made and the method returns. Otherwise, the base implementation uses CLR <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Object[])" /> to invoke the underlying <see langword="Add" /> method, as obtained from a call to <see cref="M:System.Xaml.Schema.XamlTypeInvoker.GetAddMethod(System.Xaml.XamlType)" /> for this <paramref name="" /><see cref="T:System.Xaml.Schema.XamlTypeInvoker" />.
+ The base implementation does not necessarily use its own <see cref="M:System.Xaml.Schema.XamlTypeInvoker.GetAddMethod(System.Xaml.XamlType)" /> implementation. First, a cast of <paramref name="instance" /> to <see cref="T:System.Collections.IList" /> is attempted. If this succeeds, a call to <see cref="M:System.Collections.IList.Add(System.Object)" /> is made and the method returns. Otherwise, the base implementation uses CLR <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Object[])" /> to invoke the underlying <see langword="Add" /> method, as obtained from a call to <see cref="M:System.Xaml.Schema.XamlTypeInvoker.GetAddMethod(System.Xaml.XamlType)" /> for this <see cref="T:System.Xaml.Schema.XamlTypeInvoker" />.
 
  In the base implementation no exception is raised at this level if <paramref name="item" /> is <see langword="null" />. It is still possible that the underlying <see langword="Add" /> method will raise an exception when invoked. Other run time exceptions are possible if <see cref="P:System.Xaml.XamlType.ItemType" /> does not return a valid result.</para>
         </block>
@@ -228,7 +228,7 @@
 
  Internally, the base implementation calls <see cref="P:System.Xaml.XamlType.IsDictionary" />, and throws if the result is <see langword="false" />.
 
- The base implementation does not necessarily use its own <see cref="M:System.Xaml.Schema.XamlTypeInvoker.GetAddMethod(System.Xaml.XamlType)" /> implementation. First, a cast of <paramref name="instance" /> to <see cref="T:System.Collections.IDictionary" /> is attempted. If this succeeds, a call to <see cref="M:System.Collections.IDictionary.Add(System.Object,System.Object)" /> is made and the method returns. Otherwise, the base implementation uses CLR <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Object[])" /> to invoke the underlying <see langword="Add" /> method, as obtained from a call to <see cref="M:System.Xaml.Schema.XamlTypeInvoker.GetAddMethod(System.Xaml.XamlType)" /> for this <paramref name="" /><see cref="T:System.Xaml.Schema.XamlTypeInvoker" />.
+ The base implementation does not necessarily use its own <see cref="M:System.Xaml.Schema.XamlTypeInvoker.GetAddMethod(System.Xaml.XamlType)" /> implementation. First, a cast of <paramref name="instance" /> to <see cref="T:System.Collections.IDictionary" /> is attempted. If this succeeds, a call to <see cref="M:System.Collections.IDictionary.Add(System.Object,System.Object)" /> is made and the method returns. Otherwise, the base implementation uses CLR <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Object[])" /> to invoke the underlying <see langword="Add" /> method, as obtained from a call to <see cref="M:System.Xaml.Schema.XamlTypeInvoker.GetAddMethod(System.Xaml.XamlType)" /> for this <see cref="T:System.Xaml.Schema.XamlTypeInvoker" />.
 
  In the base implementation no exception is raised at this level if <paramref name="item" /> or <paramref name="key" /> is <see langword="null" />. It is still possible that the underlying <see langword="Add" /> method will raise an exception when invoked. Other run time exceptions are possible if <see cref="P:System.Xaml.XamlType.ItemType" /> does not return a valid result.</para>
         </block>
@@ -399,7 +399,7 @@
         <block subset="none" type="overrides">
           <para>The base implementation includes a call to the internal helper <c>ThrowIfUnknown</c>. This helper always throws for cases where a <see cref="T:System.Xaml.Schema.XamlTypeInvoker" /> is based on an unknown <see cref="T:System.Xaml.XamlType" />, which includes cases where the <see cref="P:System.Xaml.XamlType.UnderlyingType" /> of the <see cref="T:System.Xaml.XamlType" /> is <see langword="null" />.
 
- The base implementation does not necessarily use its own <see cref="M:System.Xaml.Schema.XamlTypeInvoker.GetEnumeratorMethod" /> implementation. First, a cast of <paramref name="instance" /> to <see cref="T:System.Collections.IEnumerable" /> is attempted. If this succeeds, a call to <see cref="M:System.Collections.IEnumerable.GetEnumerator" /> is made and the method returns that return value. Otherwise, the base implementation uses CLR <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Object[])" /> to invoke the underlying <see langword="GetEnumerator" /> method, as obtained from a call to <see cref="M:System.Xaml.Schema.XamlTypeInvoker.GetEnumeratorMethod" /> for this <paramref name="" /><see cref="T:System.Xaml.Schema.XamlTypeInvoker" />.</para>
+ The base implementation does not necessarily use its own <see cref="M:System.Xaml.Schema.XamlTypeInvoker.GetEnumeratorMethod" /> implementation. First, a cast of <paramref name="instance" /> to <see cref="T:System.Collections.IEnumerable" /> is attempted. If this succeeds, a call to <see cref="M:System.Collections.IEnumerable.GetEnumerator" /> is made and the method returns that return value. Otherwise, the base implementation uses CLR <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Object[])" /> to invoke the underlying <see langword="GetEnumerator" /> method, as obtained from a call to <see cref="M:System.Xaml.Schema.XamlTypeInvoker.GetEnumeratorMethod" /> for this <see cref="T:System.Xaml.Schema.XamlTypeInvoker" />.</para>
         </block>
       </Docs>
     </Member>

xml/System.Xaml/AttachableMemberIdentifier.xml

@@ -24,7 +24,7 @@
     </Interface>
   </Interfaces>
   <Docs>
-    <summary>Provides a XAML type system identifier representation for attachable members. The identifier structure parallels the <paramref name="declaringType" /><see langword="." /><paramref name="memberName" /> string form for attachable member usage.</summary>
+    <summary>Provides a XAML type system identifier representation for attachable members. The identifier structure parallels the <see langword="declaringType" /><see langword="." /><see langword="memberName" /> string form for attachable member usage.</summary>
     <remarks>To be added.</remarks>
     <altmember cref="T:System.Xaml.AttachablePropertyServices" />
     <altmember cref="T:System.Xaml.XamlMember" />
@@ -96,11 +96,11 @@
         <summary>Gets or sets the <paramref name="declaringType" /> component value of the <see cref="T:System.Xaml.AttachableMemberIdentifier" />.</summary>
         <value>The <paramref name="declaringType" /> component value of the <see cref="T:System.Xaml.AttachableMemberIdentifier" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Xaml.AttachableMemberIdentifier.DeclaringType%2A> value should match the name of the <xref:System.Xaml.XamlMember.Type%2A?displayProperty=nameWithType> of the attachable member's XAML type system information.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Xaml.AttachableMemberIdentifier.DeclaringType%2A> value should match the name of the <xref:System.Xaml.XamlMember.Type%2A?displayProperty=nameWithType> of the attachable member's XAML type system information.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -179,11 +179,11 @@
         <returns>
           <see langword="true" /> if the objects have the same value; otherwise, <see langword="false" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The values that this method checks for equality are <xref:System.Xaml.AttachableMemberIdentifier.DeclaringType%2A> and <xref:System.Xaml.AttachableMemberIdentifier.MemberName%2A>.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The values that this method checks for equality are <xref:System.Xaml.AttachableMemberIdentifier.DeclaringType%2A> and <xref:System.Xaml.AttachableMemberIdentifier.MemberName%2A>.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -247,11 +247,11 @@
         <summary>Gets or sets the <paramref name="memberName" /> component value of the <see cref="T:System.Xaml.AttachableMemberIdentifier" />.</summary>
         <value>The <paramref name="memberName" /> component value of the <see cref="T:System.Xaml.AttachableMemberIdentifier" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Xaml.AttachableMemberIdentifier.MemberName%2A> value should match the <xref:System.Xaml.XamlMember.Name%2A?displayProperty=nameWithType> of the attachable member's XAML type system information.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Xaml.AttachableMemberIdentifier.MemberName%2A> value should match the <xref:System.Xaml.XamlMember.Name%2A?displayProperty=nameWithType> of the attachable member's XAML type system information.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -350,11 +350,11 @@
         <summary>Returns a <see cref="T:System.String" /> that represents the current <see cref="T:System.Xaml.AttachableMemberIdentifier" />.</summary>
         <returns>A <see cref="T:System.String" /> that represents the current <see cref="T:System.Xaml.AttachableMemberIdentifier" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- This implementation returns a string form that parallels the XAML attachable member usage in markup. That string form is `declaringType.memberName`.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ This implementation returns a string form that parallels the XAML attachable member usage in markup. That string form is `declaringType.memberName`.
+
  ]]></format>
         </remarks>
       </Docs>

xml/System.Xaml/XamlNodeQueue.xml

@@ -22,13 +22,13 @@
   <Docs>
     <summary>Provides a buffer for writing nodes and reading them again.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Nodes are consumed from the <xref:System.Xaml.XamlNodeQueue> when they are read by the XAML reader. If you require a list of XAML nodes that can be replayed, or a list model that supports random access, see <xref:System.Xaml.XamlNodeList>.  
-  
- When you create a <xref:System.Xaml.XamlNodeQueue>, you create a writer delegate that exists as the <xref:System.Xaml.XamlNodeQueue.Writer%2A> value. The writer delegate is based on an internal XAML writer class that is specifically for XAML nodes.  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Nodes are consumed from the <xref:System.Xaml.XamlNodeQueue> when they are read by the XAML reader. If you require a list of XAML nodes that can be replayed, or a list model that supports random access, see <xref:System.Xaml.XamlNodeList>.
+
+ When you create a <xref:System.Xaml.XamlNodeQueue>, you create a writer delegate that exists as the <xref:System.Xaml.XamlNodeQueue.Writer%2A> value. The writer delegate is based on an internal XAML writer class that is specifically for XAML nodes.
+
  ]]></format>
     </remarks>
   </Docs>
@@ -58,15 +58,15 @@
         <param name="schemaContext">The schema context to use for node operations.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Xaml.XamlNodeQueue" /> class using a provided XAML schema context.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The schema context is applied to the XAML writer that exists as the <xref:System.Xaml.XamlNodeQueue.Writer%2A> value.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The schema context is applied to the XAML writer that exists as the <xref:System.Xaml.XamlNodeQueue.Writer%2A> value.
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="xamlSchemaContext" /> is <see langword="null" />.</exception>
+          <paramref name="schemaContext" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="Count">