Skip to content

Commit 199c28d

Browse files
authored
Add remaining missing docs for System.ComponentModel (dotnet#10370)
* Add remaining missing docs for System.ComponentModel * Apply suggestions from code review
1 parent 45e424b commit 199c28d

File tree

4 files changed

+30
-30
lines changed

4 files changed

+30
-30
lines changed

xml/System.ComponentModel/ComponentResourceManager.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -349,9 +349,9 @@
349349
</Parameter>
350350
</Parameters>
351351
<Docs>
352-
<param name="value">To be added.</param>
353-
<param name="objectName">To be added.</param>
354-
<param name="culture">To be added.</param>
352+
<param name="value">An <see cref="T:System.Object" /> that contains the property value to be applied.</param>
353+
<param name="objectName">A <see cref="T:System.String" /> that contains the name of the object to look up in the resources.</param>
354+
<param name="culture">The culture for which to apply resources.</param>
355355
<summary>
356356
<para>Examines all the resources for the provided culture.</para>
357357
<para>When it finds a resource with a key in the format of</para>

xml/System.ComponentModel/CustomTypeDescriptor.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -490,7 +490,7 @@
490490
<para>Returns a type converter for the type this type</para>
491491
<para>descriptor is representing.</para>
492492
</summary>
493-
<returns>To be added.</returns>
493+
<returns>A <see cref="T:System.ComponentModel.TypeConverter" /> for the type represented by this type descriptor.</returns>
494494
<remarks>To be added.</remarks>
495495
</Docs>
496496
</Member>
@@ -881,7 +881,7 @@
881881
<para>Returns a collection of event descriptors</para>
882882
<para>for the object this type descriptor is representing.</para>
883883
</summary>
884-
<returns>To be added.</returns>
884+
<returns>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> containing the event descriptors for the object represented by this type descriptor.</returns>
885885
<remarks>To be added.</remarks>
886886
</Docs>
887887
</Member>
@@ -1078,7 +1078,7 @@
10781078
<para>Returns a collection of property descriptors</para>
10791079
<para>for the object this type descriptor is representing.</para>
10801080
</summary>
1081-
<returns>To be added.</returns>
1081+
<returns>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> containing the property descriptions for the object represented by this type descriptor.</returns>
10821082
<remarks>To be added.</remarks>
10831083
</Docs>
10841084
</Member>

xml/System.ComponentModel/TypeDescriptionProvider.xml

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -437,10 +437,10 @@
437437
<Parameter Name="instance" Type="System.Object" Index="0" FrameworkAlternate="net-9.0" />
438438
</Parameters>
439439
<Docs>
440-
<param name="instance">To be added.</param>
440+
<param name="instance">The object for which to get the extended type descriptor.</param>
441441
<summary>Returns an extended custom type descriptor for the given object.</summary>
442-
<returns>To be added.</returns>
443-
<remarks>An extended type descriptor is a custom type descriptor that offers properties that other objects have added to this object, but are not actually defined on the object. For example, in the .NET Framework Component Model, objects that implement the interface IExtenderProvider can "attach" properties to other objects that reside in the same logical container. The GetTypeDescriptor method does not return a type descriptor that provides these extra extended properties. GetExtendedTypeDescriptor returns the set of these extended properties. TypeDescriptor will automatically merge the results of these two property collections. Note that while the .NET Framework component model only supports extended properties this API can be used for extended attributes and events as well, if the type description provider supports it.</remarks>
442+
<returns>An <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> that can provide extended metadata for the object.</returns>
443+
<remarks>An extended type descriptor is a custom type descriptor that offers properties that other objects have added to this object, but are not actually defined on the object. For example, in the .NET Framework Component Model, objects that implement the interface IExtenderProvider can "attach" properties to other objects that reside in the same logical container. The GetTypeDescriptorFromRegisteredType method does not return a type descriptor that provides these extra extended properties. GetExtendedTypeDescriptorFromRegisteredType returns the set of these extended properties. TypeDescriptor will automatically merge the results of these two property collections. Note that while the .NET Framework component model only supports extended properties this API can be used for extended attributes and events as well, if the type description provider supports it.</remarks>
444444
</Docs>
445445
</Member>
446446
<Member MemberName="GetExtenderProviders">
@@ -1035,10 +1035,10 @@
10351035
<Parameter Name="instance" Type="System.Object" Index="0" FrameworkAlternate="net-9.0" />
10361036
</Parameters>
10371037
<Docs>
1038-
<param name="instance">To be added.</param>
1038+
<param name="instance">An instance of the type. Can be <see langword="null" /> if no instance was passed to the <see cref="T:System.ComponentModel.TypeDescriptor" />.</param>
10391039
<summary>Returns a custom type descriptor for the given type or object.</summary>
1040-
<returns>To be added.</returns>
1041-
<remarks>The objectType parameter is always valid, but the instance parameter may be <see langword="null" /> if no instance was passed to TypeDescriptor. The method should return a custom type descriptor for the object. If the method is not interested in providing type information for the object it should return base.</remarks>
1040+
<returns>An <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> that can provide metadata for the type.</returns>
1041+
<remarks>The method should return a custom type descriptor for the object. If the method is not interested in providing type information for the object it should return base.</remarks>
10421042
</Docs>
10431043
</Member>
10441044
<Member MemberName="GetTypeDescriptorFromRegisteredType">
@@ -1072,10 +1072,10 @@
10721072
<Parameter Name="objectType" Type="System.Type" Index="0" FrameworkAlternate="net-9.0" />
10731073
</Parameters>
10741074
<Docs>
1075-
<param name="objectType">To be added.</param>
1075+
<param name="objectType">The type of object for which to retrieve the type descriptor.</param>
10761076
<summary>Returns a custom type descriptor for the given type or object.</summary>
1077-
<returns>To be added.</returns>
1078-
<remarks>The objectType parameter is always valid, but the instance parameter may be <see langword="null" /> if no instance was passed to TypeDescriptor. The method should return a custom type descriptor for the object. If the method is not interested in providing type information for the object it should return base.</remarks>
1077+
<returns>An <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> that can provide metadata for the type.</returns>
1078+
<remarks>The method should return a custom type descriptor for the object. If the method is not interested in providing type information for the object it should return base.</remarks>
10791079
</Docs>
10801080
</Member>
10811081
<Member MemberName="GetTypeDescriptorFromRegisteredType">
@@ -1117,10 +1117,10 @@
11171117
<Parameter Name="instance" Type="System.Object" Index="1" FrameworkAlternate="net-9.0" />
11181118
</Parameters>
11191119
<Docs>
1120-
<param name="objectType">To be added.</param>
1121-
<param name="instance">To be added.</param>
1120+
<param name="objectType">The type of object for which to retrieve the type descriptor.</param>
1121+
<param name="instance">An instance of the type. Can be <see langword="null" /> if no instance was passed to the <see cref="T:System.ComponentModel.TypeDescriptor" />.</param>
11221122
<summary>Returns a custom type descriptor for the given type or object.</summary>
1123-
<returns>To be added.</returns>
1123+
<returns>An <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> that can provide metadata for the type.</returns>
11241124
<remarks>
11251125
<para>The objectType parameter is always valid, but the instance parameter may be <see langword="null" /> if no instance was passed to TypeDescriptor. The method should return a custom type descriptor for the object. If the method is not interested in providing type information for the object it should return base.</para>
11261126
<para>This method is prototyped as virtual, and by default returns a custom type descriptor that returns empty collections for all values if no parent provider was passed. If a parent provider was passed, this method will invoke the parent provider's GetTypeDescriptorFromRegisteredType method.</para>
@@ -1152,9 +1152,9 @@
11521152
<Parameter Name="type" Type="System.Type" Index="0" FrameworkAlternate="net-9.0" />
11531153
</Parameters>
11541154
<Docs>
1155-
<param name="type">To be added.</param>
1155+
<param name="type">The type to check if it was registered.</param>
11561156
<summary>Determines whether the type was registered with its provider through <see cref="M:System.ComponentModel.TypeDescriptor.RegisterType``1" />.</summary>
1157-
<returns>To be added.</returns>
1157+
<returns><see langword="true" /> if <paramref name="type" /> is registered; otherwise, <see langword="false" />.</returns>
11581158
<remarks>To be added.</remarks>
11591159
<exception cref="T:System.ArgumentNullException">
11601160
<paramref name="type" /> is <see langword="null" />.</exception>

xml/System.ComponentModel/TypeDescriptor.xml

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2221,9 +2221,9 @@
22212221
<Parameter Name="component" Type="System.Object" Index="0" FrameworkAlternate="net-9.0" />
22222222
</Parameters>
22232223
<Docs>
2224-
<param name="component">To be added.</param>
2224+
<param name="component">A component to get the converter for.</param>
22252225
<summary>Gets a type converter for the type of the specified component.</summary>
2226-
<returns>To be added.</returns>
2226+
<returns>A <see cref="T:System.ComponentModel.TypeConverter" /> for the specified component.</returns>
22272227
<remarks>To be added.</remarks>
22282228
</Docs>
22292229
</Member>
@@ -2252,9 +2252,9 @@
22522252
<Parameter Name="type" Type="System.Type" Index="0" FrameworkAlternate="net-9.0" />
22532253
</Parameters>
22542254
<Docs>
2255-
<param name="type">To be added.</param>
2255+
<param name="type">The <see cref="T:System.Type" /> of the target component.</param>
22562256
<summary>Gets a type converter for the specified registered type.</summary>
2257-
<returns>To be added.</returns>
2257+
<returns>A <see cref="T:System.ComponentModel.TypeConverter" /> for the specified type.</returns>
22582258
<remarks>To be added.</remarks>
22592259
</Docs>
22602260
</Member>
@@ -3510,9 +3510,9 @@
35103510
<Parameter Name="componentType" Type="System.Type" Index="0" FrameworkAlternate="net-9.0" />
35113511
</Parameters>
35123512
<Docs>
3513-
<param name="componentType">To be added.</param>
3513+
<param name="componentType">The <see cref="T:System.Type" /> of the target component.</param>
35143514
<summary>Gets a collection of events for a specified type of component.</summary>
3515-
<returns>To be added.</returns>
3515+
<returns>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> with the events for this component.</returns>
35163516
<remarks>To be added.</remarks>
35173517
</Docs>
35183518
</Member>
@@ -4163,9 +4163,9 @@
41634163
<Parameter Name="component" Type="System.Object" Index="0" FrameworkAlternate="net-9.0" />
41644164
</Parameters>
41654165
<Docs>
4166-
<param name="component">To be added.</param>
4166+
<param name="component">A component to get the properties for.</param>
41674167
<summary>Gets a collection of properties for a specified component.</summary>
4168-
<returns>To be added.</returns>
4168+
<returns>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties for the specified component.</returns>
41694169
<remarks>To be added.</remarks>
41704170
</Docs>
41714171
</Member>
@@ -4194,9 +4194,9 @@
41944194
<Parameter Name="componentType" Type="System.Type" Index="0" FrameworkAlternate="net-9.0" />
41954195
</Parameters>
41964196
<Docs>
4197-
<param name="componentType">To be added.</param>
4197+
<param name="componentType">A <see cref="T:System.Type" /> that represents the component to get properties for.</param>
41984198
<summary>Gets a collection of properties for a specified type.</summary>
4199-
<returns>To be added.</returns>
4199+
<returns>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties for a specified type of component.</returns>
42004200
<remarks>To be added.</remarks>
42014201
</Docs>
42024202
</Member>

0 commit comments

Comments
 (0)