Skip to content

Commit 22c7e8c

Browse files
committed
System.Reflection docs
1 parent 7092e78 commit 22c7e8c

File tree

9 files changed

+39
-26
lines changed

9 files changed

+39
-26
lines changed

xml/System.Reflection.Metadata/AssemblyDefinition.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -132,7 +132,7 @@
132132
</ReturnValue>
133133
<Parameters />
134134
<Docs>
135-
<summary>To be added.</summary>
135+
<summary>Creates an <see cref="T:System.Reflection.AssemblyName" /> instance corresponding to this assembly definition.</summary>
136136
<returns>To be added.</returns>
137137
<remarks>To be added.</remarks>
138138
</Docs>
@@ -154,7 +154,7 @@
154154
</ReturnValue>
155155
<Parameters />
156156
<Docs>
157-
<summary>To be added.</summary>
157+
<summary>Creates an <see cref="T:System.Reflection.Metadata.AssemblyNameInfo" /> instance corresponding to this assembly definition.</summary>
158158
<returns>To be added.</returns>
159159
<remarks>To be added.</remarks>
160160
</Docs>

xml/System.Reflection.Metadata/AssemblyReference.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -132,7 +132,7 @@
132132
</ReturnValue>
133133
<Parameters />
134134
<Docs>
135-
<summary>To be added.</summary>
135+
<summary>Creates an <see cref="T:System.Reflection.AssemblyName" /> instance corresponding to this assembly reference.</summary>
136136
<returns>To be added.</returns>
137137
<remarks>To be added.</remarks>
138138
</Docs>
@@ -154,7 +154,7 @@
154154
</ReturnValue>
155155
<Parameters />
156156
<Docs>
157-
<summary>To be added.</summary>
157+
<summary>Creates an <see cref="T:System.Reflection.Metadata.AssemblyNameInfo" /> instance corresponding to this assembly reference.</summary>
158158
<returns>To be added.</returns>
159159
<remarks>To be added.</remarks>
160160
</Docs>

xml/System.Reflection.Metadata/EventDefinition.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -155,7 +155,7 @@
155155
</ReturnValue>
156156
<Parameters />
157157
<Docs>
158-
<summary>To be added.</summary>
158+
<summary>Returns a handle to the type that declares this event.</summary>
159159
<returns>To be added.</returns>
160160
<remarks>To be added.</remarks>
161161
</Docs>

xml/System.Reflection.Metadata/FieldDefinition.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -222,7 +222,7 @@
222222
</ReturnValue>
223223
<Parameters />
224224
<Docs>
225-
<summary>To be added.</summary>
225+
<summary>Returns a handle to the type that declares this field.</summary>
226226
<returns>To be added.</returns>
227227
<remarks>To be added.</remarks>
228228
</Docs>

xml/System.Reflection.Metadata/MethodDefinition.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -262,7 +262,7 @@
262262
</ReturnValue>
263263
<Parameters />
264264
<Docs>
265-
<summary>To be added.</summary>
265+
<summary>Returns a handle to the type that declares this method.</summary>
266266
<returns>To be added.</returns>
267267
<remarks>To be added.</remarks>
268268
</Docs>

xml/System.Reflection.Metadata/PropertyDefinition.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -250,7 +250,7 @@
250250
</ReturnValue>
251251
<Parameters />
252252
<Docs>
253-
<summary>To be added.</summary>
253+
<summary>Returns a handle to the type that declares this property.</summary>
254254
<returns>To be added.</returns>
255255
<remarks>To be added.</remarks>
256256
</Docs>

xml/System.Reflection.Metadata/TypeName.xml

