diff --git a/xml/System.Reflection.Metadata/MetadataUpdateHandlerAttribute.xml b/xml/System.Reflection.Metadata/MetadataUpdateHandlerAttribute.xml index bc0a934528a..9e27664faac 100644 --- a/xml/System.Reflection.Metadata/MetadataUpdateHandlerAttribute.xml +++ b/xml/System.Reflection.Metadata/MetadataUpdateHandlerAttribute.xml @@ -20,8 +20,20 @@ - To be added. - To be added. + Indicates that a type that should receive notifications of metadata updates. + + specified by this attribute should implement static methods matching the signature of one or more of the following (visibility of the methods does not matter): + - `static void ClearCache(Type[]? updatedTypes)` + - `static void UpdateApplication(Type[]? updatedTypes)` + +After a metadata update is applied, `ClearCache` is invoked for every handler that specifies one. This gives update handlers an opportunity to clear any caches that are inferred based on the application's metadata. After all `ClearCache` methods have been invoked, `UpdateApplication` is invoked for every handler that specifies one. This enables applications to refresh the application state, trigger a UI re-render, or other such reactions. When specified, the `updatedTypes` parameter contains the set of types that were affected by the metadata update; if it's `null`, any type may have been updated. + + ]]> + @@ -47,8 +59,8 @@ - To be added. - To be added. + A type that handles metadata updates and that should be notified when any occur. + Initializes the attribute. To be added. @@ -74,7 +86,7 @@ System.Type - To be added. + Gets the type that handles metadata updates and that should be notified when any occur. To be added. To be added. diff --git a/xml/System.Reflection.Metadata/MetadataUpdater.xml b/xml/System.Reflection.Metadata/MetadataUpdater.xml index 0a83755e1b8..73547ecd942 100644 --- a/xml/System.Reflection.Metadata/MetadataUpdater.xml +++ b/xml/System.Reflection.Metadata/MetadataUpdater.xml @@ -40,12 +40,24 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The assembly to update. + The metadata changes to be applied. + The IL changes to be applied. + The PDB changes to be applied. + Updates the specified assembly using the provided metadata, IL, and PDB deltas. + + + + The assembly argument is not a runtime assembly. + The assembly argument is . + The assembly is not editable. + The update could not be applied. @@ -64,8 +76,8 @@ System.Boolean - To be added. - To be added. + Gets a value that indicates whether the assembly update is enabled and available. + if the assembly update is enabled and available; otherwise, . To be added. diff --git a/xml/System.Reflection/NullabilityInfo.xml b/xml/System.Reflection/NullabilityInfo.xml index 280366e2ebb..8558d480923 100644 --- a/xml/System.Reflection/NullabilityInfo.xml +++ b/xml/System.Reflection/NullabilityInfo.xml @@ -14,7 +14,7 @@ - To be added. + Represents nullability information. To be added. @@ -34,8 +34,8 @@ System.Reflection.NullabilityInfo - To be added. - To be added. + Gets the nullability information for the element type of the array. + If the member type is an array, the of the elements of the array; otherwise, . To be added. @@ -55,8 +55,8 @@ System.Reflection.NullabilityInfo[] - To be added. - To be added. + Gets the nullability information for each type parameter. + If the member type is a generic type, the nullability information for each type parameter. To be added. @@ -76,7 +76,7 @@ System.Reflection.NullabilityState - To be added. + Gets the nullability read state of the member. To be added. To be added. @@ -97,7 +97,7 @@ System.Type - To be added. + Gets the type of the member or generic parameter to which this instance belongs. To be added. To be added. @@ -118,7 +118,7 @@ System.Reflection.NullabilityState - To be added. + Gets the nullability write state of the member. To be added. To be added. diff --git a/xml/System.Reflection/NullabilityInfoContext.xml b/xml/System.Reflection/NullabilityInfoContext.xml index bdbefb1fb1d..b885f993b95 100644 --- a/xml/System.Reflection/NullabilityInfoContext.xml +++ b/xml/System.Reflection/NullabilityInfoContext.xml @@ -14,7 +14,7 @@ - To be added. + Provides APIs for populating nullability information and context from reflection members: , , , and . To be added. @@ -31,7 +31,7 @@ - To be added. + Initializes a new instance of the class. To be added. @@ -54,10 +54,12 @@ - To be added. - To be added. - To be added. + The event for which to populate nullability information. + Populates a for the given . If the nullablePublicOnly feature is set for an assembly, like it does in the .NET SDK, the private and/or internal member's nullability attributes are omitted, and the API will return the state. + A instance. To be added. + + is . @@ -79,10 +81,12 @@ - To be added. - To be added. - To be added. + The field for which to populate the nullability information. + Populates a for the given . If the nullablePublicOnly feature is set for an assembly, like it does in the .NET SDK, the private and/or internal member's nullability attributes are omitted, and the API will return the state. + A instance. To be added. + + is . @@ -104,10 +108,12 @@ - To be added. - To be added. - To be added. + The parameter for which to populate the nullability information. + Populates a for the given . If the nullablePublicOnly feature is set for an assembly, like it does in the .NET SDK, the private and/or internal member's nullability attributes are omitted, and the API will return the state. + A instance. To be added. + + is . @@ -129,10 +135,12 @@ - To be added. - To be added. - To be added. + The property for which to populate the nullability information. + Populates a for the given . If the nullablePublicOnly feature is set for an assembly, like it does in the .NET SDK, the private and/or internal member's nullability attributes are omitted, and the API will return the state. + A instance. To be added. + + is . diff --git a/xml/System.Reflection/NullabilityState.xml b/xml/System.Reflection/NullabilityState.xml index 7da1d89c239..83a1e9bcde1 100644 --- a/xml/System.Reflection/NullabilityState.xml +++ b/xml/System.Reflection/NullabilityState.xml @@ -13,7 +13,7 @@ System.Enum - To be added. + Describes nullability states. To be added. @@ -34,7 +34,7 @@ 1 - To be added. + Non-nullable value or reference type. @@ -54,7 +54,7 @@ 2 - To be added. + Nullable value or reference type. @@ -74,7 +74,7 @@ 0 - To be added. + Nullability context not enabled (oblivious).