dotnet · gewarren · Apr 2, 2025 · Mar 28, 2025
@@ -11708,7 +11708,7 @@ The integer value `33022` can be exported in four different arrays:
         <param name="destination">The span of characters into which this instance will be written.</param>
         <param name="charsWritten">When the method returns, contains the length of the span in number of characters.</param>
         <param name="format">A read-only span of characters that specifies the format for the formatting operation.</param>
-        <param name="provider">An object that supplies culture-specific formatting information about <paramref name="value" />.</param>
+        <param name="provider">An object that supplies culture-specific formatting information.</param>
         <summary>Formats this big integer instance into a span of characters.</summary>
         <returns>
           <see langword="true" /> if the formatting operation succeeds; <see langword="false" /> otherwise.</returns>

@@ -3383,11 +3383,6 @@ The following code example shows how to define and use a dynamic assembly. The e
 > [!NOTE]
 >  <xref:System.Reflection.Emit.AssemblyBuilder.SetCustomAttribute%2A> cannot be used to set declarative security attributes. Use one of the overloads of <xref:System.AppDomain.DefineDynamicAssembly%2A> that takes required, optional, and refused permissions.
 
-> [!NOTE]
->  Starting with the .NET Framework 2.0 Service Pack 1, this member no longer requires <xref:System.Security.Permissions.ReflectionPermission> with the <xref:System.Security.Permissions.ReflectionPermissionFlag.ReflectionEmit?displayProperty=nameWithType> flag. (See [Security Issues in Reflection Emit](/dotnet/framework/reflection-and-codedom/security-issues-in-reflection-emit).) To use this functionality, your application should target the .NET Framework 3.5 or later.
-
-
-
 ## Examples
  The following code sample illustrates the use of `SetCustomAttribute` within <xref:System.Reflection.Emit.AssemblyBuilder>, using a <xref:System.Reflection.Emit.CustomAttributeBuilder>.
 
@@ -3398,7 +3393,7 @@ The following code example shows how to define and use a dynamic assembly. The e
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="con" /> is <see langword="null" />.</exception>
+          <paramref name="customBuilder" /> is <see langword="null" />.</exception>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
       </Docs>
     </Member>

@@ -1988,11 +1988,6 @@ The following code example creates a dynamic method that takes two parameters. T
 
  This method does not demand permissions directly, but invoking the dynamic method can result in security demands, depending on the method. For example, no demands are made for anonymously hosted dynamic methods that are created with the `restrictedSkipVisibility` parameter set to `false`. On the other hand, if you create a method with `restrictedSkipVisibility` set to `true` so it can access a hidden member of a target assembly, the method will cause a demand for the permissions of the target assembly plus <xref:System.Security.Permissions.ReflectionPermission> with the <xref:System.Security.Permissions.ReflectionPermissionFlag.MemberAccess?displayProperty=nameWithType> flag.
 
-> [!NOTE]
->  Prior to .NET Framework 2.0, this method required <xref:System.Security.Permissions.ReflectionPermission> with the <xref:System.Security.Permissions.ReflectionPermissionFlag.MemberAccess> flag.
-
-
-
 ## Examples
  The following code example invokes a dynamic method with exact binding, using the US-English culture. This code example is part of a larger example provided for the <xref:System.Reflection.Emit.DynamicMethod> class.
 

@@ -3739,7 +3739,7 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="con" /> is <see langword="null" />.</exception>
+          <paramref name="customBuilder" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetCustomAttribute">

@@ -367,7 +367,7 @@
         <summary>Sets a custom attribute using a custom attribute builder.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="con" /> is <see langword="null" />.</exception>
+          <paramref name="customBuilder" /> is <see langword="null" />.</exception>
         <exception cref="T:System.InvalidOperationException">
           <see cref="M:System.Reflection.Emit.TypeBuilder.CreateType" /> has been called on the enclosing type.</exception>
       </Docs>

@@ -902,7 +902,7 @@
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="con" /> is <see langword="null" />.</exception>
+          <paramref name="customBuilder" /> is <see langword="null" />.</exception>
         <exception cref="T:System.InvalidOperationException">The parent type of this field is complete.</exception>
       </Docs>
     </Member>

@@ -1174,7 +1174,7 @@
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="con" /> is <see langword="null" />. This exception is new in the .NET Framework 4.</exception>
+          <paramref name="con" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="Emit">
@@ -1302,8 +1302,6 @@
 
  Labels are created using <xref:System.Reflection.Emit.ILGenerator.DefineLabel%2A> and their location within the stream is fixed by using <xref:System.Reflection.Emit.ILGenerator.MarkLabel%2A>. If a single-byte instruction is used, the label can represent a jump of at most 127 bytes along the stream. `opcode` must represent a branch instruction. Because branches are relative instructions, `label` will be replaced with the correct offset to branch during the fixup process.
 
-
-
 ## Examples
  The code sample below illustrates the creation of a dynamic method with a jump table. The jump table is built using an array of <xref:System.Reflection.Emit.Label>.
 