Lines changed: 28 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -481,10 +481,15 @@
481481
<Parameter Name="rank" Type="System.Int32" />
482482
</Parameters>
483483
<Docs>
484-
<param name="rank">To be added.</param>
485-
<summary>To be added.</summary>
486-
<returns>To be added.</returns>
484+
<param name="rank">The number of dimensions for the array. This number must be more than zero and less than or equal to 32.</param>
485+
<summary>
486+
<para>Creates a <see cref="T:System.Reflection.Metadata.TypeName" /> object representing an array of the current type, with the specified number of dimensions.</para>
487+
</summary>
488+
<returns>
489+
<para>A <see cref="T:System.Reflection.Metadata.TypeName" /> object representing an array of the current type, with the specified number of dimensions.</para>
490+
</returns>
487491
<remarks>To be added.</remarks>
492+
<exception cref="T:System.ArgumentOutOfRangeException">rank is invalid. For example, 0 or negative.</exception>
488493
</Docs>
489494
</Member>
490495
<Member MemberName="MakeByRefTypeName">
@@ -505,8 +510,8 @@
505510
</ReturnValue>
506511
<Parameters />
507512
<Docs>
508-
<summary>To be added.</summary>
509-
<returns>To be added.</returns>
513+
<summary>Creates a <see cref="T:System.Reflection.Metadata.TypeName" /> object that represents a managed reference to the current type.</summary>
514+
<returns>A <see cref="T:System.Reflection.Metadata.TypeName" /> object that represents a managed reference to the current type.</returns>
510515
<remarks>To be added.</remarks>
511516
</Docs>
512517
</Member>
@@ -537,10 +542,13 @@
537542
</Parameter>
538543
</Parameters>
539544
<Docs>
540-
<param name="typeArguments">To be added.</param>
541-
<summary>To be added.</summary>
542-
<returns>To be added.</returns>
545+
<param name="typeArguments">An array of type names to be used as generic arguments of the current simple type name.</param>
546+
<summary>Creates a new constructed generic type name.</summary>
547+
<returns>
548+
<para>A <see cref="T:System.Reflection.Metadata.TypeName" /> representing the constructed type name formed by using the elements of <paramref name="typeArguments" /> for the generic arguments of the current simple type name.</para>
549+
</returns>
543550
<remarks>To be added.</remarks>
551+
<exception cref="T:System.InvalidOperationException">The current type name is not simple.</exception>
544552
</Docs>
545553
</Member>
546554
<Member MemberName="MakePointerTypeName">
@@ -561,8 +569,8 @@
561569
</ReturnValue>
562570
<Parameters />
563571
<Docs>
564-
<summary>To be added.</summary>
565-
<returns>To be added.</returns>
572+
<summary>Creates a <see cref="T:System.Reflection.Metadata.TypeName" /> object that represents a pointer to the current type.</summary>
573+
<returns>A <see cref="T:System.Reflection.Metadata.TypeName" /> object that represents a pointer to the current type.</returns>
566574
<remarks>To be added.</remarks>
567575
</Docs>
568576
</Member>
@@ -584,8 +592,12 @@
584592
</ReturnValue>
585593
<Parameters />
586594
<Docs>
587-
<summary>To be added.</summary>
588-
<returns>To be added.</returns>
595+
<summary>
596+
<para>Creates a <see cref="T:System.Reflection.Metadata.TypeName" /> object representing a one-dimensional array of the current type, with a lower bound of zero.</para>
597+
</summary>
598+
<returns>
599+
<para>A <see cref="T:System.Reflection.Metadata.TypeName" /> object representing a one-dimensional array of the current type, with a lower bound of zero.</para>
600+
</returns>
589601
<remarks>To be added.</remarks>
590602
</Docs>
591603
</Member>
@@ -774,10 +786,11 @@
774786
</Parameter>
775787
</Parameters>
776788
<Docs>
777-
<param name="assemblyName">To be added.</param>
778-
<summary>To be added.</summary>
779-
<returns>To be added.</returns>
789+
<param name="assemblyName">Assembly name.</param>
790+
<summary>Creates a new <see cref="T:System.Reflection.Metadata.TypeName" /> object that represents current simple name with provided assembly name.</summary>
791+
<returns>Created simple name.</returns>
780792
<remarks>To be added.</remarks>
793+
<exception cref="T:System.InvalidOperationException">The current type name is not simple.</exception>
781794
</Docs>
782795
</Member>
783796
</Members>

xml/System.Reflection.Metadata/TypeNameParseOptions.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@
5656
<Docs>
5757
<summary>Limits the maximum <see cref="M:System.Reflection.Metadata.TypeName.GetNodeCount">number of nodes</see> that the parser can handle.</summary>
5858
<value>To be added.</value>
59-
<remarks>To be added.</remarks>
59+
<remarks><para>Setting this to a large value can render <see cref="T:System.Reflection.Metadata.TypeName" /> susceptible to Denial of Service attacks when parsing or handling malicious input.</para><para>The default value is 20.</para></remarks>
6060
</Docs>
6161
</Member>
6262
</Members>

xml/System.Reflection/DispatchProxy.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -131,8 +131,8 @@
131131
</Parameter>
132132
</Parameters>
133133
<Docs>
134-
<param name="interfaceType">To be added.</param>
135-
<param name="proxyType">To be added.</param>
134+
<param name="interfaceType">The interface the proxy should implement.</param>
135+
<param name="proxyType">The base class to use for the proxy class.</param>
136136
<summary>Creates an object instance that derives from class <paramref name="proxyType" /> and implements interface <paramref name="interfaceType" />.</summary>
137137
<returns>An object instance that implements <paramref name="interfaceType" />.</returns>
138138
<remarks>To be added.</remarks>

0 commit comments

Comments
 (0)