From e11219fe3beea56dce528dd24e37c547b359f05c Mon Sep 17 00:00:00 2001 From: kiripon <2720978+kiripon@users.noreply.github.com> Date: Mon, 12 Aug 2024 23:51:32 +0900 Subject: [PATCH 1/8] AssemblyBuilder: Fix the example not to ignore the created instance (#10238) --- .../System.Reflection.Emit/AssemblyBuilder/Overview/24895.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/snippets/csharp/System.Reflection.Emit/AssemblyBuilder/Overview/24895.cs b/snippets/csharp/System.Reflection.Emit/AssemblyBuilder/Overview/24895.cs index 69bf416f7b0..40de04003c1 100644 --- a/snippets/csharp/System.Reflection.Emit/AssemblyBuilder/Overview/24895.cs +++ b/snippets/csharp/System.Reflection.Emit/AssemblyBuilder/Overview/24895.cs @@ -210,7 +210,7 @@ public int MyMethod(int multiplier) // property value. object? o2 = null; if (t is not null) - Activator.CreateInstance(t, new object[] { 5280 }); + o2 = Activator.CreateInstance(t, new object[] { 5280 }); Console.WriteLine("o2.Number: {0}", pi?.GetValue(o2, null)); } } From 2a42230f7dabd62ad74edcaaa27d024e642081c3 Mon Sep 17 00:00:00 2001 From: Drew Noakes Date: Tue, 13 Aug 2024 01:53:32 +1000 Subject: [PATCH 2/8] Fix code formatting (#10236) The previous code had broken indentation, making it harder to read than necessary. --- .../Win32Exception/Overview/win32exception.cs | 45 ++++++++++--------- 1 file changed, 23 insertions(+), 22 deletions(-) diff --git a/snippets/csharp/System.ComponentModel/Win32Exception/Overview/win32exception.cs b/snippets/csharp/System.ComponentModel/Win32Exception/Overview/win32exception.cs index 4c0783c2948..4f3659c6b03 100644 --- a/snippets/csharp/System.ComponentModel/Win32Exception/Overview/win32exception.cs +++ b/snippets/csharp/System.ComponentModel/Win32Exception/Overview/win32exception.cs @@ -1,28 +1,29 @@ using System; using System.ComponentModel; -//using System.Diagnostics; -namespace Win32Exception_CS -{ - class Class1 { - static void Main(string[] args) { +namespace Win32Exception_CS; - // - try { - System.Diagnostics.Process myProc = new System.Diagnostics.Process(); - myProc.StartInfo.FileName = "c:\nonexist.exe"; //Attempting to start a non-existing executable - myProc.Start(); //Start the application and assign it to the process component. - } - catch(Win32Exception w) { - Console.WriteLine(w.Message); - Console.WriteLine(w.ErrorCode.ToString()); - Console.WriteLine(w.NativeErrorCode.ToString()); - Console.WriteLine(w.StackTrace); - Console.WriteLine(w.Source); - Exception e=w.GetBaseException(); - Console.WriteLine(e.Message); - } - // - } +class Class1 +{ + static void Main(string[] args) + { + // + try + { + System.Diagnostics.Process myProc = new(); + myProc.StartInfo.FileName = @"c:\nonexist.exe"; // Attempt to start a non-existent executable + myProc.Start(); + } + catch (Win32Exception w) + { + Console.WriteLine(w.Message); + Console.WriteLine(w.ErrorCode.ToString()); + Console.WriteLine(w.NativeErrorCode.ToString()); + Console.WriteLine(w.StackTrace); + Console.WriteLine(w.Source); + Exception e = w.GetBaseException(); + Console.WriteLine(e.Message); + } + // } } From 7ebf9388232e88fbcc2202b3751151eb3d75e43b Mon Sep 17 00:00:00 2001 From: Radek Zikmund <32671551+rzikm@users.noreply.github.com> Date: Mon, 12 Aug 2024 19:58:49 +0200 Subject: [PATCH 3/8] Update QuicReceiveWindowSizes.xml with .ctor summary (#10239) * Update QuicReceiveWindowSizes.xml with .ctor summary * Update xml/System.Net.Quic/QuicReceiveWindowSizes.xml --- xml/System.Net.Quic/QuicReceiveWindowSizes.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/xml/System.Net.Quic/QuicReceiveWindowSizes.xml b/xml/System.Net.Quic/QuicReceiveWindowSizes.xml index d230a5cfed2..daf3a885273 100644 --- a/xml/System.Net.Quic/QuicReceiveWindowSizes.xml +++ b/xml/System.Net.Quic/QuicReceiveWindowSizes.xml @@ -31,7 +31,7 @@ - To be added. + Initializes a new instance of the class. To be added. From 4eb50481f15bedcb6886dcf5bbc7391f0774b3fd Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Mon, 12 Aug 2024 11:31:03 -0700 Subject: [PATCH 4/8] Update .repoman.yml (#10241) * Update .repoman.yml * Update .repoman.yml --- .repoman.yml | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/.repoman.yml b/.repoman.yml index 29c96d81001..8211c0f3390 100644 --- a/.repoman.yml +++ b/.repoman.yml @@ -1,4 +1,4 @@ -revision: 1 +revision: 2 schema-version: 1 owner-ms-alias: adegeo @@ -12,6 +12,15 @@ config: issues: + labeled: + + # Temporary label to mark issues as updated for Quest. The label is instantly removed + - check: + - type: query + value: "length(Issue.labels[?name == ':world_map: mapQUEST']) != `0`" + pass: + - labels-remove: [":world_map: mapQUEST"] + reopened: # Remove won't fix label From 60b5435cceb86cd505ce5b28ce8bdaa47f8a908c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Carlos=20S=C3=A1nchez=20L=C3=B3pez?= <1175054+carlossanlop@users.noreply.github.com> Date: Mon, 12 Aug 2024 12:08:49 -0700 Subject: [PATCH 5/8] Port System.IO new docs (second pass) (#10210) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * System.IO --------- Co-authored-by: David Cantú --- xml/System.IO/File.xml | 357 +++++++++++++++++++++++++++------ xml/System.IO/Path.xml | 12 +- xml/System.IO/StreamWriter.xml | 12 +- xml/System.IO/TextWriter.xml | 25 ++- 4 files changed, 323 insertions(+), 83 deletions(-) diff --git a/xml/System.IO/File.xml b/xml/System.IO/File.xml index ca18a64fcd9..1f89926ed5c 100644 --- a/xml/System.IO/File.xml +++ b/xml/System.IO/File.xml @@ -150,10 +150,40 @@ - To be added. - To be added. - To be added. + The file to append to. + The bytes to append to the file. + + Appends the specified byte array to the end of the file at the given path. + If the file doesn't exist, this method creates a new file. + To be added. + + or is . + + + is empty. + The specified path, file name, or both exceed the system-defined maximum length. + The specified path is invalid (for example, it is on an unmapped drive). + An I/O error occurred while opening the file. + + + specified a file that is read-only. + + -or- + + specified a file that is hidden. + + -or- + + specified a directory. + + -or- + The caller does not have the required permission. + -or- + This operation is not supported on the current platform. + + + is in an invalid format. @@ -195,10 +225,38 @@ - To be added. - To be added. - To be added. + The file to append to. + The bytes to append to the file. + + Appends the specified byte array to the end of the file at the given path. + If the file doesn't exist, this method creates a new file. + To be added. + + is . + + is empty. + The specified path, file name, or both exceed the system-defined maximum length. + The specified path is invalid (for example, it is on an unmapped drive). + An I/O error occurred while opening the file. + + + specified a file that is read-only. + + -or- + + specified a file that is hidden. + + -or- + + specified a directory. + + The caller does not have the required permission. + -or- + This operation is not supported on the current platform. + + + is in an invalid format. @@ -230,12 +288,21 @@ - To be added. - To be added. - To be added. - To be added. + The file to append to. + The bytes to append to the file. + The token to monitor for cancellation requests. The default value is . + + Asynchronously appends the specified byte array to the end of the file at the given path. + If the file doesn't exist, this method creates a new file. If the operation is canceled, the task will return in a canceled state. + To be added. To be added. + + or is . + + + is empty. + The cancellation token was canceled. This exception is stored into the returned task. @@ -271,12 +338,20 @@ - To be added. - To be added. - To be added. - To be added. + The file to append to. + The bytes to append to the file. + The token to monitor for cancellation requests. The default value is . + + Asynchronously appends the specified byte array to the end of the file at the given path. + If the file doesn't exist, this method creates a new file. If the operation is canceled, the task will return in a canceled state. + To be added. To be added. + + is . + + is empty. + The cancellation token was canceled. This exception is stored into the returned task. @@ -619,10 +694,40 @@ - To be added. - To be added. - To be added. - To be added. + The file to append to. + The characters to write to the file. + Appends the specified string to the file, creating the file if it does not already exist. + + Given a string and a file path, this method opens the specified file, appends the string to the end of the file using the specified encoding, + and then closes the file. The file handle is guaranteed to be closed by this method, even if exceptions are raised. The method creates the file + if it doesn't exist, but it doesn't create new directories. Therefore, the value of the path parameter must contain existing directories. + + + is . + + is empty. + The specified path, file name, or both exceed the system-defined maximum length. + The specified path is invalid (for example, it is on an unmapped drive). + An I/O error occurred while opening the file. + + + specified a file that is read-only. + + -or- + + specified a file that is hidden. + + -or- + + specified a directory. + + -or- + The caller does not have the required permission. + -or- + This operation is not supported on the current platform. + + + is in an invalid format. @@ -763,11 +868,42 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The file to append to. + The characters to write to the file. + The encoding to apply to the string. + Appends the specified string to the file, creating the file if it does not already exist. + + Given a string and a file path, this method opens the specified file, appends the string to the end of the file using the specified encoding, + and then closes the file. The file handle is guaranteed to be closed by this method, even if exceptions are raised. The method creates the file + if it doesn't exist, but it doesn't create new directories. Therefore, the value of the path parameter must contain existing directories. + + + or is . + + + is empty. + The specified path, file name, or both exceed the system-defined maximum length. + The specified path is invalid (for example, it is on an unmapped drive). + An I/O error occurred while opening the file. + + + specified a file that is read-only. + + -or- + + specified a file that is hidden. + + -or- + + specified a directory. + + -or- + The caller does not have the required permission. + -or- + This operation is not supported on the current platform. + + + is in an invalid format. @@ -909,12 +1045,13 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The file to append the specified string to. + The characters to append to the file. + The token to monitor for cancellation requests. The default value is . + Asynchronously opens a file or creates a file if it does not already exist, appends the specified string to the file, and then closes the file. + A task that represents the asynchronous append operation. To be added. + The cancellation token was canceled. This exception is stored into the returned task. @@ -1005,13 +1142,14 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The file to append the specified string to. + The characters to append to the file. + The character encoding to use. + The token to monitor for cancellation requests. The default value is . + Asynchronously opens a file or creates the file if it does not already exist, appends the specified string to the file using the specified encoding, and then closes the file. + A task that represents the asynchronous append operation. To be added. + The cancellation token was canceled. This exception is stored into the returned task. @@ -6908,10 +7046,36 @@ It is not possible to change the compression status of a o - To be added. - To be added. - To be added. + The file to write to. + The bytes to write to the file. + Creates a new file, writes the specified byte array to the file, and then closes the file. If the target file already exists, it is truncated and overwritten. To be added. + + is . + + is empty. + The specified path, file name, or both exceed the system-defined maximum length. + The specified path is invalid (for example, it is on an unmapped drive). + An I/O error occurred while opening the file. + + + specified a file that is read-only. + + -or- + + specified a file that is hidden. + + -or- + + specified a directory. + + -or- + The caller does not have the required permission. + -or- + This operation is not supported on the current platform. + + + is in an invalid format. @@ -6993,12 +7157,17 @@ It is not possible to change the compression status of a o - To be added. - To be added. - To be added. - To be added. - To be added. + The file to write to. + The bytes to write to the file. + The token to monitor for cancellation requests. The default value is . + Asynchronously creates a new file, writes the specified byte array to the file, and then closes the file. If the target file already exists, it is truncated and overwritten. + A task that represents the asynchronous write operation. To be added. + + is . + + is empty. + The cancellation token was canceled. This exception is stored into the returned task. @@ -7551,10 +7720,38 @@ It is not possible to change the compression status of a o - To be added. - To be added. - To be added. - To be added. + The file to write to. + The characters to write to the file. + + Creates a new file, writes the specified string to the file, and then closes the file. + If the target file already exists, it is truncated and overwritten. + + This method uses UTF-8 encoding without a Byte-Order Mark (BOM), so using the method will return an empty byte array. If it is necessary to include a UTF-8 identifier, such as a byte order mark, at the beginning of a file, use the method. + + is . + + is empty. + The specified path, file name, or both exceed the system-defined maximum length. + The specified path is invalid (for example, it is on an unmapped drive). + An I/O error occurred while opening the file. + + + specified a file that is read-only. + + -or- + + specified a file that is hidden. + + -or- + + specified a directory. + + -or- + This operation is not supported on the current platform. + The caller does not have the required permission. + + + is in an invalid format. @@ -7699,11 +7896,41 @@ It is not possible to change the compression status of a o - To be added. - To be added. - To be added. - To be added. + The file to write to. + The characters to write to the file. + The encoding to apply to the string. + + Creates a new file, writes the specified string to the file using the specified encoding, and then closes the file. + If the target file already exists, it is truncated and overwritten. + To be added. + + or is . + + + is empty. + The specified path, file name, or both exceed the system-defined maximum length. + The specified path is invalid (for example, it is on an unmapped drive). + An I/O error occurred while opening the file. + + + specified a file that is read-only. + + -or- + + specified a file that is hidden. + + -or- + + specified a directory. + + -or- + The caller does not have the required permission. + -or- + This operation is not supported on the current platform. + + + is in an invalid format. @@ -7847,12 +8074,16 @@ It is not possible to change the compression status of a o - To be added. - To be added. - To be added. - To be added. - To be added. + The file to write to. + The characters to write to the file. + The token to monitor for cancellation requests. The default value is . + + Asynchronously creates a new file, writes the specified string to the file, and then closes the file. + If the target file already exists, it is truncated and overwritten. + + A task that represents the asynchronous write operation. To be added. + The cancellation token was canceled. This exception is stored into the returned task. @@ -7943,13 +8174,17 @@ It is not possible to change the compression status of a o - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The file to write to. + The characters to write to the file. + The encoding to apply to the string. + The token to monitor for cancellation requests. The default value is . + + Asynchronously creates a new file, writes the specified string to the file using the specified encoding, and then closes the file. + If the target file already exists, it is truncated and overwritten. + + A task that represents the asynchronous write operation. To be added. + The cancellation token was canceled. This exception is stored into the returned task. diff --git a/xml/System.IO/Path.xml b/xml/System.IO/Path.xml index d362edd8a3a..573ad4d7da5 100644 --- a/xml/System.IO/Path.xml +++ b/xml/System.IO/Path.xml @@ -355,9 +355,9 @@ This method is intended to concatenate individual strings into a single string t - To be added. - To be added. - To be added. + A span of parts of the path. + Combines a span of strings into a path. + The combined paths. To be added. @@ -2890,9 +2890,9 @@ Note that rooted paths can be either absolute (that is, fully qualified) or rela - To be added. - To be added. - To be added. + A span of paths. + Concatenates a span of paths into a single path. + The concatenated path. To be added. diff --git a/xml/System.IO/StreamWriter.xml b/xml/System.IO/StreamWriter.xml index a18ac46a6e7..6e5e92b77d7 100644 --- a/xml/System.IO/StreamWriter.xml +++ b/xml/System.IO/StreamWriter.xml @@ -2117,9 +2117,9 @@ See for a descr - To be added. - To be added. - To be added. + A composite format string. + An object span that contains zero or more objects to format and write. + Writes a formatted string to the stream, using the same semantics as . To be added. @@ -2976,9 +2976,9 @@ See for a d - To be added. - To be added. - To be added. + A composite format string. + An object span that contains zero or more objects to format and write. + Writes out a formatted string and a new line to the stream, using the same semantics as . To be added. diff --git a/xml/System.IO/TextWriter.xml b/xml/System.IO/TextWriter.xml index e8c5c42b973..f1a05c07869 100644 --- a/xml/System.IO/TextWriter.xml +++ b/xml/System.IO/TextWriter.xml @@ -439,10 +439,15 @@ - To be added. - To be added. - To be added. - To be added. + The instances to which all operations should be broadcast (multiplexed). + Creates an instance of that writes supplied inputs to each of the writers in . + An instance of that writes supplied inputs to each of the writers in + + The resulting instance will delegate each operation to each of the writers in . For example, calling will write the specified char to each writer, one after the other. The writers will be written to in the same order as they are specified in . An exception from the operation on one writer will prevent the operation from being performed on subsequent writers. + and will return the corresponding object from first writer in . + + + is or it contains a . @@ -2470,9 +2475,9 @@ This method is equivalent to `Write(stringBuilder.ToString())`, but it uses the - To be added. - To be added. - To be added. + A composite format string. + An object span that contains zero or more objects to format and write. + Writes a formatted string to the text stream, using the same semantics as . To be added. @@ -4627,9 +4632,9 @@ For a list of common I/O tasks, see [Common I/O Tasks](/dotnet/standard/io/commo - To be added. - To be added. - To be added. + A composite format string. + An object span that contains zero or more objects to format and write. + Writes out a formatted string and a new line to the text stream, using the same semantics as . To be added. From 7d531b18c59e7fe7b97e7bac3edc6ae869dc28e1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Carlos=20S=C3=A1nchez=20L=C3=B3pez?= <1175054+carlossanlop@users.noreply.github.com> Date: Mon, 12 Aug 2024 22:05:36 -0700 Subject: [PATCH 6/8] Port System.Reflection new docs (second pass) (#10211) * System.Reflection * System.Reflection.Emit * System.Reflection.Metadata * System.Reflecftion.PortableExecutable --- xml/System.Reflection.Emit/EnumBuilder.xml | 113 +++++++++---- .../GenericTypeParameterBuilder.xml | 54 +++--- xml/System.Reflection.Emit/ILGenerator.xml | 27 +-- xml/System.Reflection.Emit/Label.xml | 2 +- xml/System.Reflection.Emit/LocalBuilder.xml | 11 +- xml/System.Reflection.Emit/ModuleBuilder.xml | 20 ++- xml/System.Reflection.Emit/OpCode.xml | 12 +- .../PersistedAssemblyBuilder.xml | 51 +++--- xml/System.Reflection.Emit/TypeBuilder.xml | 127 +++++++++----- .../AssemblyNameInfo.xml | 52 +++--- xml/System.Reflection.Metadata/TypeName.xml | 159 ++++++++++++++---- .../TypeNameParseOptions.xml | 2 +- .../Machine.xml | 6 +- xml/System.Reflection/Assembly.xml | 9 +- xml/System.Reflection/ConstructorInvoker.xml | 18 +- xml/System.Reflection/MethodInvoker.xml | 20 +-- 16 files changed, 454 insertions(+), 229 deletions(-) diff --git a/xml/System.Reflection.Emit/EnumBuilder.xml b/xml/System.Reflection.Emit/EnumBuilder.xml index 8ad22f1eefa..719098dfbf2 100644 --- a/xml/System.Reflection.Emit/EnumBuilder.xml +++ b/xml/System.Reflection.Emit/EnumBuilder.xml @@ -882,8 +882,8 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr - To be added. - To be added. + When overridden in a derived class, implements the property and gets a bitwise combination of enumeration values that indicate the attributes associated with the . + A object representing the attribute set of the . To be added. @@ -948,13 +948,26 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + + A bitwise combination of the enumeration values that specify how the search is conducted. + -or- + + to return . + + + 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. + -or- + A reference ( in Visual Basic), to use the . + + 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. + + An array of objects representing the number, order, and type of the parameters for the constructor to get. + -or- + An empty array of the type (that is, Type[] types = new Type[0]) to get a constructor that takes no parameters. + + An array of objects representing the attributes associated with the corresponding element in the array. The default binder does not process this parameter. + 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. + A object representing the constructor that matches the specified requirements, if found; otherwise, . To be added. @@ -1974,14 +1987,30 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The string containing the name of the method to get. + + A bitwise combination of the enumeration values that specify how the search is conducted. + -or- + + to return . + + + 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. + -or- + A reference ( in Visual Basic), to use the . + + 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. + + An array of objects representing the number, order, and type of the parameters for the method to get. + -or- + An empty array of the type (that is, Type[] types = new Type[0]) to get a method that takes no parameters. + -or- + + . If is , arguments are not matched. + + An array of objects representing the attributes associated with the corresponding element in the array. The default binder does not process this parameter. + 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. + An object representing the method that matches the specified requirements, if found; otherwise, . To be added. @@ -2395,8 +2424,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the current encompasses or refers to another type; that is, whether the current is an array, a pointer, or is passed by reference. + + if the is an array, a pointer, or is passed by reference; otherwise, . To be added. @@ -2528,8 +2558,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the is an array. + + if the is an array; otherwise, . To be added. @@ -2622,8 +2653,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the is passed by reference. + + if the is passed by reference; otherwise, . To be added. @@ -2654,8 +2686,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr System.Boolean - To be added. - To be added. + Gets a value that indicates whether the type is a byref-like structure. + + if the is a byref-like structure; otherwise, . To be added. @@ -2696,8 +2729,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the is a COM object. + + if the is a COM object; otherwise, . To be added. @@ -2940,8 +2974,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the is a pointer. + + if the is a pointer; otherwise, . To be added. @@ -2982,8 +3017,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the is one of the primitive types. + + if the is one of the primitive types; otherwise, . To be added. @@ -3042,8 +3078,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr System.Boolean - To be added. - To be added. + 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. + + if the current is an array type that can represent only a single-dimensional array with a zero lower bound; otherwise, . To be added. @@ -3075,8 +3112,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr System.Boolean - To be added. - To be added. + Gets a value that indicates whether the type is a type definition. + + if the current is a type definition; otherwise, . To be added. @@ -3117,8 +3155,9 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr - To be added. - To be added. + Implements the property and determines whether the is a value type; that is, not a class or an interface. + + if the is a value type; otherwise, . To be added. diff --git a/xml/System.Reflection.Emit/GenericTypeParameterBuilder.xml b/xml/System.Reflection.Emit/GenericTypeParameterBuilder.xml index 41e57f3d5da..9c5bfaf1c7d 100644 --- a/xml/System.Reflection.Emit/GenericTypeParameterBuilder.xml +++ b/xml/System.Reflection.Emit/GenericTypeParameterBuilder.xml @@ -736,8 +736,8 @@ - To be added. - To be added. + When overridden in a derived class, implements the property and gets a bitwise combination of enumeration values that indicate the attributes associated with the . + A object representing the attribute set of the . To be added. @@ -2284,8 +2284,9 @@ - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the current encompasses or refers to another type; that is, whether the current is an array, a pointer, or is passed by reference. + + if the is an array, a pointer, or is passed by reference; otherwise, . To be added. @@ -2415,8 +2416,9 @@ - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the is an array. + + if the is an array; otherwise, . To be added. @@ -2589,8 +2591,9 @@ - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the is passed by reference. + + if the is passed by reference; otherwise, . To be added. @@ -2621,8 +2624,9 @@ System.Boolean - To be added. - To be added. + Gets a value that indicates whether the type is a byref-like structure. + + if the is a byref-like structure; otherwise, . To be added. @@ -2662,8 +2666,9 @@ - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the is a COM object. + + if the is a COM object; otherwise, . To be added. @@ -2955,8 +2960,9 @@ - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the is a pointer. + + if the is a pointer; otherwise, . To be added. @@ -2996,8 +3002,9 @@ - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the is one of the primitive types. + + if the is one of the primitive types; otherwise, . To be added. @@ -3113,8 +3120,9 @@ System.Boolean - To be added. - To be added. + 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. + + if the current is an array type that can represent only a single-dimensional array with a zero lower bound; otherwise, . To be added. @@ -3146,8 +3154,9 @@ System.Boolean - To be added. - To be added. + Gets a value that indicates whether the type is a type definition. + + if the current is a type definition; otherwise, . To be added. @@ -3187,8 +3196,9 @@ - To be added. - To be added. + Implements the property and determines whether the is a value type; that is, not a class or an interface. + + if the is a value type; otherwise, . To be added. diff --git a/xml/System.Reflection.Emit/ILGenerator.xml b/xml/System.Reflection.Emit/ILGenerator.xml index d6a53359115..b733f8079da 100644 --- a/xml/System.Reflection.Emit/ILGenerator.xml +++ b/xml/System.Reflection.Emit/ILGenerator.xml @@ -517,9 +517,9 @@ - To be added. - To be added. - To be added. + The unique ID for the label. + Creates a with the given ID. + The created. To be added. @@ -2587,6 +2587,10 @@ The following code example emits two methods, a `varargs` method and a method th or is <= 0. This belongs to a . + + is . + + is not valid. @@ -2615,13 +2619,16 @@ The following code example emits two methods, a `varargs` method and a method th - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The document for which the sequence point is being defined. + The line where the sequence point begins. + The column in the line where the sequence point begins. + The line where the sequence point ends. + The column in the line where the sequence point ends. + When overridden in a derived class, marks a sequence point in the Microsoft intermediate language (MSIL) stream. + The parameters validated in the caller: . + + is not valid. + Emitting debug info is not supported. diff --git a/xml/System.Reflection.Emit/Label.xml b/xml/System.Reflection.Emit/Label.xml index d39eea0d96d..87418fd8ca9 100644 --- a/xml/System.Reflection.Emit/Label.xml +++ b/xml/System.Reflection.Emit/Label.xml @@ -249,7 +249,7 @@ System.Int32 - To be added. + Gets the label unique id assigned by the ILGenerator. To be added. To be added. diff --git a/xml/System.Reflection.Emit/LocalBuilder.xml b/xml/System.Reflection.Emit/LocalBuilder.xml index eecf019b51b..1947aa469ed 100644 --- a/xml/System.Reflection.Emit/LocalBuilder.xml +++ b/xml/System.Reflection.Emit/LocalBuilder.xml @@ -120,8 +120,8 @@ - To be added. - To be added. + Initializes a new instance of the class. + This constructor is invoked by derived classes. @@ -334,6 +334,7 @@ There is no symbolic writer defined for the containing module. This local is defined in a dynamic method, rather than in a method of a dynamic type. + The is . @@ -422,9 +423,11 @@ - To be added. - To be added. + The name of the local variable. + When overridden in a derived class, sets the name of this local variable. To be added. + Emitting debug info is not supported. + The containing type has been created with CreateType(). diff --git a/xml/System.Reflection.Emit/ModuleBuilder.xml b/xml/System.Reflection.Emit/ModuleBuilder.xml index 2420c55d271..aa442dcd79c 100644 --- a/xml/System.Reflection.Emit/ModuleBuilder.xml +++ b/xml/System.Reflection.Emit/ModuleBuilder.xml @@ -275,11 +275,14 @@ - To be added. - To be added. - To be added. - To be added. + The URL for the document. + The GUID that identifies the document language. This is optional. + Defines a document for source. + The defined document. To be added. + + is . + This method is called on a dynamic module that is not a persisted module. @@ -375,11 +378,12 @@ - To be added. - To be added. - To be added. - To be added. + The URL for the document. + The GUID that identifies the document language. This is optional. + When override in a derived class, defines a document for source. + The defined document. To be added. + This method is called on a dynamic module that is not a debug module. diff --git a/xml/System.Reflection.Emit/OpCode.xml b/xml/System.Reflection.Emit/OpCode.xml index 706185dfb0b..727dbcfcb25 100644 --- a/xml/System.Reflection.Emit/OpCode.xml +++ b/xml/System.Reflection.Emit/OpCode.xml @@ -208,9 +208,17 @@ System.Int32 - To be added. + Gets the value of how the IL instruction changes the evaluation stack. To be added. - To be added. + + The difference between how many elements are popped from the stack and how many are pushed onto the stack as a result of the IL instruction. + For some IL instructions like stack change is not fixed and depends on the called reference signature. + For such the returns 0. In this case you should not rely on + + for calculating stack size and/or max stack, instead need to evaluate the reference signature. + For example, in case the instruction is calling a method reference, you need to evaluate the method signature; + the push count depends on the returning value, the pop count depends on how many parameters passed. + diff --git a/xml/System.Reflection.Emit/PersistedAssemblyBuilder.xml b/xml/System.Reflection.Emit/PersistedAssemblyBuilder.xml index 348466a39b4..93dc197061d 100644 --- a/xml/System.Reflection.Emit/PersistedAssemblyBuilder.xml +++ b/xml/System.Reflection.Emit/PersistedAssemblyBuilder.xml @@ -24,7 +24,7 @@ - To be added. + Provides an AssemblyBuilder implementation that can persist assembly to a disk or stream. To be added. @@ -52,11 +52,12 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The name of the assembly. + The assembly that denotes the "system assembly" that houses the well-known types such as + A collection that contains the attributes of the assembly. + Creates a instance that can be saved to a file or stream. + Currently the persisted assembly doesn't support running. You must save it and load it back to run. + The or or is . @@ -147,11 +148,13 @@ - To be added. - To be added. - To be added. - To be added. + When this method returns, contains the bytes that includes all method's IL (body) emitted. + When this method returns, contains the bytes that includes all field RVA data defined in the assembly. + Generates the metadata for the . + A that includes all members defined in the Assembly. To be added. + A module is not defined for the assembly. + The metadata was previously populated for the assembly. @@ -181,12 +184,14 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + When this method returns, contains the bytes that includes all method's IL (body) emitted. + When this method returns, contains the bytes that includes all field RVA data defined in the assembly. + When this method returns, contains the that includes PDB metadata. + Generates the metadata for the . + A that includes all members defined in the Assembly. To be added. + A module not defined for the assembly. + The metadata already populated for the assembly previously. @@ -306,9 +311,13 @@ - To be added. - To be added. + The to which the assembly should be serialized. + Serializes the assembly to the specified stream. To be added. + + is . + A module not defined for the assembly. + The metadata already populated for the assembly before. @@ -330,9 +339,13 @@ - To be added. - To be added. + The file name of the assembly. + Saves the assembly to disk. To be added. + + is . + A module not defined for the assembly. + The metadata already populated for the assembly before. diff --git a/xml/System.Reflection.Emit/TypeBuilder.xml b/xml/System.Reflection.Emit/TypeBuilder.xml index 937f1a6d950..7ec2570a7ad 100644 --- a/xml/System.Reflection.Emit/TypeBuilder.xml +++ b/xml/System.Reflection.Emit/TypeBuilder.xml @@ -4577,8 +4577,8 @@ See for a description of the format of the - To be added. - To be added. + When overridden in a derived class, implements the property and gets a bitwise combination of enumeration values that indicate the attributes associated with the . + A object representing the attribute set of the . To be added. @@ -4725,13 +4725,26 @@ See for a description of the format of the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + + A bitwise combination of the enumeration values that specify how the search is conducted. + -or- + + to return . + + + 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. + -or- + A reference ( in Visual Basic), to use the . + + 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. + + An array of objects representing the number, order, and type of the parameters for the constructor to get. + -or- + An empty array of the type (that is, Type[] types = new Type[0]) to get a constructor that takes no parameters. + + An array of objects representing the attributes associated with the corresponding element in the array. The default binder does not process this parameter. + 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. + A object representing the constructor that matches the specified requirements, if found; otherwise, . To be added. @@ -5951,14 +5964,30 @@ See for a description of the format of the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The string containing the name of the method to get. + + A bitwise combination of the enumeration values that specify how the search is conducted. + -or- + + to return . + + + 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. + -or- + A reference ( in Visual Basic), to use the . + + 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. + + An array of objects representing the number, order, and type of the parameters for the method to get. + -or- + An empty array of the type (that is, Type[] types = new Type[0]) to get a method that takes no parameters. + -or- + + . If is , arguments are not matched. + + An array of objects representing the attributes associated with the corresponding element in the array. The default binder does not process this parameter. + 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. + An object representing the method that matches the specified requirements, if found; otherwise, . To be added. @@ -6276,14 +6305,27 @@ See for a description of the format of the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The string containing the name of the property to get. + + A bitwise combination of the enumeration values that specify how the search is conducted. + -or- + + to return . + + + An object that defines a set of properties and enables binding, which can involve selection of an overloaded member, coercion of argument types, and invocation of a member through reflection. + -or- + A reference ( in Visual Basic), to use the . + + The return type of the property. + + An array of objects representing the number, order, and type of the parameters for the indexed property to get. + -or- + An empty array of the type (that is, Type[] types = new Type[0]) to get a property that is not indexed. + + An array of objects representing the attributes associated with the corresponding element in the array. The default binder does not process this parameter. + When overridden in a derived class, searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints. + An object representing the property that matches the specified requirements, if found; otherwise, . To be added. @@ -6372,8 +6414,9 @@ See for a description of the format of the - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the current encompasses or refers to another type; that is, whether the current is an array, a pointer, or is passed by reference. + + if the is an array, a pointer, or is passed by reference; otherwise, . To be added. @@ -6512,8 +6555,9 @@ See for a description of the format of the - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the is an array. + + if the is an array; otherwise, . To be added. @@ -6674,8 +6718,9 @@ See for a description of the format of the - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the is passed by reference. + + if the is passed by reference; otherwise, . To be added. @@ -6706,8 +6751,9 @@ See for a description of the format of the System.Boolean - To be added. - To be added. + Gets a value that indicates whether the type is a byref-like structure. + + if the is a byref-like structure; otherwise, . To be added. @@ -6748,8 +6794,9 @@ See for a description of the format of the - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the is a COM object. + + if the is a COM object; otherwise, . To be added. @@ -7156,8 +7203,9 @@ See for a description of the format of the - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the is a pointer. + + if the is a pointer; otherwise, . To be added. @@ -7198,8 +7246,9 @@ See for a description of the format of the - To be added. - To be added. + When overridden in a derived class, implements the property and determines whether the is one of the primitive types. + + if the is one of the primitive types; otherwise, . To be added. diff --git a/xml/System.Reflection.Metadata/AssemblyNameInfo.xml b/xml/System.Reflection.Metadata/AssemblyNameInfo.xml index f5fc5686837..a916856d84c 100644 --- a/xml/System.Reflection.Metadata/AssemblyNameInfo.xml +++ b/xml/System.Reflection.Metadata/AssemblyNameInfo.xml @@ -20,8 +20,8 @@ - To be added. - To be added. + Describes an assembly. + It's a more lightweight, immutable version of that does not pre-allocate instances. @@ -63,13 +63,15 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The simple name of the assembly. + The version of the assembly. + The name of the culture associated with the assembly. + The attributes of the assembly. + The public key or its token. Set to when it's public key. + Initializes a new instance of the AssemblyNameInfo class. To be added. + + is . @@ -98,7 +100,7 @@ System.String - To be added. + Gets the name of the culture associated with the assembly. To be added. To be added. @@ -119,7 +121,7 @@ System.Reflection.AssemblyNameFlags - To be added. + Gets the attributes of the assembly. To be added. To be added. @@ -150,9 +152,9 @@ System.String - To be added. + Gets the full name of the assembly, also known as the display name. To be added. - To be added. + In contrast to , this property doesn't validate the public key token or compute it based on the provided public key. @@ -181,7 +183,7 @@ System.String - To be added. + Gets the simple name of the assembly. To be added. To be added. @@ -211,10 +213,11 @@ - To be added. - To be added. - To be added. + A span containing the characters representing the assembly name to parse. + Parses a span of characters into a assembly name. + Parsed type name. To be added. + The provided assembly name is invalid. @@ -233,9 +236,9 @@ System.Collections.Immutable.ImmutableArray<System.Byte> - To be added. + Gets the public key or the public key token of the assembly. To be added. - To be added. + Check for flag to determine whether it's a public key or its token. @@ -261,7 +264,7 @@ - To be added. + Initializes a new instance of the class based on the stored information. To be added. To be added. @@ -297,10 +300,11 @@ - To be added. - To be added. - To be added. - To be added. + A span containing the characters representing the assembly name to parse. + Contains the result when parsing succeeds. + Tries to parse a span of characters into an assembly name. + + if assembly name was converted successfully, otherwise, . To be added. @@ -330,7 +334,7 @@ System.Version - To be added. + Gets the version of the assembly. To be added. To be added. diff --git a/xml/System.Reflection.Metadata/TypeName.xml b/xml/System.Reflection.Metadata/TypeName.xml index 8749624da79..c3d6aade49a 100644 --- a/xml/System.Reflection.Metadata/TypeName.xml +++ b/xml/System.Reflection.Metadata/TypeName.xml @@ -58,7 +58,10 @@ System.Reflection.Metadata.AssemblyNameInfo - To be added. + + Returns assembly name that contains this type, or if this was not + created from a fully qualified name. + To be added. To be added. @@ -79,9 +82,9 @@ System.String - To be added. + Gets the assembly-qualified name of the type; for example, "System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089". To be added. - To be added. + If returns , simply returns . @@ -100,9 +103,13 @@ System.Reflection.Metadata.TypeName - To be added. + + If this type is a nested type (see ), gets + the declaring type. If this type is not a nested type, throws. + To be added. - 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. @@ -121,9 +128,21 @@ System.String - To be added. + + 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. - 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. + @@ -143,9 +162,10 @@ - To be added. - To be added. + Gets the number of dimensions in an array. + An integer that contains the number of dimensions in the current type. To be added. + The current type is not an array. @@ -165,9 +185,10 @@ - To be added. + Gets the TypeName of the object encompassed or referred to by the current array, pointer, or reference type. To be added. - To be added. + For example, given "int[][]", unwraps the outermost array and returns "int[]". + The current type is not an array, pointer or reference. @@ -193,9 +214,15 @@ - To be added. + + If this represents a constructed generic type, returns an array + of all the generic arguments. Otherwise it returns an empty array. + To be added. - To be added. + + For example, given "Dictionary<string, int>", returns a 2-element array containing + string and int. + @@ -215,9 +242,10 @@ - To be added. + Returns a TypeName object that represents a generic type name definition from which the current generic type name can be constructed. To be added. - To be added. + Given "Dictionary<string, int>", this method returns the generic type definition "Dictionary<,>". + The current type is not a generic type. @@ -237,9 +265,35 @@ - To be added. + + Gets the total number of instances that are used to describe + this instance, including any generic arguments or underlying types. + To be added. - 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[]) + + + @@ -258,7 +312,10 @@ System.Boolean - To be added. + + 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. @@ -279,7 +336,10 @@ System.Boolean - To be added. + + 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. @@ -300,9 +360,9 @@ System.Boolean - To be added. + Gets a value that indicates whether this type represents a constructed generic type (for example, "List<int>"). To be added. - To be added. + Returns for open generic types (for example, "Dictionary<,>"). @@ -321,7 +381,10 @@ System.Boolean - To be added. + + 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. @@ -342,7 +405,10 @@ System.Boolean - To be added. + + 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. @@ -363,9 +429,19 @@ System.Boolean - To be added. + + 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. - 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. + @@ -384,7 +460,7 @@ System.Boolean - To be added. + Gets a value that indicates whether this type represents a single-dimensional, zero-indexed array (for example, "int[]"). To be added. To be added. @@ -405,7 +481,10 @@ System.Boolean - To be added. + + 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. @@ -426,7 +505,10 @@ System.String - To be added. + + 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. @@ -469,11 +551,13 @@ - To be added. - To be added. - To be added. - To be added. + A span containing the characters representing the type name to parse. + An object that describes optional parameters to use. + Parses a span of characters into a type name. + Parsed type name. To be added. + Provided type name was invalid. + Parsing has exceeded the limit set by . @@ -516,11 +600,12 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + A span containing the characters representing the type name to parse. + Contains the result when parsing succeeds. + An object that describes optional parameters to use. + Tries to parse a span of characters into a type name. + + if type name was converted successfully, otherwise, . To be added. diff --git a/xml/System.Reflection.Metadata/TypeNameParseOptions.xml b/xml/System.Reflection.Metadata/TypeNameParseOptions.xml index 3a29a3b962c..443cb34f272 100644 --- a/xml/System.Reflection.Metadata/TypeNameParseOptions.xml +++ b/xml/System.Reflection.Metadata/TypeNameParseOptions.xml @@ -51,7 +51,7 @@ System.Int32 - To be added. + Limits the maximum number of nodes that the parser can handle. To be added. To be added. diff --git a/xml/System.Reflection.PortableExecutable/Machine.xml b/xml/System.Reflection.PortableExecutable/Machine.xml index 28a8b1d3d7a..d3351967833 100644 --- a/xml/System.Reflection.PortableExecutable/Machine.xml +++ b/xml/System.Reflection.PortableExecutable/Machine.xml @@ -547,7 +547,7 @@ 20776 - To be added. + RISCV128 @@ -567,7 +567,7 @@ 20530 - To be added. + RISCV32 @@ -587,7 +587,7 @@ 20580 - To be added. + RISCV64 diff --git a/xml/System.Reflection/Assembly.xml b/xml/System.Reflection/Assembly.xml index 167cd5b71a6..5d478f09233 100644 --- a/xml/System.Reflection/Assembly.xml +++ b/xml/System.Reflection/Assembly.xml @@ -6372,9 +6372,12 @@ In .NET 5 and later versions, for bundled assemblies, the value returned is an e - To be added. - To be added. - To be added. + Assembly object that represents the application's new entry assembly. + Sets the application's entry assembly to the provided assembly object. + + The assembly passed to this function has to be a runtime defined Assembly + type object. Otherwise, an exception will be thrown. + diff --git a/xml/System.Reflection/ConstructorInvoker.xml b/xml/System.Reflection/ConstructorInvoker.xml index c2fd0a10065..ebce5d2fc51 100644 --- a/xml/System.Reflection/ConstructorInvoker.xml +++ b/xml/System.Reflection/ConstructorInvoker.xml @@ -111,7 +111,7 @@ The first argument for the invoked method. Invokes the constructor using the specified arguments. - To be added. + An instance of the class associated with the constructor. To be added. The arguments do not match the signature of the invoked constructor. @@ -145,8 +145,8 @@ The arguments for the invoked constructor. - To be added. - To be added. + Invokes the constructor using the specified arguments. + An instance of the class associated with the constructor. To be added. The arguments do not match the signature of the invoked constructor. @@ -187,8 +187,8 @@ The first argument for the invoked method. The second argument for the invoked method. - To be added. - To be added. + Invokes the constructor using the specified arguments. + An instance of the class associated with the constructor. To be added. @@ -230,8 +230,8 @@ The first argument for the invoked method. The second argument for the invoked method. The third argument for the invoked method. - To be added. - To be added. + Invokes the constructor using the specified arguments. + An instance of the class associated with the constructor. To be added. @@ -275,8 +275,8 @@ The second argument for the invoked method. The third argument for the invoked method. The fourth argument for the invoked method. - To be added. - To be added. + Invokes the constructor using the specified arguments. + An instance of the class associated with the constructor. To be added. diff --git a/xml/System.Reflection/MethodInvoker.xml b/xml/System.Reflection/MethodInvoker.xml index d722205d409..78cc9a7578c 100644 --- a/xml/System.Reflection/MethodInvoker.xml +++ b/xml/System.Reflection/MethodInvoker.xml @@ -119,8 +119,8 @@ The method is not declared or inherited by the class of . The object on which to invoke the method. If the method is static, this argument is ignored. The first argument for the invoked method. - To be added. - To be added. + Invokes the method using the specified arguments. + An object containing the return value of the invoked method, or if the invoked method does not have a return value. To be added. The arguments do not match the signature of the invoked method. @@ -156,8 +156,8 @@ The method is not declared or inherited by the class of . The object on which to invoke the method. If the method is static, this argument is ignored. The arguments for the invoked method. - To be added. - To be added. + Invokes the method using the specified arguments. + An object containing the return value of the invoked method, or if the invoked method does not have a return value. To be added. The arguments do not match the signature of the invoked method. @@ -188,8 +188,8 @@ The method is not declared or inherited by the class of . The object on which to invoke the method. If the method is static, this argument is ignored. The first argument for the invoked method. The second argument for the invoked method. - To be added. - To be added. + Invokes the method using the specified arguments. + An object containing the return value of the invoked method, or if the invoked method does not have a return value. To be added. @@ -221,8 +221,8 @@ The method is not declared or inherited by the class of . The first argument for the invoked method. The second argument for the invoked method. The third argument for the invoked method. - To be added. - To be added. + Invokes the method using the specified arguments. + An object containing the return value of the invoked method, or if the invoked method does not have a return value. To be added. @@ -256,8 +256,8 @@ The method is not declared or inherited by the class of . The second argument for the invoked method. The third argument for the invoked method. The fourth argument for the invoked method. - To be added. - To be added. + Invokes the method using the specified arguments. + An object containing the return value of the invoked method, or if the invoked method does not have a return value. To be added. From ccf3f886cf4bc9fe4ee348850d6c29e935a76d96 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Carlos=20S=C3=A1nchez=20L=C3=B3pez?= <1175054+carlossanlop@users.noreply.github.com> Date: Mon, 12 Aug 2024 22:18:41 -0700 Subject: [PATCH 7/8] Port Microsoft.Extensions new docs (#10208) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Microsoft.Extensions.Caching.Distributed * Microsoft.Extensions.Caching.Hybrid * Microsoft.Extensions.Caching.Memory * Microsoft.Extensions.Configuration * Microsoft.Extensions.DependencyInjection * Microsoft.Extensions.FileProviders.Physical * Microsoft.Extensions.Hosting * Microsoft.Extensions.Hosting.WindowsServices * Microsoft.Extensions.Http.Logging * Microsoft.Extensions.Logging * Microsoft.Extensions.Logging.Abstractions * Microsoft.Extensions.Logging.Configuration * Microsoft.Extensions.Logging.Console * Microsoft.Extensions.Logging.EventSource --------- Co-authored-by: David Cantú --- .../IBufferDistributedCache.xml | 48 +++--- .../HybridCache.xml | 14 +- .../HybridCacheEntryFlags.xml | 20 +-- .../HybridCacheEntryOptions.xml | 16 +- .../IHybridCacheSerializerFactory.xml | 11 +- .../IHybridCacheSerializer`1.xml | 8 +- .../CacheExtensions.xml | 28 ++-- .../MemoryCache.xml | 4 +- .../ConfigurationManager.xml | 11 +- .../ServiceCollection.xml | 49 ++++--- .../ServiceDescriptor.xml | 88 +++++------ .../PhysicalDirectoryInfo.xml | 1 + .../WindowsServiceLifetime.xml | 28 ++-- xml/Microsoft.Extensions.Hosting/Host.xml | 14 +- .../HostApplicationBuilder.xml | 26 ++-- .../SystemdHostBuilderExtensions.xml | 23 ++- ...wsServiceLifetimeHostBuilderExtensions.xml | 59 ++++++-- .../WindowsServiceLifetimeOptions.xml | 4 +- .../LoggingHttpMessageHandler.xml | 28 ++-- .../LoggingScopeHttpMessageHandler.xml | 28 ++-- .../NullLogger.xml | 4 +- .../NullLogger`1.xml | 4 +- ...ggerProviderOptionsChangeTokenSource`2.xml | 5 +- .../ConsoleLoggerSettings.xml | 16 +- .../LoggingEventSource.xml | 138 +++++++++--------- xml/Microsoft.Extensions.Logging/EventId.xml | 15 +- .../LoggerExternalScopeProvider.xml | 4 +- .../LoggerFilterRule.xml | 4 +- xml/Microsoft.Extensions.Logging/Logger`1.xml | 6 +- 29 files changed, 385 insertions(+), 319 deletions(-) diff --git a/xml/Microsoft.Extensions.Caching.Distributed/IBufferDistributedCache.xml b/xml/Microsoft.Extensions.Caching.Distributed/IBufferDistributedCache.xml index 15dab60e075..7ff905d4eb7 100644 --- a/xml/Microsoft.Extensions.Caching.Distributed/IBufferDistributedCache.xml +++ b/xml/Microsoft.Extensions.Caching.Distributed/IBufferDistributedCache.xml @@ -21,7 +21,7 @@ - To be added. + Represents a distributed cache of serialized values, with support for low allocation data transfer. To be added. @@ -53,11 +53,11 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The key of the entry to create. + The value for this cache entry. + The cache options for the entry. + Sets or overwrites a cache item. + This is functionally similar to , but avoids the array allocation. @@ -88,13 +88,13 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The key of the entry to create. + The value for this cache entry. + The cache options for the value. + The used to propagate notifications that the operation should be canceled. + Asynchronously sets or overwrites a cache entry. To be added. - To be added. + This is functionally similar to , but avoids the array allocation. @@ -117,11 +117,12 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The unique key for the cache item. + The target to write the cache contents on success. + Attempts to retrieve an existing cache item. + + if the cache item is found, otherwise. + This is functionally similar to , but avoids the array allocation. @@ -150,12 +151,13 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The unique key for the cache entry. + The target to write the cache contents on success. + The used to propagate notifications that the operation should be canceled. + Asynchronously attempts to retrieve an existing cache entry. + + if the cache entry is found, otherwise. + This is functionally similar to , but avoids the array allocation. diff --git a/xml/Microsoft.Extensions.Caching.Hybrid/HybridCache.xml b/xml/Microsoft.Extensions.Caching.Hybrid/HybridCache.xml index bbf1eea2db8..9f4e2bb3b20 100644 --- a/xml/Microsoft.Extensions.Caching.Hybrid/HybridCache.xml +++ b/xml/Microsoft.Extensions.Caching.Hybrid/HybridCache.xml @@ -24,7 +24,7 @@ - To be added. + Provides multi-tier caching services building on backends. To be added. @@ -215,9 +215,9 @@ To be added. To be added. - To be added. + Asynchronously removes the value associated with the key if it exists. To be added. - To be added. + Implementors should treat as empty. @@ -241,7 +241,7 @@ To be added. To be added. - To be added. + Asynchronously removes the value associated with the key if it exists. To be added. To be added. @@ -267,9 +267,9 @@ To be added. To be added. - To be added. + Asynchronously removes all values associated with the specified tags. To be added. - To be added. + Implementors should treat as empty. @@ -293,7 +293,7 @@ To be added. To be added. - To be added. + Asynchronously removes all values associated with the specified tag. To be added. To be added. diff --git a/xml/Microsoft.Extensions.Caching.Hybrid/HybridCacheEntryFlags.xml b/xml/Microsoft.Extensions.Caching.Hybrid/HybridCacheEntryFlags.xml index a934e43af1b..7fe54797fd7 100644 --- a/xml/Microsoft.Extensions.Caching.Hybrid/HybridCacheEntryFlags.xml +++ b/xml/Microsoft.Extensions.Caching.Hybrid/HybridCacheEntryFlags.xml @@ -19,7 +19,7 @@ - To be added. + Specifies additional flags that apply to a operation. To be added. @@ -40,7 +40,7 @@ 32 - To be added. + Disables compression for this payload. @@ -60,7 +60,7 @@ 12 - To be added. + Disables both reading from and writing to the secondary distributed cache. @@ -80,7 +80,7 @@ 4 - To be added. + Disables reading from the secondary distributed cache. @@ -100,7 +100,7 @@ 8 - To be added. + Disables writing to the secondary distributed cache. @@ -120,7 +120,7 @@ 3 - To be added. + Disables both reading from and writing to the local in-process cache. @@ -140,7 +140,7 @@ 1 - To be added. + Disables reading from the local in-process cache. @@ -160,7 +160,7 @@ 2 - To be added. + Disables writing to the local in-process cache. @@ -180,7 +180,7 @@ 16 - To be added. + Only fetches the value from cache; does not attempt to access the underlying data store. @@ -200,7 +200,7 @@ 0 - To be added. + No additional flags. diff --git a/xml/Microsoft.Extensions.Caching.Hybrid/HybridCacheEntryOptions.xml b/xml/Microsoft.Extensions.Caching.Hybrid/HybridCacheEntryOptions.xml index 36c6818a16e..41d24c286cd 100644 --- a/xml/Microsoft.Extensions.Caching.Hybrid/HybridCacheEntryOptions.xml +++ b/xml/Microsoft.Extensions.Caching.Hybrid/HybridCacheEntryOptions.xml @@ -14,7 +14,12 @@ - To be added. + + Specifies dditional options, such as expiration, that apply to a operation. When options + can be specified at multiple levels (for example, globally and per-call), the values are composed; the + most granular non- value is used, with values being inherited. If no value is specified at + any level, the implementation can choose a reasonable default. + To be added. @@ -51,7 +56,7 @@ System.Nullable<System.TimeSpan> - To be added. + Gets or sets the overall cache duration of this entry, passed to the backend distributed cache. To be added. To be added. @@ -72,7 +77,7 @@ System.Nullable<Microsoft.Extensions.Caching.Hybrid.HybridCacheEntryFlags> - To be added. + Gets or sets additional flags that apply to the requested operation. To be added. To be added. @@ -95,7 +100,10 @@ To be added. To be added. - To be added. + + When retrieving a cached value from an external cache store, this value will be used to calculate the local + cache expiration, not exceeding the remaining overall cache lifetime. + diff --git a/xml/Microsoft.Extensions.Caching.Hybrid/IHybridCacheSerializerFactory.xml b/xml/Microsoft.Extensions.Caching.Hybrid/IHybridCacheSerializerFactory.xml index e07a3746217..cf651fcd636 100644 --- a/xml/Microsoft.Extensions.Caching.Hybrid/IHybridCacheSerializerFactory.xml +++ b/xml/Microsoft.Extensions.Caching.Hybrid/IHybridCacheSerializerFactory.xml @@ -17,7 +17,7 @@ - To be added. + Factory provider for per-type instances. To be added. @@ -54,10 +54,11 @@ - To be added. - To be added. - To be added. - To be added. + The type being serialized/deserialized. + The serializer. + Requests a serializer for the provided type, if possible. + + if the factory supports this type, otherwise. To be added. diff --git a/xml/Microsoft.Extensions.Caching.Hybrid/IHybridCacheSerializer`1.xml b/xml/Microsoft.Extensions.Caching.Hybrid/IHybridCacheSerializer`1.xml index 2bc87bd441f..4fef7c5ed97 100644 --- a/xml/Microsoft.Extensions.Caching.Hybrid/IHybridCacheSerializer`1.xml +++ b/xml/Microsoft.Extensions.Caching.Hybrid/IHybridCacheSerializer`1.xml @@ -21,8 +21,8 @@ - To be added. - To be added. + The type being serialized/deserialized. + Provides per-type serialization and deserialization support for . To be added. @@ -52,7 +52,7 @@ To be added. - To be added. + Deserializes a value from the provided . To be added. To be added. @@ -85,7 +85,7 @@ To be added. To be added. - To be added. + Serializes to the provided . To be added. diff --git a/xml/Microsoft.Extensions.Caching.Memory/CacheExtensions.xml b/xml/Microsoft.Extensions.Caching.Memory/CacheExtensions.xml index 070dcd5aad1..917f94905ac 100644 --- a/xml/Microsoft.Extensions.Caching.Memory/CacheExtensions.xml +++ b/xml/Microsoft.Extensions.Caching.Memory/CacheExtensions.xml @@ -192,13 +192,13 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The type of the object to get. + The instance this method extends. + The key of the entry to look for or create. + The factory that creates the value associated with this key if the key does not exist in the cache. + The options to be applied to the if the key does not exist in the cache. + Gets the value associated with this key if it exists, or generates a new entry using the provided key and a value from the given factory if the key is not found. + The value associated with this key. To be added. @@ -288,13 +288,13 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The type of the object to get. + The instance this method extends. + The key of the entry to look for or create. + The factory task that creates the value associated with this key if the key does not exist in the cache. + The options to be applied to the if the key does not exist in the cache. + Asynchronously gets the value associated with this key if it exists, or generates a new entry using the provided key and a value from the given factory if the key is not found. + The task object representing the asynchronous operation. To be added. diff --git a/xml/Microsoft.Extensions.Caching.Memory/MemoryCache.xml b/xml/Microsoft.Extensions.Caching.Memory/MemoryCache.xml index 5e1fd15685e..ceada2a1972 100644 --- a/xml/Microsoft.Extensions.Caching.Memory/MemoryCache.xml +++ b/xml/Microsoft.Extensions.Caching.Memory/MemoryCache.xml @@ -42,7 +42,7 @@ - An implementation of using a dictionary to + Implements using a dictionary to store its entries. To be added. @@ -323,7 +323,7 @@ System.Collections.Generic.IEnumerable<System.Object> - To be added. + Gets an enumerable of the all the keys in the . To be added. To be added. diff --git a/xml/Microsoft.Extensions.Configuration/ConfigurationManager.xml b/xml/Microsoft.Extensions.Configuration/ConfigurationManager.xml index 3cd4d552c37..a32218a9be9 100644 --- a/xml/Microsoft.Extensions.Configuration/ConfigurationManager.xml +++ b/xml/Microsoft.Extensions.Configuration/ConfigurationManager.xml @@ -51,10 +51,9 @@ - Represents a mutable configuration object. It is both an and an . - As sources are added, it updates its current view of the configuration. Once is called, the configuration is frozen. - It is both an and an . - As sources are added, it updates its current view of configuration. + Represents a mutable configuration object. + It is both an and an . + As sources are added, it updates its current view of configuration. Once is called, the configuration is frozen. @@ -151,7 +150,7 @@ - To be added. + The key of the configuration section. Gets a configuration subsection with the specified key. The configuration section for the specified key. The name of the configuration section is case-insensitive. @@ -189,7 +188,7 @@ The item index. Gets or sets a configuration value. - To be added. + The configuration value. To be added. diff --git a/xml/Microsoft.Extensions.DependencyInjection/ServiceCollection.xml b/xml/Microsoft.Extensions.DependencyInjection/ServiceCollection.xml index 0457a48e5b0..c446fd5dcd0 100644 --- a/xml/Microsoft.Extensions.DependencyInjection/ServiceCollection.xml +++ b/xml/Microsoft.Extensions.DependencyInjection/ServiceCollection.xml @@ -177,7 +177,7 @@ - To be added. + The object to locate in the . Determines whether the contains a specific value. if is found in the ; otherwise, . @@ -220,8 +220,8 @@ - To be added. - To be added. + The one-dimensional that is the destination of the elements copied from . The must have zero-based indexing. + The zero-based index in at which copying begins. Copies the elements of the to an , starting at a particular index. To be added. @@ -259,7 +259,7 @@ Gets the number of elements contained in the . - To be added. + The number of elements contained in the . To be added. @@ -336,7 +336,7 @@ - To be added. + The object to locate in the . Determines the index of a specific item in the . The index of if found in the list; otherwise, -1. To be added. @@ -378,8 +378,8 @@ - To be added. - To be added. + The zero-based index at which should be inserted. + The object to insert into the . Inserts an item to the at the specified index. To be added. @@ -417,7 +417,8 @@ Gets a value indicating whether the is read-only. - To be added. + + if the is read-only; otherwise, . To be added. @@ -456,9 +457,9 @@ - To be added. + The zero-based index of the element to get or set. Gets or sets the element at the specified index. - To be added. + The element at the specified index. To be added. @@ -486,12 +487,12 @@ Makes this collection read-only. - . - + . + ]]> @@ -530,7 +531,7 @@ After the collection is marked as read-only, any further attempt to modify it th - To be added. + The object to remove from the . Removes the first occurrence of a specific object from the . if was successfully removed from the ; otherwise, . This method also returns if is not found in the original . @@ -572,7 +573,7 @@ After the collection is marked as read-only, any further attempt to modify it th - To be added. + The zero-based index of the item to remove. Removes the item at the specified index. To be added. @@ -652,12 +653,12 @@ After the collection is marked as read-only, any further attempt to modify it th Returns an enumerator that iterates through a collection. An object that can be used to iterate through the collection. - instance is cast to an interface. - + instance is cast to an interface. + ]]> diff --git a/xml/Microsoft.Extensions.DependencyInjection/ServiceDescriptor.xml b/xml/Microsoft.Extensions.DependencyInjection/ServiceDescriptor.xml index e61edbc16cb..91265b27ec9 100644 --- a/xml/Microsoft.Extensions.DependencyInjection/ServiceDescriptor.xml +++ b/xml/Microsoft.Extensions.DependencyInjection/ServiceDescriptor.xml @@ -63,7 +63,7 @@ The of the service. The instance implementing the service. - Initializes a new instance of with the specified + Initializes a new instance of with the specified as a . To be added. @@ -269,8 +269,8 @@ The type of the service. A factory to create new instances of the service implementation. The lifetime of the service. - Creates an instance of with the specified - , , + Creates an instance of with the specified + , , and . A new instance of . To be added. @@ -308,8 +308,8 @@ The type of the service. The type of the implementation. The lifetime of the service. - Creates an instance of with the specified - , , + Creates an instance of with the specified + , , and . A new instance of . To be added. @@ -1493,8 +1493,8 @@ The type of the service. A factory to create new instances of the service implementation. - Creates an instance of with the specified - , , + Creates an instance of with the specified + , , and the lifetime. A new instance of . To be added. @@ -1530,8 +1530,8 @@ The type of the service. The type of the implementation. - Creates an instance of with the specified - and + Creates an instance of with the specified + and and the lifetime. A new instance of . To be added. @@ -1566,8 +1566,8 @@ The type of the service. A factory to create new instances of the service implementation. - Creates an instance of with the specified - , , + Creates an instance of with the specified + , , and the lifetime. A new instance of . To be added. @@ -1612,8 +1612,8 @@ The type of the service. The type of the implementation. - Creates an instance of with the specified - , , + Creates an instance of with the specified + , , and the lifetime. A new instance of . To be added. @@ -1655,9 +1655,9 @@ The type of the service. The type of the implementation. A factory to create new instances of the service implementation. - Creates an instance of with the specified - , , - , + Creates an instance of with the specified + , , + , and the lifetime. A new instance of . To be added. @@ -1740,8 +1740,8 @@ The type of the service. A factory to create new instances of the service implementation. - Creates an instance of with the specified - , , + Creates an instance of with the specified + , , and the lifetime. A new instance of . To be added. @@ -1770,8 +1770,8 @@ The type of the service. The instance of the implementation. - Creates an instance of with the specified - , , + Creates an instance of with the specified + , , and the lifetime. A new instance of . To be added. @@ -1807,8 +1807,8 @@ The type of the service. The type of the implementation. - Creates an instance of with the specified - and + Creates an instance of with the specified + and and the lifetime. A new instance of . To be added. @@ -1843,8 +1843,8 @@ The type of the service. A factory to create new instances of the service implementation. - Creates an instance of with the specified - , , + Creates an instance of with the specified + , , and the lifetime. A new instance of . To be added. @@ -1879,8 +1879,8 @@ The type of the service. The instance of the implementation. - Creates an instance of with the specified - , , + Creates an instance of with the specified + , , and the lifetime. A new instance of . To be added. @@ -1925,8 +1925,8 @@ The type of the service. The type of the implementation. - Creates an instance of with the specified - , , + Creates an instance of with the specified + , , and the lifetime. A new instance of . To be added. @@ -1968,9 +1968,9 @@ The type of the service. The type of the implementation. A factory to create new instances of the service implementation. - Creates an instance of with the specified - , , - , + Creates an instance of with the specified + , , + , and the lifetime. A new instance of . To be added. @@ -1994,8 +1994,8 @@ - To be added. - To be added. + Returns a string that represents the current object. + A string that represents the current object. To be added. @@ -2023,8 +2023,8 @@ The type of the service. A factory to create new instances of the service implementation. - Creates an instance of with the specified - , , + Creates an instance of with the specified + , , and the lifetime. A new instance of . To be added. @@ -2060,8 +2060,8 @@ The type of the service. The type of the implementation. - Creates an instance of with the specified - and + Creates an instance of with the specified + and and the lifetime. A new instance of . To be added. @@ -2096,8 +2096,8 @@ The type of the service. A factory to create new instances of the service implementation. - Creates an instance of with the specified - , , + Creates an instance of with the specified + , , and the lifetime. A new instance of . To be added. @@ -2142,8 +2142,8 @@ The type of the service. The type of the implementation. - Creates an instance of with the specified - , , + Creates an instance of with the specified + , , and the lifetime. A new instance of . To be added. @@ -2185,9 +2185,9 @@ The type of the service. The type of the implementation. A factory to create new instances of the service implementation. - Creates an instance of with the specified - , , - , + Creates an instance of with the specified + , , + , and the lifetime. A new instance of . To be added. diff --git a/xml/Microsoft.Extensions.FileProviders.Physical/PhysicalDirectoryInfo.xml b/xml/Microsoft.Extensions.FileProviders.Physical/PhysicalDirectoryInfo.xml index 079c692a39b..5fca27d9a0e 100644 --- a/xml/Microsoft.Extensions.FileProviders.Physical/PhysicalDirectoryInfo.xml +++ b/xml/Microsoft.Extensions.FileProviders.Physical/PhysicalDirectoryInfo.xml @@ -157,6 +157,7 @@ To be added. To be added. To be added. + diff --git a/xml/Microsoft.Extensions.Hosting.WindowsServices/WindowsServiceLifetime.xml b/xml/Microsoft.Extensions.Hosting.WindowsServices/WindowsServiceLifetime.xml index 223d2470c37..606e83832d3 100644 --- a/xml/Microsoft.Extensions.Hosting.WindowsServices/WindowsServiceLifetime.xml +++ b/xml/Microsoft.Extensions.Hosting.WindowsServices/WindowsServiceLifetime.xml @@ -88,12 +88,12 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + Information about the host. + The that tracks the service lifetime. + The used to instantiate the lifetime logger. + The containing options for the service. + The Windows service options used to find the service name. + Initializes a new instance of the class. To be added. @@ -141,8 +141,11 @@ - To be added. - To be added. + Executes when a Shutdown command is sent to the service by the Service Control Manager (SCM). + + Triggers and waits for . + Shortly after this method returns, the Service will be marked as stopped in SCM and the process may exit at any point. + @@ -189,10 +192,11 @@ - Executes when a Stop command is sent to the service by the Service Control Manager (SCM). - Triggers and waits for . - Shortly after this method returns, the Service will be marked as stopped in SCM and the process may exit at any point. - To be added. + Executes when a Stop command is sent to the service by the Service Control Manager (SCM). + + Triggers and waits for . + Shortly after this method returns, the Service will be marked as stopped in SCM and the process may exit at any point. + diff --git a/xml/Microsoft.Extensions.Hosting/Host.xml b/xml/Microsoft.Extensions.Hosting/Host.xml index d13a39e7efd..bed892ef63d 100644 --- a/xml/Microsoft.Extensions.Hosting/Host.xml +++ b/xml/Microsoft.Extensions.Hosting/Host.xml @@ -54,7 +54,7 @@ Initializes a new instance of the class with preconfigured defaults. A new instance. - The following defaults are applied to the returned : + The following defaults are applied to the returned : Set the to the result of .Load host from "DOTNET_" prefixed environment variables.Load host from supplied command line arguments.Load app from 'appsettings.json' and 'appsettings.[].json'.Load app from User Secrets when is 'Development' using the entry assembly.Load app from environment variables.Load app from supplied command line arguments.Configure the to log to the console, debug, and event source output.Enable scope validation on the dependency injection container when is 'Development'. @@ -86,8 +86,8 @@ Controls the initial configuration and other settings for constructing the . - To be added. - To be added. + Initializes a new instance of the class with preconfigured defaults. + A new instance. To be added. @@ -122,8 +122,8 @@ The command line arguments. Initializes a new instance of the class with preconfigured defaults. A new instance. - -The following defaults are applied to the returned : + +The following defaults are applied to the returned : Set the to the result of .Load host from "DOTNET_" prefixed environment variables.Load host from supplied command line arguments.Load app from 'appsettings.json' and 'appsettings.[].json'.Load app from User Secrets when is 'Development' using the entry assembly.Load app from environment variables.Load app from supplied command line arguments.Configure the to log to the console, debug, and event source output.Enable scope validation on the dependency injection container when is 'Development'. @@ -147,7 +147,7 @@ The following defaults are applied to the returned class with preconfigured defaults. The initialized . - The following defaults are applied to the returned : + The following defaults are applied to the returned : Set the to the result of .Load host from "DOTNET_" prefixed environment variables.Load app from 'appsettings.json' and 'appsettings.[].json'.Load app from User Secrets when is 'Development' using the entry assembly.Load app from environment variables.Configure the to log to the console, debug, and event source output.Enable scope validation on the dependency injection container when is 'Development'. @@ -181,7 +181,7 @@ The following defaults are applied to the returned The command line arguments. Initializes a new instance of the class with preconfigured defaults. The initialized . - The following defaults are applied to the returned : + The following defaults are applied to the returned : Set the to the result of .Load host from "DOTNET_" prefixed environment variables.Load host from supplied command line arguments.Load app from 'appsettings.json' and 'appsettings.[].json'.Load app from User Secrets when is 'Development' using the entry assembly.Load app from environment variables.Load app from supplied command line arguments.Configure the to log to the console, debug, and event source output.Enable scope validation on the dependency injection container when is 'Development'. diff --git a/xml/Microsoft.Extensions.Hosting/HostApplicationBuilder.xml b/xml/Microsoft.Extensions.Hosting/HostApplicationBuilder.xml index c2860f16837..8908d53b1b5 100644 --- a/xml/Microsoft.Extensions.Hosting/HostApplicationBuilder.xml +++ b/xml/Microsoft.Extensions.Hosting/HostApplicationBuilder.xml @@ -49,8 +49,8 @@ Initializes a new instance of the class with preconfigured defaults. - The following defaults are applied to the returned : - + The following defaults are applied to the returned : + Set the to the result of .Load host from "DOTNET_" prefixed environment variables.Load host from supplied command line arguments.Load app from 'appsettings.json' and 'appsettings.[].json'.Load app from User Secrets when is 'Development' using the entry assembly.Load app from environment variables.Load app from supplied command line arguments.Configure the to log to the console, debug, and event source output.Enables scope validation on the dependency injection container when is 'Development'. @@ -108,8 +108,8 @@ The command line arguments. Initializes a new instance of the class with preconfigured defaults. - The following defaults are applied to the returned : - + The following defaults are applied to the returned : + Set the to the result of ,Load host from "DOTNET_" prefixed environment variables,Load host from supplied command line arguments.Load app from 'appsettings.json' and 'appsettings.[].json'.Load app from User Secrets when is 'Development' using the entry assembly.Load app from environment variables.Load app from supplied command line arguments.Configure the to log to the console, debug, and event source output.Enable scope validation on the dependency injection container when is 'Development'. @@ -196,14 +196,14 @@ A delegate used to configure the . This delegate can be used to configure services using APIs that are specific to the implementation. Registers a instance to be used to create the . - , and so the delegate specified by `configure` will run after all other services have been registered. - -If you call this method multiple times, the previously stored `factory` and `configure` delegates will be replaced. - + , and so the delegate specified by `configure` will run after all other services have been registered. + +If you call this method multiple times, the previously stored `factory` and `configure` delegates are replaced. + ]]> @@ -281,7 +281,7 @@ If you call this method multiple times, the previously stored `factory` and `con Microsoft.Extensions.Diagnostics.Metrics.IMetricsBuilder - To be added. + Allows enabling metrics and directing their output. To be added. To be added. diff --git a/xml/Microsoft.Extensions.Hosting/SystemdHostBuilderExtensions.xml b/xml/Microsoft.Extensions.Hosting/SystemdHostBuilderExtensions.xml index 178e9c88380..825480bce8f 100644 --- a/xml/Microsoft.Extensions.Hosting/SystemdHostBuilderExtensions.xml +++ b/xml/Microsoft.Extensions.Hosting/SystemdHostBuilderExtensions.xml @@ -51,10 +51,25 @@ - To be added. - To be added. - To be added. - To be added. + + The used to build the . + For example, or the passed to the + + callback. + + + Configures the lifetime of the built from to + + , provides notification messages for application started + and stopping, and configures console logging to the systemd format. + + The instance for chaining. + + This is context aware and will only activate if it detects the process is running + as a systemd Service. + The systemd service file must be configured with Type=notify to enable + notifications. See . + diff --git a/xml/Microsoft.Extensions.Hosting/WindowsServiceLifetimeHostBuilderExtensions.xml b/xml/Microsoft.Extensions.Hosting/WindowsServiceLifetimeHostBuilderExtensions.xml index dd333183ffe..00583757ce1 100644 --- a/xml/Microsoft.Extensions.Hosting/WindowsServiceLifetimeHostBuilderExtensions.xml +++ b/xml/Microsoft.Extensions.Hosting/WindowsServiceLifetimeHostBuilderExtensions.xml @@ -51,10 +51,23 @@ - To be added. - To be added. - To be added. - To be added. + + The used to build the . + For example, or the passed to the + + callback. + + + Configures the lifetime of the built from to + + and enables logging to the event log with the application + name as the default source name. + + The instance for chaining. + + This is context aware and will only activate if it detects the process is running + as a Windows Service. + @@ -78,11 +91,23 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + + The used to build the . + For example, or the passed to the + + callback. + + An to configure the provided . + + Configures the lifetime of the built from to + + and enables logging to the event log with the application name as the default source name. + + The instance for chaining. + + This is context aware and will only activate if it detects the process is running + as a Windows Service. + @@ -133,11 +158,17 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The to operate on. + An to configure the provided . + + Sets the host lifetime to and enables logging to the event log with the application + name as the default source name. + + The instance for chaining. + + This is context aware and will only activate if it detects the process is running + as a Windows Service. + diff --git a/xml/Microsoft.Extensions.Hosting/WindowsServiceLifetimeOptions.xml b/xml/Microsoft.Extensions.Hosting/WindowsServiceLifetimeOptions.xml index 7b401b896b8..cb19564646c 100644 --- a/xml/Microsoft.Extensions.Hosting/WindowsServiceLifetimeOptions.xml +++ b/xml/Microsoft.Extensions.Hosting/WindowsServiceLifetimeOptions.xml @@ -25,7 +25,7 @@ - To be added. + Specifies options to configure the lifetime of a Windows service. To be added. @@ -64,7 +64,7 @@ System.String - To be added. + The name used to identify the service to the system. To be added. To be added. diff --git a/xml/Microsoft.Extensions.Http.Logging/LoggingHttpMessageHandler.xml b/xml/Microsoft.Extensions.Http.Logging/LoggingHttpMessageHandler.xml index 5cd2ee4df99..e223d1abe9b 100644 --- a/xml/Microsoft.Extensions.Http.Logging/LoggingHttpMessageHandler.xml +++ b/xml/Microsoft.Extensions.Http.Logging/LoggingHttpMessageHandler.xml @@ -107,10 +107,10 @@ - To be added. - To be added. - To be added. - To be added. + The HTTP request message to send to the server. + A cancellation token to cancel the operation. + Sends an HTTP request to the inner handler to send to the server. + An HTTP response message. Logs the request to and response from the sent . The cancellation token was canceled. This exception is stored into the returned task. @@ -137,17 +137,17 @@ - To be added. - To be added. - To be added. - To be added. + The HTTP request message to send to the server. + A cancellation token to cancel the operation. + Sends an HTTP request to the inner handler to send to the server as an asynchronous operation. + The task object representing the asynchronous operation. - . - + . + ]]> diff --git a/xml/Microsoft.Extensions.Http.Logging/LoggingScopeHttpMessageHandler.xml b/xml/Microsoft.Extensions.Http.Logging/LoggingScopeHttpMessageHandler.xml index c403241e00b..810999005cd 100644 --- a/xml/Microsoft.Extensions.Http.Logging/LoggingScopeHttpMessageHandler.xml +++ b/xml/Microsoft.Extensions.Http.Logging/LoggingScopeHttpMessageHandler.xml @@ -107,10 +107,10 @@ - To be added. - To be added. - To be added. - To be added. + The HTTP request message to send to the server. + A cancellation token to cancel the operation. + Sends an HTTP request to the inner handler to send to the server. + An HTTP response message. Logs the request to and response from the sent . The cancellation token was canceled. This exception is stored into the returned task. @@ -137,17 +137,17 @@ - To be added. - To be added. - To be added. - To be added. + The HTTP request message to send to the server. + A cancellation token to cancel the operation. + Sends an HTTP request to the inner handler to send to the server as an asynchronous operation. + The task object representing the asynchronous operation. - . - + . + ]]> diff --git a/xml/Microsoft.Extensions.Logging.Abstractions/NullLogger.xml b/xml/Microsoft.Extensions.Logging.Abstractions/NullLogger.xml index 05b30bed577..1a6d9a643ee 100644 --- a/xml/Microsoft.Extensions.Logging.Abstractions/NullLogger.xml +++ b/xml/Microsoft.Extensions.Logging.Abstractions/NullLogger.xml @@ -68,7 +68,7 @@ - To be added. + The type of the state to begin scope for. The identifier for the scope. Begins a logical operation scope. A disposable object that ends the logical operation scope on dispose. @@ -179,7 +179,7 @@ - To be added. + The type of the object to be written. Entry will be written on this level. Id of the event. The entry to be written. Can be also an object. diff --git a/xml/Microsoft.Extensions.Logging.Abstractions/NullLogger`1.xml b/xml/Microsoft.Extensions.Logging.Abstractions/NullLogger`1.xml index 8f43ad387a1..258fe32ddeb 100644 --- a/xml/Microsoft.Extensions.Logging.Abstractions/NullLogger`1.xml +++ b/xml/Microsoft.Extensions.Logging.Abstractions/NullLogger`1.xml @@ -95,7 +95,7 @@ - To be added. + The type of the state to begin scope for. The identifier for the scope. Begins a logical operation scope. A disposable object that ends the logical operation scope on dispose. @@ -211,7 +211,7 @@ - To be added. + The type of the object to be written. Entry will be written on this level. Id of the event. The entry to be written. Can be also an object. diff --git a/xml/Microsoft.Extensions.Logging.Configuration/LoggerProviderOptionsChangeTokenSource`2.xml b/xml/Microsoft.Extensions.Logging.Configuration/LoggerProviderOptionsChangeTokenSource`2.xml index d1f6d5d5155..9cd774ec387 100644 --- a/xml/Microsoft.Extensions.Logging.Configuration/LoggerProviderOptionsChangeTokenSource`2.xml +++ b/xml/Microsoft.Extensions.Logging.Configuration/LoggerProviderOptionsChangeTokenSource`2.xml @@ -41,7 +41,10 @@ To be added. To be added. - To be added. + + Creates s so that gets + notified when changes. + To be added. diff --git a/xml/Microsoft.Extensions.Logging.Console/ConsoleLoggerSettings.xml b/xml/Microsoft.Extensions.Logging.Console/ConsoleLoggerSettings.xml index 74cdf514361..579167fade7 100644 --- a/xml/Microsoft.Extensions.Logging.Console/ConsoleLoggerSettings.xml +++ b/xml/Microsoft.Extensions.Logging.Console/ConsoleLoggerSettings.xml @@ -95,7 +95,7 @@ Microsoft.Extensions.Primitives.IChangeToken - To be added. + This property is retained only for compatibility. To be added. To be added. @@ -140,7 +140,7 @@ System.Boolean - To be added. + This property is retained only for compatibility. To be added. To be added. @@ -167,8 +167,8 @@ - To be added. - To be added. + This method is retained only for compatibility. + This method is retained only for compatibility. To be added. @@ -219,10 +219,10 @@ - To be added. - To be added. - To be added. - To be added. + This method is retained only for compatibility. + This method is retained only for compatibility. + This method is retained only for compatibility. + This method is retained only for compatibility. To be added. diff --git a/xml/Microsoft.Extensions.Logging.EventSource/LoggingEventSource.xml b/xml/Microsoft.Extensions.Logging.EventSource/LoggingEventSource.xml index 64feeab3415..047474e5a37 100644 --- a/xml/Microsoft.Extensions.Logging.EventSource/LoggingEventSource.xml +++ b/xml/Microsoft.Extensions.Logging.EventSource/LoggingEventSource.xml @@ -36,75 +36,75 @@ The LoggingEventSource is the bridge from all ILogger based logging to EventSource/EventListener logging. - diff --git a/xml/Microsoft.Extensions.Logging/EventId.xml b/xml/Microsoft.Extensions.Logging/EventId.xml index 62a1ee9018e..199e3e44173 100644 --- a/xml/Microsoft.Extensions.Logging/EventId.xml +++ b/xml/Microsoft.Extensions.Logging/EventId.xml @@ -127,9 +127,10 @@ - To be added. - To be added. - To be added. + The object to compare with the current instance. + Determines whether this instance and a specified object are equal. + + if and this instance are the same type and represent the same value; otherwise, . To be added. @@ -152,8 +153,8 @@ - To be added. - To be added. + Returns the hash code for this instance. + A 32-bit signed integer that is the hash code for this instance. To be added. @@ -310,8 +311,8 @@ - To be added. - To be added. + Returns the fully qualified type name of this instance. + The fully qualified type name. To be added. diff --git a/xml/Microsoft.Extensions.Logging/LoggerExternalScopeProvider.xml b/xml/Microsoft.Extensions.Logging/LoggerExternalScopeProvider.xml index b5f93eff21d..c4b4480122c 100644 --- a/xml/Microsoft.Extensions.Logging/LoggerExternalScopeProvider.xml +++ b/xml/Microsoft.Extensions.Logging/LoggerExternalScopeProvider.xml @@ -95,10 +95,10 @@ - To be added. + The type of state to accept. The callback to be executed for every scope object. The state object to be passed into the callback. - Executes callback for each currently active scope objects in order of creation. + Executes callback for each currently active scope objects in order of creation. All callbacks are guaranteed to be called inline from this method. To be added. diff --git a/xml/Microsoft.Extensions.Logging/LoggerFilterRule.xml b/xml/Microsoft.Extensions.Logging/LoggerFilterRule.xml index 21104c3290f..d81cf0647db 100644 --- a/xml/Microsoft.Extensions.Logging/LoggerFilterRule.xml +++ b/xml/Microsoft.Extensions.Logging/LoggerFilterRule.xml @@ -177,8 +177,8 @@ - To be added. - To be added. + Returns a string that represents the current object. + A string that represents the current object. To be added. diff --git a/xml/Microsoft.Extensions.Logging/Logger`1.xml b/xml/Microsoft.Extensions.Logging/Logger`1.xml index 469a0af5814..aca12ec7e86 100644 --- a/xml/Microsoft.Extensions.Logging/Logger`1.xml +++ b/xml/Microsoft.Extensions.Logging/Logger`1.xml @@ -49,7 +49,7 @@ The type. - Delegates to a new instance using the full name of the given type, created by the + Delegates to a new instance using the full name of the given type, created by the provided . To be added. @@ -108,7 +108,7 @@ - To be added. + The type of the state to begin scope for. The identifier for the scope. Begins a logical operation scope. A disposable object that ends the logical operation scope on dispose. @@ -177,7 +177,7 @@ - To be added. + The type of the object to be written. Entry will be written on this level. Id of the event. The entry to be written. Can be also an object. From 9ed6ee3976a7fcc7a7ad6063b5a5401c359f21b4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Carlos=20S=C3=A1nchez=20L=C3=B3pez?= <1175054+carlossanlop@users.noreply.github.com> Date: Mon, 12 Aug 2024 22:24:40 -0700 Subject: [PATCH 8/8] System.ComponentModel (#10214) --- .../ComponentResourceManager.xml | 8 ++++- .../CustomTypeDescriptor.xml | 30 +++++++++++++++--- .../ICustomTypeDescriptor.xml | 24 +++++++++++--- .../PropertyDescriptor.xml | 2 +- .../TypeDescriptionProvider.xml | 31 +++++++++++-------- xml/System.ComponentModel/TypeDescriptor.xml | 14 ++++----- 6 files changed, 77 insertions(+), 32 deletions(-) diff --git a/xml/System.ComponentModel/ComponentResourceManager.xml b/xml/System.ComponentModel/ComponentResourceManager.xml index 0933741c053..02dfecc38a1 100644 --- a/xml/System.ComponentModel/ComponentResourceManager.xml +++ b/xml/System.ComponentModel/ComponentResourceManager.xml @@ -352,7 +352,13 @@ To be added. To be added. To be added. - To be added. + + Examines all the resources for the provided culture. + When it finds a resource with a key in the format of + "[objectName].[property name]" or "[objectName]-[property name]" it will apply that resource's value + to the corresponding property on the object. If there is no matching + property the resource will be ignored. + To be added. diff --git a/xml/System.ComponentModel/CustomTypeDescriptor.xml b/xml/System.ComponentModel/CustomTypeDescriptor.xml index 1632c131e1c..63d9995fde2 100644 --- a/xml/System.ComponentModel/CustomTypeDescriptor.xml +++ b/xml/System.ComponentModel/CustomTypeDescriptor.xml @@ -486,7 +486,10 @@ - To be added. + + Returns a type converter for the type this type + descriptor is representing. + To be added. To be added. @@ -874,7 +877,10 @@ - To be added. + + Returns a collection of event descriptors + for the object this type descriptor is representing. + To be added. To be added. @@ -1068,7 +1074,10 @@ - To be added. + + Returns a collection of property descriptors + for the object this type descriptor is representing. + To be added. To be added. @@ -1161,9 +1170,20 @@ System.Nullable<System.Boolean> - To be added. + Gets a value that indicates whether types are required to be registered through . To be added. - To be added. + + The default value is which means that the type descriptor has not declared whether or not it is compatible registered types. + A type descriptor needs to implement this to return or if the feature switch + 'System.ComponentModel.TypeDescriptor.RequireRegisteredTypes' is enabled. + If is returned, then the type descriptor must also implement + + , + + , and + + . + diff --git a/xml/System.ComponentModel/ICustomTypeDescriptor.xml b/xml/System.ComponentModel/ICustomTypeDescriptor.xml index 21710b6ef24..4cd0123b456 100644 --- a/xml/System.ComponentModel/ICustomTypeDescriptor.xml +++ b/xml/System.ComponentModel/ICustomTypeDescriptor.xml @@ -332,7 +332,7 @@ - To be added. + Gets a type converter for this object that may be registered. To be added. To be added. @@ -678,7 +678,7 @@ - To be added. + Gets the events for this instance of a component that may be registered. To be added. To be added. @@ -856,7 +856,7 @@ - To be added. + Gets the properties for this instance of a component that may be registered. To be added. To be added. @@ -952,9 +952,23 @@ pd.GetValue(GetPropertyOwner(myPd)); System.Nullable<System.Boolean> - To be added. + Gets a value that indicates whether types are required to be registered through . To be added. - To be added. + + The default value is which means that the type descriptor has not declared whether or not it is compatible registered types. + A type descriptor needs to implement this to return either or if the feature switch + 'System.ComponentModel.TypeDescriptor.RequireRegisteredTypes' is enabled. + If is returned, then the type descriptor must also implement + + , + + , and + + . + +
+ + diff --git a/xml/System.ComponentModel/PropertyDescriptor.xml b/xml/System.ComponentModel/PropertyDescriptor.xml index a02006b3f10..158c03a4389 100644 --- a/xml/System.ComponentModel/PropertyDescriptor.xml +++ b/xml/System.ComponentModel/PropertyDescriptor.xml @@ -524,7 +524,7 @@ System.ComponentModel.TypeConverter - To be added. + Gets the type converter for this property. To be added. To be added. diff --git a/xml/System.ComponentModel/TypeDescriptionProvider.xml b/xml/System.ComponentModel/TypeDescriptionProvider.xml index 9e5f479c2dd..14bf4f656d7 100644 --- a/xml/System.ComponentModel/TypeDescriptionProvider.xml +++ b/xml/System.ComponentModel/TypeDescriptionProvider.xml @@ -438,9 +438,9 @@ To be added. - To be added. + Returns an extended custom type descriptor for the given object. To be added. - To be added. + 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. @@ -1036,9 +1036,9 @@ To be added. - To be added. + Returns a custom type descriptor for the given type or object. To be added. - To be added. + The objectType parameter is always valid, but the instance parameter may be 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. @@ -1073,9 +1073,9 @@ To be added. - To be added. + Returns a custom type descriptor for the given type or object. To be added. - To be added. + The objectType parameter is always valid, but the instance parameter may be 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. @@ -1119,9 +1119,12 @@ To be added. To be added. - To be added. + Returns a custom type descriptor for the given type or object. To be added. - To be added. + + The objectType parameter is always valid, but the instance parameter may be 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. + 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. + @@ -1150,9 +1153,11 @@ To be added. - To be added. + Determines whether the type was registered with its provider through . To be added. To be added. + + is . @@ -1240,8 +1245,8 @@ - To be added. - To be added. + The type to register. + Registers the type so it can be used by reflection-based providers in trimmed applications. To be added. @@ -1267,9 +1272,9 @@ System.Nullable<System.Boolean> - To be added. + Gets a value that indicates whether the provider uses reflection and requires types to be registered through to support trimmed applications. To be added. - To be added. + For backwards compatibility, this is typically only enforced when calling members that have "FromRegisteredType" suffix. diff --git a/xml/System.ComponentModel/TypeDescriptor.xml b/xml/System.ComponentModel/TypeDescriptor.xml index 594109ee2fb..de18cf252d8 100644 --- a/xml/System.ComponentModel/TypeDescriptor.xml +++ b/xml/System.ComponentModel/TypeDescriptor.xml @@ -2222,7 +2222,7 @@ To be added. - To be added. + Gets a type converter for the type of the specified component. To be added. To be added. @@ -2253,7 +2253,7 @@ To be added. - To be added. + Gets a type converter for the specified registered type. To be added. To be added. @@ -3511,7 +3511,7 @@ To be added. - To be added. + Gets a collection of events for a specified type of component. To be added. To be added. @@ -4164,7 +4164,7 @@ To be added. - To be added. + Gets a collection of properties for a specified component. To be added. To be added. @@ -4195,7 +4195,7 @@ To be added. - To be added. + Gets a collection of properties for a specified type. To be added. To be added. @@ -4906,8 +4906,8 @@ - To be added. - To be added. + The type to register. + Registers the type so it can be used by reflection-based providers in trimmed applications. To be added.