Automatic port of System.Reflection documentation (#4703)

* Automatic port of System.Reflection documentation

* Apply suggestions from code review

Co-authored-by: Genevieve Warren <[email protected]>

Co-authored-by: carlossanlop <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>

Author: carlossanlop

xml/System.Reflection.Metadata.Ecma335/ArrayShapeEncoder.xml

@@ -1,4 +1,4 @@
-<Type Name="ArrayShapeEncoder" FullName="System.Reflection.Metadata.Ecma335.ArrayShapeEncoder">
+<Type Name="ArrayShapeEncoder" FullName="System.Reflection.Metadata.Ecma335.ArrayShapeEncoder">
   <TypeSignature Language="C#" Value="public struct ArrayShapeEncoder" />
   <TypeSignature Language="ILAsm" Value=".class public sequential ansi sealed beforefieldinit ArrayShapeEncoder extends System.ValueType" />
   <TypeSignature Language="DocId" Value="T:System.Reflection.Metadata.Ecma335.ArrayShapeEncoder" />
@@ -113,6 +113,10 @@
  The array may be shorter than <paramref name="rank" /> but not longer.</param>
         <summary>Encodes array shape.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="rank" /> is outside of range [1, 0xffff], smaller than <see langword="sizes.Length" />, or smaller than <see langword="lowerBounds.Length" />.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="sizes" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
   </Members>

xml/System.Reflection.Metadata.Ecma335/BlobEncoder.xml

@@ -1,4 +1,4 @@
-<Type Name="BlobEncoder" FullName="System.Reflection.Metadata.Ecma335.BlobEncoder">
+<Type Name="BlobEncoder" FullName="System.Reflection.Metadata.Ecma335.BlobEncoder">
   <TypeSignature Language="C#" Value="public struct BlobEncoder" />
   <TypeSignature Language="ILAsm" Value=".class public sequential ansi sealed beforefieldinit BlobEncoder extends System.ValueType" />
   <TypeSignature Language="DocId" Value="T:System.Reflection.Metadata.Ecma335.BlobEncoder" />
@@ -110,6 +110,8 @@
         <param name="namedArguments">Called second, to encode named arguments.</param>
         <summary>Encodes custom attribute signature blob.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="fixedArguments" /> or <paramref name="namedArguments" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="CustomAttributeSignature">
@@ -199,6 +201,8 @@
         <summary>Encodes local variable signature.</summary>
         <returns>Encoder of a sequence of local variables.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="variableCount" /> is not in range [0, 0x1fffffff].</exception>
       </Docs>
     </Member>
     <Member MemberName="MethodSignature">
@@ -233,6 +237,8 @@
         <summary>Encodes method signature blob.</summary>
         <returns>An encoder of the rest of the signature including return value and parameters.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="genericParameterCount" /> is not in range [0, 0xffff].</exception>
       </Docs>
     </Member>
     <Member MemberName="MethodSpecificationSignature">
@@ -263,6 +269,8 @@
         <summary>Encodes method specification signature blob.</summary>
         <returns>Encoder of generic arguments.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="genericArgumentCount" /> is not in range [0, 0xffff].</exception>
       </Docs>
     </Member>
     <Member MemberName="PermissionSetArguments">
@@ -323,6 +331,8 @@
         <summary>Encodes a permission set blob.</summary>
         <returns>Permission set encoder.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="attributeCount" /> is not in range [0, 0x1fffffff].</exception>
       </Docs>
     </Member>
     <Member MemberName="PropertySignature">

xml/System.Reflection.Metadata.Ecma335/CodedIndex.xml

@@ -1,4 +1,4 @@
-<Type Name="CodedIndex" FullName="System.Reflection.Metadata.Ecma335.CodedIndex">
+<Type Name="CodedIndex" FullName="System.Reflection.Metadata.Ecma335.CodedIndex">
   <TypeSignature Language="C#" Value="public static class CodedIndex" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi abstract sealed beforefieldinit CodedIndex extends System.Object" />
   <TypeSignature Language="DocId" Value="T:System.Reflection.Metadata.Ecma335.CodedIndex" />
@@ -52,6 +52,7 @@
         <summary>Calculates a CustomAttributeType coded index for the specified handle.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">The handle type is unexpected.</exception>
       </Docs>
     </Member>
     <Member MemberName="HasConstant">
@@ -83,6 +84,7 @@
         <summary>Calculates a HasConstant coded index for the specified handle.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">The handle type is unexpected.</exception>
       </Docs>
     </Member>
     <Member MemberName="HasCustomAttribute">
@@ -114,6 +116,7 @@
         <summary>Calculates a HasCustomAttribute coded index for the specified handle.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">The handle type is unexpected.</exception>
       </Docs>
     </Member>
     <Member MemberName="HasCustomDebugInformation">
@@ -145,6 +148,7 @@
         <summary>Calculates a HasCustomDebugInformation coded index for the specified handle.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">The handle type is unexpected.</exception>
       </Docs>
     </Member>
     <Member MemberName="HasDeclSecurity">
@@ -176,6 +180,7 @@
         <summary>Calculates a HasDeclSecurity coded index for the specified handle.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">The handle type is unexpected.</exception>
       </Docs>
     </Member>
     <Member MemberName="HasFieldMarshal">
@@ -207,6 +212,7 @@
         <summary>Calculates a HasFieldMarshal coded index for the specified handle.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">The handle type is unexpected.</exception>
       </Docs>
     </Member>
     <Member MemberName="HasSemantics">
@@ -238,6 +244,7 @@
         <summary>Calculates a HasSemantics coded index for the specified handle.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">The handle type is unexpected.</exception>
       </Docs>
     </Member>
     <Member MemberName="Implementation">
@@ -269,6 +276,7 @@
         <summary>Calculates an implementation coded index for the specified handle.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">The handle type is unexpected.</exception>
       </Docs>
     </Member>
     <Member MemberName="MemberForwarded">
@@ -300,6 +308,7 @@
         <summary>Calculates a MemberForwarded coded index for the specified handle.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">The handle type is unexpected.</exception>
       </Docs>
     </Member>
     <Member MemberName="MemberRefParent">
@@ -331,6 +340,7 @@
         <summary>Calculates a MemberRefParent coded index for the specified handle.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">The handle type is unexpected.</exception>
       </Docs>
     </Member>
     <Member MemberName="MethodDefOrRef">
@@ -362,6 +372,7 @@
         <summary>Calculates a MethodDefOrRef coded index for the specified handle.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">The handle type is unexpected.</exception>
       </Docs>
     </Member>
     <Member MemberName="ResolutionScope">
@@ -393,6 +404,7 @@
         <summary>Calculates a ResolutionScope coded index for the specified handle.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">The handle type is unexpected.</exception>
       </Docs>
     </Member>
     <Member MemberName="TypeDefOrRef">
@@ -424,6 +436,7 @@
         <summary>Calculates a TypeDefOrRef coded index for the specified handle.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">The handle type is unexpected.</exception>
       </Docs>
     </Member>
     <Member MemberName="TypeDefOrRefOrSpec">
@@ -455,6 +468,7 @@
         <summary>Calculates a TypeDefOrRefOrSpec coded index for the specified handle.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">The handle type is unexpected.</exception>
       </Docs>
     </Member>
     <Member MemberName="TypeOrMethodDef">
@@ -486,6 +500,7 @@
         <summary>Calculates a TypeOrMethodDef coded index for the specified handle.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">The handle type is unexpected.</exception>
       </Docs>
     </Member>
   </Members>

xml/System.Reflection.Metadata.Ecma335/ControlFlowBuilder.xml

@@ -1,4 +1,4 @@
-<Type Name="ControlFlowBuilder" FullName="System.Reflection.Metadata.Ecma335.ControlFlowBuilder">
+<Type Name="ControlFlowBuilder" FullName="System.Reflection.Metadata.Ecma335.ControlFlowBuilder">
   <TypeSignature Language="C#" Value="public sealed class ControlFlowBuilder" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit ControlFlowBuilder extends System.Object" />
   <TypeSignature Language="DocId" Value="T:System.Reflection.Metadata.Ecma335.ControlFlowBuilder" />
@@ -80,6 +80,13 @@
         <param name="catchType">The type of exception to be caught: <see cref="T:System.Reflection.Metadata.TypeDefinitionHandle" />, <see cref="T:System.Reflection.Metadata.TypeReferenceHandle" /> or <see cref="T:System.Reflection.Metadata.TypeSpecificationHandle" />.</param>
         <summary>Adds catch region.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">A label was not defined by an instruction encoder this builder is associated with.
+
+-or-
+
+<paramref name="catchType" /> is not a valid type handle.
+        </exception>
+        <exception cref="T:System.ArgumentNullException">A label has default value.</exception>
       </Docs>
     </Member>
     <Member MemberName="AddFaultRegion">
@@ -115,6 +122,8 @@
         <param name="handlerEnd">Label marking the instruction immediately following the handler.</param>
         <summary>Adds fault region.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">A label was not defined by an instruction encoder this builder is associated with.</exception>
+        <exception cref="T:System.ArgumentNullException">A label has default value.</exception>
       </Docs>
     </Member>
     <Member MemberName="AddFilterRegion">
@@ -152,6 +161,8 @@
         <param name="filterStart">Label marking the first instruction of the filter block.</param>
         <summary>Adds catch region.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">A label was not defined by an instruction encoder this builder is associated with.</exception>
+        <exception cref="T:System.ArgumentNullException">A label has default value.</exception>
       </Docs>
     </Member>
     <Member MemberName="AddFinallyRegion">
@@ -187,6 +198,8 @@
         <param name="handlerEnd">Label marking the instruction immediately following the handler.</param>
         <summary>Adds finally region.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">A label was not defined by an instruction encoder this builder is associated with.</exception>
+        <exception cref="T:System.ArgumentNullException">A label has default value.</exception>
       </Docs>
     </Member>
   </Members>

xml/System.Reflection.Metadata.Ecma335/CustomModifiersEncoder.xml

@@ -1,4 +1,4 @@
-<Type Name="CustomModifiersEncoder" FullName="System.Reflection.Metadata.Ecma335.CustomModifiersEncoder">
+<Type Name="CustomModifiersEncoder" FullName="System.Reflection.Metadata.Ecma335.CustomModifiersEncoder">
   <TypeSignature Language="C#" Value="public struct CustomModifiersEncoder" />
   <TypeSignature Language="ILAsm" Value=".class public sequential ansi sealed beforefieldinit CustomModifiersEncoder extends System.ValueType" />
   <TypeSignature Language="DocId" Value="T:System.Reflection.Metadata.Ecma335.CustomModifiersEncoder" />
@@ -86,6 +86,8 @@
         <summary>Encodes a custom modifier.</summary>
         <returns>Encoder of subsequent modifiers.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="type" /> is <see langword="null" /> or of an unexpected kind.</exception>
       </Docs>
     </Member>
     <Member MemberName="Builder">

xml/System.Reflection.Metadata.Ecma335/ExceptionRegionEncoder.xml

@@ -1,4 +1,4 @@
-<Type Name="ExceptionRegionEncoder" FullName="System.Reflection.Metadata.Ecma335.ExceptionRegionEncoder">
+<Type Name="ExceptionRegionEncoder" FullName="System.Reflection.Metadata.Ecma335.ExceptionRegionEncoder">
   <TypeSignature Language="C#" Value="public struct ExceptionRegionEncoder" />
   <TypeSignature Language="ILAsm" Value=".class public sequential ansi sealed beforefieldinit ExceptionRegionEncoder extends System.ValueType" />
   <TypeSignature Language="DocId" Value="T:System.Reflection.Metadata.Ecma335.ExceptionRegionEncoder" />
@@ -69,6 +69,17 @@
         <summary>Adds an exception clause.</summary>
         <returns>Encoder for the next clause.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="catchType" /> is invalid.</exception>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="kind" /> has an invalid value.
+          
+-or-
+
+<paramref name="tryOffset" />, <paramref name="tryLength" />, <paramref name="handlerOffset" />, or <paramref name="handlerLength" /> is out of range.
+          
+          </exception>
+        <exception cref="T:System.InvalidOperationException">Method body was not declared to have exception regions.</exception>
       </Docs>
     </Member>
     <Member MemberName="AddCatch">
@@ -108,6 +119,11 @@
         <summary>Adds a fault clause.</summary>
         <returns>Encoder for the next clause.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="catchType" /> is invalid.</exception>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="tryOffset" />, <paramref name="tryLength" />, <paramref name="handlerOffset" /> or <paramref name="handlerLength" /> is out of range.</exception>
+        <exception cref="T:System.InvalidOperationException">Method body was not declared to have exception regions.</exception>
       </Docs>
     </Member>
     <Member MemberName="AddFault">
@@ -144,6 +160,9 @@
         <summary>Adds a fault clause.</summary>
         <returns>Encoder for the next clause.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="tryOffset" />, <paramref name="tryLength" />, <paramref name="handlerOffset" /> or <paramref name="handlerLength" /> is out of range.</exception>
+        <exception cref="T:System.InvalidOperationException">Method body was not declared to have exception regions.</exception>
       </Docs>
     </Member>
     <Member MemberName="AddFilter">
@@ -182,6 +201,9 @@
         <summary>Adds a fault clause.</summary>
         <returns>Encoder for the next clause.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="tryOffset" />, <paramref name="tryLength" />, <paramref name="handlerOffset" /> or <paramref name="handlerLength" /> is out of range.</exception>
+        <exception cref="T:System.InvalidOperationException">Method body was not declared to have exception regions.</exception>
       </Docs>
     </Member>
     <Member MemberName="AddFinally">
@@ -218,6 +240,9 @@
         <summary>Adds a finally clause.</summary>
         <returns>Encoder for the next clause.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="tryOffset" />, <paramref name="tryLength" />, <paramref name="handlerOffset" /> or <paramref name="handlerLength" /> is out of range.</exception>
+        <exception cref="T:System.InvalidOperationException">Method body was not declared to have exception regions.</exception>
       </Docs>
     </Member>
     <Member MemberName="Builder">