Merge pull request #5714 from alexischr/update_bockbuild
[mono.git] / mcs / class / corlib / Documentation / en / System.Reflection / AmbiguousMatchException.xml
index 301feae31380d9c12a8770ad4f82dabdd12a6fbf..1fd480b8afb3fe8e3daffc9b55d42db6372aad7c 100644 (file)
@@ -1,3 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
 <Type Name="AmbiguousMatchException" FullName="System.Reflection.AmbiguousMatchException" FullNameSP="System_Reflection_AmbiguousMatchException" Maintainer="ecma">
   <TypeSignature Language="ILASM" Value=".class public sealed serializable AmbiguousMatchException extends System.SystemException" />
   <TypeSignature Language="C#" Value="public sealed class AmbiguousMatchException : SystemException" />
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>
-      <para>Represents the error that occurs when binding to a method or retrieving custom attributes results
-      in more than one item matching the specified criteria.</para>
-    </summary>
     <remarks>
-      <para>
-        <see cref="T:System.Reflection.AmbiguousMatchException" /> is thrown when a search that
-   is intended to return no more than one match, detects multiple matching items.
-   For example, this exception is thrown when the <see cref="M:System.Attribute.GetCustomAttribute(System.Reflection.MemberInfo,System.Type)" /> methods (which return a single custom attribute),
-   find multiple occurrences of the attribute.</para>
+      <attribution license="cc4" from="Microsoft" modified="false" />
+      <para>AmbiguousMatchException uses the HRESULT COR_E_AMBIGUOUSMATCH which has the value 0x8000211D.</para>
+      <para>An AmbiguousMatchException is thrown when a member is invoked late-bound and multiple overloads satisfy the binding criteria, or when more than one member matches the binding criteria passed to a reflection method that can return only a single result (for example, <see cref="Overload:System.Type.GetMethod" /> or <see cref="Overload:System.Type.GetProperty" />). </para>
     </remarks>
+    <summary>
+      <attribution license="cc4" from="Microsoft" modified="false" />
+      <para>The exception that is thrown when binding to a member results in more than one member matching the binding criteria. This class cannot be inherited.</para>
+    </summary>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>
-          <para>Constructs and initializes a new instance of the <see cref="T:System.Reflection.AmbiguousMatchException" />
-class.</para>
-        </summary>
         <remarks>
-          <para>This constructor initializes the <see cref="!:System.Reflection.AmbiguousMatchException.Message" /> property of the new
-   instance to a system-supplied message that describes the error, such as "Ambiguous match found."
-   This message takes into account the current system culture.</para>
-          <para>The <see cref="!:System.Reflection.AmbiguousMatchException.InnerException" /> property is initialized to <see langword="null" />
-.</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>AmbiguousMatchException inherits from <see cref="T:System.Exception" />. This constructor sets the properties of the Exception object as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Property </para>
+                </term>
+                <description>
+                  <para>Value </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>
+                  <see cref="P:System.Exception.InnerException" /> </para>
+              </term>
+              <description>
+                <para>null  </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>
+                  <see cref="P:System.Exception.Message" /> </para>
+              </term>
+              <description>
+                <para>The empty string (""). </para>
+              </description>
+            </item>
+          </list>
         </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Initializes a new instance of the <see cref="T:System.Reflection.AmbiguousMatchException" /> class with an empty message string and the root cause exception set to null.</para>
+        </summary>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -76,18 +102,46 @@ class.</para>
         <Parameter Name="message" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="message">A <see cref="T:System.String" /> that describes the error. The content of <paramref name="message" /> is intended to be understood by humans. The caller of this constructor is required to ensure that this string has been localized for the current system culture.</param>
-        <summary>
-          <para>Constructs and initializes a new instance of the <see cref="T:System.Reflection.AmbiguousMatchException" />
-class.</para>
-        </summary>
         <remarks>
