From 748d149fece87d5fde776a9bfc80d2eb0e4e1bb8 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Fri, 29 May 2026 14:44:56 -0700 Subject: [PATCH 1/3] Remove .NET Framework remarks --- .../DomainMode.xml | 2 +- .../ForestMode.xml | 2 +- .../DirectoryEntry.xml | 11 +- xml/System.Drawing.Design/UITypeEditor.xml | 18 - xml/System.Drawing.Imaging/Metafile.xml | 2 +- .../PrintController.xml | 4 +- .../PrintingPermission.xml | 45 +-- .../PrintingPermissionAttribute.xml | 6 +- xml/System.Drawing/Bitmap.xml | 5 - xml/System.Drawing/BufferedGraphics.xml | 2 +- .../BufferedGraphicsContext.xml | 12 +- .../BufferedGraphicsManager.xml | 8 +- xml/System.Drawing/Graphics.xml | 2 +- xml/System.Drawing/Image.xml | 4 +- xml/System.Drawing/StringUnit.xml | 9 +- xml/System.Formats.Asn1/AsnDecoder.xml | 318 +++++++++--------- xml/System.Formats.Asn1/AsnReader.xml | 314 +++++++++-------- xml/System.Formats.Asn1/AsnWriter.xml | 80 +++-- xml/System.Formats.Asn1/ValueAsnReader.xml | 314 +++++++++-------- 19 files changed, 533 insertions(+), 625 deletions(-) diff --git a/xml/System.DirectoryServices.ActiveDirectory/DomainMode.xml b/xml/System.DirectoryServices.ActiveDirectory/DomainMode.xml index 591e32f33c9..a547542d017 100644 --- a/xml/System.DirectoryServices.ActiveDirectory/DomainMode.xml +++ b/xml/System.DirectoryServices.ActiveDirectory/DomainMode.xml @@ -212,7 +212,7 @@ 7 - [Supported in the .NET Framework 4.5.1 and later versions] The domain is operating in Windows Server 2012 R2 mode. + The domain is operating in Windows Server 2012 R2 mode. diff --git a/xml/System.DirectoryServices.ActiveDirectory/ForestMode.xml b/xml/System.DirectoryServices.ActiveDirectory/ForestMode.xml index 750c92a9ce1..893549279e3 100644 --- a/xml/System.DirectoryServices.ActiveDirectory/ForestMode.xml +++ b/xml/System.DirectoryServices.ActiveDirectory/ForestMode.xml @@ -189,7 +189,7 @@ 6 - [Supported in the .NET Framework 4.5.1 and later versions] The is operating in Windows Server 2012 R2 mode. + The is operating in Windows Server 2012 R2 mode. diff --git a/xml/System.DirectoryServices/DirectoryEntry.xml b/xml/System.DirectoryServices/DirectoryEntry.xml index 6e8e5875be7..826c2f59b5f 100644 --- a/xml/System.DirectoryServices/DirectoryEntry.xml +++ b/xml/System.DirectoryServices/DirectoryEntry.xml @@ -290,15 +290,8 @@ public class PrintChildren{ Gets or sets the type of authentication to use. - One of the values. - - . Beginning with .NET Framework 2.0, the default value is . - - ]]> - + One of the values. The default is . + To be added. diff --git a/xml/System.Drawing.Design/UITypeEditor.xml b/xml/System.Drawing.Design/UITypeEditor.xml index 556ed7c051f..de39074e883 100644 --- a/xml/System.Drawing.Design/UITypeEditor.xml +++ b/xml/System.Drawing.Design/UITypeEditor.xml @@ -493,15 +493,6 @@ ## Remarks Editors should paint within the boundaries of the specified rectangle. This rectangle indicates the area of the Properties window to draw a representation of the value within. - Starting with the .NET Framework 4.6, the rectangle specified by will be resized based on the system DPI setting when the app.config file contains the following entry: - -``` - - - - -``` - ]]> @@ -559,15 +550,6 @@ ## Remarks Editors should paint within the boundaries of the specified rectangle. This rectangle indicates the area of the Properties window to draw a representation of the value within. - Starting with the .NET Framework 4.6, the rectangle specified by will be resized based on the system DPI setting when the app.config file contains the following entry: - -``` - - - - -``` - ]]> diff --git a/xml/System.Drawing.Imaging/Metafile.xml b/xml/System.Drawing.Imaging/Metafile.xml index 21599972c96..32228f84324 100644 --- a/xml/System.Drawing.Imaging/Metafile.xml +++ b/xml/System.Drawing.Imaging/Metafile.xml @@ -57,7 +57,7 @@ method to save a graphic image as a Windows Metafile Format (WMF) or Enhanced Metafile Format (EMF) file, the resulting file is saved as a Portable Network Graphics (PNG) file instead. This behavior occurs because the GDI+ component of the .NET Framework does not have an encoder that you can use to save files as .wmf or .emf files. + When you use the method to save a graphic image as a Windows Metafile Format (WMF) or Enhanced Metafile Format (EMF) file, the resulting file is saved as a Portable Network Graphics (PNG) file instead. This behavior occurs because the GDI+ component of .NET does not have an encoder that you can use to save files as .wmf or .emf files. [!INCLUDE[System.Drawing.Common note](~/includes/system-drawing-common.md)] diff --git a/xml/System.Drawing.Printing/PrintController.xml b/xml/System.Drawing.Printing/PrintController.xml index 4c64030c2e0..f8544897bc8 100644 --- a/xml/System.Drawing.Printing/PrintController.xml +++ b/xml/System.Drawing.Printing/PrintController.xml @@ -51,9 +51,9 @@ is used by , and not typically used directly. - The .NET Framework includes three print controllers that are derived from that help accomplish common tasks. The prints a document to a printer. The generates a preview of what the document will look like when printed and is used by the and classes. The provides a printing status dialog during the printing process. +.NET includes three print controllers that are derived from that help accomplish common tasks. The prints a document to a printer. The generates a preview of what the document will look like when printed and is used by the and classes. The provides a printing status dialog during the printing process. - For more information about printing with Windows Forms, see the namespace overview. If you wish to print from a Windows Presentation Foundation application, see the namespace. + For more information about printing with Windows Forms, see the namespace overview. If you want to print from a Windows Presentation Foundation application, see the namespace. ]]> diff --git a/xml/System.Drawing.Printing/PrintingPermission.xml b/xml/System.Drawing.Printing/PrintingPermission.xml index 582205e36e6..acd3e6d2990 100644 --- a/xml/System.Drawing.Printing/PrintingPermission.xml +++ b/xml/System.Drawing.Printing/PrintingPermission.xml @@ -131,14 +131,7 @@ One of the values. Initializes a new instance of the class with either fully restricted or unrestricted access, as specified. - - - + To be added. is not a valid . @@ -176,14 +169,7 @@ Creates and returns an identical copy of the current permission object. A copy of the current permission object. - - - + To be added. @@ -260,14 +246,7 @@ A permission object of the same type as the current permission object. Creates and returns a permission that is the intersection of the current permission object and a target permission object. A new permission object that represents the intersection of the current object and the specified target. This object is if the intersection is empty. - - - + To be added. is an object that is not of the same type as the current permission object. @@ -352,14 +331,7 @@ Gets a value indicating whether the permission is unrestricted. if permission is unrestricted; otherwise, . - - - + To be added. @@ -470,14 +442,7 @@ A permission object of the same type as the current permission object. Creates a permission that combines the permission object and the target permission object. A new permission object that represents the union of the current permission object and the specified permission object. - - is a permission that represents all the operations represented by the current permission object, and all the operations represented by the specified permission object. - - ]]> - + To be added. is an object that is not of the same type as the current permission object. diff --git a/xml/System.Drawing.Printing/PrintingPermissionAttribute.xml b/xml/System.Drawing.Printing/PrintingPermissionAttribute.xml index 4ca26c38979..e868c3407bc 100644 --- a/xml/System.Drawing.Printing/PrintingPermissionAttribute.xml +++ b/xml/System.Drawing.Printing/PrintingPermissionAttribute.xml @@ -44,14 +44,12 @@ Allows declarative printing permission checks. - diff --git a/xml/System.Drawing/Bitmap.xml b/xml/System.Drawing/Bitmap.xml index 881fa041f3f..2aa64e1ce44 100644 --- a/xml/System.Drawing/Bitmap.xml +++ b/xml/System.Drawing/Bitmap.xml @@ -63,11 +63,6 @@ [!INCLUDE[System.Drawing.Common note](~/includes/system-drawing-common.md)] -> [!NOTE] -> The class is not accessible across application domains. For example, if you create a dynamic and create several brushes, pens, and bitmaps in that domain, then pass these objects back to the main application domain, you can successfully use the pens and brushes. However, if you call the method to draw the marshaled , you receive the following exception: -> -> **Remoting cannot find field "native image" on type "System.Drawing.Image".** - ## Examples The following code example demonstrates how to construct a new from a file, using the and methods to recolor the image. It also uses the , , and properties. diff --git a/xml/System.Drawing/BufferedGraphics.xml b/xml/System.Drawing/BufferedGraphics.xml index 2cb7daeff20..ea5447151a7 100644 --- a/xml/System.Drawing/BufferedGraphics.xml +++ b/xml/System.Drawing/BufferedGraphics.xml @@ -56,7 +56,7 @@ > [!NOTE] > The simplest way to use double buffering is to set the control style flag on a control using the method. Setting the flag for a control redirects all painting for the control through a default graphics buffer, without requiring any additional code. This flag is set to `true` by default. - The class has no public constructor and must be created by the for an application domain using its method. You can retrieve the for the current application domain from the static property. + The class has no public constructor and must be created by the using its method. You can retrieve the from the static property. The property can be used for drawing to the graphics buffer. This property provides access to the object that draws to the graphics buffer allocated for this object. diff --git a/xml/System.Drawing/BufferedGraphicsContext.xml b/xml/System.Drawing/BufferedGraphicsContext.xml index 384d95268c5..3fbbd9b7ad2 100644 --- a/xml/System.Drawing/BufferedGraphicsContext.xml +++ b/xml/System.Drawing/BufferedGraphicsContext.xml @@ -56,12 +56,12 @@ The class provides methods for creating and configuring a graphics buffer. The method creates a , which is a wrapper for a graphics buffer that also provides methods you can use to write to the buffer and render its contents to an output device. - You can retrieve the for the current application domain from the static property. For graphically intensive applications such as animation, you can create a dedicated using the constructor, but for most applications the property will be sufficient. + You can retrieve the from the static property. For graphically intensive applications such as animation, you can create a dedicated using the constructor, but for most applications the property will be sufficient. For more information on drawing buffered graphics and custom buffering implementations, see [Double Buffered Graphics](/dotnet/desktop/winforms/advanced/double-buffered-graphics) and [How to: Manually Manage Buffered Graphics](/dotnet/desktop/winforms/advanced/how-to-manually-manage-buffered-graphics). ## Examples - The following code example demonstrates how to acquire the for the current application domain. This code is part of a larger example provided for the class. + The following code example demonstrates how to acquire the . This code is part of a larger example provided for the class. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/BufferingExamples/CPP/bufferingexamples.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/BufferedGraphics/Render/bufferingexamples.cs" id="Snippet1"::: @@ -169,9 +169,7 @@ method with a rectangle whose size exceeds the value of the property, a temporary is created to allocate the buffer and provide a temporary context for the buffer. The new is distinct from the for the application domain and it is disposed automatically when the returned by the method is disposed. - - + When you call the method with a rectangle whose size exceeds the value of the property, a temporary is created to allocate the buffer and provide a temporary context for the buffer. The new is distinct from the and it is disposed automatically when the returned by the method is disposed. ## Examples The following code example demonstrates creating a graphics buffer using the method. This code is part of a larger example provided for the class. @@ -229,9 +227,7 @@ method with a rectangle whose size exceeds the value of the property, a temporary is created to allocate the buffer and provide a temporary context for the buffer. The new is distinct from the for the application domain and it is disposed automatically when the returned by the method is disposed. - - + When you call the method with a rectangle whose size exceeds the value of the property, a temporary is created to allocate the buffer and provide a temporary context for the buffer. The new is distinct from the and it is disposed automatically when the returned by the method is disposed. ## Examples The following code example demonstrates creating a graphics buffer using the method. This code is part of a larger example provided for the class. diff --git a/xml/System.Drawing/BufferedGraphicsManager.xml b/xml/System.Drawing/BufferedGraphicsManager.xml index 394740269b0..a4b3d8d9b9d 100644 --- a/xml/System.Drawing/BufferedGraphicsManager.xml +++ b/xml/System.Drawing/BufferedGraphicsManager.xml @@ -48,12 +48,10 @@ This class has one static property, , which returns the main for the current application domain. The class creates instances that can be used to draw buffered graphics. - The class has no public constructor and must be created by the object for an application domain using its method. You can retrieve the object for the current application domain from the static property. + The class has no public constructor and must be created by the object using its method. You can retrieve the object from the static property. For more information on double buffering, see [Double Buffered Graphics](/dotnet/desktop/winforms/advanced/double-buffered-graphics), , and . - - ## Examples The following code example demonstrates acquiring the for the current application domain. @@ -103,9 +101,7 @@ property always returns the same object. - - + Within an application, the property always returns the same object. ## Examples The following code example demonstrates acquiring the for the current application domain. diff --git a/xml/System.Drawing/Graphics.xml b/xml/System.Drawing/Graphics.xml index 2909603c9b1..e743a0b6ff9 100644 --- a/xml/System.Drawing/Graphics.xml +++ b/xml/System.Drawing/Graphics.xml @@ -19546,7 +19546,7 @@ The object has a transform applied othe property represents the world transformation, which maps world coordinates to page coordinates. + GDI+ uses three coordinate spaces: world, page, and device. World coordinates are the coordinates used to model a particular graphic world and are the coordinates you pass to methods in .NET. Page coordinates refer to the coordinate system used by a drawing surface, such as a form or a control. Device coordinates are the coordinates used by the physical device being drawn on, such as a screen or a printer. The property represents the world transformation, which maps world coordinates to page coordinates. Because the matrix returned and by the property is a copy of the geometric transform, you should dispose of the matrix when you no longer need it. diff --git a/xml/System.Drawing/Image.xml b/xml/System.Drawing/Image.xml index 904412f0ae8..e592354f171 100644 --- a/xml/System.Drawing/Image.xml +++ b/xml/System.Drawing/Image.xml @@ -1852,12 +1852,10 @@ method to save a graphic image as a Windows Metafile Format (WMF) or Enhanced Metafile Format (EMF) file, the resulting file is saved as a Portable Network Graphics (PNG) file. This behavior occurs because the GDI+ component of the .NET Framework does not have an encoder that you can use to save files as .wmf or .emf files. + If no encoder exists for the file format of the image, the Portable Network Graphics (PNG) encoder is used. When you use the method to save a graphic image as a Windows Metafile Format (WMF) or Enhanced Metafile Format (EMF) file, the resulting file is saved as a Portable Network Graphics (PNG) file. This behavior occurs because the GDI+ component of .NET does not have an encoder that you can use to save files as .wmf or .emf files. Saving the image to the same file it was constructed from is not allowed and throws an exception. - - ## Examples The following code example demonstrates how to call the method. This example is designed to be used with Windows Forms. Create a form that contains a button named `Button5`. Paste the code into the form, and associate the method with the button's event. diff --git a/xml/System.Drawing/StringUnit.xml b/xml/System.Drawing/StringUnit.xml index 04f7ddd67bc..0125508629f 100644 --- a/xml/System.Drawing/StringUnit.xml +++ b/xml/System.Drawing/StringUnit.xml @@ -33,14 +33,7 @@ Specifies the units of measure for a text string. - - - + To be added. diff --git a/xml/System.Formats.Asn1/AsnDecoder.xml b/xml/System.Formats.Asn1/AsnDecoder.xml index bda8095c0dd..f86a8e954bc 100644 --- a/xml/System.Formats.Asn1/AsnDecoder.xml +++ b/xml/System.Formats.Asn1/AsnDecoder.xml @@ -22,9 +22,7 @@ - - Provides stateless methods for decoding BER-encoded, CER-encoded, and DER-encoded ASN.1 data. - + Provides stateless methods for decoding BER-encoded, CER-encoded, and DER-encoded ASN.1 data. To be added. @@ -144,13 +142,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -211,13 +209,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -287,24 +285,24 @@ is not defined. - + -or- - + is not a known character string type. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The string did not successfully decode. @@ -439,13 +437,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -515,28 +513,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was declared with . - + -or- - + . is , but . is not correct for @@ -614,28 +612,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was declared with . - + -or- - + . is , but . is not correct for @@ -692,13 +690,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -758,13 +756,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -824,13 +822,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -903,13 +901,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -979,28 +977,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was not declared with - + -or- - + . is , but . is not correct for @@ -1075,7 +1073,7 @@ with bits increasing in value until the least significant bit of the first byte, proceeding with the most significant bit of the second byte, and so on. Under this scheme, the following ASN.1 type declaration and C# enumeration can be used together: - + KeyUsage ::= BIT STRING { digitalSignature (0), @@ -1103,7 +1101,7 @@ DecipherOnly = 1 << (8), } - + While the example here uses the KeyUsage NamedBitList from RFC 3280 (4.2.1.3), the example enum uses values that are different from @@ -1114,28 +1112,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was not declared with - + -or- - + . is , but . is not correct for @@ -1189,13 +1187,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1261,13 +1259,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1334,13 +1332,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1413,13 +1411,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1498,13 +1496,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1566,20 +1564,20 @@ To be added. is not defined. - + -or- - + is not in the range [99, 9999]. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1712,13 +1710,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1726,9 +1724,9 @@ , but . is not correct for the method. - + -or- - + overlaps . @@ -1795,24 +1793,24 @@ is not defined. - + -or- - + is not a known character string type. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The string did not successfully decode. @@ -1885,13 +1883,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1899,9 +1897,9 @@ , but . is not a character string tag type. - + -or- - + overlaps . @@ -2038,13 +2036,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2111,13 +2109,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2187,13 +2185,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2201,9 +2199,9 @@ , but . is not correct for the method. - + -or- - + overlaps . @@ -2272,13 +2270,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2350,13 +2348,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2424,13 +2422,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2504,13 +2502,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2583,13 +2581,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. diff --git a/xml/System.Formats.Asn1/AsnReader.xml b/xml/System.Formats.Asn1/AsnReader.xml index e5e29cb277e..b06cb1b1d34 100644 --- a/xml/System.Formats.Asn1/AsnReader.xml +++ b/xml/System.Formats.Asn1/AsnReader.xml @@ -22,9 +22,7 @@ - - Represents a stateful, forward-only reader for BER-encoded, CER-encoded, or DER-encoded ASN.1 data. - + Represents a stateful, forward-only reader for BER-encoded, CER-encoded, or DER-encoded ASN.1 data. To be added. @@ -60,7 +58,7 @@ This constructor does not evaluate for correctness. Any correctness checks are done as part of member methods. - + This constructor does not copy . The caller is responsible for ensuring that the values do not change until the reader is finished. @@ -286,13 +284,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -340,13 +338,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -404,17 +402,17 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The string did not successfully decode. @@ -498,13 +496,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -558,28 +556,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was declared with . - + -or- - + . is , but . is not correct for @@ -644,28 +642,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was declared with . - + -or- - + . is , but . is not correct for @@ -709,13 +707,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -762,13 +760,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -816,13 +814,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -867,13 +865,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -922,28 +920,28 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was not declared with - + -or- - + . is , but . is not correct for @@ -1006,7 +1004,7 @@ with bits increasing in value until the least significant bit of the first byte, proceeding with the most significant bit of the second byte, and so on. Under this scheme, the following ASN.1 type declaration and C# enumeration can be used together: - + KeyUsage ::= BIT STRING { digitalSignature (0), @@ -1034,7 +1032,7 @@ DecipherOnly = 1 << (8), } - + While the example here uses the KeyUsage NamedBitList from RFC 3280 (4.2.1.3), the example enum uses values that are different from @@ -1042,28 +1040,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was not declared with - + -or- - + . is , but . is not correct for @@ -1104,13 +1102,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1156,13 +1154,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1211,13 +1209,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1271,13 +1269,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1332,13 +1330,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1397,13 +1395,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1452,13 +1450,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1511,13 +1509,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1644,13 +1642,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1717,17 +1715,17 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The string did not successfully decode. @@ -1787,13 +1785,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1848,13 +1846,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1908,13 +1906,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1971,13 +1969,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2037,13 +2035,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2099,13 +2097,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2158,13 +2156,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2225,13 +2223,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2291,13 +2289,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. diff --git a/xml/System.Formats.Asn1/AsnWriter.xml b/xml/System.Formats.Asn1/AsnWriter.xml index f8eec0b660d..97824c8d324 100644 --- a/xml/System.Formats.Asn1/AsnWriter.xml +++ b/xml/System.Formats.Asn1/AsnWriter.xml @@ -28,9 +28,7 @@ - - A writer for BER-encoded, CER-encoded, and DER-encoded ASN.1 data. - + A writer for BER-encoded, CER-encoded, and DER-encoded ASN.1 data. To be added. @@ -141,17 +139,17 @@ A or has not been closed via or . - + -or- - + This writer is empty. - + -or- - + This writer represents more than one top-level value. - + -or- - + This writer's value is encoded in a manner that is not compatible with the ruleset for the destination writer. @@ -958,13 +956,13 @@ , but . is not correct for the method. - + -or- - + has length 0 and is not 0 - + -or- - + is not empty and any of the bits identified by is set. @@ -1053,9 +1051,9 @@ To be added. is not a restricted character string encoding type. - + -or- - + is a restricted character string encoding type that is not currently supported by this method. @@ -1110,9 +1108,9 @@ is is not a restricted character string encoding type. - + -or- - + is a restricted character string encoding type that is not currently supported by this method. @@ -1160,9 +1158,9 @@ could not be read under the current encoding rules. - + -or- - + has data beyond the end of the first value. @@ -1208,13 +1206,13 @@ , but . is not correct for the method. - + -or- - + is not a boxed enum value. - + -or- - + the unboxed type of is declared []. @@ -1274,13 +1272,13 @@ , but . is not correct for the method. - + -or- - + is not an enum. - + -or- - + is declared []. @@ -1442,9 +1440,9 @@ To be added. The 9 most significant bits are all set. - + -or- - + The 9 most significant bits are all unset. @@ -1614,13 +1612,13 @@ , but . is not correct for the method. - + -or- - + is not a boxed enum value. - + -or- - + the unboxed type of is not declared []. @@ -1681,13 +1679,13 @@ , but . is not correct for the method. - + -or- - + is not an enum value. - + -or- - + is not declared []. @@ -1765,9 +1763,9 @@ , but . is not correct for the method. - + -or- - + is not a valid dotted decimal object identifier. @@ -1809,9 +1807,9 @@ , but . is not correct for the method. - + -or- - + is not a valid dotted decimal object identifier. diff --git a/xml/System.Formats.Asn1/ValueAsnReader.xml b/xml/System.Formats.Asn1/ValueAsnReader.xml index 9c7adcccc05..646e979a64a 100644 --- a/xml/System.Formats.Asn1/ValueAsnReader.xml +++ b/xml/System.Formats.Asn1/ValueAsnReader.xml @@ -24,9 +24,7 @@ - - Represents a stateful, forward-only reader for BER-encoded, CER-encoded, or DER-encoded ASN.1 data. - + Represents a stateful, forward-only reader for BER-encoded, CER-encoded, or DER-encoded ASN.1 data. To be added. @@ -56,7 +54,7 @@ This constructor does not evaluate for correctness. Any correctness checks are done as part of member methods. - + This constructor does not copy . The caller is responsible for ensuring that the values do not change until the reader is finished. @@ -246,13 +244,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -294,13 +292,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -352,17 +350,17 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The string did not successfully decode. @@ -434,13 +432,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -488,28 +486,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was declared with . - + -or- - + . is , but . is not correct for @@ -568,28 +566,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was declared with . - + -or- - + . is , but . is not correct for @@ -627,13 +625,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -674,13 +672,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -722,13 +720,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -767,13 +765,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -816,28 +814,28 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was not declared with - + -or- - + . is , but . is not correct for @@ -894,7 +892,7 @@ with bits increasing in value until the least significant bit of the first byte, proceeding with the most significant bit of the second byte, and so on. Under this scheme, the following ASN.1 type declaration and C# enumeration can be used together: - + KeyUsage ::= BIT STRING { digitalSignature (0), @@ -922,7 +920,7 @@ DecipherOnly = 1 << (8), } - + While the example here uses the KeyUsage NamedBitList from RFC 3280 (4.2.1.3), the example enum uses values that are different from @@ -930,28 +928,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was not declared with - + -or- - + . is , but . is not correct for @@ -986,13 +984,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1032,13 +1030,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1081,13 +1079,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1135,13 +1133,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1190,13 +1188,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1249,13 +1247,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1298,13 +1296,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1351,13 +1349,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1478,13 +1476,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1545,17 +1543,17 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The string did not successfully decode. @@ -1609,13 +1607,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1664,13 +1662,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1718,13 +1716,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1775,13 +1773,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1835,13 +1833,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1891,13 +1889,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1944,13 +1942,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2005,13 +2003,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2065,13 +2063,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. From 2d29e7371e5aaef6667e159e86621d1471429d50 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Fri, 29 May 2026 15:25:03 -0700 Subject: [PATCH 2/3] revert Asn1 docs changes --- xml/System.Formats.Asn1/AsnDecoder.xml | 318 +++++++++++---------- xml/System.Formats.Asn1/AsnReader.xml | 314 ++++++++++---------- xml/System.Formats.Asn1/AsnWriter.xml | 80 +++--- xml/System.Formats.Asn1/ValueAsnReader.xml | 314 ++++++++++---------- 4 files changed, 517 insertions(+), 509 deletions(-) diff --git a/xml/System.Formats.Asn1/AsnDecoder.xml b/xml/System.Formats.Asn1/AsnDecoder.xml index f86a8e954bc..bda8095c0dd 100644 --- a/xml/System.Formats.Asn1/AsnDecoder.xml +++ b/xml/System.Formats.Asn1/AsnDecoder.xml @@ -22,7 +22,9 @@ - Provides stateless methods for decoding BER-encoded, CER-encoded, and DER-encoded ASN.1 data. + + Provides stateless methods for decoding BER-encoded, CER-encoded, and DER-encoded ASN.1 data. + To be added. @@ -142,13 +144,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -209,13 +211,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -285,24 +287,24 @@ is not defined. - + -or- - + is not a known character string type. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The string did not successfully decode. @@ -437,13 +439,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -513,28 +515,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was declared with . - + -or- - + . is , but . is not correct for @@ -612,28 +614,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was declared with . - + -or- - + . is , but . is not correct for @@ -690,13 +692,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -756,13 +758,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -822,13 +824,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -901,13 +903,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -977,28 +979,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was not declared with - + -or- - + . is , but . is not correct for @@ -1073,7 +1075,7 @@ with bits increasing in value until the least significant bit of the first byte, proceeding with the most significant bit of the second byte, and so on. Under this scheme, the following ASN.1 type declaration and C# enumeration can be used together: - + KeyUsage ::= BIT STRING { digitalSignature (0), @@ -1101,7 +1103,7 @@ DecipherOnly = 1 << (8), } - + While the example here uses the KeyUsage NamedBitList from RFC 3280 (4.2.1.3), the example enum uses values that are different from @@ -1112,28 +1114,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was not declared with - + -or- - + . is , but . is not correct for @@ -1187,13 +1189,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1259,13 +1261,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1332,13 +1334,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1411,13 +1413,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1496,13 +1498,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1564,20 +1566,20 @@ To be added. is not defined. - + -or- - + is not in the range [99, 9999]. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1710,13 +1712,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1724,9 +1726,9 @@ , but . is not correct for the method. - + -or- - + overlaps . @@ -1793,24 +1795,24 @@ is not defined. - + -or- - + is not a known character string type. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The string did not successfully decode. @@ -1883,13 +1885,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1897,9 +1899,9 @@ , but . is not a character string tag type. - + -or- - + overlaps . @@ -2036,13 +2038,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2109,13 +2111,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2185,13 +2187,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2199,9 +2201,9 @@ , but . is not correct for the method. - + -or- - + overlaps . @@ -2270,13 +2272,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2348,13 +2350,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2422,13 +2424,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2502,13 +2504,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2581,13 +2583,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. diff --git a/xml/System.Formats.Asn1/AsnReader.xml b/xml/System.Formats.Asn1/AsnReader.xml index b06cb1b1d34..e5e29cb277e 100644 --- a/xml/System.Formats.Asn1/AsnReader.xml +++ b/xml/System.Formats.Asn1/AsnReader.xml @@ -22,7 +22,9 @@ - Represents a stateful, forward-only reader for BER-encoded, CER-encoded, or DER-encoded ASN.1 data. + + Represents a stateful, forward-only reader for BER-encoded, CER-encoded, or DER-encoded ASN.1 data. + To be added. @@ -58,7 +60,7 @@ This constructor does not evaluate for correctness. Any correctness checks are done as part of member methods. - + This constructor does not copy . The caller is responsible for ensuring that the values do not change until the reader is finished. @@ -284,13 +286,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -338,13 +340,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -402,17 +404,17 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The string did not successfully decode. @@ -496,13 +498,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -556,28 +558,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was declared with . - + -or- - + . is , but . is not correct for @@ -642,28 +644,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was declared with . - + -or- - + . is , but . is not correct for @@ -707,13 +709,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -760,13 +762,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -814,13 +816,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -865,13 +867,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -920,28 +922,28 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was not declared with - + -or- - + . is , but . is not correct for @@ -1004,7 +1006,7 @@ with bits increasing in value until the least significant bit of the first byte, proceeding with the most significant bit of the second byte, and so on. Under this scheme, the following ASN.1 type declaration and C# enumeration can be used together: - + KeyUsage ::= BIT STRING { digitalSignature (0), @@ -1032,7 +1034,7 @@ DecipherOnly = 1 << (8), } - + While the example here uses the KeyUsage NamedBitList from RFC 3280 (4.2.1.3), the example enum uses values that are different from @@ -1040,28 +1042,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was not declared with - + -or- - + . is , but . is not correct for @@ -1102,13 +1104,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1154,13 +1156,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1209,13 +1211,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1269,13 +1271,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1330,13 +1332,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1395,13 +1397,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1450,13 +1452,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1509,13 +1511,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1642,13 +1644,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1715,17 +1717,17 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The string did not successfully decode. @@ -1785,13 +1787,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1846,13 +1848,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1906,13 +1908,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1969,13 +1971,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2035,13 +2037,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2097,13 +2099,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2156,13 +2158,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2223,13 +2225,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2289,13 +2291,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. diff --git a/xml/System.Formats.Asn1/AsnWriter.xml b/xml/System.Formats.Asn1/AsnWriter.xml index 97824c8d324..f8eec0b660d 100644 --- a/xml/System.Formats.Asn1/AsnWriter.xml +++ b/xml/System.Formats.Asn1/AsnWriter.xml @@ -28,7 +28,9 @@ - A writer for BER-encoded, CER-encoded, and DER-encoded ASN.1 data. + + A writer for BER-encoded, CER-encoded, and DER-encoded ASN.1 data. + To be added. @@ -139,17 +141,17 @@ A or has not been closed via or . - + -or- - + This writer is empty. - + -or- - + This writer represents more than one top-level value. - + -or- - + This writer's value is encoded in a manner that is not compatible with the ruleset for the destination writer. @@ -956,13 +958,13 @@ , but . is not correct for the method. - + -or- - + has length 0 and is not 0 - + -or- - + is not empty and any of the bits identified by is set. @@ -1051,9 +1053,9 @@ To be added. is not a restricted character string encoding type. - + -or- - + is a restricted character string encoding type that is not currently supported by this method. @@ -1108,9 +1110,9 @@ is is not a restricted character string encoding type. - + -or- - + is a restricted character string encoding type that is not currently supported by this method. @@ -1158,9 +1160,9 @@ could not be read under the current encoding rules. - + -or- - + has data beyond the end of the first value. @@ -1206,13 +1208,13 @@ , but . is not correct for the method. - + -or- - + is not a boxed enum value. - + -or- - + the unboxed type of is declared []. @@ -1272,13 +1274,13 @@ , but . is not correct for the method. - + -or- - + is not an enum. - + -or- - + is declared []. @@ -1440,9 +1442,9 @@ To be added. The 9 most significant bits are all set. - + -or- - + The 9 most significant bits are all unset. @@ -1612,13 +1614,13 @@ , but . is not correct for the method. - + -or- - + is not a boxed enum value. - + -or- - + the unboxed type of is not declared []. @@ -1679,13 +1681,13 @@ , but . is not correct for the method. - + -or- - + is not an enum value. - + -or- - + is not declared []. @@ -1763,9 +1765,9 @@ , but . is not correct for the method. - + -or- - + is not a valid dotted decimal object identifier. @@ -1807,9 +1809,9 @@ , but . is not correct for the method. - + -or- - + is not a valid dotted decimal object identifier. diff --git a/xml/System.Formats.Asn1/ValueAsnReader.xml b/xml/System.Formats.Asn1/ValueAsnReader.xml index 646e979a64a..9c7adcccc05 100644 --- a/xml/System.Formats.Asn1/ValueAsnReader.xml +++ b/xml/System.Formats.Asn1/ValueAsnReader.xml @@ -24,7 +24,9 @@ - Represents a stateful, forward-only reader for BER-encoded, CER-encoded, or DER-encoded ASN.1 data. + + Represents a stateful, forward-only reader for BER-encoded, CER-encoded, or DER-encoded ASN.1 data. + To be added. @@ -54,7 +56,7 @@ This constructor does not evaluate for correctness. Any correctness checks are done as part of member methods. - + This constructor does not copy . The caller is responsible for ensuring that the values do not change until the reader is finished. @@ -244,13 +246,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -292,13 +294,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -350,17 +352,17 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The string did not successfully decode. @@ -432,13 +434,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -486,28 +488,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was declared with . - + -or- - + . is , but . is not correct for @@ -566,28 +568,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was declared with . - + -or- - + . is , but . is not correct for @@ -625,13 +627,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -672,13 +674,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -720,13 +722,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -765,13 +767,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -814,28 +816,28 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was not declared with - + -or- - + . is , but . is not correct for @@ -892,7 +894,7 @@ with bits increasing in value until the least significant bit of the first byte, proceeding with the most significant bit of the second byte, and so on. Under this scheme, the following ASN.1 type declaration and C# enumeration can be used together: - + KeyUsage ::= BIT STRING { digitalSignature (0), @@ -920,7 +922,7 @@ DecipherOnly = 1 << (8), } - + While the example here uses the KeyUsage NamedBitList from RFC 3280 (4.2.1.3), the example enum uses values that are different from @@ -928,28 +930,28 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The encoded value is too big to fit in a value. is not an enum type. - + -or- - + was not declared with - + -or- - + . is , but . is not correct for @@ -984,13 +986,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1030,13 +1032,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1079,13 +1081,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1133,13 +1135,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1188,13 +1190,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1247,13 +1249,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1296,13 +1298,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1349,13 +1351,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1476,13 +1478,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1543,17 +1545,17 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. - + -or- - + The string did not successfully decode. @@ -1607,13 +1609,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1662,13 +1664,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1716,13 +1718,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1773,13 +1775,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1833,13 +1835,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1889,13 +1891,13 @@ The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -1942,13 +1944,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2003,13 +2005,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. @@ -2063,13 +2065,13 @@ To be added. The next value does not have the correct tag. - + -or- - + The length encoding is not valid under the current encoding rules. - + -or- - + The contents are not valid under the current encoding rules. From 3b161baf5dae05e1eaa09e1491ac915f2d66e19d Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Fri, 29 May 2026 15:34:10 -0700 Subject: [PATCH 3/3] respond to feedback --- xml/System.Drawing/BufferedGraphicsContext.xml | 4 ++-- xml/System.Drawing/BufferedGraphicsManager.xml | 8 ++++---- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/xml/System.Drawing/BufferedGraphicsContext.xml b/xml/System.Drawing/BufferedGraphicsContext.xml index 3fbbd9b7ad2..6b3b86a26b6 100644 --- a/xml/System.Drawing/BufferedGraphicsContext.xml +++ b/xml/System.Drawing/BufferedGraphicsContext.xml @@ -169,7 +169,7 @@ method with a rectangle whose size exceeds the value of the property, a temporary is created to allocate the buffer and provide a temporary context for the buffer. The new is distinct from the and it is disposed automatically when the returned by the method is disposed. + When you call the method with a rectangle whose size exceeds the value of the property, a temporary is created to allocate the buffer and provide a temporary context for the buffer. The new is distinct from the current and it is disposed automatically when the returned by the method is disposed. ## Examples The following code example demonstrates creating a graphics buffer using the method. This code is part of a larger example provided for the class. @@ -227,7 +227,7 @@ method with a rectangle whose size exceeds the value of the property, a temporary is created to allocate the buffer and provide a temporary context for the buffer. The new is distinct from the and it is disposed automatically when the returned by the method is disposed. + When you call the method with a rectangle whose size exceeds the value of the property, a temporary is created to allocate the buffer and provide a temporary context for the buffer. The new is distinct from the current and it is disposed automatically when the returned by the method is disposed. ## Examples The following code example demonstrates creating a graphics buffer using the method. This code is part of a larger example provided for the class. diff --git a/xml/System.Drawing/BufferedGraphicsManager.xml b/xml/System.Drawing/BufferedGraphicsManager.xml index a4b3d8d9b9d..f566fcd1797 100644 --- a/xml/System.Drawing/BufferedGraphicsManager.xml +++ b/xml/System.Drawing/BufferedGraphicsManager.xml @@ -46,7 +46,7 @@ ## Remarks The class allows you to implement custom double buffering for your graphics. Graphics that use double buffering can reduce or eliminate flicker that is caused by redrawing a display surface. - This class has one static property, , which returns the main for the current application domain. The class creates instances that can be used to draw buffered graphics. + This class has one static property, , which returns the current . The class creates instances that can be used to draw buffered graphics. The class has no public constructor and must be created by the object using its method. You can retrieve the object from the static property. @@ -95,8 +95,8 @@ System.Drawing.BufferedGraphicsContext - Gets the for the current application domain. - The for the current application domain. + Gets the current buffered graphics context. + The current buffered graphics context. property always returns the same object. ## Examples - The following code example demonstrates acquiring the for the current application domain. + The following code example demonstrates acquiring the current buffered graphics context. :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/BufferingExamples/CPP/bufferingexamples.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Drawing/BufferedGraphics/Render/bufferingexamples.cs" id="Snippet1":::