Skip to content

Commit 7d531b1

Browse files
carlossanlopcarlossanlop
authored
Port System.Reflection new docs (second pass) (#10211)
* System.Reflection * System.Reflection.Emit * System.Reflection.Metadata * System.Reflecftion.PortableExecutable
1 parent 60b5435 commit 7d531b1

File tree

16 files changed

+454
-229
lines changed

16 files changed

+454
-229
lines changed

‎xml/System.Reflection.Emit/EnumBuilder.xml

Lines changed: 76 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -882,8 +882,8 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr
882882
</ReturnValue>
883883
<Parameters />
884884
<Docs>
885-
<summary>To be added.</summary>
886-
<returns>To be added.</returns>
885+
<summary>When overridden in a derived class, implements the <see cref="T:System.Type.Attributes" /> property and gets a bitwise combination of enumeration values that indicate the attributes associated with the <see cref="T:System.Type" />.</summary>
886+
<returns>A <see cref="T:System.Reflection.TypeAttributes" /> object representing the attribute set of the <see cref="T:System.Type" />.</returns>
887887
<remarks>To be added.</remarks>
888888
<inheritdoc />
889889
</Docs>
@@ -948,13 +948,26 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr
948948
<Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" Index="4" FrameworkAlternate="net-5.0;net-6.0;net-7.0;net-8.0;net-9.0;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;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;netstandard-2.0;netstandard-2.1" />
949949
</Parameters>
950950
<Docs>
951-
<param name="bindingAttr">To be added.</param>
952-
<param name="binder">To be added.</param>
953-
<param name="callConvention">To be added.</param>
954-
<param name="types">To be added.</param>
955-
<param name="modifiers">To be added.</param>
956-
<summary>To be added.</summary>
957-
<returns>To be added.</returns>
951+
<param name="bindingAttr">
952+
<para>A bitwise combination of the enumeration values that specify how the search is conducted.</para>
953+
<para>-or-</para>
954+
<para>
955+
<see cref="T:System.Reflection.BindingFlags.Default" /> to return <see langword="null" />.</para>
956+
</param>
957+
<param name="binder">
958+
<para>An object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection.</para>
959+
<para>-or-</para>
960+
<para>A <see langword="null" /> reference (<see langword="Nothing" /> in Visual Basic), to use the <see cref="T:System.Type.DefaultBinder" />.</para>
961+
</param>
962+
<param name="callConvention">The object that specifies the set of rules to use regarding the order and layout of arguments, how the return value is passed, what registers are used for arguments, and the stack is cleaned up.</param>
963+
<param name="types">
964+
<para>An array of <see cref="T:System.Type" /> objects representing the number, order, and type of the parameters for the constructor to get.</para>
965+
<para>-or-</para>
966+
<para>An empty array of the type <see cref="T:System.Type" /> (that is, Type[] types = new Type[0]) to get a constructor that takes no parameters.</para>
967+
</param>
968+
<param name="modifiers">An array of <see cref="T:System.Reflection.ParameterModifier" /> objects representing the attributes associated with the corresponding element in the <paramref name="types" /> array. The default binder does not process this parameter.</param>
969+
<summary>When overridden in a derived class, searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention.</summary>
970+
<returns>A <see cref="T:System.Reflection.ConstructorInfo" /> object representing the constructor that matches the specified requirements, if found; otherwise, <see langword="null" />.</returns>
958971
<remarks>To be added.</remarks>
959972
<inheritdoc />
960973
</Docs>
@@ -1974,14 +1987,30 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr
19741987
<Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" Index="5" FrameworkAlternate="net-5.0;net-6.0;net-7.0;net-8.0;net-9.0;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;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;netstandard-2.0;netstandard-2.1" />
19751988
</Parameters>
19761989
<Docs>
1977-
<param name="name">To be added.</param>
1978-
<param name="bindingAttr">To be added.</param>
1979-
<param name="binder">To be added.</param>
1980-
<param name="callConvention">To be added.</param>
1981-
<param name="types">To be added.</param>
1982-
<param name="modifiers">To be added.</param>
1983-
<summary>To be added.</summary>
1984-
<returns>To be added.</returns>
1990+
<param name="name">The string containing the name of the method to get.</param>
1991+
<param name="bindingAttr">
1992+
<para>A bitwise combination of the enumeration values that specify how the search is conducted.</para>
1993+
<para>-or-</para>
1994+
<para>
1995+
<see cref="T:System.Reflection.BindingFlags.Default" /> to return <see langword="null" />.</para>
1996+
</param>
1997+
<param name="binder">
1998+
<para>An object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection.</para>
1999+
<para>-or-</para>
2000+
<para>A <see langword="null" /> reference (<see langword="Nothing" /> in Visual Basic), to use the <see cref="T:System.Type.DefaultBinder" />.</para>
2001+
</param>
2002+
<param name="callConvention">The object that specifies the set of rules to use regarding the order and layout of arguments, how the return value is passed, what registers are used for arguments, and what process cleans up the stack.</param>
2003+
<param name="types">
2004+
<para>An array of <see cref="T:System.Type" /> objects representing the number, order, and type of the parameters for the method to get.</para>
2005+
<para>-or-</para>
2006+
<para>An empty array of the type <see cref="T:System.Type" /> (that is, Type[] types = new Type[0]) to get a method that takes no parameters.</para>
2007+
<para>-or-</para>
2008+
<para>
2009+
<see langword="null" />. If <paramref name="types" /> is <see langword="null" />, arguments are not matched.</para>
2010+
</param>
2011+
<param name="modifiers">An array of <see cref="T:System.Reflection.ParameterModifier" /> objects representing the attributes associated with the corresponding element in the <paramref name="types" /> array. The default binder does not process this parameter.</param>
2012+
<summary>When overridden in a derived class, searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention.</summary>
2013+
<returns>An object representing the method that matches the specified requirements, if found; otherwise, <see langword="null" />.</returns>
19852014
<remarks>To be added.</remarks>
19862015
<inheritdoc />
19872016
</Docs>
@@ -2395,8 +2424,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr
23952424
</ReturnValue>
23962425
<Parameters />
23972426
<Docs>
2398-
<summary>To be added.</summary>
2399-
<returns>To be added.</returns>
2427+
<summary>When overridden in a derived class, implements the <see cref="T:System.Type.HasElementType" /> property and determines whether the current <see cref="T:System.Type" /> encompasses or refers to another type; that is, whether the current <see cref="T:System.Type" /> is an array, a pointer, or is passed by reference.</summary>
2428+
<returns>
2429+
<see langword="true" /> if the <see cref="T:System.Type" /> is an array, a pointer, or is passed by reference; otherwise, <see langword="false" />.</returns>
24002430
<remarks>To be added.</remarks>
24012431
<inheritdoc />
24022432
</Docs>
@@ -2528,8 +2558,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr
25282558
</ReturnValue>
25292559
<Parameters />
25302560
<Docs>
2531-
<summary>To be added.</summary>
2532-
<returns>To be added.</returns>
2561+
<summary>When overridden in a derived class, implements the <see cref="T:System.Type.IsArray" /> property and determines whether the <see cref="T:System.Type" /> is an array.</summary>
2562+
<returns>
2563+
<see langword="true" /> if the <see cref="T:System.Type" /> is an array; otherwise, <see langword="false" />.</returns>
25332564
<remarks>To be added.</remarks>
25342565
<inheritdoc />
25352566
</Docs>
@@ -2622,8 +2653,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr
26222653
</ReturnValue>
26232654
<Parameters />
26242655
<Docs>
2625-
<summary>To be added.</summary>
2626-
<returns>To be added.</returns>
2656+
<summary>When overridden in a derived class, implements the <see cref="T:System.Type.IsByRef" /> property and determines whether the <see cref="T:System.Type" /> is passed by reference.</summary>
2657+
<returns>
2658+
<see langword="true" /> if the <see cref="T:System.Type" /> is passed by reference; otherwise, <see langword="false" />.</returns>
26272659
<remarks>To be added.</remarks>
26282660
<inheritdoc />
26292661
</Docs>
@@ -2654,8 +2686,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr
26542686
<ReturnType>System.Boolean</ReturnType>
26552687
</ReturnValue>
26562688
<Docs>
2657-
<summary>To be added.</summary>
2658-
<value>To be added.</value>
2689+
<summary>Gets a value that indicates whether the type is a byref-like structure.</summary>
2690+
<value>
2691+
<see langword="true" /> if the <see cref="T:System.Type" /> is a byref-like structure; otherwise, <see langword="false" />.</value>
26592692
<remarks>To be added.</remarks>
26602693
<inheritdoc />
26612694
</Docs>
@@ -2696,8 +2729,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr
26962729
</ReturnValue>
26972730
<Parameters />
26982731
<Docs>
2699-
<summary>To be added.</summary>
2700-
<returns>To be added.</returns>
2732+
<summary>When overridden in a derived class, implements the <see cref="T:System.Type.IsCOMObject" /> property and determines whether the <see cref="T:System.Type" /> is a COM object.</summary>
2733+
<returns>
2734+
<see langword="true" /> if the <see cref="T:System.Type" /> is a COM object; otherwise, <see langword="false" />.</returns>
27012735
<remarks>To be added.</remarks>
27022736
<inheritdoc />
27032737
</Docs>
@@ -2940,8 +2974,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr
29402974
</ReturnValue>
29412975
<Parameters />
29422976
<Docs>
2943-
<summary>To be added.</summary>
2944-
<returns>To be added.</returns>
2977+
<summary>When overridden in a derived class, implements the <see cref="T:System.Type.IsPointer" /> property and determines whether the <see cref="T:System.Type" /> is a pointer.</summary>
2978+
<returns>
2979+
<see langword="true" /> if the <see cref="T:System.Type" /> is a pointer; otherwise, <see langword="false" />.</returns>
29452980
<remarks>To be added.</remarks>
29462981
<inheritdoc />
29472982
</Docs>
@@ -2982,8 +3017,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr
29823017
</ReturnValue>
29833018
<Parameters />
29843019
<Docs>
2985-
<summary>To be added.</summary>
2986-
<returns>To be added.</returns>
3020+
<summary>When overridden in a derived class, implements the <see cref="T:System.Type.IsPrimitive" /> property and determines whether the <see cref="T:System.Type" /> is one of the primitive types.</summary>
3021+
<returns>
3022+
<see langword="true" /> if the <see cref="T:System.Type" /> is one of the primitive types; otherwise, <see langword="false" />.</returns>
29873023
<remarks>To be added.</remarks>
29883024
<inheritdoc />
29893025
</Docs>
@@ -3042,8 +3078,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr
30423078
<ReturnType>System.Boolean</ReturnType>
30433079
</ReturnValue>
30443080
<Docs>
3045-
<summary>To be added.</summary>
3046-
<value>To be added.</value>
3081+
<summary>Gets a value that indicates whether the type is an array type that can represent only a single-dimensional array with a zero lower bound.</summary>
3082+
<value>
3083+
<see langword="true" /> if the current <see cref="T:System.Type" /> is an array type that can represent only a single-dimensional array with a zero lower bound; otherwise, <see langword="false" />.</value>
30473084
<remarks>To be added.</remarks>
30483085
<inheritdoc />
30493086
</Docs>
@@ -3075,8 +3112,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr
30753112
<ReturnType>System.Boolean</ReturnType>
30763113
</ReturnValue>
30773114
<Docs>
3078-
<summary>To be added.</summary>
3079-
<value>To be added.</value>
3115+
<summary>Gets a value that indicates whether the type is a type definition.</summary>
3116+
<value>
3117+
<see langword="true" /> if the current <see cref="T:System.Type" /> is a type definition; otherwise, <see langword="false" />.</value>
30803118
<remarks>To be added.</remarks>
30813119
<inheritdoc />
30823120
</Docs>
@@ -3117,8 +3155,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr
31173155
</ReturnValue>
31183156
<Parameters />
31193157
<Docs>
3120-
<summary>To be added.</summary>
3121-
<returns>To be added.</returns>
3158+
<summary>Implements the <see cref="T:System.Type.IsValueType" /> property and determines whether the <see cref="T:System.Type" /> is a value type; that is, not a class or an interface.</summary>
3159+
<returns>
3160+
<see langword="true" /> if the <see cref="T:System.Type" /> is a value type; otherwise, <see langword="false" />.</returns>
31223161
<remarks>To be added.</remarks>
31233162
<inheritdoc />
31243163
</Docs>

0 commit comments

Comments
 (0)