@@ -1313,8 +1311,6 @@
 
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentNullException">
-          <paramref name="con" /> is <see langword="null" />. This exception is new in the .NET Framework 4.</exception>
       </Docs>
     </Member>
     <Member MemberName="Emit">

@@ -3229,7 +3229,6 @@
 
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentNullException">The <paramref name="name" /> parameter is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="GetFieldToken">
@@ -5438,13 +5437,8 @@
 ## Remarks
  This method does nothing.
 
-> [!NOTE]
->  Starting with the .NET Framework 2.0 Service Pack 1, this member no longer requires <xref:System.Security.Permissions.ReflectionPermission> with the <xref:System.Security.Permissions.ReflectionPermissionFlag.ReflectionEmit?displayProperty=nameWithType> flag. (See [Security Issues in Reflection Emit](/dotnet/framework/reflection-and-codedom/security-issues-in-reflection-emit).) To use this functionality, your application should target the .NET Framework 3.5 or later.
-
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentNullException">
-          <paramref name="url" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetUserEntryPoint">

@@ -535,7 +535,7 @@
         <summary>Set a custom attribute using a custom attribute builder.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="con" /> is <see langword="null" />.</exception>
+          <paramref name="customBuilder" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetCustomAttribute">

@@ -65,7 +65,7 @@ For more information about this API, see [Persisted dynamic assemblies in .NET](
         <param name="assemblyAttributes">A collection that contains the attributes of the assembly.</param>
         <summary>Creates a <see cref="T:System.Reflection.Emit.PersistedAssemblyBuilder" /> instance that can be saved to a file or stream.</summary>
         <remarks>Currently the persisted assembly doesn't support running. You must save it and load it back to run.</remarks>
-        <exception cref="T:System.ArgumentNullException">The <paramref name="name" /> or <paramref name="name.Name.Name" /> or <paramref name="coreAssembly" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentNullException">The <paramref name="name" /> or <paramref name="coreAssembly" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="DefineDynamicModuleCore">

@@ -785,7 +785,7 @@ For more information, see [ECMA 335 Common Language Infrastructure (CLI)](https:
         <returns>The <see langword="SignatureHelper" /> object for a method.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">
-          <paramref name="unmanagedCallConv" /> is an unknown unmanaged calling convention.</exception>
+          <paramref name="unmanagedCallingConvention" /> is an unknown unmanaged calling convention.</exception>
       </Docs>
     </Member>
     <Member MemberName="GetMethodSigHelper">

@@ -80,7 +80,7 @@ Metadata root constitutes of a metadata header followed by metadata streams (`#~
         <param name="tablesAndHeaps">Builder populated with metadata entities stored in tables and values stored in heaps. The entities and values will be enumerated when serializing the metadata root.</param>
         <param name="metadataVersion">The version string written to the metadata header. The default value is "v4.0.30319".</param>
         <param name="suppressValidation">
-          <see langword="true" /> to suppress basic validation of metadata tables during serialization; otherwise, <paramref name="false" />.</param>
+          <see langword="true" /> to suppress basic validation of metadata tables during serialization; otherwise, <see langword="false" />.</param>
         <summary>Creates a builder of a metadata root.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[

@@ -3253,8 +3253,6 @@ Note: In <see href="https://go.microsoft.com/fwlink/?LinkID=247912">.NET for Win
 > [!NOTE]
 >  If the type has been forwarded to another assembly, it is still returned by this method. For information on type forwarding, see [Type Forwarding in the Common Language Runtime](/dotnet/standard/assembly/type-forwarding).
 
-
-
 ## Examples
  The following example defines an abstract `MeansOfTransportation` class in the `Transportation` namespace. It calls the <xref:System.Reflection.Assembly.GetType%28System.String%29> method to retrieve its <xref:System.Type> object, calls the <xref:System.Type.GetProperties%2A?displayProperty=nameWithType> method to get an array of <xref:System.Reflection.PropertyInfo> objects that represent the type's properties, and then displays information on the type's abstract properties. Note that the call to the <xref:System.Reflection.Assembly.GetType%28System.String%29> method uses the type's fully qualified name (that is, its namespace along with its type name).
 
@@ -3275,11 +3273,9 @@ Note: In <see href="https://go.microsoft.com/fwlink/?LinkID=247912">.NET for Win
  -or-
 
  The current assembly was loaded into the reflection-only context, and <paramref name="name" /> requires a dependent assembly that was not preloaded.
-
-Note: In <see href="https://go.microsoft.com/fwlink/?LinkID=247912">.NET for Windows Store apps</see> or the <see href="https://learn.microsoft.com/dotnet/standard/cross-platform/cross-platform-development-with-the-portable-class-library">Portable Class Library</see>, catch the base class exception, <see cref="T:System.IO.IOException" />, instead.
         </exception>
         <exception cref="T:System.BadImageFormatException">
-          <paramref name="typeName" /> requires a dependent assembly, but the file is not a valid assembly for the currently loaded runtime.
+          <paramref name="name" /> requires a dependent assembly, but the file is not a valid assembly for the currently loaded runtime.
         </exception>
       </Docs>
     </Member>
@@ -3384,7 +3380,7 @@ Note: In <see href="https://go.microsoft.com/fwlink/?LinkID=247912">.NET for Win
 
  The current assembly was loaded into the reflection-only context, and <paramref name="name" /> requires a dependent assembly that was not preloaded.</exception>
         <exception cref="T:System.BadImageFormatException">
-          <paramref name="typeName" /> requires a dependent assembly, but the file is not a valid assembly for the currently loaded runtime.
+          <paramref name="name" /> requires a dependent assembly, but the file is not a valid assembly for the currently loaded runtime.
         </exception>
       </Docs>
     </Member>
@@ -3489,7 +3485,7 @@ Note: In <see href="https://go.microsoft.com/fwlink/?LinkID=247912">.NET for Win
 
  The current assembly was loaded into the reflection-only context, and <paramref name="name" /> requires a dependent assembly that was not preloaded.</exception>
         <exception cref="T:System.BadImageFormatException">
-          <paramref name="typeName" /> requires a dependent assembly, but the file is not a valid assembly for the currently loaded runtime.
+          <paramref name="name" /> requires a dependent assembly, but the file is not a valid assembly for the currently loaded runtime.
         </exception>
       </Docs>
     </Member>
@@ -5595,7 +5591,7 @@ The assembly is loaded into the default AssemblyLoadContext. For more informatio
         </remarks>
         <exception cref="T:System.ArgumentNullException">The <paramref name="partialName" /> parameter is <see langword="null" />.</exception>
         <exception cref="T:System.BadImageFormatException">
-          <paramref name="assemblyFile" /> is not a valid assembly for the currently loaded runtime.
+          The assembly is not a valid assembly for the currently loaded runtime.
         </exception>
         <altmember cref="M:System.Reflection.Assembly.Load(System.String)" />
         <altmember cref="M:System.Reflection.Assembly.LoadFrom(System.String)" />
@@ -5665,7 +5661,7 @@ The assembly is loaded into the default AssemblyLoadContext. For more informatio
         <exception cref="T:System.IO.FileLoadException">An assembly or module was loaded twice with two different sets of evidence.</exception>
         <exception cref="T:System.ArgumentNullException">The <paramref name="partialName" /> parameter is <see langword="null" />.</exception>
         <exception cref="T:System.BadImageFormatException">
-          <paramref name="assemblyFile" /> is not a valid assembly for the currently loaded runtime.
+          The assembly is not a valid assembly for the currently loaded runtime.
         </exception>
         <altmember cref="M:System.Reflection.Assembly.Load(System.String)" />
         <altmember cref="M:System.Reflection.Assembly.LoadFrom(System.String)" />

@@ -1057,7 +1057,7 @@ Note: In <see href="https://go.microsoft.com/fwlink/?LinkID=247912">.NET for Win
       </Parameters>
       <Docs>
         <param name="obj">The instance that created this method.</param>
-        <param name="parameters">An array of objects used to match the number, order, and type of the parameters for this constructor, under the constraints of <paramref name="binder" />. If this constructor does not require parameters, pass an array with zero elements. Any object in this array that is not explicitly initialized with a value will contain the default value for that object type. For reference-type elements, this value is <see langword="null" />. For value-type elements, this value is 0, 0.0, or <see langword="false" />, depending on the specific element type.</param>
+        <param name="parameters">An array of objects used to match the number, order, and type of the parameters for this constructor. If this constructor does not require parameters, pass an array with zero elements. Any object in this array that is not explicitly initialized with a value will contain the default value for that object type. For reference-type elements, this value is <see langword="null" />. For value-type elements, this value is 0, 0.0, or <see langword="false" />, depending on the specific element type.</param>
         <summary>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Object[])" /> method.</summary>
         <returns>An instance of the type.</returns>
         <remarks>
@@ -1155,7 +1155,7 @@ Note: In <see href="https://go.microsoft.com/fwlink/?LinkID=247912">.NET for Win
         <Parameter Name="parameters" 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;netframework-4.8.1" />
       </Parameters>
       <Docs>
-        <param name="parameters">An array of objects used to match the number, order, and type of the parameters for this constructor, under the constraints of <paramref name="binder" />. If this constructor does not require parameters, pass an array with zero elements. Any object in this array that is not explicitly initialized with a value will contain the default value for that object type. For reference-type elements, this value is <see langword="null" />. For value-type elements, this value is 0, 0.0, or <see langword="false" />, depending on the specific element type.</param>
+        <param name="parameters">An array of objects used to match the number, order, and type of the parameters for this constructor. If this constructor does not require parameters, pass an array with zero elements. Any object in this array that is not explicitly initialized with a value will contain the default value for that object type. For reference-type elements, this value is <see langword="null" />. For value-type elements, this value is 0, 0.0, or <see langword="false" />, depending on the specific element type.</param>
         <summary>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.ConstructorInfo.Invoke(System.Object[])" /> method.</summary>
         <returns>An instance of the type.</returns>
         <remarks>