-          <para>This constructor initializes the <see cref="!:System.Reflection.AmbiguousMatchException.Message" /> property of the new instance using <paramref name="message" />. If <paramref name="message" /> is 
-<see langword="null" />, the <see cref="!:System.Reflection.AmbiguousMatchException.Message" /> property is initialized to the 
-   system-supplied message provided by the constructor that takes no
-   arguments. </para>
-          <para> The <see cref="!:System.Reflection.AmbiguousMatchException.InnerException" /> property is initialized to <see langword="null" />.</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>AmbiguousMatchException inherits from <see cref="T:System.Exception" />. This constructor sets the properties of the Exception object as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Property </para>
+                </term>
+                <description>
+                  <para>Value </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>
+                  <see cref="P:System.Exception.InnerException" /> </para>
+              </term>
+              <description>
+                <para>null  </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>
+                  <see cref="P:System.Exception.Message" /> </para>
+              </term>
+              <description>
+                <para>The <paramref name="message" /> string. </para>
+              </description>
+            </item>
+          </list>
         </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Initializes a new instance of the <see cref="T:System.Reflection.AmbiguousMatchException" /> class with its message string set to the given message and the root cause exception set to null.</para>
+        </summary>
+        <param name="message">
+          <attribution license="cc4" from="Microsoft" modified="false" />A string indicating the reason this exception was thrown. </param>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -107,26 +161,52 @@ class.</para>
         <Parameter Name="inner" Type="System.Exception" />
       </Parameters>
       <Docs>
-        <param name="message">A <see cref="T:System.String" /> that describes the error. The content of <paramref name="message" /> is intended to be understood by humans. The caller of this constructor is required to ensure that this string has been localized for the current system culture.</param>
-        <param name="inner">An instance of <see cref="T:System.Exception" /> that is the cause of the current Exception. If <paramref name="inner" /> is non-null, then the current Exception was raised in a catch block handling <paramref name="inner" /> .</param>
-        <summary>
-          <para>Constructs and initializes a new instance of the <see cref="T:System.Reflection.AmbiguousMatchException" />
-class.</para>
-        </summary>
         <remarks>
-          <para>This constructor initializes the <see cref="!:System.Reflection.AmbiguousMatchException.Message" /> property of the new instance using <paramref name="message" />, and
-   the <see cref="!:System.Reflection.AmbiguousMatchException.InnerException" /> property using <paramref name="inner" />. If <paramref name="message" /> is <see langword="null" />,
-   the <see cref="!:System.Reflection.AmbiguousMatchException.Message" /> property is initialized to the
-   system-supplied message provided by the constructor that takes no
-   arguments. </para>
-          <para>
-            <block subset="none" type="note"> For information on inner exceptions,
-   see <see cref="P:System.Exception.InnerException" />.</block>
-          </para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An exception that is thrown as a direct result of a previous exception should include a reference to the previous exception in the <see cref="P:System.Exception.InnerException" /> property. The <see cref="P:System.Exception.InnerException" /> property returns the same value that is passed into the constructor, or null if the <see cref="P:System.Exception.InnerException" /> property does not supply the inner exception value to the constructor.</para>
+          <para>The following table shows the initial property values for an instance of <see cref="T:System.Reflection.AmbiguousMatchException" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Property </para>
+                </term>
+                <description>
+                  <para>Value </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>
+                  <see cref="P:System.Exception.InnerException" /> </para>
+              </term>
+              <description>
+                <para>The inner exception reference. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>
+                  <see cref="P:System.Exception.Message" /> </para>
+              </term>
+              <description>
+                <para>The error message string. </para>
+              </description>
+            </item>
+          </list>
         </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Initializes a new instance of the <see cref="T:System.Reflection.AmbiguousMatchException" /> class with a specified error message and a reference to the inner exception that is the cause of this exception.</para>
+        </summary>
+        <param name="message">
+          <attribution license="cc4" from="Microsoft" modified="false" />The error message that explains the reason for the exception. </param>
+        <param name="inner">
+          <attribution license="cc4" from="Microsoft" modified="false" />The exception that is the cause of the current exception. If the <paramref name="inner" /> parameter is not null, the current exception is raised in a catch block that handles the inner exception. </param>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
   </Members>
   <TypeExcluded>0</TypeExcluded>
-</Type>
+</Type>
\ No newline at end of file