diff --git a/xml/System.Collections.Concurrent/ConcurrentDictionary`2+AlternateLookup`1.xml b/xml/System.Collections.Concurrent/ConcurrentDictionary`2+AlternateLookup`1.xml index aad0e92e0d0..0379e2f1bb7 100644 --- a/xml/System.Collections.Concurrent/ConcurrentDictionary`2+AlternateLookup`1.xml +++ b/xml/System.Collections.Concurrent/ConcurrentDictionary`2+AlternateLookup`1.xml @@ -49,8 +49,7 @@ The type of the values in the dictionary. The alternate type of a key for performing lookups. - Provides a type that may be used to perform operations on a - using a as a key instead of a . + Provides a type that may be used to perform operations on a using a as a key instead of a . To be added. @@ -129,8 +128,7 @@ The alternate key of the value to get or set. Gets or sets the value associated with the specified alternate key. - The value associated with the specified alternate key. If the specified alternate key is not found, a get operation throws - a , and a set operation creates a new element with the specified key. + The value associated with the specified alternate key. If the specified alternate key is not found, a get operation throws a , and a set operation creates a new element with the specified key. To be added. @@ -198,10 +196,7 @@ The alternate key of the value to get. - - When this method returns, contains the value associated with the specified key, if the key is found; - otherwise, the default value for the type of the value parameter. - + When this method returns, contains the value associated with the specified key, if the key is found; otherwise, the default value for the type of the value parameter. Gets the value associated with the specified alternate key. if an entry was found; otherwise, . @@ -248,12 +243,11 @@ The alternate key of the value to get. - When this method returns, contains the actual key associated with the alternate key, if the key is found; - otherwise, the default value for the type of the key parameter. + When this method returns, contains the actual key associated with the alternate key, if the key is found; + otherwise, the default value for the type of the key parameter. - When this method returns, contains the value associated with the specified key, if the key is found; - otherwise, the default value for the type of the value parameter. + When this method returns, contains the value associated with the specified key, if the key is found; otherwise, the default value for the type of the value parameter. Gets the value associated with the specified alternate key. @@ -294,8 +288,9 @@ The alternate key of the element to remove. The removed element. - Removes the value with the specified alternate key from the , - and copies the element to the value parameter. + Removes the value with the specified alternate key from the + , + and copies the element to the value parameter. if the element is successfully found and removed; otherwise, . @@ -344,8 +339,8 @@ The removed key. The removed element. - Removes the value with the specified alternate key from the , - and copies the associated key and element to the value parameter. + Removes the value with the specified alternate key from the , + and copies the associated key and element to the value parameter. if the element is successfully found and removed; otherwise, . diff --git a/xml/System.Collections.Concurrent/ConcurrentDictionary`2.xml b/xml/System.Collections.Concurrent/ConcurrentDictionary`2.xml index 6231bfc8f00..a0c246cd7bf 100644 --- a/xml/System.Collections.Concurrent/ConcurrentDictionary`2.xml +++ b/xml/System.Collections.Concurrent/ConcurrentDictionary`2.xml @@ -1011,14 +1011,12 @@ The alternate type of a key for performing lookups. - Gets an instance of a type that may be used to perform operations on a - using a as a key instead of a . + Gets an instance of a type that may be used to perform operations on a using a as a key instead of a . The created lookup instance. - This instance must be using a comparer that implements with - - and . If it doesn't, an exception will be thrown. + This instance must be using a comparer that implements with + and . If it doesn't, an exception will be thrown. This instance's comparer is not compatible with . diff --git a/xml/System.Collections.Frozen/FrozenDictionary`2+AlternateLookup`1.xml b/xml/System.Collections.Frozen/FrozenDictionary`2+AlternateLookup`1.xml index b6440ff7c77..b759e02c974 100644 --- a/xml/System.Collections.Frozen/FrozenDictionary`2+AlternateLookup`1.xml +++ b/xml/System.Collections.Frozen/FrozenDictionary`2+AlternateLookup`1.xml @@ -45,8 +45,10 @@ The type of the values in the dictionary. The alternate type of a key for performing lookups. - Provides a type that may be used to perform operations on a - using a as a key instead of a . + Provides a type that may be used to perform operations on a + + using a as a key + instead of a . To be added. @@ -125,8 +127,7 @@ The alternate key of the value to get or set. Gets or sets the value associated with the specified alternate key. - The value associated with the specified alternate key. If the specified alternate key is not found, a get operation throws - a , and a set operation creates a new element with the specified key. + The value associated with the specified alternate key. If the specified alternate key is not found, a get operation throws a , and a set operation creates a new element with the specified key. To be added. @@ -164,8 +165,8 @@ The alternate key of the value to get. - When this method returns, contains the value associated with the specified key, if the key is found; - otherwise, the default value for the type of the value parameter. + When this method returns, contains the value associated with the specified key, if the key is found; + otherwise, the default value for the type of the value parameter. Gets the value associated with the specified alternate key. diff --git a/xml/System.Collections.Frozen/FrozenDictionary`2.xml b/xml/System.Collections.Frozen/FrozenDictionary`2.xml index b40da7014bc..a7ecdd74787 100644 --- a/xml/System.Collections.Frozen/FrozenDictionary`2.xml +++ b/xml/System.Collections.Frozen/FrozenDictionary`2.xml @@ -291,14 +291,14 @@ The alternate type of a key for performing lookups. - Gets an instance of a type that may be used to perform operations on a - using a as a key instead of a . + Gets an instance of a type that may be used to perform operations on a using a as a key instead of a . The created lookup instance. - This instance must be using a comparer that implements with - - and . If it doesn't, an exception will be thrown. + This instance must be using a comparer that implements + + with and . + If it doesn't, an exception will be thrown. This instance's comparer is not compatible with . diff --git a/xml/System.Collections.Frozen/FrozenSet`1+AlternateLookup`1.xml b/xml/System.Collections.Frozen/FrozenSet`1+AlternateLookup`1.xml index 1626b56d2a6..78c1da10a2d 100644 --- a/xml/System.Collections.Frozen/FrozenSet`1+AlternateLookup`1.xml +++ b/xml/System.Collections.Frozen/FrozenSet`1+AlternateLookup`1.xml @@ -48,10 +48,7 @@ The type of the values in this set. The alternate type of a key for performing lookups. - - Provides a type that may be used to perform operations on a - using a as a key instead of a . - + Provides a type that may be used to perform operations on a using a as a key instead of a . To be added. diff --git a/xml/System.Collections.Frozen/FrozenSet`1.xml b/xml/System.Collections.Frozen/FrozenSet`1.xml index 4c296f7fed8..21cf901982e 100644 --- a/xml/System.Collections.Frozen/FrozenSet`1.xml +++ b/xml/System.Collections.Frozen/FrozenSet`1.xml @@ -280,16 +280,9 @@ The alternate type of a item for performing lookups. - - Gets an instance of a type that may be used to perform operations on a - using a instead of a . - + Gets an instance of a type that may be used to perform operations on a using a instead of a . The created lookup instance. - - This instance must be using a comparer that implements with - - and . If it doesn't, an exception will be thrown. - + This instance must be using a comparer that implements with and . If it doesn't, an exception will be thrown. This instance's comparer is not compatible with . diff --git a/xml/System.Collections.Generic/OrderedDictionary`2.xml b/xml/System.Collections.Generic/OrderedDictionary`2.xml index e4fb81a6cb8..2957ab48c17 100644 --- a/xml/System.Collections.Generic/OrderedDictionary`2.xml +++ b/xml/System.Collections.Generic/OrderedDictionary`2.xml @@ -78,10 +78,7 @@ The type of the keys in the dictionary. The type of the values in the dictionary. Represents a collection of key/value pairs that are accessible by the key or index. - - Operations on the collection have algorithmic complexities that are similar to that of the - class, except with lookups by key similar in complexity to that of . - + Operations on the collection have algorithmic complexities that are similar to that of the class, except with lookups by key similar in complexity to that of . @@ -98,10 +95,7 @@ - - Initializes a new instance of the class that is empty, - has the default initial capacity, and uses the default equality comparer for the key type. - + Initializes a new instance of the class that is empty, has the default initial capacity, and uses the default equality comparer for the key type. To be added. @@ -122,14 +116,8 @@ - - The whose elements are copied to the new . - The initial order of the elements in the new collection is the order the elements are enumerated from the supplied dictionary. - - - Initializes a new instance of the class that contains elements copied from - the specified and uses the default equality comparer for the key type. - + The whose elements are copied to the new . The initial order of the elements in the new collection is the order the elements are enumerated from the supplied dictionary. + Initializes a new instance of the class that contains elements copied from the specified and uses the default equality comparer for the key type. To be added. is . @@ -159,14 +147,8 @@ - - The whose elements are copied to the new . - The initial order of the elements in the new collection is the order the elements are enumerated from the supplied collection. - - - Initializes a new instance of the class that contains elements copied - from the specified and uses the default equality comparer for the key type. - + The whose elements are copied to the new . The initial order of the elements in the new collection is the order the elements are enumerated from the supplied collection. + Initializes a new instance of the class that contains elements copied from the specified and uses the default equality comparer for the key type. To be added. is . @@ -196,14 +178,8 @@ - - The implementation to use when comparing keys, - or to use the default for the type of the key. - - - Initializes a new instance of the class that is empty, - has the default initial capacity, and uses the specified . - + The implementation to use when comparing keys, or to use the default for the type of the key. + Initializes a new instance of the class that is empty, has the default initial capacity, and uses the specified . To be added. @@ -225,10 +201,7 @@ The initial number of elements that the can contain. - - Initializes a new instance of the class that is empty, - has the specified initial capacity, and uses the default equality comparer for the key type. - + Initializes a new instance of the class that is empty, has the specified initial capacity, and uses the default equality comparer for the key type. To be added. capacity is less than 0. @@ -258,18 +231,9 @@ - - The whose elements are copied to the new . - The initial order of the elements in the new collection is the order the elements are enumerated from the supplied dictionary. - - - The implementation to use when comparing keys, - or to use the default for the type of the key. - - - Initializes a new instance of the class that contains elements copied from - the specified and uses the specified . - + The whose elements are copied to the new . The initial order of the elements in the new collection is the order the elements are enumerated from the supplied dictionary. + The implementation to use when comparing keys, or to use the default for the type of the key. + Initializes a new instance of the class that contains elements copied from the specified and uses the specified . To be added. is . @@ -307,18 +271,9 @@ - - The whose elements are copied to the new . - The initial order of the elements in the new collection is the order the elements are enumerated from the supplied collection. - - - The implementation to use when comparing keys, - or to use the default for the type of the key. - - - Initializes a new instance of the class that contains elements copied - from the specified and uses the specified . - + The whose elements are copied to the new . The initial order of the elements in the new collection is the order the elements are enumerated from the supplied collection. + The implementation to use when comparing keys, or to use the default for the type of the key. + Initializes a new instance of the class that contains elements copied from the specified and uses the specified . To be added. is . @@ -350,14 +305,8 @@ The initial number of elements that the can contain. - - The implementation to use when comparing keys, - or to use the default for the type of the key. - - - Initializes a new instance of the class that is empty, - has the specified initial capacity, and uses the specified . - + The implementation to use when comparing keys, or to use the default for the type of the key. + Initializes a new instance of the class that is empty, has the specified initial capacity, and uses the specified . To be added. capacity is less than 0. diff --git a/xml/System.Reflection.Metadata/TypeName.xml b/xml/System.Reflection.Metadata/TypeName.xml index f6a103bcd6d..56d4f04c4c3 100644 --- a/xml/System.Reflection.Metadata/TypeName.xml +++ b/xml/System.Reflection.Metadata/TypeName.xml @@ -52,10 +52,7 @@ System.Reflection.Metadata.AssemblyNameInfo - - Returns assembly name that contains this type, or if this was not - created from a fully qualified name. - + Returns assembly name that contains this type, or if this was not created from a fully qualified name. To be added. To be added. @@ -99,10 +96,7 @@ System.Reflection.Metadata.TypeName - - If this type is a nested type (see ), gets - the declaring type. If this type is not a nested type, throws. - + If this type is a nested type (see ), gets the declaring type. If this type is not a nested type, throws. To be added. For example, given "Namespace.Declaring+Nested", this property unwraps the outermost type and returns "Namespace.Declaring". The current type is not a nested type. @@ -125,21 +119,9 @@ System.String - - Gets the full name of this type, including namespace, but without the assembly name; for example, "System.Int32". - Nested types are represented with a '+'; for example, "MyNamespace.MyType+NestedType". - + Gets the full name of this type, including namespace, but without the assembly name; for example, "System.Int32". Nested types are represented with a '+'; for example, "MyNamespace.MyType+NestedType". To be added. - - For constructed generic types, the type arguments will be listed using their fully qualified - names. For example, given "List<int>", the property will return - "System.Collections.Generic.List`1[[System.Int32, mscorlib, ...]]". - For open generic types, the convention is to use a backtick ("`") followed by - the arity of the generic type. For example, given "Dictionary<,>", the - property will return "System.Collections.Generic.Dictionary`2". Given "Dictionary<,>.Enumerator", - the property will return "System.Collections.Generic.Dictionary`2+Enumerator". - See ECMA-335, Sec. I.10.7.2 (Type names and arity encoding) for more information. - + For constructed generic types, the type arguments will be listed using their fully qualified names. For example, given "List<int>", the property will return "System.Collections.Generic.List`1[[System.Int32, mscorlib, ...]]". For open generic types, the convention is to use a backtick ("`") followed by the arity of the generic type. For example, given "Dictionary<,>", the property will return "System.Collections.Generic.Dictionary`2". Given "Dictionary<,>.Enumerator", the property will return "System.Collections.Generic.Dictionary`2+Enumerator". See ECMA-335, Sec. I.10.7.2 (Type names and arity encoding) for more information. @@ -214,15 +196,9 @@ - - If this represents a constructed generic type, returns an array - of all the generic arguments. Otherwise it returns an empty array. - + If this represents a constructed generic type, returns an array of all the generic arguments. Otherwise it returns an empty array. To be added. - - For example, given "Dictionary<string, int>", returns a 2-element array containing - string and int. - + For example, given "Dictionary<string, int>", returns a 2-element array containing string and int. @@ -267,34 +243,26 @@ - - Gets the total number of instances that are used to describe - this instance, including any generic arguments or underlying types. - + Gets the total number of instances that are used to describe this instance, including any generic arguments or underlying types. To be added. - This value is computed every time this method gets called, it's not cached. - There's not really a parallel concept to this in reflection. Think of it - as the total number of instances that would be created if - you were to totally deconstruct this instance and visit each intermediate - that occurs as part of deconstruction. - "int" and "Person" each have complexities of 1 because they're standalone types. - "int[]" has a node count of 2 because to fully inspect it involves inspecting the - array type itself, plus unwrapping the underlying type ("int") and inspecting that. - "Dictionary<string, List<int[][]>>" has node count 8 because fully visiting it - involves inspecting 8 instances total: - - - Dictionary<string, List<int[][]>> (the original type) - Dictionary`2 (the generic type definition) - string (a type argument of Dictionary) - List<int[][]> (a type argument of Dictionary) - List`1 (the generic type definition) - int[][] (a type argument of List) - int[] (the underlying type of int[][]) - int (the underlying type of int[]) - - + This value is computed every time this method gets called, it's not cached. There's not really a parallel concept to this in reflection. + Think of it as the total number of instances that would be created if you were to + totally deconstruct this instance and visit each intermediate that occurs as part + of deconstruction. "int" and "Person" each have complexities of 1 because they're standalone types. "int[]" has a node count of 2 + because to fully inspect it involves inspecting the array type itself, plus unwrapping the underlying type ("int") and + inspecting that. "Dictionary<string, List<int[][]>>" has node count 8 because fully visiting it involves inspecting 8 + instances total: + + Dictionary<string, List<int[][]>> (the original type) + Dictionary`2 (the generic type definition) + string (a type argument of Dictionary) + List<int[][]> (a type argument of Dictionary) + List`1 (the generic type definition) + int[][] (a type argument of List) + int[] (the underlying type of int[][]) + int (the underlying type of int[]) + @@ -315,10 +283,7 @@ System.Boolean - - Gets a value that indicates whether this type represents any kind of array, regardless of the array's - rank or its bounds. - + Gets a value that indicates whether this type represents any kind of array, regardless of the array's rank or its bounds. To be added. To be added. @@ -340,10 +305,7 @@ System.Boolean - - Gets a value that indicates whether this is a managed pointer type (for example, "ref int"). - Managed pointer types are sometimes called byref types (). - + Gets a value that indicates whether this is a managed pointer type (for example, "ref int"). Managed pointer types are sometimes called byref types (). To be added. To be added. @@ -397,10 +359,7 @@ System.Boolean - - Gets a value that indicates whether this is a nested type (for example, "Namespace.Declaring+Nested"). - For nested types returns their declaring type. - + Gets a value that indicates whether this is a nested type (for example, "Namespace.Declaring+Nested"). For nested types returns their declaring type. To be added. To be added. @@ -422,10 +381,7 @@ System.Boolean - - Gets a value that indicates whether this type represents an unmanaged pointer (for example, "int*" or "void*"). - Unmanaged pointer types are often just called pointers (). - + Gets a value that indicates whether this type represents an unmanaged pointer (for example, "int*" or "void*"). Unmanaged pointer types are often just called pointers (). To be added. To be added. @@ -457,18 +413,14 @@ System.Boolean - - Gets a value that indicates whether this is a "plain" type; that is, not an array, not a pointer, not a reference, and - not a constructed generic type. Examples of elemental types are "System.Int32", - "System.Uri", and "YourNamespace.YourClass". - + Gets a value that indicates whether this is a "plain" type; that is, not an array, not a pointer, not a reference, and not a constructed generic type. Examples of elemental types are "System.Int32", "System.Uri", and "YourNamespace.YourClass". To be added. - This property returning doesn't mean that the type is a primitive like string - or int; it just means that there's no underlying type. - This property will return for generic type definitions (for example, "Dictionary<,>"). - This is because determining whether a type truly is a generic type requires loading the type - and performing a runtime check. + This property returning doesn't mean that the type is a primitive like string or int; it just means that there's no underlying type. + + This property will return for generic type definitions (for example, "Dictionary<,>"). This is because determining whether a type + truly is a generic type requires loading the type and performing a runtime check. + @@ -511,10 +463,7 @@ System.Boolean - - Gets a value that indicates whether this type represents a variable-bound array; that is, an array of rank greater - than 1 (for example, "int[,]") or a single-dimensional array that isn't necessarily zero-indexed. - + Gets a value that indicates whether this type represents a variable-bound array; that is, an array of rank greater than 1 (for example, "int[,]") or a single-dimensional array that isn't necessarily zero-indexed. To be added. To be added. @@ -664,10 +613,7 @@ System.String - - Gets the name of this type, without the namespace and the assembly name; for example, "Int32". - Nested types are represented without a '+'; for example, "MyNamespace.MyType+NestedType" is just "NestedType". - + Gets the name of this type, without the namespace and the assembly name; for example, "Int32". Nested types are represented without a '+'; for example, "MyNamespace.MyType+NestedType" is just "NestedType". To be added. To be added. diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonParameterInfo.xml b/xml/System.Text.Json.Serialization.Metadata/JsonParameterInfo.xml index 87a6b9cb5ac..eeb0d914190 100644 --- a/xml/System.Text.Json.Serialization.Metadata/JsonParameterInfo.xml +++ b/xml/System.Text.Json.Serialization.Metadata/JsonParameterInfo.xml @@ -51,8 +51,8 @@ Gets a custom attribute provider for the current parameter. To be added. - When resolving metadata via the built-in resolvers this will be populated with - the underlying of the constructor metadata. + When resolving metadata via the built-in resolvers this will be populated with + the underlying of the constructor metadata. @@ -148,8 +148,8 @@ Gets a value indicating whether the parameter represents a required or init-only member initializer. To be added. - Only returns for source-generated metadata that can only access - required or init-only member initializers using object initialize expressions. + Only returns for source-generated metadata that can only access + required or init-only member initializers using object initialize expressions. @@ -173,12 +173,14 @@ Gets a value indicating whether the constructor parameter is annotated as nullable. To be added. - Contracts originating from or , - derive the value of this parameter from nullable reference type annotations, including annotations - from attributes such as or . - This property has no effect on deserialization unless the - property has been enabled, in which case the serializer will reject any deserialization results. - This setting is in sync with the associated property. + Contracts originating from or + , derive the value of this parameter from nullable + reference type annotations, including annotations from attributes such as + or + . This property has no effect on deserialization + unless the property has been enabled, + in which case the serializer will reject any deserialization results. This setting is in sync + with the associated property. diff --git a/xml/System.Text.Json/JsonSerializer.xml b/xml/System.Text.Json/JsonSerializer.xml index a94a915f4ff..4ee00da7e03 100644 --- a/xml/System.Text.Json/JsonSerializer.xml +++ b/xml/System.Text.Json/JsonSerializer.xml @@ -382,15 +382,30 @@ There is remaining data in the string beyond a single JSON value. Reads one JSON value (including objects or arrays) from the provided reader into an instance specified by the . A representation of the JSON value. - If the property of is or , the reader will be advanced by one call to to determine the start of the value. - - Upon completion of this method, will be positioned at the final token in the JSON value. If an exception is thrown, the reader is reset to the state it was in when the method was called. - - This method makes a copy of the data the reader acted on, so there is no caller requirement to maintain data integrity beyond the return of this method. - - The used to create the instance of the take precedence over the when they conflict. - Hence, , , and are used while reading. - + + If the property of + is + or , the reader will be advanced by one + call to to determine the start of the value. + + + Upon completion of this method, will be positioned at the final token + in the JSON value. If an exception is thrown, the reader is reset to the state it was in when the + method was called. + + + This method makes a copy of the data the reader acted on, so there is no caller requirement to + maintain data integrity beyond the return of this method. + + + The used to create the instance of the + take precedence over the + when they conflict. + Hence, , + , and + are used + while reading. + The JSON is invalid, is not compatible with the JSON, @@ -4011,8 +4026,7 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa or is . - There is no compatible - for or its serializable members. + There is no compatible for or its serializable members. @@ -4058,10 +4072,7 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa is not compatible with . , , or is . - - There is no compatible - for or its serializable members. - + There is no compatible for or its serializable members. @@ -4260,10 +4271,7 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa To be added. is . - - There is no compatible - for or its serializable members. - + There is no compatible for or its serializable members.