diff --git a/includes/context.md b/includes/context.md deleted file mode 100644 index 48e7573b5ca..00000000000 --- a/includes/context.md +++ /dev/null @@ -1,2 +0,0 @@ -> [!NOTE] -> This article provides supplementary remarks to the reference documentation for this API. diff --git a/includes/dependencypropertyremark-md.md b/includes/dependencypropertyremark-md.md deleted file mode 100644 index fab6dc31270..00000000000 --- a/includes/dependencypropertyremark-md.md +++ /dev/null @@ -1 +0,0 @@ -You indirectly access each public property and event of this type by the resolution of a corresponding dependency property. This dependency property is the public static field named **XProperty** or **XEvent**, where X is the corresponding property. \ No newline at end of file diff --git a/includes/deprecatedcontent-md.md b/includes/deprecatedcontent-md.md deleted file mode 100644 index 0907e3b584c..00000000000 --- a/includes/deprecatedcontent-md.md +++ /dev/null @@ -1 +0,0 @@ -This material discusses types and namespaces that are obsolete. For more information, see [Deprecated Types in Windows Workflow Foundation 4.5](https://aka.ms/wfdeprecatedtypes). \ No newline at end of file diff --git a/includes/forms-auth-warning.md b/includes/forms-auth-warning.md deleted file mode 100644 index e364edc46cb..00000000000 --- a/includes/forms-auth-warning.md +++ /dev/null @@ -1,2 +0,0 @@ -> [!WARNING] -> Storing user credentials in the `credentials` section is **insecure**. Instead, use [Azure Key Vault](/azure/key-vault/general/overview). diff --git a/includes/note-compatibility-md.md b/includes/note-compatibility-md.md deleted file mode 100644 index 1d43adaf52d..00000000000 --- a/includes/note-compatibility-md.md +++ /dev/null @@ -1,2 +0,0 @@ -> [!NOTE] -> Functions and objects in the namespace are provided for use by the tools for upgrading from Visual Basic 6.0 to Visual Basic 2008. In most cases, these functions and objects duplicate functionality that you can find in other namespaces in the .NET Framework. They are necessary only when the Visual Basic 6.0 code model differs significantly from the .NET Framework implementation. \ No newline at end of file diff --git a/includes/System.Windows.Forms.PictureBox/load-behavior-changes.md b/includes/picturebox-load-behavior-changes.md similarity index 100% rename from includes/System.Windows.Forms.PictureBox/load-behavior-changes.md rename to includes/picturebox-load-behavior-changes.md diff --git a/includes/remarks/System/String/provider-string-format.md b/includes/provider-string-format.md similarity index 100% rename from includes/remarks/System/String/provider-string-format.md rename to includes/provider-string-format.md diff --git a/includes/remarks/System.IO.Compression/CompressionLevel/CompressionLevel.md b/includes/remarks/System.IO.Compression/CompressionLevel/CompressionLevel.md deleted file mode 100644 index c9318b19777..00000000000 --- a/includes/remarks/System.IO.Compression/CompressionLevel/CompressionLevel.md +++ /dev/null @@ -1,18 +0,0 @@ -Compression operations usually involve a tradeoff between the speed and the effectiveness of compression. You use the enumeration to indicate which factor is more important in your development scenario: the time to complete the compression operation or the size of the compressed file. These values do not correspond to specific compression levels; the object that implements compression determines how to handle them. - -The following methods of the , , , , and classes include a parameter named `compressionLevel` that lets you specify the compression level: - -- -- -- -- -- -- -- - -## Examples - -The following example shows how to set the compression level when creating a zip archive by using the class. - -:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipFile/CreateFromDirectory/program3.cs" id="Snippet3"::: -:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipFile/CreateFromDirectory/program3.vb" id="Snippet3"::: diff --git a/includes/remarks/System.IO.Compression/DeflateStream/.ctor_Stream_CompressionLevel.md b/includes/remarks/System.IO.Compression/DeflateStream/.ctor_Stream_CompressionLevel.md deleted file mode 100644 index 4ce0d1df2a4..00000000000 --- a/includes/remarks/System.IO.Compression/DeflateStream/.ctor_Stream_CompressionLevel.md +++ /dev/null @@ -1,8 +0,0 @@ -This constructor overload uses the compression mode . To set the compression mode to another value, use the or overload. - -## Examples - -The following example shows how to set the compression level when creating a object and how to leave the stream open. - -:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/Deflate/FileCompressionLevelExample.cs" id="Snippet1"::: -:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/Deflate/FileCompressionLevelExample.vb" id="Snippet1"::: diff --git a/includes/remarks/System.IO.Compression/DeflateStream/.ctor_Stream_CompressionMode.md b/includes/remarks/System.IO.Compression/DeflateStream/.ctor_Stream_CompressionMode.md deleted file mode 100644 index 766ba4c57e1..00000000000 --- a/includes/remarks/System.IO.Compression/DeflateStream/.ctor_Stream_CompressionMode.md +++ /dev/null @@ -1,12 +0,0 @@ -By default, owns the underlying stream, so closing the stream also closes the underlying stream. Note that the state of the underlying stream can affect the usability of the stream. Also, no explicit checks are performed, so no additional exceptions are thrown when the new instance is created. - -If an instance of the class is created with the `mode` parameter equal to `Compress`, header information is inserted immediately. If no further action occurs, the stream appears as a valid, empty, compressed file. - -By default, the compression level is set to when the compression mode is . - -## Examples - -The following example shows how to use the class to compress and decompress a file. - -:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/Deflate/FileCompressionModeExample.cs" id="Snippet1"::: -:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/Deflate/FileCompressionModeExample.vb" id="Snippet1"::: diff --git a/includes/remarks/System.IO.Compression/ZipArchive/.ctor_Stream_ZipArchiveMode_Boolean_Encoding.md b/includes/remarks/System.IO.Compression/ZipArchive/.ctor_Stream_ZipArchiveMode_Boolean_Encoding.md deleted file mode 100644 index 8be8dea016d..00000000000 --- a/includes/remarks/System.IO.Compression/ZipArchive/.ctor_Stream_ZipArchiveMode_Boolean_Encoding.md +++ /dev/null @@ -1,18 +0,0 @@ -If the `mode` parameter is set to , the stream must support reading. If the `mode` parameter is set to , the stream must support writing. If the `mode` parameter is set to , the stream must support reading, writing, and seeking. - -When you open a zip archive file for reading and `entryNameEncoding` is set to `null`, entry names and comments are decoded according to the following rules: - -- When the language encoding flag (in the general-purpose bit flag of the local file header) is not set, the current system default code page is used to decode the entry name and comment. -- When the language encoding flag is set, UTF-8 is used to decode the entry name and comment. - -When you open a zip archive file for reading and `entryNameEncoding` is set to a value other than `null`, entry names and comments are decoded according to the following rules: - -- When the language encoding flag is not set, the specified `entryNameEncoding` is used to decode the entry name and comment. -- When the language encoding flag is set, UTF-8 is used to decode the entry name and comment. - -When you write to archive files and `entryNameEncoding` is set to `null`, entry names and comments are encoded according to the following rules: - -- For entry names and comments that contain characters outside the ASCII range, the language encoding flag is set, and entry names and comments are encoded by using UTF-8. -- For entry names and comments that contain only ASCII characters, the language encoding flag is not set, and entry names and comments are encoded by using the current system default code page. - -When you write to archive files and `entryNameEncoding` is set to a value other than `null`, the specified `entryNameEncoding` is used to encode the entry names and comments into bytes. The language encoding flag (in the general-purpose bit flag of the local file header) is set only when the specified encoding is a UTF-8 encoding. diff --git a/includes/remarks/System.IO.Compression/ZipArchive/ZipArchive.md b/includes/remarks/System.IO.Compression/ZipArchive/ZipArchive.md deleted file mode 100644 index 4361957ded0..00000000000 --- a/includes/remarks/System.IO.Compression/ZipArchive/ZipArchive.md +++ /dev/null @@ -1,32 +0,0 @@ -The methods for manipulating zip archives and their file entries are spread across three classes: , , and . - -|To|Use| -|--------|---------| -|Create a zip archive from a directory|| -|Extract the contents of a zip archive to a directory|| -|Add new files to an existing zip archive|| -|Retrieve a file from a zip archive|| -|Retrieve all the files from a zip archive|| -|Open a stream to a single file contained in a zip archive|| -|Delete a file from a zip archive|| - -When you create a new entry, the file is compressed and added to the zip package. The method enables you to specify a directory hierarchy when adding the entry. You include the relative path of the new entry within the zip package. For example, creating a new entry with a relative path of `AddedFolder\NewFile.txt` creates a compressed text file in a directory named AddedFolder. - -If you reference the `System.IO.Compression.FileSystem` assembly in your project, you can access four extension methods (from the class) for the class: , , , and (available in .NET Core 2.0 and later versions). These extension methods enable you to compress and decompress the contents of the entry to a file. The `System.IO.Compression.FileSystem` assembly is not available for Windows 8.x Store apps. In Windows 8.x Store apps, you can compress and decompress files by using the or class, or you can use the Windows Runtime types and . - -## Examples - -The first example shows how to create a new entry and write to it by using a stream. - -:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/CreateEntry/program1.cs" id="Snippet1"::: -:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/CreateEntry/program1.vb" id="Snippet1"::: - -The following example shows how to open a zip archive and iterate through the collection of entries. - -:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/Entries/program1.cs" id="Snippet1"::: -:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/Entries/program1.vb" id="Snippet1"::: - -The third example shows how to use extension methods to create a new entry in a zip archive from an existing file and extract the archive contents. You must reference the `System.IO.Compression.FileSystem` assembly to execute the code. - -:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/Entries/program3.cs" id="Snippet3"::: -:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/Entries/program3.vb" id="Snippet3"::: diff --git a/includes/remarks/System.IO.Compression/ZipArchiveEntry/FullName.md b/includes/remarks/System.IO.Compression/ZipArchiveEntry/FullName.md deleted file mode 100644 index c669c3c31d9..00000000000 --- a/includes/remarks/System.IO.Compression/ZipArchiveEntry/FullName.md +++ /dev/null @@ -1,10 +0,0 @@ -The property contains the relative path, including the subdirectory hierarchy, of an entry in a zip archive. (In contrast, the property contains only the name of the entry and does not include the subdirectory hierarchy.) For example, if you create two entries in a zip archive by using the method and provide `NewEntry.txt` as the name for the first entry and `AddedFolder\\NewEntry.txt` for the second entry, both entries will have `NewEntry.txt` in the property. The first entry will also have `NewEntry.txt` in the property, but the second entry will have `AddedFolder\\NewEntry.txt` in the property. - -You can specify any string as the path of an entry, including strings that specify invalid and absolute paths. Therefore, the property might contain a value that is not correctly formatted. An invalid or absolute path might result in an exception when you extract the contents of the zip archive. - -## Examples - -The following example shows how to iterate through the contents of a .zip file, and extract files that contain the .txt extension. - -:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/Entries/program1.cs" id="Snippet1"::: -:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/Entries/program1.vb" id="Snippet1"::: diff --git a/includes/remarks/System.IO.Compression/ZipArchiveEntry/LastWriteTime.md b/includes/remarks/System.IO.Compression/ZipArchiveEntry/LastWriteTime.md deleted file mode 100644 index e78d01eb5e3..00000000000 --- a/includes/remarks/System.IO.Compression/ZipArchiveEntry/LastWriteTime.md +++ /dev/null @@ -1,10 +0,0 @@ -When you create a new entry from an existing file by calling the method, the property for the entry is automatically set to the last time the file was modified. When you create a new entry programmatically by calling the method, the property for the entry is automatically set to the time of execution. If you modify the entry, you must explicitly set the property if you want the value to reflect the time of the latest change. - -When you set this property, the value is converted to a timestamp format that is specific to zip archives. This format supports a resolution of two seconds. The earliest permitted value is 1980 January 1 0:00:00 (midnight). The latest permitted value is 2107 December 31 23:59:58 (one second before midnight). If the value for the last write time is not valid, the property returns a default value of 1980 January 1 0:00:00 (midnight). - -## Examples - -The following example shows how to open an entry in a zip archive, modify it, and set the property to the current time. - -:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/GetEntry/program2.cs" id="Snippet2"::: -:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/GetEntry/program2.vb" id="Snippet2"::: diff --git a/includes/remarks/System.IO.Compression/ZipArchiveEntry/Name.md b/includes/remarks/System.IO.Compression/ZipArchiveEntry/Name.md deleted file mode 100644 index 369b7e1e413..00000000000 --- a/includes/remarks/System.IO.Compression/ZipArchiveEntry/Name.md +++ /dev/null @@ -1,9 +0,0 @@ -The property contains the portion of the property that follows the final directory separator character (\\), and does not include the subdirectory hierarchy. For example, if you create two entries in a zip archive by using the method and provide `NewEntry.txt` as the name for the first entry and `AddedFolder\\NewEntry.txt` for the second entry, both entries will have `NewEntry.txt` in the property. The first entry will also have `NewEntry.txt` in the property, but the second entry will have `AddedFolder\\NewEntry.txt` in the property. -On Windows, colons (`:`) are also treated as separators due to NTFS rules, which can cause to differ across platforms. For platform-independent behavior, you can use , which always reflects the complete entry name as stored in the archive. - -## Examples - -The following example shows how to retrieve entries from a zip archive and evaluate the properties of the entries. It uses the property to display the name of the entry, and the and properties to calculate how much the file was compressed. - -:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/GetEntry/program1.cs" id="Snippet1"::: -:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/GetEntry/program1.vb" id="Snippet1"::: diff --git a/includes/remarks/System.IO.Compression/ZipArchiveEntry/ZipArchiveEntry.md b/includes/remarks/System.IO.Compression/ZipArchiveEntry/ZipArchiveEntry.md deleted file mode 100644 index 2d2ee597580..00000000000 --- a/includes/remarks/System.IO.Compression/ZipArchiveEntry/ZipArchiveEntry.md +++ /dev/null @@ -1,27 +0,0 @@ -A zip archive contains an entry for each compressed file. The class enables you to examine the properties of an entry, and open or delete the entry. When you open an entry, you can modify the compressed file by writing to the stream for that compressed file. - -The methods for manipulating zip archives and their file entries are spread across three classes: , and . - -|To...|Use...| -|---------|----------| -|Create a zip archive from a directory|| -|Extract the contents of a zip archive to a directory|| -|Add new files to an existing zip archive|| -|Retrieve a file in a zip archive|| -|Retrieve all of the files in a zip archive|| -|To open a stream to an individual file contained in a zip archive|| -|Delete a file from a zip archive|| - -If you reference the `System.IO.Compression.FileSystem` assembly in your project, you can access two extension methods for the class. Those methods are and , and they enable you to decompress the contents of the entry to a file. The `System.IO.Compression.FileSystem` assembly is not available in Windows 8. In Windows 8.x Store apps, you can decompress the contents of an archive by using or , or you can use the Windows Runtime types and to compress and decompress files. - -## Examples - -The first example shows how to create a new entry in a zip archive and write to it. - -:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/CreateEntry/program1.cs" id="Snippet1"::: -:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/CreateEntry/program1.vb" id="Snippet1"::: - -The second example shows how to use the extension method. You must reference the `System.IO.Compression.FileSystem` assembly in your project for the code to execute. - -:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/Entries/program1.cs" id="Snippet1"::: -:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/Entries/program1.vb" id="Snippet1"::: diff --git a/includes/remarks/System.IO.Compression/ZipArchiveMode/ZipArchiveMode.md b/includes/remarks/System.IO.Compression/ZipArchiveMode/ZipArchiveMode.md deleted file mode 100644 index 82e41ac61ee..00000000000 --- a/includes/remarks/System.IO.Compression/ZipArchiveMode/ZipArchiveMode.md +++ /dev/null @@ -1,20 +0,0 @@ -When you set the mode to Read, the underlying file or stream must support reading, but does not have to support seeking. If the underlying file or stream supports seeking, the files are read from the archive as they are requested. If the underlying file or stream does not support seeking, the entire archive is held in memory. - -When you set the mode to Create, the underlying file or stream must support writing, but does not have to support seeking. Each entry in the archive can be opened only once for writing. If you create a single entry, the data is written to the underlying stream or file as soon as it is available. If you create multiple entries, such as by calling the method, the data is written to the underlying stream or file after all the entries are created. - -When you set the mode to Update, the underlying file or stream must support reading, writing, and seeking. The content of the entire archive is held in memory, and no data is written to the underlying file or stream until the archive is disposed. - -The following methods include a parameter named `mode` that lets you specify the archive mode: - -- - -- - -- - -## Examples - -The following example shows how to specify a `ZipArchiveMode` value when creating a object. - -:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/CreateEntry/program1.cs" id="Snippet1"::: -:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/CreateEntry/program1.vb" id="Snippet1"::: diff --git a/includes/remarks/System.IO.Compression/ZipFile/Open.md b/includes/remarks/System.IO.Compression/ZipFile/Open.md deleted file mode 100644 index 572d81b4c1b..00000000000 --- a/includes/remarks/System.IO.Compression/ZipFile/Open.md +++ /dev/null @@ -1,22 +0,0 @@ -When you set the `mode` parameter to , the archive is opened with as the file mode value. If the archive does not exist, a exception is thrown. Setting the `mode` parameter to is equivalent to calling the method. - -When you set the `mode` parameter to , the archive is opened with as the file mode value. If the archive already exists, an is thrown. - -When you set the `mode` parameter to , the archive is opened with as the file mode value. If the archive exists, it is opened. The existing entries can be modified and new entries can be created. If the archive does not exist, a new archive is created; however, creating a zip archive in mode is not as efficient as creating it in mode. - -When you open a zip archive file for reading and `entryNameEncoding` is set to `null`, entry names and comments are decoded according to the following rules: - -- When the language encoding flag (in the general-purpose bit flag of the local file header) is not set, the current system default code page is used to decode the entry name and comment. -- When the language encoding flag is set, UTF-8 is used to decode the entry name and comment. - -When you open a zip archive file for reading and `entryNameEncoding` is set to a value other than `null`, entry names and comments are decoded according to the following rules: - -- When the language encoding flag is not set, the specified `entryNameEncoding` is used to decode the entry name and comment. -- When the language encoding flag is set, UTF-8 is used to decode the entry name and comment. - -When you write to archive files and `entryNameEncoding` is set to `null`, entry names and comments are encoded according to the following rules: - -- For entry names or comments that contain characters outside the ASCII range, the language encoding flag is set, and entry names and comments are encoded by using UTF-8. -- For entry names or comments that contain only ASCII characters, the language encoding flag is not set, and entry names and comments are encoded by using the current system default code page. - -When you write to archive files and `entryNameEncoding` is set to a value other than `null`, the specified `entryNameEncoding` is used to encode the entry names and comments into bytes. The language encoding flag (in the general-purpose bit flag of the local file header) is set only when the specified encoding is a UTF-8 encoding. diff --git a/includes/remarks/System.IO.Compression/ZipFile/ZipFile.md b/includes/remarks/System.IO.Compression/ZipFile/ZipFile.md deleted file mode 100644 index 489afac7817..00000000000 --- a/includes/remarks/System.IO.Compression/ZipFile/ZipFile.md +++ /dev/null @@ -1,21 +0,0 @@ -> [!NOTE] -> To use the class in a .NET Framework app, you must add a reference to the `System.IO.Compression.FileSystem` assembly in your project. For information on how to add a reference to your project in Visual Studio, see [How to: Add or Remove References](/visualstudio/ide/how-to-add-or-remove-references-by-using-the-reference-manager). - -The methods for manipulating zip archives and their files are spread across three classes: , , and . - -| To... | Use... | -|---------------------------------------|--------| -| Create a zip archive from a directory | | -| Extract the contents of a zip archive to a directory | | -| Add new files to an existing zip archive | | -| Retrieve a file in a zip archive | | -| Retrieve all of the files in a zip archive | | -| Open a stream to an individual file contained in a zip archive| | -| Delete a file from a zip archive | | - -## Examples - -This example shows how to create and extract a zip archive by using the class. It compresses the contents of a folder into a zip archive, and then extracts that content to a new folder. - -:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipFile/CreateFromDirectory/program1.cs" id="Snippet1"::: -:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipFile/CreateFromDirectory/program1.vb" id="Snippet1"::: diff --git a/includes/remarks/System.IO.Compression/ZipFileExtensions/ZipFileExtensions.md b/includes/remarks/System.IO.Compression/ZipFileExtensions/ZipFileExtensions.md deleted file mode 100644 index eea3bc321eb..00000000000 --- a/includes/remarks/System.IO.Compression/ZipFileExtensions/ZipFileExtensions.md +++ /dev/null @@ -1,31 +0,0 @@ -The class contains only static methods that extend the and classes. You do not create an instance of the class; instead, you use these methods from instances of or . - -To use the extension methods, you must reference the `System.IO.Compression.FileSystem` assembly in your project. The `System.IO.Compression.FileSystem` assembly is not available in Windows 8.x Store apps. Therefore, the and classes (both of which are in the `System.IO.Compression.FileSystem` assembly) are not available in Windows 8.x Store apps. In Windows 8.x Store apps, you work with compressed files by using the methods in , , , and . - -The class contains four methods that extend : - -- - -- - -- - -- - -The class contains two methods that extend : - -- - -- - -## Examples - -The following example shows how to create a new entry in a zip archive from an existing file, and extract the contents of the archive to a directory. - -:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/Entries/program3.cs" id="Snippet3"::: -:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/Entries/program3.vb" id="Snippet3"::: - -The following example shows how to iterate through the contents of a zip archive and extract files that have a .txt extension. - -:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/Entries/program1.cs" id="Snippet1"::: -:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/Entries/program1.vb" id="Snippet1"::: diff --git a/includes/remarks/System/String/simple-string-format.md b/includes/simple-string-format.md similarity index 100% rename from includes/remarks/System/String/simple-string-format.md rename to includes/simple-string-format.md diff --git a/includes/system-json.md b/includes/system-json.md deleted file mode 100644 index 5286deaf0ba..00000000000 --- a/includes/system-json.md +++ /dev/null @@ -1,2 +0,0 @@ -> [!NOTE] -> The namespace was designed for Silverlight, which is no longer supported. For processing JSON, we recommend using APIs in the namespace instead. diff --git a/includes/unnamed-parm-md.md b/includes/unnamed-parm-md.md deleted file mode 100644 index 0562e2499e3..00000000000 --- a/includes/unnamed-parm-md.md +++ /dev/null @@ -1 +0,0 @@ -Some methods, especially operators, declare a type for a parameter but do not specify a parameter name. Such a parameter is known as an *unnamed parameter*. In the documentation for these methods, the *A_0* placeholder represents the unnamed parameter. diff --git a/includes/remarks/System.Threading/WaitHandle/exit-context.md b/includes/waithandle-exit-context.md similarity index 100% rename from includes/remarks/System.Threading/WaitHandle/exit-context.md rename to includes/waithandle-exit-context.md diff --git a/includes/wif-saml2-ref-md.md b/includes/wif-saml2-ref-md.md deleted file mode 100644 index 1e7ffa5ad63..00000000000 --- a/includes/wif-saml2-ref-md.md +++ /dev/null @@ -1 +0,0 @@ -For more information about the element that this class represents, see the following specification: [Assertions and Protocols for the OASIS Security Assertion Markup Language (SAML) V2.0](https://docs.oasis-open.org/security/saml/v2.0/saml-core-2.0-os.pdf). diff --git a/includes/wif-wsfed-ref-md.md b/includes/wif-wsfed-ref-md.md deleted file mode 100644 index 255ed0b5e1e..00000000000 --- a/includes/wif-wsfed-ref-md.md +++ /dev/null @@ -1 +0,0 @@ -For more information about the message that this class represents, see section 13 of the following specification: [Web Services Federation Language (WS-Federation) Version 1.2](https://docs.oasis-open.org/wsfed/federation/v1.2/os/ws-federation-1.2-spec-os.html). diff --git a/includes/wif-wstrust-ref-md.md b/includes/wif-wstrust-ref-md.md deleted file mode 100644 index b989044a7f1..00000000000 --- a/includes/wif-wstrust-ref-md.md +++ /dev/null @@ -1 +0,0 @@ -For more information about the element that this class represents, see the WS-Trust specification that applies to your scenario: [WS-Trust February 2005](https://schemas.xmlsoap.org/ws/2005/02/trust/), [WS-Trust 1.3](https://docs.oasis-open.org/ws-sx/ws-trust/200512/ws-trust-1.3-os.html), or [WS-Trust 1.4](https://docs.oasis-open.org/ws-sx/ws-trust/v1.4/os/ws-trust-1.4-spec-os.html). diff --git a/includes/xmlreader-read-sample-output.md b/includes/xmlreader-read-output.md similarity index 98% rename from includes/xmlreader-read-sample-output.md rename to includes/xmlreader-read-output.md index 836c6a82e74..21800f93a41 100644 --- a/includes/xmlreader-read-sample-output.md +++ b/includes/xmlreader-read-output.md @@ -1,3 +1,3 @@ ```xml Test with an entity: 123Test with a child element stuffTest with a CDATA section ]]> defTest with a char entity: A1234567890ABCD -``` +``` \ No newline at end of file diff --git a/includes/xsltransform-script.md b/includes/xsltransform-script.md deleted file mode 100644 index 44d6b32f455..00000000000 --- a/includes/xsltransform-script.md +++ /dev/null @@ -1,7 +0,0 @@ - ```xml - - - -``` \ No newline at end of file diff --git a/xml/Microsoft.CSharp.RuntimeBinder/RuntimeBinderException.xml b/xml/Microsoft.CSharp.RuntimeBinder/RuntimeBinderException.xml index 82626427973..6cb8b78ccfc 100644 --- a/xml/Microsoft.CSharp.RuntimeBinder/RuntimeBinderException.xml +++ b/xml/Microsoft.CSharp.RuntimeBinder/RuntimeBinderException.xml @@ -167,14 +167,7 @@ The object that holds the serialized object data about the exception being thrown. The contextual information about the source or destination. Initializes a new instance of the class that has serialized data. - - - + To be added. diff --git a/xml/Microsoft.CSharp.RuntimeBinder/RuntimeBinderInternalCompilerException.xml b/xml/Microsoft.CSharp.RuntimeBinder/RuntimeBinderInternalCompilerException.xml index 42077b913ec..f6c1febb042 100644 --- a/xml/Microsoft.CSharp.RuntimeBinder/RuntimeBinderInternalCompilerException.xml +++ b/xml/Microsoft.CSharp.RuntimeBinder/RuntimeBinderInternalCompilerException.xml @@ -167,14 +167,7 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. diff --git a/xml/Microsoft.VisualBasic.CompilerServices/NewLateBinding.xml b/xml/Microsoft.VisualBasic.CompilerServices/NewLateBinding.xml index 4210d52a602..62ffbfb1aba 100644 --- a/xml/Microsoft.VisualBasic.CompilerServices/NewLateBinding.xml +++ b/xml/Microsoft.VisualBasic.CompilerServices/NewLateBinding.xml @@ -108,14 +108,7 @@ A value indicating whether or not the return value can be ignored. Executes a late-bound method or function call. This helper method is not meant to be called directly from your code. An instance of the call object. - - . - - ]]> - + To be added. diff --git a/xml/Microsoft.VisualBasic.FileIO/MalformedLineException.xml b/xml/Microsoft.VisualBasic.FileIO/MalformedLineException.xml index 6c273a91cc7..b2b8d30cdca 100644 --- a/xml/Microsoft.VisualBasic.FileIO/MalformedLineException.xml +++ b/xml/Microsoft.VisualBasic.FileIO/MalformedLineException.xml @@ -198,14 +198,7 @@ The object that holds the serialized object data about the exception being thrown. The structure that contains contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. @@ -417,14 +410,7 @@ The object that holds the serialized object data about the exception being thrown. The structure that contains contextual information about the source or destination. Sets the object with information about the exception. - - object with all the exception object data targeted for serialization. During deserialization, the exception is reconstituted from the transmitted over the stream. - - ]]> - + To be added. diff --git a/xml/Microsoft.Win32/Registry.xml b/xml/Microsoft.Win32/Registry.xml index 021ee161fbc..67eb3e7542a 100644 --- a/xml/Microsoft.Win32/Registry.xml +++ b/xml/Microsoft.Win32/Registry.xml @@ -367,25 +367,23 @@ The following code example stores values of several data types in an example key ## Remarks `LocalMachine` contains five keys: - Hardware + `Hardware`\ Describes the physical hardware in the computer, the way device drivers use that hardware, and mappings and related data that link kernel-mode drivers with user-mode code. All data in this key is recreated each time the system is started. The Description subkey describes the actual computer hardware. The DeviceMap subkey contains miscellaneous data in formats specific to particular classes of drivers. The ResourceMap subkey describes which device drivers claim which hardware resources. The Windows NT Diagnostics program (Winmsdp.exe) can report on its contents in an easy-to-read form. - SAM - The directory services database of security information for user and group accounts, and for the domains in Windows 2000 Server (SAM is the Security Account Manager, known as the directory services database). + `SAM`\ + The directory services database of security information for user and group accounts, and for the domains in Windows Server (SAM is the Security Account Manager, known as the directory services database). - Security - Contains the local security policy, such as specific user rights. This key is used only by the Windows 2000 security subsystem. + `Security`\ + Contains the local security policy, such as specific user rights. This key is used only by the Windows security subsystem. - Software + `Software`\ The per-computer software database. This key contains data about software installed on the local computer, along with various items of miscellaneous configuration data. - System - Controls system startup, device driver loading, Windows 2000 services, and operating system behavior. + `System`\ + Controls system startup, device driver loading, Windows services, and operating system behavior. By convention, if similar data exists under and under , the data in takes precedence. However, values in this key can also extend (rather than replace) data in Registry.LocalMachine. Also, some items (such as device driver loading entries) are meaningless if they occur outside of Registry.LocalMachine. - - ## Examples The following example demonstrates how to retrieve the subkeys of this key, and prints their names to the screen. Use the method to create an instance of the particular subkey of interest. You can then use other operations in to manipulate that key. @@ -442,11 +440,6 @@ The following code example stores values of several data types in an example key To obtain performance data from a remote system, you must use the method, with the computer name of the remote system and the Registry.PerformanceData key. This call retrieves a key representing the performance data for the remote system. To retrieve the data, call using this key, rather than the Registry.PerformanceData key. -> [!NOTE] -> On Windows Server 2003, a user must at least belong to the Performance Monitor Users group in order to access subkeys of this base key. - - - ## Examples The following example demonstrates how to retrieve the subkeys of this key, and prints their names to the screen. Use the method to create an instance of the particular subkey of interest. You can then use other operations in to manipulate that key. Note that this example can often return no results, since there might be no performance data. diff --git a/xml/Microsoft.Win32/RegistryKey.xml b/xml/Microsoft.Win32/RegistryKey.xml index cf0eeb72902..0ef569cca37 100644 --- a/xml/Microsoft.Win32/RegistryKey.xml +++ b/xml/Microsoft.Win32/RegistryKey.xml @@ -211,10 +211,10 @@ The user does not have the permissions required to create or open the registry key. The on which this method is being invoked is closed (closed keys cannot be accessed). The cannot be written to; for example, it was not opened as a writable key , or the user does not have the necessary access rights. - The nesting level exceeds 510. - - -or- - + The nesting level exceeds 510. + + -or- + A system error occurred, such as deletion of the key, or an attempt to create a key in the root. @@ -277,10 +277,10 @@ contains an invalid value. The on which this method is being invoked is closed (closed keys cannot be accessed). The cannot be written to; for example, it was not opened as a writable key, or the user does not have the necessary access rights. - The nesting level exceeds 510. - - -or- - + The nesting level exceeds 510. + + -or- + A system error occurred, such as deletion of the key, or an attempt to create a key in the root. @@ -340,10 +340,10 @@ is . The user does not have the permissions required to create or open the registry key. The current cannot be written to; for example, it was not opened as a writable key, or the user does not have the necessary access rights. - The nesting level exceeds 510. - - -or- - + The nesting level exceeds 510. + + -or- + A system error occurred, such as deletion of the key, or an attempt to create a key in the root. @@ -397,10 +397,10 @@ is . The current object is closed (closed keys cannot be accessed). The current object cannot be written to; for example, it was not opened as a writable key, or the user does not have the required access rights. - The nesting level exceeds 510. - - -or- - + The nesting level exceeds 510. + + -or- + A system error occurred, such as deletion of the key or an attempt to create a key in the root. The user does not have the permissions required to create or open the registry key. @@ -480,10 +480,10 @@ contains an invalid value. The on which this method is being invoked is closed (closed keys cannot be accessed). The current cannot be written to; for example, it was not opened as a writable key, or the user does not have the necessary access rights. - The nesting level exceeds 510. - - -or- - + The nesting level exceeds 510. + + -or- + A system error occurred, such as deletion of the key, or an attempt to create a key in the root. @@ -547,10 +547,10 @@ does not specify a valid Option The user does not have the permissions required to create or open the registry key. The current cannot be written to; for example, it was not opened as a writable key, or the user does not have the necessary access rights. - The nesting level exceeds 510. - - -or- - + The nesting level exceeds 510. + + -or- + A system error occurred, such as deletion of the key, or an attempt to create a key in the root. @@ -614,10 +614,10 @@ is . The current object is closed. Closed keys cannot be accessed. The current object cannot be written to; for example, it was not opened as a writable key, or the user does not have the required access rights. - The nesting level exceeds 510. - - -or- - + The nesting level exceeds 510. + + -or- + A system error occurred, such as deletion of the key or an attempt to create a key in the root. The user does not have the permissions required to create or open the registry key. @@ -837,10 +837,10 @@ is . - Deletion of a root hive is attempted. - - -or- - + Deletion of a root hive is attempted. + + -or- + does not specify a valid registry subkey. An I/O error has occurred. The user does not have the permissions required to delete the key. @@ -886,10 +886,10 @@ Indicates whether an exception should be raised if the specified subkey cannot be found. If this argument is and the specified subkey does not exist, an exception is raised. If this argument is and the specified subkey does not exist, no action is taken. Deletes the specified subkey and any child subkeys recursively, and specifies whether an exception is raised if the subkey is not found. To be added. - An attempt was made to delete the root hive of the tree. - - -or- - + An attempt was made to delete the root hive of the tree. + + -or- + does not specify a valid registry subkey, and is . is . @@ -1021,10 +1021,10 @@ - is not a valid reference to a value and is . - - -or- - + is not a valid reference to a value and is . + + -or- + is . The user does not have the permissions required to delete the value. The being manipulated is closed (closed keys cannot be accessed). @@ -1745,13 +1745,11 @@ The user does not have the permissions required to read from the registry key. The that contains the specified value is closed (closed keys cannot be accessed). - The subkey that contains the specified value does not exist. - - -or- - - The name/value pair specified by does not exist. - - This exception is not thrown on Windows 95, Windows 98, or Windows Millennium Edition. + The subkey that contains the specified value does not exist. + + -or- + + The name/value pair specified by does not exist. The user does not have the necessary registry rights. @@ -2480,10 +2478,10 @@ contains an invalid value. The is closed (closed keys cannot be accessed). - includes invalid registry rights values. - - -or- - + includes invalid registry rights values. + + -or- + The user does not have the requested permissions. @@ -2644,13 +2642,8 @@ is an unsupported data type. The that contains the specified value is closed (closed keys cannot be accessed). - The is read-only, and cannot be written to; for example, the key has not been opened with write access. - - -or- - - The object represents a root-level node, and the operating system is Windows Millennium Edition or Windows 98. + The is read-only, and cannot be written to; for example, the key has not been opened with write access. The user does not have the permissions required to create or modify registry keys. - The object represents a root-level node, and the operating system is Windows 2000, Windows XP, or Windows Server 2003. @@ -2742,13 +2735,8 @@ is . The type of did not match the registry data type specified by , therefore the data could not be converted properly. The that contains the specified value is closed (closed keys cannot be accessed). - The is read-only, and cannot be written to; for example, the key has not been opened with write access. - - -or- - - The object represents a root-level node, and the operating system is Windows Millennium Edition or Windows 98. + The is read-only, and cannot be written to; for example, the key has not been opened with write access. The user does not have the permissions required to create or modify registry keys. - The object represents a root-level node, and the operating system is Windows 2000, Windows XP, or Windows Server 2003. @@ -2952,10 +2940,10 @@ Gets the view that was used to create the registry key. - The view that was used to create the registry key. - - -or- - + The view that was used to create the registry key. + + -or- + , if no view was used. System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. The attempt to create a system events window thread did not succeed. - - This message is provided only for compatibility with 16-bit Windows-based applications. - diff --git a/xml/System.CodeDom.Compiler/CodeDomProvider.xml b/xml/System.CodeDom.Compiler/CodeDomProvider.xml index 1cb42270847..9f9bf9ed6d5 100644 --- a/xml/System.CodeDom.Compiler/CodeDomProvider.xml +++ b/xml/System.CodeDom.Compiler/CodeDomProvider.xml @@ -292,9 +292,6 @@ ]]> - - You should implement the members in the class and throw a when this method is called. - @@ -409,9 +406,6 @@ ]]> - - You should implement the members in the class and throw a when this method is called. - diff --git a/xml/System.Collections.Generic/Dictionary`2.xml b/xml/System.Collections.Generic/Dictionary`2.xml index 2295806519b..994dda9099f 100644 --- a/xml/System.Collections.Generic/Dictionary`2.xml +++ b/xml/System.Collections.Generic/Dictionary`2.xml @@ -789,14 +789,7 @@ A object containing the information required to serialize the . A structure containing the source and destination of the serialized stream associated with the . Initializes a new instance of the class with serialized data. - - - + To be added. @@ -1433,14 +1426,7 @@ The only mutating methods that do not invalidate enumerators are A object that contains the information required to serialize the instance. A structure that contains the source and destination of the serialized stream associated with the instance. Implements the interface and returns the data needed to serialize the instance. - - . - - ]]> - + To be added. is . @@ -1666,7 +1652,6 @@ The only mutating methods that do not invalidate enumerators are - diff --git a/xml/System.Collections.Generic/HashSet`1.xml b/xml/System.Collections.Generic/HashSet`1.xml index 427acbc182f..3c706bbae9e 100644 --- a/xml/System.Collections.Generic/HashSet`1.xml +++ b/xml/System.Collections.Generic/HashSet`1.xml @@ -580,14 +580,7 @@ The following example demonstrates how to merge two disparate sets. This example A object that contains the information required to serialize the object. A structure that contains the source and destination of the serialized stream associated with the object. Initializes a new instance of the class with serialized data. - - - + To be added. @@ -1463,14 +1456,7 @@ The following example demonstrates how to merge two disparate sets. This example A object that contains the information required to serialize the object. A structure that contains the source and destination of the serialized stream associated with the object. Implements the interface and returns the data needed to serialize a object. - - . - - ]]> - + To be added. is . diff --git a/xml/System.Collections.Generic/IEqualityComparer`1.xml b/xml/System.Collections.Generic/IEqualityComparer`1.xml index 076064d4edb..2a816d35fd6 100644 --- a/xml/System.Collections.Generic/IEqualityComparer`1.xml +++ b/xml/System.Collections.Generic/IEqualityComparer`1.xml @@ -221,7 +221,6 @@ Implementations are required to ensure that if the method returns for two objects and , then the value returned by the method for must equal the value returned for . - diff --git a/xml/System.Collections.Generic/KeyNotFoundException.xml b/xml/System.Collections.Generic/KeyNotFoundException.xml index 8759840fa76..ddac5279274 100644 --- a/xml/System.Collections.Generic/KeyNotFoundException.xml +++ b/xml/System.Collections.Generic/KeyNotFoundException.xml @@ -252,14 +252,7 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. diff --git a/xml/System.Collections.Generic/LinkedList`1+Enumerator.xml b/xml/System.Collections.Generic/LinkedList`1+Enumerator.xml index c172bf25d6a..585b5b15dbd 100644 --- a/xml/System.Collections.Generic/LinkedList`1+Enumerator.xml +++ b/xml/System.Collections.Generic/LinkedList`1+Enumerator.xml @@ -451,7 +451,6 @@ - diff --git a/xml/System.Collections.Generic/LinkedList`1.xml b/xml/System.Collections.Generic/LinkedList`1.xml index 80490fad5bb..9a0e6bb4f5d 100644 --- a/xml/System.Collections.Generic/LinkedList`1.xml +++ b/xml/System.Collections.Generic/LinkedList`1.xml @@ -300,18 +300,7 @@ A object containing the information required to serialize the . A object containing the source and destination of the serialized stream associated with the . Initializes a new instance of the class that is serializable with the specified and . - - accepts `null` as a valid for reference types and allows duplicate values. - - If the is empty, the and properties contain `null`. - - This constructor is an O(n) operation. - - ]]> - + To be added. @@ -1513,14 +1502,7 @@ A object that contains the information required to serialize the instance. A object that contains the source and destination of the serialized stream associated with the instance. Implements the interface and returns the data needed to serialize the instance. - - . - - ]]> - + To be added. is . @@ -1651,7 +1633,6 @@ - diff --git a/xml/System.Collections.Generic/SortedSet`1.xml b/xml/System.Collections.Generic/SortedSet`1.xml index cfb48766e14..6885995bd99 100644 --- a/xml/System.Collections.Generic/SortedSet`1.xml +++ b/xml/System.Collections.Generic/SortedSet`1.xml @@ -393,14 +393,7 @@ The object that contains the information that is required to serialize the object. The structure that contains the source and destination of the serialized stream associated with the object. Initializes a new instance of the class that contains serialized data. - - - + To be added. diff --git a/xml/System.Collections.Specialized/CollectionsUtil.xml b/xml/System.Collections.Specialized/CollectionsUtil.xml index 4db14d88b24..48ebcc83d38 100644 --- a/xml/System.Collections.Specialized/CollectionsUtil.xml +++ b/xml/System.Collections.Specialized/CollectionsUtil.xml @@ -179,7 +179,6 @@ ]]> - Performing Culture-Insensitive String Operations in Collections @@ -240,7 +239,6 @@ is . - Performing Culture-Insensitive String Operations in Collections @@ -300,7 +298,6 @@ is less than zero. - Performing Culture-Insensitive String Operations in Collections diff --git a/xml/System.Collections.Specialized/HybridDictionary.xml b/xml/System.Collections.Specialized/HybridDictionary.xml index 2e0b80c4ff5..c04948796f9 100644 --- a/xml/System.Collections.Specialized/HybridDictionary.xml +++ b/xml/System.Collections.Specialized/HybridDictionary.xml @@ -100,7 +100,6 @@ - Performing Culture-Insensitive String Operations diff --git a/xml/System.Collections.Specialized/NameObjectCollectionBase.xml b/xml/System.Collections.Specialized/NameObjectCollectionBase.xml index 723884d7c59..3c9c7e4c98c 100644 --- a/xml/System.Collections.Specialized/NameObjectCollectionBase.xml +++ b/xml/System.Collections.Specialized/NameObjectCollectionBase.xml @@ -174,7 +174,6 @@ This class uses - Performing Culture-Insensitive String Operations @@ -295,7 +294,6 @@ This class uses is less than zero. - Performing Culture-Insensitive String Operations @@ -352,25 +350,8 @@ This class uses The that will supply the hash codes for all keys in the instance. The to use to determine whether two keys are equal. Initializes a new instance of the class that is empty, has the default initial capacity, and uses the specified hash code provider and the specified comparer. - - is the number of elements that the can hold. As elements are added to a , the capacity is automatically increased as required by reallocating the internal array. - - If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the . - - The hash code provider dispenses hash codes for keys in the instance. The default hash code provider is the . - - The comparer determines whether two keys are equal. The default comparer is the . - - This constructor is an O(1) operation. - - ]]> - - + To be added. - Performing Culture-Insensitive String Operations @@ -488,14 +469,7 @@ This class uses A object that contains the information required to serialize the new instance. A object that contains the source and destination of the serialized stream associated with the new instance. Initializes a new instance of the class that is serializable and uses the specified and . - - - + To be added. @@ -556,26 +530,9 @@ This class uses The that will supply the hash codes for all keys in the instance. The to use to determine whether two keys are equal. Initializes a new instance of the class that is empty, has the specified initial capacity and uses the specified hash code provider and the specified comparer. - - is the number of elements that the can hold. As elements are added to a , the capacity is automatically increased as required by reallocating the internal array. - - If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the . - - The hash code provider dispenses hash codes for keys in the instance. The default hash code provider is the . - - The comparer determines whether two keys are equal. The default comparer is the . - - This constructor is an O(`n`) operation, where `n` is `capacity`. - - ]]> - + To be added. is less than zero. - - Performing Culture-Insensitive String Operations @@ -1641,14 +1598,7 @@ This class uses A object that contains the information required to serialize the instance. A object that contains the source and destination of the serialized stream associated with the instance. Implements the interface and returns the data needed to serialize the instance. - - . - - ]]> - + To be added. is . @@ -1833,7 +1783,6 @@ This class uses The object associated with the current instance is invalid. - diff --git a/xml/System.Collections.Specialized/NameValueCollection.xml b/xml/System.Collections.Specialized/NameValueCollection.xml index 3c66711e2a0..d27bc4d4a0a 100644 --- a/xml/System.Collections.Specialized/NameValueCollection.xml +++ b/xml/System.Collections.Specialized/NameValueCollection.xml @@ -152,7 +152,6 @@ ]]> - Performing Culture-Insensitive String Operations @@ -275,7 +274,6 @@ is . - Performing Culture-Insensitive String Operations @@ -338,7 +336,6 @@ is less than zero. - Performing Culture-Insensitive String Operations @@ -395,24 +392,7 @@ The that will supply the hash codes for all keys in the . The to use to determine whether two keys are equal. Initializes a new instance of the class that is empty, has the default initial capacity and uses the specified hash code provider and the specified comparer. - - is the number of elements that the can hold. As elements are added to a , the capacity is automatically increased as required by reallocating the internal array. - - If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the . - - The hash code provider dispenses hash codes for keys in the . The default hash code provider is the . - - The comparer determines whether two keys are equal. The default comparer is the . - - This constructor is an O(1) operation. - - ]]> - - - + To be added. Performing Culture-Insensitive String Operations @@ -542,7 +522,6 @@ is less than zero. is . - Performing Culture-Insensitive String Operations @@ -598,14 +577,7 @@ A object that contains the information required to serialize the new instance. A object that contains the source and destination of the serialized stream associated with the new instance. Initializes a new instance of the class that is serializable and uses the specified and . - - - + To be added. @@ -666,25 +638,9 @@ The that will supply the hash codes for all keys in the . The to use to determine whether two keys are equal. Initializes a new instance of the class that is empty, has the specified initial capacity and uses the specified hash code provider and the specified comparer. - - is the number of elements that the can hold. As elements are added to a , the capacity is automatically increased as required by reallocating the internal array. - - If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the . - - The hash code provider dispenses hash codes for keys in the . The default hash code provider is the . - - The comparer determines whether two keys are equal. The default comparer is the . - - This constructor is an O(`n`) operation, where `n` is `capacity`. - - ]]> - + To be added. is less than zero. - Performing Culture-Insensitive String Operations diff --git a/xml/System.Collections.Specialized/OrderedDictionary.xml b/xml/System.Collections.Specialized/OrderedDictionary.xml index e4587b2213e..37c30f5cc0f 100644 --- a/xml/System.Collections.Specialized/OrderedDictionary.xml +++ b/xml/System.Collections.Specialized/OrderedDictionary.xml @@ -380,14 +380,7 @@ A object containing the information required to serialize the collection. A object containing the source and destination of the serialized stream associated with the . Initializes a new instance of the class that is serializable using the specified and objects. - - collection must be unique. The default comparer is the key's implementation of . - - ]]> - + To be added. diff --git a/xml/System.Collections/CaseInsensitiveComparer.xml b/xml/System.Collections/CaseInsensitiveComparer.xml index eb7d5d2f81b..6ef0396d56e 100644 --- a/xml/System.Collections/CaseInsensitiveComparer.xml +++ b/xml/System.Collections/CaseInsensitiveComparer.xml @@ -89,7 +89,6 @@ The class is the default implementation of th - Performing Culture-Insensitive String Operations in Collections diff --git a/xml/System.Collections/CaseInsensitiveHashCodeProvider.xml b/xml/System.Collections/CaseInsensitiveHashCodeProvider.xml index d6108f1230a..83a6469c523 100644 --- a/xml/System.Collections/CaseInsensitiveHashCodeProvider.xml +++ b/xml/System.Collections/CaseInsensitiveHashCodeProvider.xml @@ -63,22 +63,8 @@ Supplies a hash code for an object, using a hashing algorithm that ignores the case of strings. - - implements the interface supporting case-insensitive comparisons on strings, just as implements the interface supporting case-insensitive comparisons on strings. - -> [!IMPORTANT] -> We don't recommend that you use the `CaseInsensitiveHashCodeProvider` class for new development. Instead, we recommend that you use the object returned by the , , or property. - - The objects used as keys by a are required to override the method (or the interface) and the method (or the interface). The implementation of both methods or interfaces must handle case sensitivity the same way; otherwise, the might behave incorrectly. For example, when creating a , you must use this class with the class or any case-insensitive implementation. - - ]]> - + To be added. - diff --git a/xml/System.Collections/Comparer.xml b/xml/System.Collections/Comparer.xml index 26d7744e0b9..79c4b971551 100644 --- a/xml/System.Collections/Comparer.xml +++ b/xml/System.Collections/Comparer.xml @@ -477,14 +477,7 @@ The object to populate with data. The context information about the source or destination of the serialization. Populates a object with the data required for serialization. - - method is not visible to COM clients by default, inheriting the class can expose it and can cause undesirable behavior in COM clients. - - ]]> - + To be added. is . diff --git a/xml/System.Collections/Hashtable.xml b/xml/System.Collections/Hashtable.xml index 7aa9d21363d..8ab7f23aa63 100644 --- a/xml/System.Collections/Hashtable.xml +++ b/xml/System.Collections/Hashtable.xml @@ -155,7 +155,6 @@ Each element is a key/value pair stored in a - @@ -748,27 +747,7 @@ Each element is a key/value pair stored in a to use the default comparer, which is each key's implementation of . Initializes a new, empty instance of the class using the default initial capacity and load factor, and the specified hash code provider and comparer. - - object. The default hash code provider is the key's implementation of . - - The comparer determines whether two keys are equal. Every key in a must be unique. The default comparer is the key's implementation of . - - The custom hash code provider and the custom comparer enable scenarios such as doing lookups with case-insensitive strings. - - This constructor is an `O(1)` operation. - - ]]> - - + To be added. @@ -1010,26 +989,7 @@ Each element is a key/value pair stored in a A object containing the information required to serialize the object. A object containing the source and destination of the serialized stream associated with the . Initializes a new, empty instance of the class that is serializable using the specified and objects. - - object. The default hash code provider is the key's implementation of . - - The comparer determines whether two keys are equal. Every key in a must be unique. The default comparer is the key's implementation of . - - This constructor is an `O(n)` operation, where `n` is . - - Because serializing and deserializing an enumerator for a can cause the elements to become reordered, it is not possible to continue enumeration without calling the method. - - ]]> - + To be added. is . @@ -1115,32 +1075,10 @@ Each element is a key/value pair stored in a to use the default comparer, which is each key's implementation of . Initializes a new instance of the class by copying the elements from the specified dictionary to the new object. The new object has an initial capacity equal to the number of elements copied, and uses the default load factor, and the specified hash code provider and comparer. This API is obsolete. For an alternative, see . - - object. The default hash code provider is the key's implementation of . - - The comparer determines whether two keys are equal. Every key in a must be unique. The default comparer is the key's implementation of . - - The custom hash code provider and the custom comparer enable scenarios such as doing lookups with case-insensitive strings. - - The elements of the new are sorted in the same order in which the enumerator iterates through the object. - - This constructor is an `O(n)` operation, where `n` is the number of elements in the `d` parameter. - - ]]> - + To be added. is . - @@ -1319,29 +1257,9 @@ Each element is a key/value pair stored in a to use the default comparer, which is each key's implementation of . Initializes a new, empty instance of the class using the specified initial capacity, hash code provider, comparer, and the default load factor. - - object. Capacity is automatically increased as required based on the load factor. - - The load factor is the maximum ratio of elements to buckets. A smaller load factor means faster lookup at the cost of increased memory consumption. - - When the actual load factor reaches the specified load factor, the number of buckets is automatically increased to the smallest prime number that is larger than twice the current number of buckets. - - The hash code provider dispenses hash codes for keys in the . The default hash code provider is the key's implementation of . - - The comparer determines whether two keys are equal. Every key in a must be unique. The default comparer is the key's implementation of . - - The custom hash code provider and the custom comparer enable scenarios such as doing lookups with case-insensitive strings. - - This constructor is an `O(n)` operation, where `n` is the `capacity` parameter. - - ]]> - + To be added. is less than zero. - @@ -1522,28 +1440,7 @@ Each element is a key/value pair stored in a to use the default comparer, which is each key's implementation of . Initializes a new instance of the class by copying the elements from the specified dictionary to the new object. The new object has an initial capacity equal to the number of elements copied, and uses the specified load factor, hash code provider, and comparer. - - object. The default hash code provider is the key's implementation of . - - The comparer determines whether two keys are equal. Every key in a must be unique. The default comparer is the key's implementation of . - - The custom hash code provider and the custom comparer enable scenarios such as doing lookups with case-insensitive strings. - - The elements of the new are sorted in the same order in which the enumerator iterates through the object. - - This constructor is an `O(n)` operation, where `n` is the number of elements in the `d` parameter. - - ]]> - + To be added. is . @@ -1624,26 +1521,7 @@ Each element is a key/value pair stored in a to use the default comparer, which is each key's implementation of . Initializes a new, empty instance of the class using the specified initial capacity, load factor, hash code provider, and comparer. - - object. Capacity is automatically increased as required based on the load factor. - - The load factor is the maximum ratio of elements to buckets. A smaller load factor means faster lookup at the cost of increased memory consumption. A load factor of 1.0 is the best balance between speed and size. - - When the actual load factor reaches the specified load factor, the number of buckets is automatically increased to the smallest prime number that is larger than twice the current number of buckets. - - The hash code provider dispenses hash codes for keys in the . The default hash code provider is the key's implementation of . - - The comparer determines whether two keys are equal. Every key in a must be unique. The default comparer is the key's implementation of . - - The custom hash code provider and the custom comparer enable scenarios such as doing lookups with case-insensitive strings. - - This constructor is an `O(n)` operation, where `n` is the `capacity` parameter. - - ]]> - + To be added. is less than zero. @@ -1654,7 +1532,6 @@ Each element is a key/value pair stored in a is greater than 1.0. - @@ -1958,14 +1835,7 @@ Each element is a key/value pair stored in a Gets or sets the to use for the . The to use for the . - - - + To be added. The property is set to a value, but the hash table was created using an . @@ -2574,7 +2444,6 @@ This method uses the collection's objects' and is . - @@ -2640,14 +2509,7 @@ This method uses the collection's objects' and A object containing the information required to serialize the . A object containing the source and destination of the serialized stream associated with the . Implements the interface and returns the data needed to serialize the . - - . - - ]]> - + To be added. is . The collection was modified. @@ -2717,16 +2579,8 @@ This method uses the collection's objects' and Gets or sets the object that can dispense hash codes. The object that can dispense hash codes. - - - + To be added. The property is set to a value, but the hash table was created using an . - @@ -3237,7 +3091,6 @@ This method uses the collection's objects' and The object associated with the current is invalid. - diff --git a/xml/System.Collections/IEqualityComparer.xml b/xml/System.Collections/IEqualityComparer.xml index 75385c792b8..d930f27a8c2 100644 --- a/xml/System.Collections/IEqualityComparer.xml +++ b/xml/System.Collections/IEqualityComparer.xml @@ -199,7 +199,6 @@ The `IEqualityComparer` interface supports only equality comparisons. Customizat Implementations are required to ensure that if the method returns for two objects and , then the value returned by the method for must equal the value returned for . - diff --git a/xml/System.Collections/IHashCodeProvider.xml b/xml/System.Collections/IHashCodeProvider.xml index 1b44f1e4c7b..074b9e8b489 100644 --- a/xml/System.Collections/IHashCodeProvider.xml +++ b/xml/System.Collections/IHashCodeProvider.xml @@ -76,24 +76,9 @@ Supplies a hash code for an object, using a custom hash function. - - [!IMPORTANT] -> We don't recommend that you use the `IHashCodeProvider` interface for new development. Its recommended replacement is the or interface. - -The interface is used in conjunction with the class. The objects used as keys by a object must override the and methods. or the key's implementation of is used as the hash code provider. or the key's implementation of is used as the comparer. - - However, some overloads of the constructor take a parameter that is an implementation, or a parameter that is an implementation, or both. If an implementation is passed to the constructor, the method of that implementation is used as the hash code provider. If an implementation is passed to the constructor, the method of that implementation is used as the comparer. - - ]]> - + To be added. - - diff --git a/xml/System.ComponentModel.DataAnnotations/FilterUIHintAttribute.xml b/xml/System.ComponentModel.DataAnnotations/FilterUIHintAttribute.xml index c9224568a5b..5a54dbb0788 100644 --- a/xml/System.ComponentModel.DataAnnotations/FilterUIHintAttribute.xml +++ b/xml/System.ComponentModel.DataAnnotations/FilterUIHintAttribute.xml @@ -53,42 +53,7 @@ Represents an attribute that is used to specify the filtering behavior for a column. - - _ -Public Class Product - Private Class Product_MD - _ - Public Property Category As Object - End Property - - _ - Public Property Discontinued As Object - End Property - - End Class -End Class -``` - - ]]> - + To be added. diff --git a/xml/System.ComponentModel.DataAnnotations/ValidationException.xml b/xml/System.ComponentModel.DataAnnotations/ValidationException.xml index 717278fc970..b138e95df89 100644 --- a/xml/System.ComponentModel.DataAnnotations/ValidationException.xml +++ b/xml/System.ComponentModel.DataAnnotations/ValidationException.xml @@ -187,14 +187,7 @@ The object that holds the serialized data. Context information about the source or destination of the serialized object. Initializes a new instance of the class using serialized data. - - - + To be added. diff --git a/xml/System.ComponentModel.Design.Serialization/RootDesignerSerializerAttribute.xml b/xml/System.ComponentModel.Design.Serialization/RootDesignerSerializerAttribute.xml index daf2fed5565..d3c92fd7679 100644 --- a/xml/System.ComponentModel.Design.Serialization/RootDesignerSerializerAttribute.xml +++ b/xml/System.ComponentModel.Design.Serialization/RootDesignerSerializerAttribute.xml @@ -71,31 +71,7 @@ Indicates the base serializer to use for a root designer object. This class cannot be inherited. - - indicates the serializer to use when the serialization manager serializes the design document, and whether the specified serializer supports automatic reloading of the design document without first completely disposing of the document. - - This attribute contains the following significant members: - -- indicates what serialization object to use to serialize the class at design time. - -- indicates the fully qualified name of the serialization object's base type. - -- indicates whether the serializer supports reloading a design document without user interaction to open a new designer view. - - - -## Examples - The following example code applies a to a component. - - :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/IDesignerSerializationManagerSample/CPP/idesignerserializationmanagersample.cpp" id="Snippet2"::: - :::code language="csharp" source="~/snippets/csharp/System.ComponentModel.Design.Serialization/CodeDomSerializer/Overview/idesignerserializationmanagersample.cs" id="Snippet2"::: - :::code language="vb" source="~/snippets/visualbasic/System.ComponentModel.Design.Serialization/CodeDomSerializer/Overview/idesignerserializationmanagersample.vb" id="Snippet2"::: - - ]]> - + To be added. diff --git a/xml/System.ComponentModel.Design/DesignSurface.xml b/xml/System.ComponentModel.Design/DesignSurface.xml index be7c1aca148..4b543312731 100644 --- a/xml/System.ComponentModel.Design/DesignSurface.xml +++ b/xml/System.ComponentModel.Design/DesignSurface.xml @@ -485,14 +485,7 @@ The type of component to create. Creates an instance of a component. The newly created component. - - method is called by the design surface's method to create an instance of a component. The component should be created and added to the public container on the design surface. - - ]]> - + To be added. is . The attached to the has been disposed. diff --git a/xml/System.ComponentModel/RecommendedAsConfigurableAttribute.xml b/xml/System.ComponentModel/RecommendedAsConfigurableAttribute.xml index 32a528fb13b..ba353772167 100644 --- a/xml/System.ComponentModel/RecommendedAsConfigurableAttribute.xml +++ b/xml/System.ComponentModel/RecommendedAsConfigurableAttribute.xml @@ -63,14 +63,7 @@ Specifies that the property can be used as an application setting. - - set to `true` display when you expand the **ConfigurableProperties** line in the **Properties** window. A property that has no recommended setting or that is marked with set to `false` is not shown and is an unlikely candidate for being an application setting. The default is `false`. - - ]]> - + To be added. @@ -118,7 +111,6 @@ if the property this attribute is bound to can be used as an application setting; otherwise, . Initializes a new instance of the class. To be added. - @@ -160,7 +152,6 @@ Specifies the default value for the , which is . This field is read-only. To be added. - @@ -355,7 +346,6 @@ ]]> - @@ -400,7 +390,6 @@ if the property this attribute is bound to can be used as an application setting; otherwise, . To be added. - @@ -455,7 +444,6 @@ ]]> - diff --git a/xml/System.ComponentModel/TypeDescriptor.xml b/xml/System.ComponentModel/TypeDescriptor.xml index 96ac4758256..ce808988aab 100644 --- a/xml/System.ComponentModel/TypeDescriptor.xml +++ b/xml/System.ComponentModel/TypeDescriptor.xml @@ -724,7 +724,6 @@ ]]> - diff --git a/xml/System.Configuration/ConfigurationPermissionAttribute.xml b/xml/System.Configuration/ConfigurationPermissionAttribute.xml index 9f022f187ac..6a5abde432e 100644 --- a/xml/System.Configuration/ConfigurationPermissionAttribute.xml +++ b/xml/System.Configuration/ConfigurationPermissionAttribute.xml @@ -86,7 +86,6 @@ The security action represented by an enumeration member of . Determines the permission state of the attribute. Initializes a new instance of the class. To be added. - diff --git a/xml/System.Data.Common/DataAdapter.xml b/xml/System.Data.Common/DataAdapter.xml index 1105f930c28..7628f337066 100644 --- a/xml/System.Data.Common/DataAdapter.xml +++ b/xml/System.Data.Common/DataAdapter.xml @@ -370,19 +370,7 @@ Creates a copy of this instance of . The cloned instance of . - - constructor should be used instead of this method. - - All the commands, the , the , and the are cloned. However, the connections for the commands are not copied, but shared. Thus, the cloned can be used against the same connection as the original. - - ]]> - - - When overriding in a derived class, be sure to call the base class's method. - + To be added. ADO.NET Overview diff --git a/xml/System.Data.Common/DbDataReader.xml b/xml/System.Data.Common/DbDataReader.xml index cce4812ef7d..5dc017317df 100644 --- a/xml/System.Data.Common/DbDataReader.xml +++ b/xml/System.Data.Common/DbDataReader.xml @@ -2148,9 +2148,7 @@ private static void GetCredits(String connectionString) Returns if the executed command returned no resultset, or after returns . A that describes the column metadata. To be added. - The is closed. - The column index is out of range. - In all cases. + The base class implementation always throws this exception. ADO.NET Overview diff --git a/xml/System.Data.Common/DbException.xml b/xml/System.Data.Common/DbException.xml index 31c85f4521b..648a99bc1e7 100644 --- a/xml/System.Data.Common/DbException.xml +++ b/xml/System.Data.Common/DbException.xml @@ -237,14 +237,7 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. Initializes a new instance of the class with the specified serialization information and context. - - class is an abstract class used as the base class for provider-specific exception class implementations. - - ]]> - + To be added. ADO.NET Overview diff --git a/xml/System.Data.Odbc/OdbcParameterCollection.xml b/xml/System.Data.Odbc/OdbcParameterCollection.xml index b1161a80304..69809c176d4 100644 --- a/xml/System.Data.Odbc/OdbcParameterCollection.xml +++ b/xml/System.Data.Odbc/OdbcParameterCollection.xml @@ -250,14 +250,7 @@ INSERT INTO MyTable VALUES (@p1, @p2, @p3); The of the to add to the collection. Adds an to the given the parameter name and value. The index of the new object. - - method to specify integer parameter values. Because this overload takes a `value` of type , you must convert the integer value to an type when the value is zero. If you don't perform this conversion, the compiler will assume you are attempting to call the overload. - - ]]> - + To be added. The parameter is not an . Working with Commands Using Parameters with a DataAdapter diff --git a/xml/System.Data.OleDb/OleDbParameterCollection.xml b/xml/System.Data.OleDb/OleDbParameterCollection.xml index 82d7041bd60..a9b95958ead 100644 --- a/xml/System.Data.OleDb/OleDbParameterCollection.xml +++ b/xml/System.Data.OleDb/OleDbParameterCollection.xml @@ -252,14 +252,7 @@ The of the to add to the collection. Adds an to the given the parameter name and value. The index of the new object. - - method to specify integer parameter values. Because this overload takes a `value` of type , you must convert the value to an type when the value is zero.If you don't perform this conversion, the compiler will assume you are attempting to call the overload. - - ]]> - + To be added. The parameter is not an . Working with Commands Using Parameters with a DataAdapter diff --git a/xml/System.Data.SqlTypes/SqlTypeException.xml b/xml/System.Data.SqlTypes/SqlTypeException.xml index d8ce224b003..bbada9f6f2b 100644 --- a/xml/System.Data.SqlTypes/SqlTypeException.xml +++ b/xml/System.Data.SqlTypes/SqlTypeException.xml @@ -214,14 +214,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System.Data/DataSet.xml b/xml/System.Data/DataSet.xml index 25f8ea69a3f..0bb5d961fa3 100644 --- a/xml/System.Data/DataSet.xml +++ b/xml/System.Data/DataSet.xml @@ -323,15 +323,7 @@ The following example consists of several methods that, combined, create and fil The serialized data for the data set. Contextual information about the serialized stream. Initializes a new instance of the class with serialized data. - - - + To be added. .NET 7 and later versions only: contains binary data. @@ -398,11 +390,9 @@ The following example consists of several methods that, combined, create and fil +]]> .NET 7 and later versions only: contains binary data. diff --git a/xml/System.Data/DataTable.xml b/xml/System.Data/DataTable.xml index 38549863482..bbf90bec088 100644 --- a/xml/System.Data/DataTable.xml +++ b/xml/System.Data/DataTable.xml @@ -331,14 +331,7 @@ This sample demonstrates how to create a DataTable manually with specific schema The serialized data for the data set. Contextual information about the serialized stream. Initializes a new instance of the class with serialized data. - - constructor is required for . - - ]]> - + To be added. .NET 7 and later versions only: contains binary data. DataTables diff --git a/xml/System.Data/StrongTypingException.xml b/xml/System.Data/StrongTypingException.xml index 7e2d4707ac0..317989cbc3d 100644 --- a/xml/System.Data/StrongTypingException.xml +++ b/xml/System.Data/StrongTypingException.xml @@ -216,14 +216,7 @@ A object. A structure. Initializes a new instance of the class using the specified serialization information and streaming context. - - class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality. - - ]]> - + To be added. diff --git a/xml/System.Diagnostics.PerformanceData/CounterType.xml b/xml/System.Diagnostics.PerformanceData/CounterType.xml index 3a73991de1b..98f0fc05dba 100644 --- a/xml/System.Diagnostics.PerformanceData/CounterType.xml +++ b/xml/System.Diagnostics.PerformanceData/CounterType.xml @@ -30,14 +30,7 @@ Defines the possible types of counters. Each counter is assigned a counter type. The counter type determines how the counter data is calculated, averaged, and displayed. - - - + To be added. diff --git a/xml/System.Diagnostics.SymbolStore/ISymbolBinder.xml b/xml/System.Diagnostics.SymbolStore/ISymbolBinder.xml index 796a91cafed..48d4cab56af 100644 --- a/xml/System.Diagnostics.SymbolStore/ISymbolBinder.xml +++ b/xml/System.Diagnostics.SymbolStore/ISymbolBinder.xml @@ -123,14 +123,7 @@ The search path used to locate the symbol file. Gets the interface of the symbol reader for the current file. The interface that reads the debugging symbols. - - method returns the interface that reads the debugging symbols associated with the module. - - ]]> - + To be added. diff --git a/xml/System.Diagnostics/EventLog.xml b/xml/System.Diagnostics/EventLog.xml index d46b995697b..e0e6f3310dd 100644 --- a/xml/System.Diagnostics/EventLog.xml +++ b/xml/System.Diagnostics/EventLog.xml @@ -68,7 +68,7 @@ On Windows, User Account Control (UAC) determines the credentials of a user. If To write to an event log, specify or create an event source ( property). You must have administrative credentials on the computer to create a new event source. The event source registers your application with the event log as a valid source of entries. You can use the event source to write to only one log at a time. The property can be any random string, but the name must be distinct from other sources on the computer. The event source is typically the name of the application or another identifying string. Trying to create a duplicate value throws an exception. However, a single event log can be associated with multiple sources. - If the event source for the event log associated with the instance doesn't exist, a new event source is created. To create an event source in Windows Vista and later or Windows Server 2003, you must have administrative credentials. + If the event source for the event log associated with the instance doesn't exist, a new event source is created. To create an event source on Windows, you must have administrative credentials. This requirement is because all event logs, including Security logs, must be searched to determine whether the event source is unique. Users don't have permission to access the Security log; therefore, a is thrown. @@ -622,7 +622,7 @@ On Windows, User Account Control (UAC) determines the credentials of a user. If The method uses the input `sourceData` , and properties to create registry values on the target computer for the new source and its associated event log. A new source name cannot match an existing source name or an existing event log name on the target computer. If the property is not set, the source is registered for the Application event log. If the is not set, the source is registered on the local computer. > [!NOTE] -> To create an event source in Windows Vista and later or Windows Server 2003, you must have administrative privileges. +> To create an event source on Windows, you must have administrative privileges. > > The reason for this requirement is that all event logs, including security, must be searched to determine whether the event source is unique. Starting with Windows Vista, users do not have permission to access the security log; therefore, a is thrown. > @@ -858,7 +858,7 @@ SVC_UPDATE.EXE If `logName` is `null` or an empty string ("") when you call , the log defaults to the Application log. If the log does not exist on the local computer, the system creates a custom log and registers your application as a for that log. > [!NOTE] -> To create an event source in Windows Vista and later or Windows Server 2003, you must have administrative privileges. +> To create an event source on Windows, you must have administrative privileges. > > The reason for this requirement is that all event logs, including security, must be searched to determine whether the event source is unique. Starting with Windows Vista, users do not have permission to access the security log; therefore, a is thrown. > @@ -994,7 +994,7 @@ SVC_UPDATE.EXE You only need to create an event source if you are writing to the event log. Before writing an entry to an event log, you must register the event source with the event log as a valid source of events. When you write a log entry, the system uses the to find the appropriate log in which to place your entry. If you are reading the event log, you can either specify the , or a and . > [!NOTE] -> To create an event source in Windows Vista and later or Windows Server 2003, you must have administrative privileges. +> To create an event source on Windows, you must have administrative privileges. > > The reason for this requirement is that all event logs, including security, must be searched to determine whether the event source is unique. In Windows Vista and later, users do not have permission to access the security log; therefore, a is thrown. > @@ -2917,7 +2917,7 @@ SVC_UPDATE.EXE Because this method accesses the registry, you must have the appropriate registry permissions on the local computer; otherwise, a will be thrown. > [!NOTE] -> To search for an event source in Windows Vista and later or Windows Server 2003, you must have administrative privileges. +> To search for an event source on Windows, you must have administrative privileges. > > The reason for this requirement is that all event logs, including security, must be searched to determine whether the event source is unique. Starting with Windows Vista, users do not have permission to access the security log; therefore, a is thrown. > @@ -3006,7 +3006,7 @@ SVC_UPDATE.EXE Because this method accesses the registry, you must have the appropriate registry permissions on the given server; otherwise, a will be thrown. > [!NOTE] -> To search for an event source in Windows Vista and later or Windows Server 2003, you must have administrative privileges. +> To search for an event source on Windows, you must have administrative privileges. > > The reason for this requirement is that all event logs, including security, must be searched to determine whether the event source is unique. Starting with Windows Vista, users do not have permission to access the security log; therefore, a is thrown. > diff --git a/xml/System.Diagnostics/EventLogPermission.xml b/xml/System.Diagnostics/EventLogPermission.xml index de949763e43..f0cef58c502 100644 --- a/xml/System.Diagnostics/EventLogPermission.xml +++ b/xml/System.Diagnostics/EventLogPermission.xml @@ -166,7 +166,6 @@ Initializes a new instance of the class with the specified permission state. To be added. The parameter is not a valid value of . - diff --git a/xml/System.Diagnostics/EventLogPermissionAttribute.xml b/xml/System.Diagnostics/EventLogPermissionAttribute.xml index f0e5c575b32..29a3849fa52 100644 --- a/xml/System.Diagnostics/EventLogPermissionAttribute.xml +++ b/xml/System.Diagnostics/EventLogPermissionAttribute.xml @@ -92,7 +92,6 @@ One of the values. Initializes a new instance of the class. To be added. - diff --git a/xml/System.Diagnostics/PerformanceCounter.xml b/xml/System.Diagnostics/PerformanceCounter.xml index 7d0e3eee83a..e58f70f32ce 100644 --- a/xml/System.Diagnostics/PerformanceCounter.xml +++ b/xml/System.Diagnostics/PerformanceCounter.xml @@ -50,13 +50,13 @@ To publish performance counter data, create one or more custom counters using the method, create an instance of the class, set the , and, optionally, or properties, and then call the , , or methods, or set the property to change the value of your custom counter. > [!NOTE] -> The , , and methods use interlocks to update the counter value. This helps keep the counter value accurate in multithreaded or multiprocess scenarios, but also results in a performance penalty. If you do not need the accuracy that interlocked operations provide, you can update the property directly for up to a 5 times performance improvement. However, in multithreaded scenarios, some updates to the counter value might be ignored, resulting in inaccurate data. +> The , , and methods use interlocks to update the counter value. This helps keep the counter value accurate in multithreaded or multiprocess scenarios, but also results in a performance penalty. If you do not need the accuracy that interlocked operations provide, you can update the property directly for up to a 5 times performance improvement. However, in multithreaded scenarios, some updates to the counter value might be ignored, resulting in inaccurate data. The counter is the mechanism by which performance data is collected. The registry stores the names of all the counters, each of which is related to a specific area of system functionality. Examples include a processor's busy time, memory usage, or the number of bytes received over a network connection. Each counter is uniquely identified through its name and its location. In the same way that a file path includes a drive, a directory, one or more subdirectories, and a file name, counter information consists of four elements: the computer, the category, the category instance, and the counter name. - The counter information must include the category, or performance object, that the counter measures data for. A computer's categories include physical components, such as processors, disks, and memory. There are also system categories, such as processes and threads. Each category is related to a functional element within the computer and has a set of standard counters assigned to it. These objects are listed in the Performance object drop-down list of the Add Counters dialog box within the Windows 2000 System Monitor, and you must include them in the counter path. Performance data is grouped by the category to which is it related. + The counter information must include the category, or performance object, that the counter measures data for. A computer's categories include physical components, such as processors, disks, and memory. There are also system categories, such as processes and threads. Each category is related to a functional element within the computer and has a set of standard counters assigned to it. These objects are listed in the Performance object drop-down list of the Add Counters dialog box within the Windows System Monitor, and you must include them in the counter path. Performance data is grouped by the category to which is it related. In certain cases, several copies of the same category can exist. For example, several processes and threads run simultaneously, and some computers contain more than one processor. The category copies are called category instances, and each instance has a set of standard counters assigned to it. If a category can have more than one instance, an instance specification must be included in the counter information. @@ -126,7 +126,7 @@ This constructor does not initialize the performance counter, so it does not associate the instance with an existing counter on the local computer. To point to a specific performance counter, set the , , and, optionally, the and properties before reading any other properties or attempting to read from a counter. To write to a performance counter, set the property to `false`. > [!NOTE] -> The attribute applied to this member has the following property value: | . The does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). For more information, see the class or [SQL Server Programming and Host Protection Attributes](/dotnet/framework/performance/sql-server-programming-and-host-protection-attributes). +> The attribute applied to this member has the following property value: | . The does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). For more information, see the class or [SQL Server Programming and Host Protection Attributes](/dotnet/framework/performance/sql-server-programming-and-host-protection-attributes). ## Examples The following code example creates a default instance of the class. After the instance is created, the , , and property values are set, and the results of a call to the method are displayed. @@ -185,7 +185,7 @@ This constructor initializes the performance counter and associates the instance with an existing counter (either a system or a custom counter) on the local computer. The values that you pass in for the and properties must point to an existing performance counter on the local computer. > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. ]]> @@ -263,10 +263,10 @@ This constructor initializes the performance counter and associates the instance with an existing counter (either a system or a custom counter) on the local computer. The values that you pass in for the and properties must point to an existing performance counter on the local computer. If the performance counter instance that you point to is not valid, calling the constructor throws an exception. > [!NOTE] -> You can use this overload to connect to a system counter, but you cannot write to a system counter. Therefore, setting `readOnly` to `false` when connecting to a system counter causes the constructor to throw an exception. +> You can use this overload to connect to a system counter, but you cannot write to a system counter. Therefore, setting `readOnly` to `false` when connecting to a system counter causes the constructor to throw an exception. > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. ## Examples The following code example creates an instance of the class. The example passes in category names, counter names, and a flag value indicating that the counter is not read-only. This code example is part of a larger example for the class. @@ -438,7 +438,7 @@ This constructor initializes the performance counter and associates the instance with an existing counter (either a system or a custom counter) on the local computer. The values that you pass in for the , , and properties must point to an existing performance counter on the local computer. If the performance counter instance that you point to is not valid, calling the constructor throws an exception. > [!NOTE] -> You can use this overload to connect to a system counter, but you cannot write to a system counter. Therefore, setting `readOnly` to `false` when connecting to a system counter causes the constructor to throw an exception. +> You can use this overload to connect to a system counter, but you cannot write to a system counter. Therefore, setting `readOnly` to `false` when connecting to a system counter causes the constructor to throw an exception. To create a performance category instance, specify an `instanceName` on the constructor. If the category instance specified by `instanceName` already exists the new object will reference the existing category instance. @@ -532,7 +532,7 @@ This constructor initializes the performance counter and associates the instance with an existing counter (either a system or a custom counter) on the specified computer. The values that you pass in for the , , and properties must point to an existing performance counter. If the performance counter instance you point to is not valid, calling the constructor throws an exception. This overload can access any read-only or read/write counter, but does so in a read-only mode. A instance created using this overload cannot write to the counter, even if the counter itself is read/write. > [!NOTE] -> You cannot write to remote performance counters. There is no overload that allows you to specify a read/write instance of the class that connects to a remote computer. +> You cannot write to remote performance counters. There is no overload that allows you to specify a read/write instance of the class that connects to a remote computer. To create a performance category instance, specify an `instanceName` on the constructor. If the category instance specified by `instanceName` already exists the new object will reference the existing category instance. @@ -540,7 +540,7 @@ > To read performance counters in Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > [!NOTE] -> In Windows Vista, when the remote computer is a member of a workgroup, you may need to disable UAC so that the local user account is not filtered and can be elevated to an administrator account. For security reasons, disabling UAC should be a last resort. For information on disabling UAC, see [User Account Control and WMI](/windows/win32/wmisdk/user-account-control-and-wmi). +> In Windows Vista, when the remote computer is a member of a workgroup, you may need to disable UAC so that the local user account is not filtered and can be elevated to an administrator account. For security reasons, disabling UAC should be a last resort. For information on disabling UAC, see [User Account Control and WMI](/windows/win32/wmisdk/user-account-control-and-wmi). ]]> @@ -959,7 +959,7 @@ You can write only to custom counters. All system counters are read-only. > [!NOTE] -> The , , and methods use interlocks to update the counter value. This helps keep the counter value accurate in multithreaded or multiprocess scenarios, but also results in a performance penalty. If you do not need the accuracy that interlocked operations provide, you can update the property directly for up to a 5 times performance improvement. However, in multithreaded scenarios, some updates to the counter value might be ignored, resulting in inaccurate data. +> The , , and methods use interlocks to update the counter value. This helps keep the counter value accurate in multithreaded or multiprocess scenarios, but also results in a performance penalty. If you do not need the accuracy that interlocked operations provide, you can update the property directly for up to a 5 times performance improvement. However, in multithreaded scenarios, some updates to the counter value might be ignored, resulting in inaccurate data. ]]> @@ -1147,7 +1147,7 @@ You can write only to custom counters. All system counters are read-only. > [!NOTE] -> The , , and methods use interlocks to update the counter value. This helps keep the counter value accurate in multithreaded or multiprocess scenarios, but also results in a performance penalty. If you do not need the accuracy that interlocked operations provide, you can update the property directly for up to a 5 times performance improvement. However, in multithreaded scenarios, some updates to the counter value might be ignored, resulting in inaccurate data. +> The , , and methods use interlocks to update the counter value. This helps keep the counter value accurate in multithreaded or multiprocess scenarios, but also results in a performance penalty. If you do not need the accuracy that interlocked operations provide, you can update the property directly for up to a 5 times performance improvement. However, in multithreaded scenarios, some updates to the counter value might be ignored, resulting in inaccurate data. ]]> @@ -1207,7 +1207,7 @@ You can write only to custom counters. All system counters are read-only. > [!NOTE] -> The , , and methods use interlocks to update the counter value. This helps keep the counter value accurate in multithreaded or multiprocess scenarios, but also results in a performance penalty. If you do not need the accuracy that interlocked operations provide, you can update the property directly for up to a 5 times performance improvement. However, in multithreaded scenarios, some updates to the counter value might be ignored, resulting in inaccurate data. +> The , , and methods use interlocks to update the counter value. This helps keep the counter value accurate in multithreaded or multiprocess scenarios, but also results in a performance penalty. If you do not need the accuracy that interlocked operations provide, you can update the property directly for up to a 5 times performance improvement. However, in multithreaded scenarios, some updates to the counter value might be ignored, resulting in inaccurate data. @@ -1316,7 +1316,7 @@ ## Remarks > [!NOTE] -> Instance names must be shorter than 128 characters in length. +> Instance names must be shorter than 128 characters in length. In some situations, categories are subdivided into instances, which track data about multiple occurrences of the object that a category relates to. Instances apply to the category as whole, rather than to individual counters. Every counter within a category has each instance defined for the category. For example, the Process category contains instances named Idle and System. Every counter within the Process category thus contains data for each instance, showing information about either idle processes or system processes. @@ -1327,7 +1327,7 @@ To create a performance category instance, specify an `instanceName` on the constructor. If the category instance specified by `instanceName` already exists the new object will reference the existing category instance. > [!NOTE] -> Do not use the characters "(", ")", "#", "\\", or "/" in the instance name. If any of these characters are used, the Performance Console (see [Runtime Profiling](/dotnet/framework/debug-trace-profile/runtime-profiling)) may not correctly display the instance values. +> Do not use the characters "(", ")", "#", "\\", or "/" in the instance name. If any of these characters are used, the Performance Console (see [Runtime Profiling](/dotnet/framework/debug-trace-profile/runtime-profiling)) may not correctly display the instance values. If the instance name is automatically generated and might contain the characters "(", ")", "#", "\\", or "/", use the character mapping in the following table. @@ -1498,10 +1498,10 @@ ## Remarks > [!NOTE] -> If the calculated value of a counter depends on two counter reads, the first read operation returns 0.0. Resetting the performance counter properties to specify a different counter is equivalent to creating a new performance counter, and the first read operation using the new properties returns 0.0. The recommended delay time between calls to the method is one second, to allow the counter to perform the next incremental read. +> If the calculated value of a counter depends on two counter reads, the first read operation returns 0.0. Resetting the performance counter properties to specify a different counter is equivalent to creating a new performance counter, and the first read operation using the new properties returns 0.0. The recommended delay time between calls to the method is one second, to allow the counter to perform the next incremental read. > [!NOTE] -> To read performance counters, you must have administrative privileges. In Windows Vista, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> To read performance counters, you must have administrative privileges. In Windows Vista, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. @@ -1561,7 +1561,7 @@ Because system counters are read-only, you can get but not set their raw values. > [!NOTE] -> The , , and methods use interlocks to update the counter value. This helps keep the counter value accurate in multithreaded or multiprocess scenarios, but also results in a performance penalty. If you do not need the accuracy that interlocked operations provide, you can update the property directly for up to a 5 times performance improvement. However, in multithreaded scenarios, some updates to the counter value might be ignored, resulting in inaccurate data. +> The , , and methods use interlocks to update the counter value. This helps keep the counter value accurate in multithreaded or multiprocess scenarios, but also results in a performance penalty. If you do not need the accuracy that interlocked operations provide, you can update the property directly for up to a 5 times performance improvement. However, in multithreaded scenarios, some updates to the counter value might be ignored, resulting in inaccurate data. > [!NOTE] > To read performance counters in Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. @@ -1671,7 +1671,7 @@ You can remove an instance only for a custom counter. All system counters are read-only, so attempting to remove one of them throws an exception. > [!NOTE] -> To avoid a possible race condition when the performance counter shared memory is released, it is recommended that the method be called from the event handler. +> To avoid a possible race condition when the performance counter shared memory is released, it is recommended that the method be called from the event handler. To create a performance category instance, specify an `instanceName` on the constructor. If the category instance specified by `instanceName` already exists the new object will reference the existing category instance. diff --git a/xml/System.Diagnostics/PerformanceCounterCategory.xml b/xml/System.Diagnostics/PerformanceCounterCategory.xml index 1639c0dd918..33050bb2f7c 100644 --- a/xml/System.Diagnostics/PerformanceCounterCategory.xml +++ b/xml/System.Diagnostics/PerformanceCounterCategory.xml @@ -39,7 +39,7 @@ ## Remarks > [!IMPORTANT] -> Creating or deleting a performance counter requires synchronization of the underlying code by using a named mutex. If a highly privileged application locks the named mutex, attempts to create or delete a performance counter causes the application to stop responding until the lock is released. To help avoid this problem, never grant permission to untrusted code. In addition, permission potentially allows other permissions to be bypassed and should only be granted to highly trusted code. +> Creating or deleting a performance counter requires synchronization of the underlying code by using a named mutex. If a highly privileged application locks the named mutex, attempts to create or delete a performance counter causes the application to stop responding until the lock is released. To help avoid this problem, never grant permission to untrusted code. In addition, permission potentially allows other permissions to be bypassed and should only be granted to highly trusted code. The instance's property is displayed in the Performance Object field of the Performance Viewer application's Add Counter dialog box. @@ -52,10 +52,10 @@ Although your system makes many more counter categories available, the categories that you will probably interact with most frequently are the Cache, Memory, Objects, PhysicalDisk, Process, Processor, Server, System, and Thread categories. > [!IMPORTANT] -> The method in the class will release the counter and, if the reuse option is selected for that category, the instance of the counter will be reused. This could cause a race condition if another process or even another part of the code is trying to write to the counter instance. +> The method in the class will release the counter and, if the reuse option is selected for that category, the instance of the counter will be reused. This could cause a race condition if another process or even another part of the code is trying to write to the counter instance. > [!NOTE] -> It is strongly recommended that new performance counter categories be created during the installation of the application, not during the execution of the application. This allows time for the operating system to refresh its list of registered performance counter categories. If the list has not been refreshed, the attempt to use the category will fail. +> It is strongly recommended that new performance counter categories be created during the installation of the application, not during the execution of the application. This allows time for the operating system to refresh its list of registered performance counter categories. If the list has not been refreshed, the attempt to use the category will fail. > [!NOTE] > Performance counter categories installed with .NET use separate shared memory, with each performance counter category having its own memory. You can specify the size of separate shared memory by creating a DWORD named FileMappingSize in the registry key HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\\*\*\Performance. The FileMappingSize value is set to the shared memory size of the category. The default size is 131072 decimal. @@ -439,11 +439,11 @@ If you have not set the property, this method uses the local computer ("."). > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. ## Examples The following code example determines whether a exists. It gets a category name, counter name, and computer name from the command line, if they are given. It creates a object using the appropriate . It then uses the method to determine whether the specified exists, and informs the user. @@ -508,11 +508,11 @@ ## Remarks > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. ## Examples The following code example determines whether a exists. It gets a category name, counter name, and computer name from the command line, if they are given. It uses the static overloads of the method to determine whether the specified name exists in the . The overload is selected based on whether a computer name is provided. @@ -583,11 +583,11 @@ ## Remarks > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. ## Examples The following code example determines whether a exists. It gets a category name, counter name, and computer name from the command line, if they are given. It uses the static overloads of the method to determine whether the specified name exists in the . The overload is selected based on whether a computer name is provided. @@ -680,11 +680,11 @@ ## Remarks > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. ]]> @@ -856,11 +856,11 @@ ## Remarks > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. ]]> @@ -941,14 +941,14 @@ Performance counter categories installed with .NET use separate shared memory, with each performance counter category having its own memory. You can specify the size of separate shared memory by creating a DWORD named FileMappingSize in the registry key HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\\*\*\Performance. The FileMappingSize value is set to the shared memory size of the category. The default size is 131072 decimal. If the FileMappingSize value is not present, the `fileMappingSize` attribute value for the `performanceCounters` element specified in the Machine.config file is used, causing additional overhead for configuration file processing. You can realize a performance improvement for application startup by setting the file mapping size in the registry. > [!NOTE] -> It is strongly recommended that new performance counter categories be created during the installation of the application, not during the execution of the application. This allows time for the operating system to refresh its list of registered performance counter categories. If the list has not been refreshed, the attempt to use the category will fail. +> It is strongly recommended that new performance counter categories be created during the installation of the application, not during the execution of the application. This allows time for the operating system to refresh its list of registered performance counter categories. If the list has not been refreshed, the attempt to use the category will fail. > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. @@ -1027,11 +1027,11 @@ You can delete only custom performance counter categories from the system. You cannot delete a counter from a category. To do so, delete the category and recreate the category with the counters you want to retain. To avoid an exception, confirm that the category exists before you attempt to delete it. > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. @@ -1104,11 +1104,11 @@ Use of the method can result in a noticeable performance penalty while all performance counters on the machine are checked for availability. If you are only writing to a performance counter, you can avoid the global search for performance counters by creating the performance counter when the application is installed and assuming the category exists when accessing the counter. There is no way to avoid the performance counter search when reading from performance counters. > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. @@ -1174,11 +1174,11 @@ Use of the method can result in a noticeable performance penalty while all performance counters on the machine are checked for availability. If you are only writing to a performance counter, you can avoid the global search for performance counters by creating the performance counter when the application is installed and assuming the category exists when accessing the counter. There is no way to avoid the performance counter search when reading from performance counters. > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. @@ -1255,11 +1255,11 @@ ## Remarks > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. @@ -1319,11 +1319,11 @@ To retrieve the categories on the local computer, use another overload or pass "." as the `machineName` parameter. > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. @@ -1390,11 +1390,11 @@ For more information about performance object instances, see the class overview. > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. @@ -1460,11 +1460,11 @@ For more information about performance object instances, see the class overview. > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. @@ -1528,11 +1528,11 @@ ## Remarks > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. @@ -1609,11 +1609,11 @@ This overload of is not `static`. It requires you to create a object and to set the property. > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. @@ -1682,11 +1682,11 @@ It is not possible to determine whether a performance object instance exists on a computer without specifying a specific category to look in. > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. @@ -1762,11 +1762,11 @@ You can use "." to specify the local computer. > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. @@ -1886,11 +1886,11 @@ Reading the entire category at once can be as efficient as reading a single counter because of the way that the system provides the data. > [!NOTE] -> To read performance counters from a non-interactive logon session in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges. +> To read performance counters from a non-interactive logon session on Windows, you must either be a member of the Performance Monitor Users group or have administrative privileges. > -> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. +> To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group. > -> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. +> In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator. diff --git a/xml/System.Diagnostics/PerformanceCounterPermissionAttribute.xml b/xml/System.Diagnostics/PerformanceCounterPermissionAttribute.xml index 55cffef4d30..792f98a560d 100644 --- a/xml/System.Diagnostics/PerformanceCounterPermissionAttribute.xml +++ b/xml/System.Diagnostics/PerformanceCounterPermissionAttribute.xml @@ -92,7 +92,6 @@ One of the values. Initializes a new instance of the class. To be added. - diff --git a/xml/System.Diagnostics/Process.xml b/xml/System.Diagnostics/Process.xml index 21ac5addef6..72fb0de414e 100644 --- a/xml/System.Diagnostics/Process.xml +++ b/xml/System.Diagnostics/Process.xml @@ -1651,8 +1651,6 @@ The following code example creates a process that prints a file. It sets the [!NOTE] > Multiple Windows services can be loaded within the same instance of the Service Host process (svchost.exe). GetProcesses does not identify those individual services; for that, see . - - ## Examples The following example retrieves information of the current process, processes running on the local computer, all instances of Notepad running on the local computer, and a specific process on the local computer. It then retrieves information for the same processes on a remote computer. @@ -1665,7 +1663,6 @@ The following code example creates a process that prints a file. It sets the The parameter syntax is invalid. It might have length zero (0). The parameter is . The operating system platform does not support this operation on remote computers. - There are problems accessing the performance counter APIs used to get process information. This exception is specific to Windows NT, Windows 2000, and Windows XP. A problem occurred accessing an underlying system API. @@ -1770,7 +1767,6 @@ The following code example creates a process that prints a file. It sets the - There are problems accessing the performance counter APIs used to get process information. This exception is specific to Windows NT, Windows 2000, and Windows XP. @@ -1873,11 +1869,7 @@ The following code example creates a process that prints a file. It sets the The parameter syntax is invalid. It might have length zero (0). The parameter is . The operating system platform does not support this operation on remote computers. - The attempt to connect to has failed. - - -or- - -There are problems accessing the performance counter APIs used to get process information. This exception is specific to Windows NT, Windows 2000, and Windows XP. + The attempt to connect to has failed. A problem occurred accessing an underlying system API. @@ -3688,16 +3680,7 @@ If no main module is found, it could be because the process hasn't finished load Gets the peak working set size for the associated process, in bytes. The maximum amount of physical memory that the associated process has required all at once, in bytes. - - - + To be added. @@ -4147,9 +4130,6 @@ If no main module is found, it could be because the process hasn't finished load ## Remarks The property holds an executable file name, such as Outlook, that does not include the .exe extension or the path. It is helpful for getting and manipulating all the processes that are associated with the same executable file. -> [!NOTE] -> On Windows 2000 operating systems, the property may be truncated to 15 characters if the process module information cannot be obtained. - You can call , passing it an executable file name, to retrieve an array that contains every running instance on the specified computer. You can use this array, for example, to shut down all the running instances of the executable file. ]]> @@ -4219,19 +4199,19 @@ If no main module is found, it could be because the process hasn't finished load ## Remarks The value returned by this property represents the most recently refreshed affinity of the process. To get the most up to date affinity, you need to call method first. - In Windows 2000 and later, a thread in a process can migrate from processor to processor, with each migration reloading the processor cache. Under heavy system loads, specifying which processor should run a specific thread can improve performance by reducing the number of times the processor cache is reloaded. The association between a processor and a thread is called the processor affinity. +A thread in a process can migrate from processor to processor, with each migration reloading the processor cache. Under heavy system loads, specifying which processor should run a specific thread can improve performance by reducing the number of times the processor cache is reloaded. The association between a processor and a thread is called the processor affinity. Each processor is represented as a bit. Bit 0 is processor one, bit 1 is processor two, and so forth. If you set a bit to the value 1, the corresponding processor is selected for thread assignment. When you set the value to zero, the operating system's scheduling algorithms set the thread's affinity. When the value is set to any nonzero value, the value is interpreted as a bitmask that specifies those processors eligible for selection. The following table shows a selection of values for an eight-processor system. -|Bitmask|Binary value|Eligible processors| -|-------------|------------------|-------------------------| -|0x0001|00000000 00000001|1| -|0x0003|00000000 00000011|1 and 2| -|0x0007|00000000 00000111|1, 2 and 3| -|0x0009|00000000 00001001|1 and 4| -|0x007F|00000000 01111111|1, 2, 3, 4, 5, 6 and 7| +| Bitmask | Binary value | Eligible processors | +|---------|-------------------|------------------------| +| 0x0001 | 00000000 00000001 | 1 | +| 0x0003 | 00000000 00000011 | 1 and 2 | +| 0x0007 | 00000000 00000111 | 1, 2 and 3 | +| 0x0009 | 00000000 00001001 | 1 and 4 | +| 0x007F | 00000000 01111111 | 1, 2, 3, 4, 5, 6 and 7 | ]]> @@ -7293,21 +7273,9 @@ No process is associated with this o Gets the associated process's physical memory usage, in bytes. The total amount of physical memory the associated process is using, in bytes. - - method first. - - The working set of a process is the set of memory pages currently visible to the process in physical RAM memory. These pages are resident and available for an application to use without triggering a page fault. - - The working set includes both shared and private data. The shared data includes the pages that contain all the instructions that the process executes, including the process modules and the system libraries. - - ]]> - + To be added. - diff --git a/xml/System.Diagnostics/ProcessStartInfo.xml b/xml/System.Diagnostics/ProcessStartInfo.xml index 6a92b2a8a62..4081d2a036f 100644 --- a/xml/System.Diagnostics/ProcessStartInfo.xml +++ b/xml/System.Diagnostics/ProcessStartInfo.xml @@ -975,9 +975,7 @@ If you use this property to set command-line arguments, diff --git a/xml/System.DirectoryServices.ActiveDirectory/ReplicationCursor.xml b/xml/System.DirectoryServices.ActiveDirectory/ReplicationCursor.xml index 48eb390a4a7..5c5be56104c 100644 --- a/xml/System.DirectoryServices.ActiveDirectory/ReplicationCursor.xml +++ b/xml/System.DirectoryServices.ActiveDirectory/ReplicationCursor.xml @@ -59,7 +59,6 @@ ]]> - This property is not supported on Windows 2000. diff --git a/xml/System.DirectoryServices.ActiveDirectory/TrustType.xml b/xml/System.DirectoryServices.ActiveDirectory/TrustType.xml index baeebad181c..eccf07bf76a 100644 --- a/xml/System.DirectoryServices.ActiveDirectory/TrustType.xml +++ b/xml/System.DirectoryServices.ActiveDirectory/TrustType.xml @@ -93,7 +93,7 @@ 4 - The trust relationship is between two forest root domains in separate Windows Server 2003 forests. + The trust relationship is between two forest root domains in separate Windows Server forests. diff --git a/xml/System.DirectoryServices.Protocols/LocatorFlags.xml b/xml/System.DirectoryServices.Protocols/LocatorFlags.xml index cf34f747592..18c15536ed7 100644 --- a/xml/System.DirectoryServices.Protocols/LocatorFlags.xml +++ b/xml/System.DirectoryServices.Protocols/LocatorFlags.xml @@ -71,7 +71,7 @@ 32 - Attempts to find a domain controller that supports directory service functions (Windows 2000 or later). The value is equal to 32 or 0x20. + Attempts to find a domain controller that supports directory service functions. The value is equal to 32 or 0x20. diff --git a/xml/System.DirectoryServices/AuthenticationTypes.xml b/xml/System.DirectoryServices/AuthenticationTypes.xml index 8bee8f632bb..e349b8fbc7d 100644 --- a/xml/System.DirectoryServices/AuthenticationTypes.xml +++ b/xml/System.DirectoryServices/AuthenticationTypes.xml @@ -27,22 +27,22 @@ The enumeration specifies the types of authentication used in . This enumeration has a attribute that allows a bitwise combination of its member values. - [!NOTE] -> None of these options are supported by the Novell Netware Directory Service (NDS) system provider. - +> None of these options are supported by the Novell Netware Directory Service (NDS) system provider. + ]]> diff --git a/xml/System.DirectoryServices/DirectorySearcher.xml b/xml/System.DirectoryServices/DirectorySearcher.xml index 390bee82ad6..6cd9e3825cb 100644 --- a/xml/System.DirectoryServices/DirectorySearcher.xml +++ b/xml/System.DirectoryServices/DirectorySearcher.xml @@ -1023,7 +1023,7 @@ SearchResultCollection res = src.FindAll(); System.Collections.Specialized.StringCollection - Gets a value indicating the list of properties to retrieve during the search. + Gets a list of properties to retrieve during the search. A object that contains the set of properties to retrieve during the search. The default is an empty , which retrieves all properties. @@ -1031,9 +1031,9 @@ SearchResultCollection res = src.FindAll(); diff --git a/xml/System.DirectoryServices/DirectoryServicesCOMException.xml b/xml/System.DirectoryServices/DirectoryServicesCOMException.xml index d621aa1e47e..a8888503eb1 100644 --- a/xml/System.DirectoryServices/DirectoryServicesCOMException.xml +++ b/xml/System.DirectoryServices/DirectoryServicesCOMException.xml @@ -247,7 +247,6 @@ The object that is the destination for this serialization. Populates the object with the data needed to serialize the object. To be added. - diff --git a/xml/System.DirectoryServices/DirectoryServicesPermission.xml b/xml/System.DirectoryServices/DirectoryServicesPermission.xml index 5511a1cb0cd..23383fbe435 100644 --- a/xml/System.DirectoryServices/DirectoryServicesPermission.xml +++ b/xml/System.DirectoryServices/DirectoryServicesPermission.xml @@ -159,7 +159,6 @@ Initializes a new instance of the class with the specified permission state. To be added. The parameter is not a valid value of . - diff --git a/xml/System.DirectoryServices/DirectoryServicesPermissionAttribute.xml b/xml/System.DirectoryServices/DirectoryServicesPermissionAttribute.xml index d9c447cc0a2..817d6c3ef61 100644 --- a/xml/System.DirectoryServices/DirectoryServicesPermissionAttribute.xml +++ b/xml/System.DirectoryServices/DirectoryServicesPermissionAttribute.xml @@ -91,7 +91,6 @@ Initializes a new instance of the class. To be added. - diff --git a/xml/System.Drawing.Printing/PrintingPermissionAttribute.xml b/xml/System.Drawing.Printing/PrintingPermissionAttribute.xml index e868c3407bc..88a3d628222 100644 --- a/xml/System.Drawing.Printing/PrintingPermissionAttribute.xml +++ b/xml/System.Drawing.Printing/PrintingPermissionAttribute.xml @@ -87,7 +87,6 @@ One of the values. Initializes a new instance of the class. To be added. - diff --git a/xml/System.Drawing.Text/PrivateFontCollection.xml b/xml/System.Drawing.Text/PrivateFontCollection.xml index d353c306222..3832dabe7b5 100644 --- a/xml/System.Drawing.Text/PrivateFontCollection.xml +++ b/xml/System.Drawing.Text/PrivateFontCollection.xml @@ -123,7 +123,7 @@ is not supported on operating systems before Windows 2000. When using a private font on operating systems before Windows 2000, the default font, typically Microsoft Sans Serif, will be substituted. + Windows Forms applications support TrueType fonts and have limited support for OpenType fonts. If you try to use a font that is not supported, such as an unsupported OpenType font or a Bitmap font, an exception will occur. ]]> diff --git a/xml/System.Drawing/SystemFonts.xml b/xml/System.Drawing/SystemFonts.xml index 9364d11d574..8ac3c18e0de 100644 --- a/xml/System.Drawing/SystemFonts.xml +++ b/xml/System.Drawing/SystemFonts.xml @@ -185,8 +185,7 @@ property returns Tahoma, 8 point. Otherwise, returns the value of the property. The returned by does not change when the user is in High Contrast mode. For a font that changes when the user is in High Contrast mode use another system font such as . + returns the value of the property. The returned by does not change when the user is in High Contrast mode. For a font that changes when the user is in High Contrast mode, use another system font such as . ]]> diff --git a/xml/System.Globalization/CultureInfo.xml b/xml/System.Globalization/CultureInfo.xml index eb76fa10f4b..d04b21e5cc3 100644 --- a/xml/System.Globalization/CultureInfo.xml +++ b/xml/System.Globalization/CultureInfo.xml @@ -1192,7 +1192,6 @@ The following example demonstrates how to change the - diff --git a/xml/System.Globalization/CultureNotFoundException.xml b/xml/System.Globalization/CultureNotFoundException.xml index 18b1c302524..ed97b9b7976 100644 --- a/xml/System.Globalization/CultureNotFoundException.xml +++ b/xml/System.Globalization/CultureNotFoundException.xml @@ -264,14 +264,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class using the specified serialization data and context. - - - + To be added. @@ -684,16 +677,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Sets the object with the parameter name and additional exception information. - - sets a with all the exception object data targeted for serialization. During deserialization, the exception object is reconstituted from the transmitted over the stream. - - For more information, see . - - ]]> - + To be added. is . diff --git a/xml/System.IO.Compression/CompressionLevel.xml b/xml/System.IO.Compression/CompressionLevel.xml index 0f7aeaa478a..fa1349287a8 100644 --- a/xml/System.IO.Compression/CompressionLevel.xml +++ b/xml/System.IO.Compression/CompressionLevel.xml @@ -47,7 +47,24 @@ enumeration to indicate which factor is more important in your development scenario: the time to complete the compression operation or the size of the compressed file. These values do not correspond to specific compression levels; the object that implements compression determines how to handle them. + +The following methods of the , , , , and classes include a parameter named `compressionLevel` that lets you specify the compression level: + +- +- +- +- +- +- +- + +## Examples + +The following example shows how to set the compression level when creating a zip archive by using the class. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipFile/CreateFromDirectory/program3.cs" id="Snippet3"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipFile/CreateFromDirectory/program3.vb" id="Snippet3"::: ]]> diff --git a/xml/System.IO.Compression/DeflateStream.xml b/xml/System.IO.Compression/DeflateStream.xml index 8753696a584..4d861bf9a07 100644 --- a/xml/System.IO.Compression/DeflateStream.xml +++ b/xml/System.IO.Compression/DeflateStream.xml @@ -134,7 +134,14 @@ The following example shows how to use the class. -[!INCLUDE[remarks](~/includes/remarks/System.IO.Compression/DeflateStream/.ctor_Stream_CompressionLevel.md)] +This constructor overload uses the compression mode . To set the compression mode to another value, use the or overload. + +## Examples + +The following example shows how to set the compression level when creating a object and how to leave the stream open. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/Deflate/FileCompressionLevelExample.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/Deflate/FileCompressionLevelExample.vb" id="Snippet1"::: ]]> @@ -187,7 +194,18 @@ You use this constructor when you want to specify whether compression efficiency owns the underlying stream, so closing the stream also closes the underlying stream. Note that the state of the underlying stream can affect the usability of the stream. Also, no explicit checks are performed, so no additional exceptions are thrown when the new instance is created. + +If an instance of the class is created with the `mode` parameter equal to `Compress`, header information is inserted immediately. If no further action occurs, the stream appears as a valid, empty, compressed file. + +By default, the compression level is set to when the compression mode is . + +## Examples + +The following example shows how to use the class to compress and decompress a file. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/Deflate/FileCompressionModeExample.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/Deflate/FileCompressionModeExample.vb" id="Snippet1"::: ]]> @@ -255,7 +273,14 @@ You use this constructor when you want to specify whether compression efficiency You use this constructor when you want to specify whether compression efficiency or speed is more important for an instance of the class, and whether to leave the stream object open after disposing the object. -[!INCLUDE[remarks](~/includes/remarks/System.IO.Compression/DeflateStream/.ctor_Stream_CompressionLevel.md)] +This constructor overload uses the compression mode . To set the compression mode to another value, use the or overload. + +## Examples + +The following example shows how to set the compression level when creating a object and how to leave the stream open. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/Deflate/FileCompressionLevelExample.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/Deflate/FileCompressionLevelExample.vb" id="Snippet1"::: ]]> @@ -311,7 +336,18 @@ You use this constructor when you want to specify whether compression efficiency owns the underlying stream, so closing the stream also closes the underlying stream. Note that the state of the underlying stream can affect the usability of the stream. Also, no explicit checks are performed, so no additional exceptions are thrown when the new instance is created. + +If an instance of the class is created with the `mode` parameter equal to `Compress`, header information is inserted immediately. If no further action occurs, the stream appears as a valid, empty, compressed file. + +By default, the compression level is set to when the compression mode is . + +## Examples + +The following example shows how to use the class to compress and decompress a file. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/Deflate/FileCompressionModeExample.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/Deflate/FileCompressionModeExample.vb" id="Snippet1"::: ]]> diff --git a/xml/System.IO.Compression/ZipArchive.xml b/xml/System.IO.Compression/ZipArchive.xml index f194e69f2bc..a1ffa5776c7 100644 --- a/xml/System.IO.Compression/ZipArchive.xml +++ b/xml/System.IO.Compression/ZipArchive.xml @@ -62,7 +62,38 @@ , , and . + +|To|Use| +|--------|--------| +|Create a zip archive from a directory|| +|Extract the contents of a zip archive to a directory|| +|Add new files to an existing zip archive|| +|Retrieve a file from a zip archive|| +|Retrieve all the files from a zip archive|| +|Open a stream to a single file contained in a zip archive|| +|Delete a file from a zip archive|| + +When you create a new entry, the file is compressed and added to the zip package. The method enables you to specify a directory hierarchy when adding the entry. You include the relative path of the new entry within the zip package. For example, creating a new entry with a relative path of `AddedFolder\NewFile.txt` creates a compressed text file in a directory named AddedFolder. + +The class provides four extension methods for the type: , , , and . These extension methods enable you to compress and decompress the contents of the entry to a file. + +## Examples + +The first example shows how to create a new entry and write to it by using a stream. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/CreateEntry/program1.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/CreateEntry/program1.vb" id="Snippet1"::: + +The following example shows how to open a zip archive and iterate through the collection of entries. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/Entries/program1.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/Entries/program1.vb" id="Snippet1"::: + +The third example shows how to use extension methods to create a new entry in a zip archive from an existing file and extract the archive contents. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/Entries/program3.cs" id="Snippet3"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/Entries/program3.vb" id="Snippet3"::: ]]> @@ -293,7 +324,24 @@ , the stream must support reading. If the `mode` parameter is set to , the stream must support writing. If the `mode` parameter is set to , the stream must support reading, writing, and seeking. + +When you open a zip archive file for reading and `entryNameEncoding` is set to `null`, entry names and comments are decoded according to the following rules: + +- When the language encoding flag (in the general-purpose bit flag of the local file header) is not set, the current system default code page is used to decode the entry name and comment. +- When the language encoding flag is set, UTF-8 is used to decode the entry name and comment. + +When you open a zip archive file for reading and `entryNameEncoding` is set to a value other than `null`, entry names and comments are decoded according to the following rules: + +- When the language encoding flag is not set, the specified `entryNameEncoding` is used to decode the entry name and comment. +- When the language encoding flag is set, UTF-8 is used to decode the entry name and comment. + +When you write to archive files and `entryNameEncoding` is set to `null`, entry names and comments are encoded according to the following rules: + +- For entry names and comments that contain characters outside the ASCII range, the language encoding flag is set, and entry names and comments are encoded by using UTF-8. +- For entry names and comments that contain only ASCII characters, the language encoding flag is not set, and entry names and comments are encoded by using the current system default code page. + +When you write to archive files and `entryNameEncoding` is set to a value other than `null`, the specified `entryNameEncoding` is used to encode the entry names and comments into bytes. The language encoding flag (in the general-purpose bit flag of the local file header) is set only when the specified encoding is a UTF-8 encoding. ]]> diff --git a/xml/System.IO.Compression/ZipArchiveEntry.xml b/xml/System.IO.Compression/ZipArchiveEntry.xml index 26f90366650..b67fdaef3b1 100644 --- a/xml/System.IO.Compression/ZipArchiveEntry.xml +++ b/xml/System.IO.Compression/ZipArchiveEntry.xml @@ -50,7 +50,33 @@ class enables you to examine the properties of an entry, and open or delete the entry. When you open an entry, you can modify the compressed file by writing to the stream for that compressed file. + +The methods for manipulating zip archives and their file entries are spread across three classes: , , and . + +| To... | Use... | +|---------------------------------------|--------| +| Create a zip archive from a directory | | +|Extract the contents of a zip archive to a directory|| +|Add new files to an existing zip archive|| +|Retrieve a file in a zip archive|| +|Retrieve all of the files in a zip archive|| +|To open a stream to an individual file contained in a zip archive|| +|Delete a file from a zip archive|| + +The class provides extension methods for , such as and , which enable you to decompress the contents of the entry to a file. + +## Examples + +The first example shows how to create a new entry in a zip archive and write to it. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/CreateEntry/program1.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/CreateEntry/program1.vb" id="Snippet1"::: + +The second example shows how to use the extension method. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/Entries/program1.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/Entries/program1.vb" id="Snippet1"::: ]]> @@ -359,7 +385,16 @@ If the comment byte length is larger than , it will property contains the relative path, including the subdirectory hierarchy, of an entry in a zip archive. (In contrast, the property contains only the name of the entry and does not include the subdirectory hierarchy.) For example, if you create two entries in a zip archive by using the method and provide `NewEntry.txt` as the name for the first entry and `AddedFolder\NewEntry.txt` for the second entry, both entries will have `NewEntry.txt` in the property. The first entry will also have `NewEntry.txt` in the property, but the second entry will have `AddedFolder\NewEntry.txt` in the property. + +You can specify any string as the path of an entry, including strings that specify invalid and absolute paths. Therefore, the property might contain a value that is not correctly formatted. An invalid or absolute path might result in an exception when you extract the contents of the zip archive. + +## Examples + +The following example shows how to iterate through the contents of a .zip file, and extract files that contain the .txt extension. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/Entries/program1.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/Entries/program1.vb" id="Snippet1"::: ]]> @@ -429,7 +464,16 @@ If the comment byte length is larger than , it will method, the property for the entry is automatically set to the last time the file was modified. When you create a new entry programmatically by calling the method, the property for the entry is automatically set to the time of execution. If you modify the entry, you must explicitly set the property if you want the value to reflect the time of the latest change. + +When you set this property, the value is converted to a timestamp format that is specific to zip archives. This format supports a resolution of two seconds. The earliest permitted value is 1980 January 1 0:00:00 (midnight). The latest permitted value is 2107 December 31 23:59:58 (one second before midnight). If the value for the last write time is not valid, the property returns a default value of 1980 January 1 0:00:00 (midnight). + +## Examples + +The following example shows how to open an entry in a zip archive, modify it, and set the property to the current time. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/GetEntry/program2.cs" id="Snippet2"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/GetEntry/program2.vb" id="Snippet2"::: ]]> @@ -528,7 +572,16 @@ If the comment byte length is larger than , it will property contains the portion of the property that follows the final directory separator character (\\), and does not include the subdirectory hierarchy. For example, if you create two entries in a zip archive by using the method and provide `NewEntry.txt` as the name for the first entry and `AddedFolder\NewEntry.txt` for the second entry, both entries will have `NewEntry.txt` in the property. The first entry will also have `NewEntry.txt` in the property, but the second entry will have `AddedFolder\NewEntry.txt` in the property. + +On Windows, colons (`:`) are also treated as separators due to NTFS rules, which can cause to differ across platforms. For platform-independent behavior, you can use , which always reflects the complete entry name as stored in the archive. + +## Examples + +The following example shows how to retrieve entries from a zip archive and evaluate the properties of the entries. It uses the property to display the name of the entry, and the and properties to calculate how much the file was compressed. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/GetEntry/program1.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/GetEntry/program1.vb" id="Snippet1"::: ]]> diff --git a/xml/System.IO.Compression/ZipArchiveMode.xml b/xml/System.IO.Compression/ZipArchiveMode.xml index dedec63791a..d5a03a8f8fe 100644 --- a/xml/System.IO.Compression/ZipArchiveMode.xml +++ b/xml/System.IO.Compression/ZipArchiveMode.xml @@ -43,7 +43,26 @@ method, the data is written to the underlying stream or file after all the entries are created. + +When you set the mode to Update, the underlying file or stream must support reading, writing, and seeking. The content of the entire archive is held in memory, and no data is written to the underlying file or stream until the archive is disposed. + +The following methods include a parameter named `mode` that lets you specify the archive mode: + +- + +- + +- + +## Examples + +The following example shows how to specify a `ZipArchiveMode` value when creating a object. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/CreateEntry/program1.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/CreateEntry/program1.vb" id="Snippet1"::: ]]> diff --git a/xml/System.IO.Compression/ZipFile.xml b/xml/System.IO.Compression/ZipFile.xml index 52a22ba6129..8f80b442297 100644 --- a/xml/System.IO.Compression/ZipFile.xml +++ b/xml/System.IO.Compression/ZipFile.xml @@ -54,7 +54,24 @@ , , and . + +| To... | Use... | +|---------------------------------------|--------| +| Create a zip archive from a directory | | +| Extract the contents of a zip archive to a directory | | +| Add new files to an existing zip archive | | +| Retrieve a file in a zip archive | | +| Retrieve all of the files in a zip archive | | +| Open a stream to an individual file contained in a zip archive| | +| Delete a file from a zip archive | | + +## Examples + +This example shows how to create and extract a zip archive by using the class. It compresses the contents of a folder into a zip archive, and then extracts that content to a new folder. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipFile/CreateFromDirectory/program1.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipFile/CreateFromDirectory/program1.vb" id="Snippet1"::: ]]> @@ -2501,7 +2518,7 @@ An archive entry has been compressed using a compression method that isn't suppo When you set the `mode` parameter to , the archive is opened with as the file mode value. If the archive already exists, an is thrown. - When you set the `mode` parameter to , the archive is opened with as the file mode value. If the archive exists, it is opened. The existing entries can be modified and new entries can be created. If the archive does not exist, a new archive is created; however, creating a zip archive in mode is not as efficient as creating it in mode. + When you set the `mode` parameter to , the archive is opened with as the file mode value. If the archive exists, it is opened. The existing entries can be modified and new entries can be created. If the archive does not exist, a new archive is created; however, creating a zip archive in mode is not as efficient as creating it in mode. ## Examples The following example shows how to open a zip archive in the update mode and add an entry to the archive. @@ -2610,7 +2627,28 @@ An unspecified I/O error occurred while opening the file. , the archive is opened with as the file mode value. If the archive does not exist, a exception is thrown. Setting the `mode` parameter to is equivalent to calling the method. + +When you set the `mode` parameter to , the archive is opened with as the file mode value. If the archive already exists, an is thrown. + +When you set the `mode` parameter to , the archive is opened with as the file mode value. If the archive exists, it is opened. The existing entries can be modified and new entries can be created. If the archive does not exist, a new archive is created; however, creating a zip archive in mode is not as efficient as creating it in mode. + +When you open a zip archive file for reading and `entryNameEncoding` is set to `null`, entry names and comments are decoded according to the following rules: + +- When the language encoding flag (in the general-purpose bit flag of the local file header) is not set, the current system default code page is used to decode the entry name and comment. +- When the language encoding flag is set, UTF-8 is used to decode the entry name and comment. + +When you open a zip archive file for reading and `entryNameEncoding` is set to a value other than `null`, entry names and comments are decoded according to the following rules: + +- When the language encoding flag is not set, the specified `entryNameEncoding` is used to decode the entry name and comment. +- When the language encoding flag is set, UTF-8 is used to decode the entry name and comment. + +When you write to archive files and `entryNameEncoding` is set to `null`, entry names and comments are encoded according to the following rules: + +- For entry names or comments that contain characters outside the ASCII range, the language encoding flag is set, and entry names and comments are encoded by using UTF-8. +- For entry names or comments that contain only ASCII characters, the language encoding flag is not set, and entry names and comments are encoded by using the current system default code page. + +When you write to archive files and `entryNameEncoding` is set to a value other than `null`, the specified `entryNameEncoding` is used to encode the entry names and comments into bytes. The language encoding flag (in the general-purpose bit flag of the local file header) is set only when the specified encoding is a UTF-8 encoding. ]]> diff --git a/xml/System.IO.Compression/ZipFileExtensions.xml b/xml/System.IO.Compression/ZipFileExtensions.xml index db8d0a85e76..db1875a39d0 100644 --- a/xml/System.IO.Compression/ZipFileExtensions.xml +++ b/xml/System.IO.Compression/ZipFileExtensions.xml @@ -58,7 +58,29 @@ class contains four methods that extend : + +- +- +- +- + +The class contains two methods that extend : + +- +- + +## Examples + +The following example shows how to create a new entry in a zip archive from an existing file, and extract the contents of the archive to a directory. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/Entries/program3.cs" id="Snippet3"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/Entries/program3.vb" id="Snippet3"::: + +The following example shows how to iterate through the contents of a zip archive and extract files that have a .txt extension. + +:::code language="csharp" source="~/snippets/csharp/System.IO.Compression/ZipArchive/Entries/program1.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.IO.Compression/ZipArchive/Entries/program1.vb" id="Snippet1"::: ]]> diff --git a/xml/System.IO.IsolatedStorage/IsolatedStorage.xml b/xml/System.IO.IsolatedStorage/IsolatedStorage.xml index 6355fac5987..8413fc7c740 100644 --- a/xml/System.IO.IsolatedStorage/IsolatedStorage.xml +++ b/xml/System.IO.IsolatedStorage/IsolatedStorage.xml @@ -297,14 +297,7 @@ Gets a value representing the current size of isolated storage. The number of storage units currently used within the isolated storage scope. - - implements this property. In the case of objects, this value is in bytes. In the case of implementations of other storage objects, such as a database, this value might be in other units of storage. - - ]]> - + To be added. The current size of the isolated store is undefined. @@ -579,16 +572,7 @@ Gets a value representing the maximum amount of space available for isolated storage. When overridden in a derived class, this value can take different units of measure. The maximum amount of isolated storage space in bytes. Derived classes can return different units of value. - - property returns the value of , which is expressed in bytes. Derived classes can express the value in other units of measure. A potential example of such an implementation is an isolated storage database. - - You cannot set , but the quota is configured in the security policy, and can be set. Code receives a quota of space on the basis of its evidence, so the same code can receive a different quota if it is run with different evidence (for example, the same application run locally and from a share on an intranet can receive different quotas). implements this property. - - ]]> - + To be added. The quota has not been defined. diff --git a/xml/System.IO.IsolatedStorage/IsolatedStorageException.xml b/xml/System.IO.IsolatedStorage/IsolatedStorageException.xml index fb8b0555336..35cc8591d93 100644 --- a/xml/System.IO.IsolatedStorage/IsolatedStorageException.xml +++ b/xml/System.IO.IsolatedStorage/IsolatedStorageException.xml @@ -238,14 +238,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. diff --git a/xml/System.IO.IsolatedStorage/IsolatedStorageFile.xml b/xml/System.IO.IsolatedStorage/IsolatedStorageFile.xml index 78b68848bef..88be684bb79 100644 --- a/xml/System.IO.IsolatedStorage/IsolatedStorageFile.xml +++ b/xml/System.IO.IsolatedStorage/IsolatedStorageFile.xml @@ -518,18 +518,7 @@ This type implements the interface. When you've finish Gets the current size of the isolated storage. The total number of bytes of storage currently in use within the isolated storage scope. - - property. - - ]]> - + To be added. The property is unavailable. The current store has a roaming scope or is not open. The current object size is undefined. Isolated Storage @@ -2389,16 +2378,7 @@ This type implements the interface. When you've finish Gets a value representing the maximum amount of space available for isolated storage within the limits established by the quota. The limit of isolated storage space in bytes. - - property. - - ]]> - + To be added. The property is unavailable. cannot be determined without evidence from the assembly's creation. The evidence could not be determined when the object was created. An isolated storage error occurred. Isolated Storage diff --git a/xml/System.IO.IsolatedStorage/IsolatedStorageFileStream.xml b/xml/System.IO.IsolatedStorage/IsolatedStorageFileStream.xml index 463302e3261..2551a7349db 100644 --- a/xml/System.IO.IsolatedStorage/IsolatedStorageFileStream.xml +++ b/xml/System.IO.IsolatedStorage/IsolatedStorageFileStream.xml @@ -1403,14 +1403,7 @@ This type implements the interface. When you've finish Gets the file handle for the file that the current object encapsulates. Accessing this property is not permitted on an object, and throws an . The file handle for the file that the current object encapsulates. - - . - - ]]> - + To be added. The property always generates this exception. diff --git a/xml/System.IO.Pipelines/PipeReader.xml b/xml/System.IO.Pipelines/PipeReader.xml index 9295097256d..8796a1affec 100644 --- a/xml/System.IO.Pipelines/PipeReader.xml +++ b/xml/System.IO.Pipelines/PipeReader.xml @@ -425,16 +425,7 @@ The canceled The callback to register. The state object to pass to when it's invoked. Registers a callback that executes when the side of the pipe is completed. - - [!IMPORTANT] -> `OnWriterCompleted` may not be invoked on all implementations of . This method will be removed in a future release. - - ]]> - + To be added. diff --git a/xml/System.IO.Pipelines/PipeWriter.xml b/xml/System.IO.Pipelines/PipeWriter.xml index df01bc61d4a..8f34fb94a1e 100644 --- a/xml/System.IO.Pipelines/PipeWriter.xml +++ b/xml/System.IO.Pipelines/PipeWriter.xml @@ -423,16 +423,7 @@ You must request a new buffer after calling The callback to register. The state object to pass to when it's invoked. Registers a callback that executes when the side of the pipe is completed. - - [!IMPORTANT] -> `OnReaderCompleted` may not be invoked on all implementations of . This method will be removed in a future release. - - ]]> - + To be added. diff --git a/xml/System.IO.Ports/SerialPort.xml b/xml/System.IO.Ports/SerialPort.xml index 3107e6bf2d8..a9e07992450 100644 --- a/xml/System.IO.Ports/SerialPort.xml +++ b/xml/System.IO.Ports/SerialPort.xml @@ -361,11 +361,6 @@ ]]> The stream is closed. This can occur because the method has not been called or the method has been called. - The stream is in a .NET Compact Framework application and one of the following methods was called: - - - - The .NET Compact Framework does not support the asynchronous model with base streams. diff --git a/xml/System.IO/Directory.xml b/xml/System.IO/Directory.xml index 0b19d0741f6..d988c54870f 100644 --- a/xml/System.IO/Directory.xml +++ b/xml/System.IO/Directory.xml @@ -2060,9 +2060,6 @@ The returned collection is not cached. Each call to the The caller does not have the required permission. - The operating system is Windows CE, which does not have current directory functionality. - - This method is available in the .NET Compact Framework, but is not currently supported. File and Stream I/O How to: Read Text from a File How to: Write Text to a File diff --git a/xml/System.IO/DirectoryInfo.xml b/xml/System.IO/DirectoryInfo.xml index ab1ab52e756..17d1e14dc56 100644 --- a/xml/System.IO/DirectoryInfo.xml +++ b/xml/System.IO/DirectoryInfo.xml @@ -445,11 +445,7 @@ -or- - The directory is the application's current working directory. - - -or- - - There is an open handle on the directory, and the operating system is Windows XP or earlier. This open handle can result from enumerating directories. For more information, see How to: Enumerate Directories and Files. + The directory is the application's current working directory. The caller does not have the required permission. File and Stream I/O How to: Read Text from a File @@ -533,11 +529,7 @@ -or- - The directory is the application's current working directory. - - -or- - - There is an open handle on the directory or on one of its files, and the operating system is Windows XP or earlier. This open handle can result from enumerating directories and files. For more information, see How to: Enumerate Directories and Files. + The directory is the application's current working directory. The caller does not have the required permission. File and Stream I/O How to: Read Text from a File diff --git a/xml/System.IO/File.xml b/xml/System.IO/File.xml index ee6ca6f88ed..64b7d7a3ad1 100644 --- a/xml/System.IO/File.xml +++ b/xml/System.IO/File.xml @@ -2118,11 +2118,7 @@ An I/O error occurred. is . The specified path is invalid (for example, it is on an unmapped drive). - The specified file is in use. - - -or- - - There is an open handle on the file, and the operating system is Windows XP or earlier. This open handle can result from enumerating directories and files. For more information, see How to: Enumerate Directories and Files. + The specified file is in use. is in an invalid format. The specified path, file name, or both exceed the system-defined maximum length. diff --git a/xml/System.IO/FileInfo.xml b/xml/System.IO/FileInfo.xml index ffd5ded1ae0..ce6145081c3 100644 --- a/xml/System.IO/FileInfo.xml +++ b/xml/System.IO/FileInfo.xml @@ -793,11 +793,6 @@ C:\Users\userName\AppData\Local\Temp\tmp70CB.tmp was successfully deleted. ]]> - The target file is open or memory-mapped on a computer running Microsoft Windows NT. - - -or- - - There is an open handle on the file, and the operating system is Windows XP or earlier. This open handle can result from enumerating directories and files. For more information, see How to: Enumerate Directories and Files. The caller does not have the required permission. The path is a directory. File and Stream I/O diff --git a/xml/System.IO/FileStream.xml b/xml/System.IO/FileStream.xml index 4be01949c21..d83b487b19a 100644 --- a/xml/System.IO/FileStream.xml +++ b/xml/System.IO/FileStream.xml @@ -270,23 +270,7 @@ A object will not have an exclusive hold on its hand A file handle for the file that the current object will encapsulate. A bitwise combination of the enumeration values that sets the and properties of the object. Initializes a new instance of the class for the specified file handle, with the specified read/write permission. - - is called, the handle is also closed and the file's handle count is decremented. - - `FileStream` assumes that it has exclusive control over the handle. Reading, writing, or seeking while a `FileStream` is also holding a handle could result in data corruption. For data safety, call before using the handle, and avoid calling any methods other than `Close` after you are done using the handle. - -> [!CAUTION] -> When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown. - - `FileShare.Read` is the default for those constructors without a `FileShare` parameter. - - For a list of common file and directory operations, see [Common I/O Tasks](/dotnet/standard/io/common-i-o-tasks). - - ]]> - + To be added. is not a field of . The caller does not have the required permission. @@ -406,7 +390,6 @@ A object will not have an exclusive hold on its hand The specified path, file name, or both exceed the system-defined maximum length. contains an invalid value. - File and Stream I/O How to: Read Text from a File How to: Write Text to a File @@ -631,23 +614,7 @@ The file was too large (when if the file handle will be owned by this instance; otherwise, . Initializes a new instance of the class for the specified file handle, with the specified read/write permission and instance ownership. - - method will also close the handle and the file's handle count is decremented. The `FileStream` object is given the default buffer size of 4096 bytes. - - `FileStream` assumes that it has exclusive control over the handle. Reading, writing, or seeking while a `FileStream` is also holding a handle could result in data corruption. For data safety, call before using the handle, and avoid calling methods other than `Close` after you are done using the handle. - - `FileShare.Read` is the default for those constructors without a `FileShare` parameter. - -> [!CAUTION] -> When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown. - - For a list of common file and directory operations, see [Common I/O Tasks](/dotnet/standard/io/common-i-o-tasks). - - ]]> - + To be added. is not a field of . The caller does not have the required permission. @@ -910,23 +877,7 @@ The file was too large (when if the file handle will be owned by this instance; otherwise, . A positive value greater than 0 indicating the buffer size. The default buffer size is 4096. Initializes a new instance of the class for the specified file handle, with the specified read/write permission, instance ownership, and buffer size. - - method will also close the handle. In particular, the file's handle count is decremented. The `FileStream` object is given the specified buffer size. - - `FileStream` assumes that it has exclusive control over the handle. Reading, writing, or seeking while a `FileStream` is also holding a handle could result in data corruption. For data safety, call before using the handle, and avoid calling any methods other than `Close` after you are done using the handle. Alternately, read and write to the handle before calling this `FileStream` constructor. - - `FileShare.Read` is the default for those constructors without a `FileShare` parameter. - -> [!CAUTION] -> When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown. - - For a list of common file and directory operations, see [Common I/O Tasks](/dotnet/standard/io/common-i-o-tasks). - - ]]> - + To be added. is negative. An I/O error, such as a disk error, occurred. @@ -1114,23 +1065,7 @@ The file was too large (when if the handle was opened asynchronously (that is, in overlapped I/O mode); otherwise, . Initializes a new instance of the class for the specified file handle, with the specified read/write permission, instance ownership, buffer size, and synchronous or asynchronous state. - - method will also close the handle. In particular, the file's handle count is decremented. The `FileStream` object is given the specified buffer size. - - `FileStream` assumes that it has exclusive control over the handle. Reading, writing, or seeking while a `FileStream` is also holding a handle could result in data corruption. For data safety, call before using the handle, and avoid calling any methods other than `Close` after you are done using the handle. Alternately, read and write to the handle before calling this `FileStream` constructor. - - `FileShare.Read` is the default for those constructors without a `FileShare` parameter. - -> [!CAUTION] -> When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown. - - For a list of common file and directory operations, see [Common I/O Tasks](/dotnet/standard/io/common-i-o-tasks). - - ]]> - + To be added. is less than or greater than or is less than or equal to 0. The handle is invalid. @@ -2559,19 +2494,7 @@ This method flushes the .NET stream buffers to the file, but does not flush inte Gets the operating system file handle for the file that the current object encapsulates. The operating system file handle for the file encapsulated by this object, or -1 if the has been closed. - - property to discover whether this handle was opened asynchronously. In Win32, this means the handle was opened for overlapped IO, and it requires different parameters to `ReadFile` and `WriteFile`. - -> [!CAUTION] -> Data corruption might occur if a `FileStream` is created, its handle is passed, some operation moves the handle's file pointer, and then the `FileStream` is used again. Multiple threads cannot safely write to the same file simultaneously, and `FileStream` buffering code assumes that it exclusively controls the handle. `FileStream` might throw an if `FileStream` detects that some other process has moved the file pointer. To avoid this, do not write any data into a portion of the file that `FileStream` might have buffered, and restore the file pointer to the location it had when methods were last called on `FileStream`. - - ]]> - + To be added. The caller does not have the required permission. File and Stream I/O How to: Read Text from a File diff --git a/xml/System.IO/FileSystemInfo.xml b/xml/System.IO/FileSystemInfo.xml index f7af0e52734..136eb6d0c85 100644 --- a/xml/System.IO/FileSystemInfo.xml +++ b/xml/System.IO/FileSystemInfo.xml @@ -229,14 +229,7 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. The specified is null. File and Stream I/O @@ -617,7 +610,6 @@ On Unix platforms that do not support creation or birth time, this property retu Deletes a file or directory. To be added. The specified path is invalid; for example, it is on an unmapped drive. - There is an open handle on the file or directory, and the operating system is Windows XP or earlier. This open handle can result from enumerating directories and files. For more information, see How to: Enumerate Directories and Files. File and Stream I/O How to: Read Text from a File @@ -945,14 +937,7 @@ The `Extension` property returns the extension, The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. Sets the object with the file name and additional exception information. - - - + To be added. File and Stream I/O How to: Read Text from a File diff --git a/xml/System.IO/FileSystemWatcher.xml b/xml/System.IO/FileSystemWatcher.xml index f4955fcb2da..a989c726189 100644 --- a/xml/System.IO/FileSystemWatcher.xml +++ b/xml/System.IO/FileSystemWatcher.xml @@ -184,23 +184,20 @@ Note that a may miss an event when the buffer . +The following table shows initial property values for an instance of . -|Property|Initial Value| -|--------------|-------------------| -||bitwise OR combination of `LastWrite`, `FileName`, and `DirectoryName`| -||`false`| -||"*.\*" (Watch all files.)| -||`false`| -||8192| -||empty string ("")| +| Property | Initial Value | +|-----------------------------------------------------------|------------------------------------------------------------------------| +| | bitwise OR combination of `LastWrite`, `FileName`, and `DirectoryName` | +| | `false` | +| | "*.\*" (Watch all files.) | +| | `false` | +| | 8192 | +| | empty string ("") | > [!NOTE] -> The component will not watch the specified directory until the is set, and is `true`. - - +> The component will not watch the specified directory until the is set, and is `true`. ## Examples The following example creates a object to watch the directory specified at run time. The object watches for changes in `LastWrite` and `LastAccess` times, and for the creation, deletion, or renaming of text files in the directory. If a file is changed, created, or deleted, the path to the file displays to the console. When a file is renamed, the old and new paths display to the console. @@ -269,11 +266,11 @@ Note that a may miss an event when the buffer ## Remarks > [!NOTE] -> The component will not watch the specified directory until the is set, and is `true`. +> The component will not watch the specified directory until the is set, and is `true`. The component can watch files on your personal computer, a network drive, or a remote computer. - You cannot watch a remote computer that does not have Windows NT or Windows 2000. You cannot watch a remote Windows NT 4.0 computer from a Windows NT 4.0 computer. The property is set by default to watch all files. +The property is set by default to watch all files. ]]> @@ -345,12 +342,10 @@ Note that a may miss an event when the buffer ## Remarks > [!NOTE] -> The component will not watch the specified directory until the is set, and is `true`. +> The component will not watch the specified directory until the is set, and is `true`. The component can watch files on your personal computer, a network drive, or a remote computer. - You cannot watch a remote computer that does not have Windows NT or Windows 2000. You cannot watch a remote Windows NT 4.0 computer from a Windows NT 4.0 computer. - ]]> The parameter is . @@ -477,15 +472,15 @@ Note that a may miss an event when the buffer The event is raised when changes are made to the size, system attributes, last write time, last access time, or security permissions of a file or directory in the directory being monitored. > [!NOTE] -> Common file system operations might raise more than one event. For example, when a file is moved from one directory to another, several and some and events might be raised. Moving a file is a complex operation that consists of multiple simple operations, therefore raising multiple events. Likewise, some applications (for example, antivirus software) might cause additional file system events that are detected by . +> Common file system operations might raise more than one event. For example, when a file is moved from one directory to another, several and some and events might be raised. Moving a file is a complex operation that consists of multiple simple operations, therefore raising multiple events. Likewise, some applications (for example, antivirus software) might cause additional file system events that are detected by . Use to restrict the number of notifications raised when this event is handled. > [!NOTE] -> The event is raised unexpectedly when a file is renamed, but is not raised when a directory is renamed. To watch for renaming, use the event. +> The event is raised unexpectedly when a file is renamed, but is not raised when a directory is renamed. To watch for renaming, use the event. > [!NOTE] -> The order in which the event is raised in relation to the other events may change when the property is not `null`. +> The order in which the event is raised in relation to the other events may change when the property is not `null`. @@ -551,10 +546,10 @@ Note that a may miss an event when the buffer Some common occurrences, such as copying or moving a file or directory, do not correspond directly to an event, but these occurrences do cause events to be raised. When you copy a file or directory, the system raises a event in the directory to which the file was copied, if that directory is being watched. If the directory from which you copied was being watched by another instance of , no event would be raised. For example, you create two instances of . FileSystemWatcher1 is set to watch "C:\My Documents", and FileSystemWatcher2 is set to watch "C:\Your Documents". If you copy a file from "My Documents" into "Your Documents", a event will be raised by FileSystemWatcher2, but no event is raised for FileSystemWatcher1. Unlike copying, moving a file or directory would raise two events. From the previous example, if you moved a file from "My Documents" to "Your Documents", a event would be raised by FileSystemWatcher2 and a event would be raised by FileSystemWatcher1. > [!NOTE] -> Common file system operations might raise more than one event. For example, when a file is moved from one directory to another, several and some and events might be raised. Moving a file is a complex operation that consists of multiple simple operations, therefore raising multiple events. Likewise, some applications (for example, antivirus software) might cause additional file system events that are detected by . +> Common file system operations might raise more than one event. For example, when a file is moved from one directory to another, several and some and events might be raised. Moving a file is a complex operation that consists of multiple simple operations, therefore raising multiple events. Likewise, some applications (for example, antivirus software) might cause additional file system events that are detected by . > [!NOTE] -> The order in which the event is raised in relation to the other events may change when the property is not `null`. +> The order in which the event is raised in relation to the other events may change when the property is not `null`. The event is raised as soon as a file is created. If a file is being copied or transferred into a watched directory, the event will be raised immediately, followed by one or more events. @@ -623,10 +618,10 @@ Note that a may miss an event when the buffer Some common occurrences, such as copying or moving a file or directory, do not correspond directly to an event, but these occurrences do cause events to be raised. When you copy a file or directory, the system raises a event in the directory to which the file was copied, if that directory is being watched. If the directory from which you copied was being watched by another instance of , no event would be raised. For example, you create two instances of . FileSystemWatcher1 is set to watch "C:\My Documents", and FileSystemWatcher2 is set to watch "C:\Your Documents". If you copy a file from "My Documents" into "Your Documents", a event will be raised by FileSystemWatcher2, but no event is raised for FileSystemWatcher1. Unlike copying, moving a file or directory would raise two events. From the previous example, if you moved a file from "My Documents" to "Your Documents", a event would be raised by FileSystemWatcher2 and a event would be raised by FileSystemWatcher1. > [!NOTE] -> Common file system operations might raise more than one event. For example, when a file is moved from one directory to another, several and some and events might be raised. Moving a file is a complex operation that consists of multiple simple operations, therefore raising multiple events. Likewise, some applications (for example, antivirus software) might cause additional file system events that are detected by . +> Common file system operations might raise more than one event. For example, when a file is moved from one directory to another, several and some and events might be raised. Moving a file is a complex operation that consists of multiple simple operations, therefore raising multiple events. Likewise, some applications (for example, antivirus software) might cause additional file system events that are detected by . > [!NOTE] -> The order in which the event is raised in relation to the other events may change when the property is not `null`. +> The order in which the event is raised in relation to the other events may change when the property is not `null`. @@ -792,7 +787,7 @@ Note that a may miss an event when the buffer The component will not raise events unless you set to `true`. > [!NOTE] -> The component will not watch the specified directory until the property has been set and is `true`. +> The component will not watch the specified directory until the property has been set and is `true`. The method allows event handlers to be invoked to respond to file changes even if this property is set to `false`. @@ -915,7 +910,7 @@ Note that a may miss an event when the buffer The system notifies you of file changes, and it stores those changes in a buffer that the component creates and passes to the APIs. If there are many changes in a short time, the buffer can overflow. This causes the component to lose track of changes in the directory, and it will only provide blanket notification. Increasing the size of the buffer is expensive, because it comes from non paged memory that cannot be swapped out to disk, so keep the buffer as small as possible. To avoid a buffer overflow, use the , , and properties to filter out unwanted change notifications. > [!NOTE] -> Common file system operations might raise more than one event. For example, when a file is moved from one directory to another, several and some and events might be raised. Moving a file is a complex operation that consists of multiple simple operations, therefore raising multiple events. Likewise, some applications (for example, antivirus software) might cause additional file system events that are detected by . +> Common file system operations might raise more than one event. For example, when a file is moved from one directory to another, several and some and events might be raised. Moving a file is a complex operation that consists of multiple simple operations, therefore raising multiple events. Likewise, some applications (for example, antivirus software) might cause additional file system events that are detected by . ]]> @@ -1613,7 +1608,7 @@ Note that a may miss an event when the buffer The property supports Universal Naming Convention (UNC) paths. > [!NOTE] -> This property must be set before the component can watch for changes. +> This property must be set before the component can watch for changes. When a directory is renamed, the automatically reattaches itself to the newly renamed item. For example, if you set the property to "C:\My Documents" and then manually rename the directory to "C:\Your Documents", the component continues listening for change notifications on the newly renamed directory. However, when you ask for the property, it contains the old path. This happens because the component determines what directory watches based on the handle, rather than the name of the directory. Renaming does not affect the handle. So, if you destroy the component, and then recreate it without updating the property, your application will fail because the directory no longer exists. @@ -1879,7 +1874,7 @@ Public Delegate Sub RenamedEventHandler(sender As Object, e As RenamedEventArgs) This method waits indefinitely until the first change occurs and then returns. This is the same as using with the `timeout` parameter set to -1. > [!NOTE] -> This method allows an event handler to be invoked to respond to file changes even if the property is set to `false`. +> This method allows an event handler to be invoked to respond to file changes even if the property is set to `false`. In some systems, reports changes to files using the short 8.3 file name format. For example, a change to "LongFileName.LongExtension" could be reported as "LongFi~.Lon". @@ -1941,7 +1936,7 @@ Public Delegate Sub RenamedEventHandler(sender As Object, e As RenamedEventArgs) This method waits until a change occurs or it has timed out. A value of -1 for the `timeout` parameter means wait indefinitely. > [!NOTE] -> This method allows an event handler to be invoked to respond to file changes even if the property is set to `false`. +> This method allows an event handler to be invoked to respond to file changes even if the property is set to `false`. In some systems, reports changes to files using the short 8.3 file name format. For example, a change to "LongFileName.LongExtension" could be reported as "LongFi~.Lon". diff --git a/xml/System.IO/Path.xml b/xml/System.IO/Path.xml index cfe93591ece..bd1099cd590 100644 --- a/xml/System.IO/Path.xml +++ b/xml/System.IO/Path.xml @@ -2343,18 +2343,7 @@ A trailing period in `path` is not considered an extension. Provides a platform-specific array of characters that cannot be specified in path string arguments passed to members of the class. - - remarks to learn what the set of characters returned by this field is. - -> [!CAUTION] -> Do not use if you think your code might execute alongside untrusted code. is an array, so its elements can be overwritten. If untrusted code overwrites elements of , it might cause your code to malfunction in ways that could be exploited. - - ]]> - + To be added. File and Stream I/O How to: Read Text from a File How to: Write Text to a File diff --git a/xml/System.IO/Stream.xml b/xml/System.IO/Stream.xml index fd29290ad5e..8f0e6689493 100644 --- a/xml/System.IO/Stream.xml +++ b/xml/System.IO/Stream.xml @@ -1207,16 +1207,7 @@ This method is available to support legacy code; however, the newer async method Allocates a object. A reference to the allocated . - - or until the asynchronous operation is complete. - - ]]> - + To be added. File and Stream I/O How to: Read Text from a File How to: Write Text to a File diff --git a/xml/System.Linq.Expressions/Expression.xml b/xml/System.Linq.Expressions/Expression.xml index 1f672037282..90507ddcd54 100644 --- a/xml/System.Linq.Expressions/Expression.xml +++ b/xml/System.Linq.Expressions/Expression.xml @@ -165,14 +165,7 @@ The to set as the node type. The of this . Initializes a new instance of the class. - - - + To be added. diff --git a/xml/System.Linq/ParallelEnumerable.xml b/xml/System.Linq/ParallelEnumerable.xml index a063b7702a1..587db211ccd 100644 --- a/xml/System.Linq/ParallelEnumerable.xml +++ b/xml/System.Linq/ParallelEnumerable.xml @@ -2498,14 +2498,7 @@ This parameter is not used. This Concat overload should never be called. This method is marked as obsolete and always throws when called. This overload always throws a . - - and a right data source of type . Otherwise, the Concat operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation. - - ]]> - + To be added. The exception that occurs when this method is called. Parallel LINQ (PLINQ) @@ -3369,14 +3362,7 @@ This parameter is not used. This Except overload should never be called. This method is marked as obsolete and always throws when called. This overload always throws a . - - and a right data source of type . Otherwise, the Except operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation. - - ]]> - + To be added. The exception that occurs when this method is called. Parallel LINQ (PLINQ) @@ -3513,14 +3499,7 @@ This parameter is not used. This Except overload should never be called. This method is marked as obsolete and always throws when called. This overload always throws a . - - and a right data source of type . Otherwise, the Except operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation. - - ]]> - + To be added. The exception that occurs when this method is called. Parallel LINQ (PLINQ) @@ -4778,14 +4757,7 @@ This parameter is not used. This GroupJoin overload should never be called. This method is marked as obsolete and always throws when called. This overload always throws a . - - and a right data source of type . Otherwise, the GroupJoin operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation. - - ]]> - + To be added. The exception that occurs when this method is called. Parallel LINQ (PLINQ) @@ -4988,14 +4960,7 @@ This parameter is not used. This GroupJoin overload should never be called. This method is marked as obsolete and always throws when called. This overload always throws a . - - and a right data source of type . Otherwise, the GroupJoin operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation. - - ]]> - + To be added. The exception that occurs when this method is called. Parallel LINQ (PLINQ) @@ -5175,14 +5140,7 @@ This parameter is not used. This Intersect overload should never be called. This method is marked as obsolete and always throws when called. This overload always throws a . - - and a right data source of type . Otherwise, the Intersect operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation. - - ]]> - + To be added. The exception that occurs when this method is called. Parallel LINQ (PLINQ) @@ -5319,14 +5277,7 @@ This parameter is not used. This Intersect overload should never be called. This method is marked as obsolete and always throws when called. This overload always throws a . - - and a right data source of type . Otherwise, the Intersect operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation. - - ]]> - + To be added. The exception that occurs when this method is called. Parallel LINQ (PLINQ) @@ -5506,14 +5457,7 @@ This parameter is not used. This Join overload should never be called. This method is marked as obsolete and always throws when invoked. This overload always throws a . - - and a right data source of type . Otherwise, the Join operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation. - - ]]> - + To be added. The exception that occurs when this method is called. Parallel LINQ (PLINQ) @@ -5716,14 +5660,7 @@ This parameter is not used. This Join overload should never be called. This method is marked as obsolete and always throws when invoked. This overload always throws a . - - and a right data source of type . Otherwise, the Join operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation. - - ]]> - + To be added. The exception that occurs when this method is called. Parallel LINQ (PLINQ) @@ -9987,14 +9924,7 @@ This parameter is not used. This SequenceEqual overload should never be called. This method is marked as obsolete and always throws when called. This overload always throws a . - - and a right data source of type . Otherwise, the SequenceEqual operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation. - - ]]> - + To be added. Thrown every time this method is called. Parallel LINQ (PLINQ) @@ -10132,14 +10062,7 @@ This parameter is not used. This SequenceEqual overload should never be called. This method is marked as obsolete and always throws when called. This overload always throws a . - - and a right data source of type . Otherwise, the SequenceEqual operator would appear to be binding to the parallel implementation, but would in reality bind to sequential implementation. - - ]]> - + To be added. Thrown every time this method is called. Parallel LINQ (PLINQ) @@ -13179,14 +13102,7 @@ This parameter is not used. This Union overload should never be called. This method is marked as obsolete and always throws when called. This overload always throws a . - - and a right data source of type . Otherwise, the Union operator would appear to be binding to the parallel implementation, but would in reality bind to sequential implementation. - - ]]> - + To be added. The exception that occurs when this method is called. The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. @@ -13325,14 +13241,7 @@ This parameter is not used. This Union overload should never be called. This method is marked as obsolete and always throws when called. This overload always throws a . - - and a right data source of type . Otherwise, the Union operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation. - - ]]> - + To be added. The exception that occurs when this method is called. The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. @@ -13900,14 +13809,7 @@ This parameter is not used. This Zip overload should never be called. This method is marked as obsolete and always throws when invoked. This overload always throws a . - - and a right data source of type . Otherwise, the Zip operator would appear to be bind to the parallel implementation, but would in reality bind to the sequential implementation. - - ]]> - + To be added. The exception that occurs when this method is called. Parallel LINQ (PLINQ) diff --git a/xml/System.Management/ImpersonationLevel.xml b/xml/System.Management/ImpersonationLevel.xml index f529927e6b8..9a426090087 100644 --- a/xml/System.Management/ImpersonationLevel.xml +++ b/xml/System.Management/ImpersonationLevel.xml @@ -87,7 +87,7 @@ 4 - Delegate-level COM impersonation level that allows objects to permit other objects to use the credentials of the caller. This level, which will work with WMI calls but may constitute an unnecessary security risk, is supported only under Windows 2000. + Delegate-level COM impersonation level that allows objects to permit other objects to use the credentials of the caller. diff --git a/xml/System.Management/ManagementException.xml b/xml/System.Management/ManagementException.xml index d3d8b60374b..ac7b6459af0 100644 --- a/xml/System.Management/ManagementException.xml +++ b/xml/System.Management/ManagementException.xml @@ -214,7 +214,6 @@ The destination for this serialization. Populates the with the data needed to serialize the . To be added. - diff --git a/xml/System.Net.Http/HttpRequestMessage.xml b/xml/System.Net.Http/HttpRequestMessage.xml index 56055d65759..57d82b75876 100644 --- a/xml/System.Net.Http/HttpRequestMessage.xml +++ b/xml/System.Net.Http/HttpRequestMessage.xml @@ -526,14 +526,7 @@ When the `disposing` parameter is `true`, this method releases all resources hel Gets a set of properties for the HTTP request. Returns . - - property. Using both at the same time may cause unexpected key collisions. - - ]]> - + To be added. diff --git a/xml/System.Net.Mail/MailMessage.xml b/xml/System.Net.Mail/MailMessage.xml index 7386748805a..c1520867353 100644 --- a/xml/System.Net.Mail/MailMessage.xml +++ b/xml/System.Net.Mail/MailMessage.xml @@ -1337,14 +1337,7 @@ Gets or sets the ReplyTo address for the mail message. A MailAddress that indicates the value of the field. - - property to indicate an address other than the address to use to reply to this message. - - ]]> - + To be added. diff --git a/xml/System.Net.Mail/SmtpException.xml b/xml/System.Net.Mail/SmtpException.xml index 87ea76c11a1..cf1d0bcc856 100644 --- a/xml/System.Net.Mail/SmtpException.xml +++ b/xml/System.Net.Mail/SmtpException.xml @@ -353,14 +353,7 @@ A that contains the information required to serialize the new . A that contains the source and destination of the serialized stream associated with the new instance. Initializes a new instance of the class from the specified instances of the and classes. - - interface for the class. - - ]]> - + To be added. @@ -476,14 +469,7 @@ The to populate with data. A that specifies the destination for this serialization. Populates a instance with the data needed to serialize the . - - are automatically tracked and serialized by the formatter. - - ]]> - + To be added. diff --git a/xml/System.Net.Mail/SmtpFailedRecipientException.xml b/xml/System.Net.Mail/SmtpFailedRecipientException.xml index c6ab1f9d5eb..10029bcd5c1 100644 --- a/xml/System.Net.Mail/SmtpFailedRecipientException.xml +++ b/xml/System.Net.Mail/SmtpFailedRecipientException.xml @@ -256,14 +256,7 @@ A that contains the information required to serialize the new . A that contains the source and destination of the serialized stream that is associated with the new instance. Initializes a new instance of the class from the specified instances of the and classes. - - interface for the class. - - ]]> - + To be added. @@ -504,14 +497,7 @@ The to populate with data. A that specifies the destination for this serialization. Populates a instance with the data that is needed to serialize the . - - are automatically tracked and serialized by the formatter. - - ]]> - + To be added. diff --git a/xml/System.Net.Mail/SmtpFailedRecipientsException.xml b/xml/System.Net.Mail/SmtpFailedRecipientsException.xml index ec098a4effa..8f202617e5e 100644 --- a/xml/System.Net.Mail/SmtpFailedRecipientsException.xml +++ b/xml/System.Net.Mail/SmtpFailedRecipientsException.xml @@ -215,14 +215,7 @@ A instance that contains the information required to serialize the new instance. A that contains the source of the serialized stream that is associated with the new instance. Initializes a new instance of the class from the specified instances of the and classes. - - interface for the class. - - ]]> - + To be added. XML and SOAP Serialization diff --git a/xml/System.Net.NetworkInformation/IPGlobalProperties.xml b/xml/System.Net.NetworkInformation/IPGlobalProperties.xml index 7300e7dd3cb..5a833775552 100644 --- a/xml/System.Net.NetworkInformation/IPGlobalProperties.xml +++ b/xml/System.Net.NetworkInformation/IPGlobalProperties.xml @@ -677,12 +677,8 @@ ## Remarks ICMP version 6 is a set of messages for use with Internet Protocol version 6 (IPv6). ICMP is used by IPv6 nodes to report errors encountered in processing data packets and to perform other Internet layer functions. ICMP version 6 is defined in IETF RFC 1885. - The IPv6 protocol is not supported for computers with Windows 2000 or earlier operating systems. - For details on the ICMP version 6 traffic statistics available to applications, see the class documentation. Note that the object returned by this method reflects the statistics as of the time the object is created. This information is not updated dynamically. - - ## Examples The following example displays the current ICMPv6 statistics. @@ -691,7 +687,7 @@ ]]> The Win32 function failed. - The local computer's operating system is not Windows XP or later. + The operating system is not Windows. @@ -887,12 +883,10 @@ class documentation. Note that the object returned by this method reflects the statistics as of the time the object is created. This information is not updated dynamically. - - ## Examples The following code example displays IP statistics for the local computer. diff --git a/xml/System.Net.NetworkInformation/MulticastIPAddressInformation.xml b/xml/System.Net.NetworkInformation/MulticastIPAddressInformation.xml index 01cdfab468d..c1d4e2e8f13 100644 --- a/xml/System.Net.NetworkInformation/MulticastIPAddressInformation.xml +++ b/xml/System.Net.NetworkInformation/MulticastIPAddressInformation.xml @@ -153,7 +153,7 @@ ]]> - This property is not valid on computers running operating systems earlier than Windows XP. + The operating system is not Windows. @@ -209,7 +209,7 @@ ]]> - This property is not valid on computers running operating systems earlier than Windows XP. + The operating system is not Windows. @@ -322,7 +322,7 @@ ]]> - This property is not valid on computers running operating systems earlier than Windows XP. + The operating system is not Windows. @@ -378,7 +378,7 @@ ]]> - This property is not valid on computers running operating systems earlier than Windows XP. + The operating system is not Windows. @@ -434,7 +434,7 @@ ]]> - This property is not valid on computers running operating systems earlier than Windows XP. + The operating system is not Windows. diff --git a/xml/System.Net.NetworkInformation/NetworkInformationException.xml b/xml/System.Net.NetworkInformation/NetworkInformationException.xml index 7c0b04c5b0d..98cdb6d7e03 100644 --- a/xml/System.Net.NetworkInformation/NetworkInformationException.xml +++ b/xml/System.Net.NetworkInformation/NetworkInformationException.xml @@ -215,14 +215,7 @@ A SerializationInfo object that contains the serialized exception data. A StreamingContext that contains contextual information about the serialized exception. Initializes a new instance of the class with serialized data. - - instance from serialized data. - - ]]> - + To be added. diff --git a/xml/System.Net.NetworkInformation/NetworkInterface.xml b/xml/System.Net.NetworkInformation/NetworkInterface.xml index 7e6b316c530..1738300f24e 100644 --- a/xml/System.Net.NetworkInformation/NetworkInterface.xml +++ b/xml/System.Net.NetworkInformation/NetworkInterface.xml @@ -662,7 +662,7 @@ System.Boolean - Gets a value that indicates whether the network interface is set to only receive data packets. + Gets a value that indicates whether the network interface is set to only receive data packets. if the interface only receives network traffic; otherwise, . @@ -676,7 +676,6 @@ ]]> - This property is not valid on computers running operating systems earlier than Windows XP. @@ -1065,7 +1064,7 @@ System.Boolean - Gets a value that indicates whether the network interface is enabled to receive multicast packets. + Gets a value that indicates whether the network interface is enabled to receive multicast packets. if the interface receives multicast packets; otherwise, . @@ -1074,8 +1073,6 @@ ## Remarks Multicasting is the act of sending a data packet to multiple destinations simultaneously. - - ## Examples The following code example displays a summary for all interfaces on the local computer. @@ -1084,7 +1081,6 @@ ]]> - This property is not valid on computers running operating systems earlier than Windows XP. diff --git a/xml/System.Net.NetworkInformation/PingException.xml b/xml/System.Net.NetworkInformation/PingException.xml index 029b8e3004e..ddab5c98185 100644 --- a/xml/System.Net.NetworkInformation/PingException.xml +++ b/xml/System.Net.NetworkInformation/PingException.xml @@ -173,14 +173,7 @@ The object that holds the serialized object data. A that specifies the contextual information about the source or destination for this serialization. Initializes a new instance of the class with serialized data. - - object. - - ]]> - + To be added. diff --git a/xml/System.Net.NetworkInformation/UnicastIPAddressInformation.xml b/xml/System.Net.NetworkInformation/UnicastIPAddressInformation.xml index d54561d8c14..94d4c9d62e0 100644 --- a/xml/System.Net.NetworkInformation/UnicastIPAddressInformation.xml +++ b/xml/System.Net.NetworkInformation/UnicastIPAddressInformation.xml @@ -159,7 +159,7 @@ ]]> - This property is not valid on computers running operating systems earlier than Windows XP. + The operating system is not Windows. @@ -215,7 +215,7 @@ ]]> - This property is not valid on computers running operating systems earlier than Windows XP. + The operating system is not Windows. @@ -328,7 +328,7 @@ ]]> - This property is not valid on computers running operating systems earlier than Windows XP. + The operating system is not Windows. @@ -467,7 +467,7 @@ ]]> - This property is not valid on computers running operating systems earlier than Windows XP. + The operating system is not Windows. @@ -523,7 +523,7 @@ ]]> - This property is not valid on computers running operating systems earlier than Windows XP. + The operating system is not Windows. diff --git a/xml/System.Net.PeerToPeer.Collaboration/PeerCollaborationPermissionAttribute.xml b/xml/System.Net.PeerToPeer.Collaboration/PeerCollaborationPermissionAttribute.xml index 906b1141c46..09e7954e020 100644 --- a/xml/System.Net.PeerToPeer.Collaboration/PeerCollaborationPermissionAttribute.xml +++ b/xml/System.Net.PeerToPeer.Collaboration/PeerCollaborationPermissionAttribute.xml @@ -123,9 +123,6 @@ Creates and returns a new . A new object. To be added. - - When permissions are inherited , must be overridden. - diff --git a/xml/System.Net.Security/NegotiateStream.xml b/xml/System.Net.Security/NegotiateStream.xml index 77cd1023303..8606efcd320 100644 --- a/xml/System.Net.Security/NegotiateStream.xml +++ b/xml/System.Net.Security/NegotiateStream.xml @@ -1069,7 +1069,6 @@ The following example demonstrates calling this constructor. This code example i The authentication failed. You can use this object to retry the authentication. The authentication failed. You can use this object to retry the authentication. This object has been closed. - Windows 95 and Windows 98 are not supported. @@ -1137,7 +1136,6 @@ The following example demonstrates calling this constructor. This code example i The parameter was set to on a platform that does not support extended protection. Integrated Windows Authentication with Extended Protection - Windows 95 and Windows 98 are not supported. @@ -1209,7 +1207,6 @@ The following example demonstrates calling this constructor. This code example i -or- This stream was used previously to attempt authentication as the client. You cannot use the stream to retry authentication as the server. - Windows 95 and Windows 98 are not supported. @@ -1297,7 +1294,6 @@ The following example demonstrates calling this constructor. This code example i The parameter was set to on a platform that does not support extended protection. Integrated Windows Authentication with Extended Protection - Windows 95 and Windows 98 are not supported. @@ -1366,7 +1362,6 @@ The following example demonstrates calling this constructor. This code example i The authentication failed. You can use this object to retry the authentication. The authentication failed. You can use this object to retry the authentication. This object has been closed. - Windows 95 and Windows 98 are not supported. @@ -1442,7 +1437,6 @@ The following example demonstrates calling this constructor. This code example i The parameter was set to on a platform that does not support extended protection. Integrated Windows Authentication with Extended Protection - Windows 95 and Windows 98 are not supported. @@ -1515,7 +1509,6 @@ The following example demonstrates calling this constructor. This code example i -or- This stream was used previously to attempt authentication as the client. You cannot use the stream to retry authentication as the server. - Windows 95 and Windows 98 are not supported. @@ -1604,7 +1597,6 @@ The following example demonstrates calling this constructor. This code example i The parameter was set to on a platform that does not support extended protection. Integrated Windows Authentication with Extended Protection - Windows 95 and Windows 98 are not supported. @@ -2191,7 +2183,6 @@ The following example demonstrates calling this method to begin an asynchronous The authentication failed. You can use this object to retry the authentication. The authentication failed. You can use this object to retry the authentication. This object has been closed. - Windows 95 and Windows 98 are not supported. @@ -2270,7 +2261,6 @@ The following example demonstrates calling this method to begin an asynchronous The parameter was set to on a platform that does not support extended protection. Integrated Windows Authentication with Extended Protection - Windows 95 and Windows 98 are not supported. @@ -2364,7 +2354,6 @@ The following example demonstrates calling this method to begin an asynchronous -or- This stream was used previously to attempt authentication as the client. You cannot use the stream to retry authentication as the server. - Windows 95 and Windows 98 are not supported. @@ -2465,7 +2454,6 @@ The following example demonstrates calling this method to begin an asynchronous The parameter was set to on a platform that does not support extended protection. Integrated Windows Authentication with Extended Protection - Windows 95 and Windows 98 are not supported. diff --git a/xml/System.Net.Security/SslStream.xml b/xml/System.Net.Security/SslStream.xml index 60ba5de187a..112288fd375 100644 --- a/xml/System.Net.Security/SslStream.xml +++ b/xml/System.Net.Security/SslStream.xml @@ -1186,7 +1186,6 @@ Use the overloads for methods that authenticate SslStreams that don't specify a Authentication is already in progress. This object has been closed. - The method is not supported on Windows 95, Windows 98, or Windows Millennium. @@ -1255,7 +1254,6 @@ Use the overloads for methods that authenticate SslStreams that don't specify a Authentication is already in progress. This object has been closed. - The method is not supported on Windows 95, Windows 98, or Windows Millennium. @@ -1325,7 +1323,6 @@ Use the overloads for methods that authenticate SslStreams that don't specify a Authentication is already in progress. This object has been closed. - The method is not supported on Windows 95, Windows 98, or Windows Millennium. @@ -1402,7 +1399,6 @@ Use the overloads for methods that authenticate SslStreams that don't specify a Authentication is already in progress. This object has been closed. - The method is not supported on Windows 95, Windows 98, or Windows Millennium. @@ -1484,7 +1480,6 @@ Use the overloads for methods that authenticate SslStreams that don't specify a Authentication is already in progress. This object has been closed. - The method is not supported on Windows 95, Windows 98, or Windows Millennium. @@ -2186,7 +2181,6 @@ Use the overloads for methods that authenticate SslStreams that don't specify a Authentication is already in progress. This object has been closed. - The method is not supported on Windows 95, Windows 98, or Windows Millennium. @@ -2280,7 +2274,6 @@ Use the overloads for methods that authenticate SslStreams that don't specify a Authentication is already in progress. This object has been closed. - The method is not supported on Windows 95, Windows 98, or Windows Millennium. @@ -2381,7 +2374,6 @@ Use the overloads for methods that authenticate SslStreams that don't specify a Authentication is already in progress. This object has been closed. - The method is not supported on Windows 95, Windows 98, or Windows Millennium. @@ -2937,11 +2929,8 @@ Use the overloads for methods that authenticate SslStreams that don't specify a is required for the property when the enumeration value is used to construct a instance. - - Windows Server 2003 and Windows XP do not support the value. So even if the value is used to construct the instance, the property will be . The value is only returned on Windows Vista and later. - +A value of is required for the property when the enumeration value is used to construct a instance. ## Examples The following code example displays the cryptography settings for the specified stream. diff --git a/xml/System.Net.Sockets/IOControlCode.xml b/xml/System.Net.Sockets/IOControlCode.xml index 5020db57d48..04d49517687 100644 --- a/xml/System.Net.Sockets/IOControlCode.xml +++ b/xml/System.Net.Sockets/IOControlCode.xml @@ -290,7 +290,7 @@ The enumeration provides named values fo 3355443225 - Sort the structure returned by the field and add scope ID information for IPv6 addresses. This control code is supported on Windows XP and later operating systems. This value is equal to the Winsock 2 SIO_ADDRESS_LIST_SORT constant. + Sort the structure returned by the field and add scope ID information for IPv6 addresses. This value is equal to the Winsock 2 `SIO_ADDRESS_LIST_SORT` constant. @@ -1083,7 +1083,7 @@ The enumeration provides named values fo 2281701401 - Control whether the socket receives notification when a namespace query becomes invalid. This control code is supported on Windows XP and later operating systems. This value is equal to the Winsock 2 SIO_NSP_NOTIFY_CHANGE constant. + Control whether the socket receives notification when a namespace query becomes invalid. This value is equal to the Winsock 2 `SIO_NSP_NOTIFY_CHANGE` constant. diff --git a/xml/System.Net.Sockets/IPProtectionLevel.xml b/xml/System.Net.Sockets/IPProtectionLevel.xml index 54cd8866ffe..60f190b553e 100644 --- a/xml/System.Net.Sockets/IPProtectionLevel.xml +++ b/xml/System.Net.Sockets/IPProtectionLevel.xml @@ -94,7 +94,7 @@ 20 - The IP protection level is edge restricted. This value would be used by applications designed to operate across the Internet. This setting does not allow Network Address Translation (NAT) traversal using the Windows Teredo implementation. These applications may bypass IPv4 firewalls, so applications must be hardened against Internet attacks directed at the opened port. On Windows Server 2003 and Windows XP, the default value for the IP Protection level on a socket is edge restricted. + The IP protection level is edge restricted. This value would be used by applications designed to operate across the Internet. This setting does not allow Network Address Translation (NAT) traversal using the Windows Teredo implementation. These applications might bypass IPv4 firewalls, so applications must be hardened against Internet attacks directed at the opened port. diff --git a/xml/System.Net.Sockets/Socket.xml b/xml/System.Net.Sockets/Socket.xml index be4effdae69..bd24500ee6c 100644 --- a/xml/System.Net.Sockets/Socket.xml +++ b/xml/System.Net.Sockets/Socket.xml @@ -6133,7 +6133,7 @@ Duplication of the socket reference failed. Gets or sets a value that indicates whether the allows only one process to bind to a port. - if the allows only one socket to bind to a specific port; otherwise, . The default is for Windows Server 2003 and Windows XP and newer versions. + if the allows only one socket to bind to a specific port; otherwise, . The default is . - An error occurred when attempting to access the socket. - --or- - - In .NET Compact Framework applications, the Windows CE default buffer space is set to 32768 bytes. You can change the per socket buffer space by calling . + An error occurred when attempting to access the socket. The has been closed. @@ -6490,11 +6486,7 @@ In general, the `GetSocketOption` method should be used whenever getting a - An error occurred when attempting to access the socket. - --or- - - In .NET Compact Framework applications, the Windows CE default buffer space is set to 32768 bytes. You can change the per socket buffer space by calling . + An error occurred when attempting to access the socket. The has been closed. @@ -13855,15 +13847,7 @@ For more information about these options, refer to the Gets a value indicating whether IPv4 support is available and enabled on the current host. if the current host supports the IPv4 protocol; otherwise, . - - - - + To be added. @@ -13922,7 +13906,6 @@ For more information about these options, refer to the if the framework supports IPv6 for certain obsolete methods; otherwise, . To be added. - @@ -14037,7 +14020,7 @@ For more information about these options, refer to the Gets or sets a value that specifies whether the socket should only use Overlapped I/O mode. Always . - The value of this property is always `false`, and you cannot change its value. + To be added. The socket has been bound to a completion port. diff --git a/xml/System.Net.Sockets/SocketException.xml b/xml/System.Net.Sockets/SocketException.xml index cd21deb6366..0e349818c14 100644 --- a/xml/System.Net.Sockets/SocketException.xml +++ b/xml/System.Net.Sockets/SocketException.xml @@ -257,14 +257,7 @@ A instance that contains the information that is required to serialize the new instance. A that contains the source of the serialized stream that is associated with the new instance. Initializes a new instance of the class from the specified instances of the and classes. - - interface for the class. - - ]]> - + To be added. XML and SOAP Serialization diff --git a/xml/System.Net.Sockets/SocketOptionLevel.xml b/xml/System.Net.Sockets/SocketOptionLevel.xml index dfd6fceefb9..9c16d5ec008 100644 --- a/xml/System.Net.Sockets/SocketOptionLevel.xml +++ b/xml/System.Net.Sockets/SocketOptionLevel.xml @@ -51,10 +51,6 @@ ## Remarks The enumeration defines the socket option levels that can be passed to the and methods. enumerated values are grouped by . - **Note** To use IPv6 on Windows XP, install Advance Networking Pack for Windows XP. - - - ## Examples The following example uses this enumeration to set socket options. diff --git a/xml/System.Net.Sockets/TcpClient.xml b/xml/System.Net.Sockets/TcpClient.xml index 95caa9f7e7e..f23f70d54be 100644 --- a/xml/System.Net.Sockets/TcpClient.xml +++ b/xml/System.Net.Sockets/TcpClient.xml @@ -1961,7 +1961,7 @@ The `Available` property is a way to determine whether data is queued for readin Gets or sets a value that specifies whether the allows only one client to use a port. - if the allows only one client to use a specific port; otherwise, . The default is for Windows Server 2003 and Windows XP Service Pack 2 and later, and for all other versions. + if the allows only one client to use a specific port; otherwise, . The default is . , , , or , the client port is bound as a side effect of the method, and you cannot subsequently set the `ExclusiveAddressUse` property. - - ## Examples The following code example creates a and gets and sets the value of the `ExclusiveAddressUse` property. @@ -2303,8 +2301,6 @@ The `GetStream` method returns a that yo If the network buffer is smaller than the amount of data you request in the `Read` method, you will not be able to retrieve the desired amount of data in one read operation. This incurs the overhead of additional calls to the `Read` method. - - ## Examples The following code example sets and gets the receive buffer size. @@ -2313,11 +2309,7 @@ The `GetStream` method returns a that yo ]]> - An error occurred when setting the buffer size. - - -or- - - In .NET Compact Framework applications, you cannot set this property. For a workaround, see the Platform Note in Remarks. + An error occurred when setting the buffer size. diff --git a/xml/System.Net.Sockets/TcpListener.xml b/xml/System.Net.Sockets/TcpListener.xml index 552ffca141f..99c0093cbd6 100644 --- a/xml/System.Net.Sockets/TcpListener.xml +++ b/xml/System.Net.Sockets/TcpListener.xml @@ -152,18 +152,7 @@ The port on which to listen for incoming connection attempts. Initializes a new instance of the class that listens on the specified port. - - [!NOTE] -> This constructor is obsolete. Use the or constructors. - - This constructor allows you to specify the port number on which to listen for incoming connection attempts. With this constructor, the underlying service provider assigns the most appropriate network address. If you do not care which local port is used, you can specify 0 for the port number. In this case, the service provider will assign an available ephemeral port number. If you use this approach, you can discover what local network address and port number has been assigned by using the property. - - Call the method to begin listening for incoming connection attempts. - - ]]> - + To be added. is not between and . @@ -1167,7 +1156,7 @@ Gets or sets a value that specifies whether the allows only one underlying socket to listen to a specific port. - if the allows only one to listen to a specific port; otherwise, . The default is for Windows Server 2003 and Windows XP Service Pack 2 and later, and for all other versions. + if the allows only one to listen to a specific port; otherwise, . The default is . , or call the method and then set this property. - - ## Examples The following code example gets and sets the property. diff --git a/xml/System.Net.Sockets/UdpClient.xml b/xml/System.Net.Sockets/UdpClient.xml index 3fd8b96ecbb..48c97f9b746 100644 --- a/xml/System.Net.Sockets/UdpClient.xml +++ b/xml/System.Net.Sockets/UdpClient.xml @@ -1945,7 +1945,7 @@ Gets or sets a value that specifies whether the allows only one client to use a port. - if the allows only one client to use a specific port; otherwise, . The default is for Windows Server 2003 and Windows XP Service Pack 2 and later, and for all other versions. + if the allows only one client to use a specific port; otherwise, . The default is . , , , or , the client port is bound as a side effect of the constructor, and you cannot subsequently set the property - - ## Examples The following code example creates a , and gets and sets the property. diff --git a/xml/System.Net/CookieException.xml b/xml/System.Net/CookieException.xml index 54678cf04dc..6ba4b2e2a16 100644 --- a/xml/System.Net/CookieException.xml +++ b/xml/System.Net/CookieException.xml @@ -214,14 +214,7 @@ The to be used. The to be used. Initializes a new instance of the class with specific values of and . - - - + To be added. @@ -307,14 +300,7 @@ The object that holds the serialized object data. The to populate with data. The contextual information about the source or destination. A that specifies the destination for this serialization. Populates a instance with the data needed to serialize the . - - are automatically tracked and serialized by the formatter. - - ]]> - + To be added. diff --git a/xml/System.Net/Dns.xml b/xml/System.Net/Dns.xml index 5d2a7ff11c3..60abdddcd36 100644 --- a/xml/System.Net/Dns.xml +++ b/xml/System.Net/Dns.xml @@ -236,21 +236,7 @@ A user-defined object that contains information about the operation. This object is passed to the delegate when the operation is complete. Begins an asynchronous request for information about the specified DNS host name. An instance that references the asynchronous request. - - operation must be completed by calling the method. Typically, the method is invoked by the `requestCallback` delegate. - - This method does not block until the operation is complete. To block until the operation is complete, use the method. - - For detailed information about using the asynchronous programming model, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously). - -> [!NOTE] -> This member emits trace information when you enable network tracing in your application. - - ]]> - + To be added. is . An error was encountered executing the DNS query. @@ -528,21 +514,7 @@ A user-defined object that contains information about the operation. This object is passed to the delegate when the operation is complete. Begins an asynchronous request to resolve a DNS host name or IP address to an instance. An instance that references the asynchronous request. - - operation must be completed by calling the method. Typically, the method is invoked by the `requestCallback` delegate. - - This method does not block until the operation is complete. To block until the operation is complete, use the method. - - For more information about using the asynchronous programming model, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously). - -> [!NOTE] -> This member emits trace information when you enable network tracing in your application. - - ]]> - + To be added. is . The caller does not have permission to access DNS information. @@ -663,21 +635,7 @@ An instance that is returned by a call to the method. Ends an asynchronous request for DNS information. An object that contains DNS information about a host. - - method. - - If the property is set to `true`, the property of the instance returned is not populated by this method and will always be empty. - -> [!NOTE] -> This member emits trace information when you enable network tracing in your application. - - ]]> - + To be added. is . Asynchronous Programming Overview @@ -801,21 +759,7 @@ An instance that is returned by a call to the method. Ends an asynchronous request for DNS information. An object that contains DNS information about a host. - - is set to `true`, the property of the instance returned is not populated by this method and will always be empty. - - To perform this operation synchronously, use the method. - -> [!NOTE] -> This member emits trace information when you enable network tracing in your application. - - ]]> - + To be added. is . Asynchronous Programming Overview @@ -1133,16 +1077,7 @@ An . Creates an instance from the specified . An instance. - - [!NOTE] -> This member emits trace information when you enable network tracing in your application. - - ]]> - + To be added. is . An error is encountered when resolving . @@ -1205,16 +1140,7 @@ An IP address. Creates an instance from an IP address. An instance. - - [!NOTE] -> This member emits trace information when you enable network tracing in your application. - - ]]> - + To be added. is . An error is encountered when resolving . @@ -1279,21 +1205,7 @@ The DNS name of the host. Gets the DNS information for the specified DNS host name. An object that contains host information for the address specified in . - - method queries the Internet DNS server for host information. If you pass an empty string as the host name, this method retrieves the standard host name for the local computer. - - For asynchronous access to DNS information, use the and methods. - - If the property is set to `true`, the property of the instance returned is not populated by this method and will always be empty. - -> [!NOTE] -> This member emits trace information when you enable network tracing in your application. - - ]]> - + To be added. is . The length of is greater than 255 characters. @@ -1858,21 +1770,7 @@ A DNS-style host name or IP address. Resolves a DNS host name or IP address to an instance. An instance that contains address information about the host specified in . - - method queries a DNS server for the IP address associated with a host name or IP address. - - When `hostName` is a DNS-style host name associated with multiple IP addresses, only the first IP address that resolves to that host name is returned. - - If the property is set to `true`, the property of the instance returned is not populated by this method and will always be empty. - -> [!NOTE] -> This member emits trace information when you enable network tracing in your application. - - ]]> - + To be added. is . The length of is greater than 255 characters. diff --git a/xml/System.Net/DnsPermissionAttribute.xml b/xml/System.Net/DnsPermissionAttribute.xml index 0c774d419e6..fdcd2adf562 100644 --- a/xml/System.Net/DnsPermissionAttribute.xml +++ b/xml/System.Net/DnsPermissionAttribute.xml @@ -88,7 +88,6 @@ Initializes a new instance of the class with the specified value. To be added. The parameter is not a valid . - diff --git a/xml/System.Net/FileWebRequest.xml b/xml/System.Net/FileWebRequest.xml index cbe6413290d..68b82719f1c 100644 --- a/xml/System.Net/FileWebRequest.xml +++ b/xml/System.Net/FileWebRequest.xml @@ -139,14 +139,7 @@ A object that contains the information that is required to serialize the new object. A object that contains the source of the serialized stream that is associated with the new object. Initializes a new instance of the class from the specified instances of the and classes. - - interface for the class. - - ]]> - + To be added. XML and SOAP Serialization @@ -758,14 +751,7 @@ This member outputs trace information when you enable network tracing in your ap The to populate with data. A that specifies the destination for this serialization. Populates a with the data needed to serialize the target object. - - are automatically tracked and serialized by the formatter. - - ]]> - + To be added. diff --git a/xml/System.Net/FileWebResponse.xml b/xml/System.Net/FileWebResponse.xml index da735d3e130..cf9d48a982e 100644 --- a/xml/System.Net/FileWebResponse.xml +++ b/xml/System.Net/FileWebResponse.xml @@ -130,14 +130,7 @@ A instance that contains the information required to serialize the new instance. An instance of the class that contains the source of the serialized stream associated with the new instance. Initializes a new instance of the class from the specified instances of the and classes. - - interface for the class. - - ]]> - + To be added. XML and SOAP Serialization @@ -364,14 +357,7 @@ The to populate with data. A that specifies the destination for this serialization. Populates a with the data needed to serialize the target object. - - are automatically tracked and serialized by the formatter. - - ]]> - + To be added. diff --git a/xml/System.Net/GlobalProxySelection.xml b/xml/System.Net/GlobalProxySelection.xml index bc1980cb789..24305c3f615 100644 --- a/xml/System.Net/GlobalProxySelection.xml +++ b/xml/System.Net/GlobalProxySelection.xml @@ -63,18 +63,7 @@ Contains a global default proxy instance for all HTTP requests. - - stores the proxy settings for the default proxy that instances use to contact Internet sites beyond the local network. The default proxy setting is initialized from the global or application configuration file, and can be overridden for individual requests or disabled by setting the property to the result of the method. - - The proxy settings stored in are used by any derived objects that support proxies and have their property value set to `null` (the default). Proxies are currently supported by , , and . - - **Note** Changes to the after a request is made are not reflected in a . - - ]]> - + To be added. diff --git a/xml/System.Net/HttpListener.xml b/xml/System.Net/HttpListener.xml index 0473239cec4..d14e57c6a46 100644 --- a/xml/System.Net/HttpListener.xml +++ b/xml/System.Net/HttpListener.xml @@ -163,10 +163,8 @@ Starting in .NET 11, the Windows `HTTP.sys` implementation of - This class cannot be used on the current operating system. Windows Server 2003 or Windows XP SP2 is required to use instances of this class. - - Note: This member outputs trace information when you enable network tracing in your application. - + The operating system is not supported. + This member outputs trace information when you enable network tracing in your application. diff --git a/xml/System.Net/HttpWebRequest.xml b/xml/System.Net/HttpWebRequest.xml index f67b6e97584..261620f28db 100644 --- a/xml/System.Net/HttpWebRequest.xml +++ b/xml/System.Net/HttpWebRequest.xml @@ -1058,7 +1058,6 @@ The request cache validator indicated that the response for this request can be served from the cache; however, requests that write data must not use the cache. This exception can occur if you are using a custom cache validator that is incorrectly implemented. was previously called. - In a .NET Compact Framework application, a request stream with zero content length was not obtained and closed correctly. @@ -2115,15 +2114,7 @@ The to populate with data. A that specifies the destination for this serialization. Populates a with the data required to serialize the target object. - - are automatically tracked and serialized by the formatter. - - ]]> - + To be added. @@ -2204,7 +2195,6 @@ -or- An error occurred while processing the request. - In a .NET Compact Framework application, a request stream with zero content length was not obtained and closed correctly. @@ -3462,15 +3452,7 @@ The to populate with data. A that specifies the destination for this serialization. Populates a with the data needed to serialize the target object. - - are automatically tracked and serialized by the formatter. - - ]]> - + To be added. diff --git a/xml/System.Net/HttpWebResponse.xml b/xml/System.Net/HttpWebResponse.xml index 4995d6a0885..40daea134ed 100644 --- a/xml/System.Net/HttpWebResponse.xml +++ b/xml/System.Net/HttpWebResponse.xml @@ -211,14 +211,7 @@ The contents of the response from the Internet resource are returned as a A that contains the information required to serialize the new . A that contains the source of the serialized stream that is associated with the new . Initializes a new instance of the class from the specified and instances. - - interface for the class. - - ]]> - + To be added. @@ -712,14 +705,7 @@ The contents of the response from the Internet resource are returned as a The to populate with data. A that specifies the destination for this serialization. Populates a with the data needed to serialize the target object. - - are automatically tracked and serialized by the formatter. - - ]]> - + To be added. diff --git a/xml/System.Net/ProtocolViolationException.xml b/xml/System.Net/ProtocolViolationException.xml index 30e352ae8ed..86570029fc0 100644 --- a/xml/System.Net/ProtocolViolationException.xml +++ b/xml/System.Net/ProtocolViolationException.xml @@ -221,14 +221,7 @@ A that contains the information that is required to deserialize the . A that contains the source of the serialized stream that is associated with the new . Initializes a new instance of the class from the specified and instances. - - interface for the class. - - ]]> - + To be added. @@ -285,14 +278,7 @@ The to populate with data. A that specifies the destination for this serialization. Populates a with the data required to serialize the target object. - - are automatically tracked and serialized by the formatter. - - ]]> - + To be added. diff --git a/xml/System.Net/ServicePointManager.xml b/xml/System.Net/ServicePointManager.xml index 1615d2db3b6..3f8a077cddf 100644 --- a/xml/System.Net/ServicePointManager.xml +++ b/xml/System.Net/ServicePointManager.xml @@ -638,14 +638,7 @@ To opt out of the behavior that blocks insecure cipher and hashing algorithms fo The object of the Internet resource to contact. Finds an existing object or creates a new object to manage communications with the specified object. The object that manages communications for the request. - - method returns the object associated with the specified Internet host name. If no object exists for that host, the object creates one. - - ]]> - + To be added. is . The maximum number of objects defined in has been reached. @@ -714,22 +707,7 @@ To opt out of the behavior that blocks insecure cipher and hashing algorithms fo The proxy data for this request. Finds an existing object or creates a new object to manage communications with the specified Uniform Resource Identifier (URI). The object that manages communications for the request. - - method returns the object associated with the specified Internet host name. If no object exists for that host, the object creates one. - - - -## Examples - The following code example demonstrates calling this method to access a object. - - :::code language="csharp" source="~/snippets/csharp/System.Net/HttpWebRequest/ServicePoint/servicepoint.cs" id="Snippet7"::: - :::code language="vb" source="~/snippets/visualbasic/System.Net/HttpWebRequest/ServicePoint/servicepoint.vb" id="Snippet7"::: - - ]]> - + To be added. The URI specified in is invalid. The maximum number of objects defined in has been reached. @@ -798,14 +776,7 @@ To opt out of the behavior that blocks insecure cipher and hashing algorithms fo The proxy data for this request. Finds an existing object or creates a new object to manage communications with the specified object. The object that manages communications for the request. - - method returns the object associated with the specified Internet host name. If no object exists for that host, the object creates one. - - ]]> - + To be added. is . The maximum number of objects defined in has been reached. diff --git a/xml/System.Net/WebClient.xml b/xml/System.Net/WebClient.xml index 8e6c6dd333c..96317fa4a13 100644 --- a/xml/System.Net/WebClient.xml +++ b/xml/System.Net/WebClient.xml @@ -110,22 +110,7 @@ Initializes a new instance of the class. - - class. The default HTTP method is GET. The default FTP method is RETR. The default is . The default value of is `true`. - -## Examples - The following code example creates a instance and then uses it to download data from a server and display it on the system console, to download data from a server and write it to a file, and to upload form values to a server and receive the response. - - [!code-cpp[WebClient#1](~/snippets/cpp/VS_Snippets_Remoting/WebClient/CPP/webclient.cpp#1)] - [!code-csharp[WebClient#1](~/snippets/csharp/System.Net/WebClient/.ctor/webclient.cs#1)] - [!code-vb[WebClient#1](~/snippets/visualbasic/System.Net/WebClient/.ctor/webclient.vb#1)] - - ]]> - + To be added. @@ -229,15 +214,7 @@ Gets or sets a value that indicates whether to buffer the data written to the Internet resource for a instance. to enable buffering of the data written to the Internet resource; to disable buffering. The default is . - - property is `true`, the data is buffered in memory so it can be written more efficiently to the Internet resource in larger chunks. - - ]]> - + To be added. @@ -4060,7 +4037,6 @@ - diff --git a/xml/System.Net/WebException.xml b/xml/System.Net/WebException.xml index 162b9995e07..d996abf6f08 100644 --- a/xml/System.Net/WebException.xml +++ b/xml/System.Net/WebException.xml @@ -256,14 +256,7 @@ A that contains the information required to serialize the new . A that contains the source of the serialized stream that is associated with the new . Initializes a new instance of the class from the specified and instances. - - interface for the class. - - ]]> - + To be added. diff --git a/xml/System.Net/WebHeaderCollection.xml b/xml/System.Net/WebHeaderCollection.xml index 055d70eb963..d1c3aa61c5f 100644 --- a/xml/System.Net/WebHeaderCollection.xml +++ b/xml/System.Net/WebHeaderCollection.xml @@ -196,14 +196,7 @@ The class is generally accessed through A containing the information required to serialize the . A containing the source of the serialized stream associated with the new . Initializes a new instance of the class from the specified instances of the and classes. - - interface for the class. - - ]]> - + To be added. The header name contains invalid characters. @@ -1070,14 +1063,7 @@ The class is generally accessed through The to populate with data. A that specifies the destination for this serialization. Populates a with the data needed to serialize the target object. - - are automatically tracked and serialized by the formatter. - - ]]> - + To be added. diff --git a/xml/System.Net/WebPermission.xml b/xml/System.Net/WebPermission.xml index 85faba726b2..2df70b131ed 100644 --- a/xml/System.Net/WebPermission.xml +++ b/xml/System.Net/WebPermission.xml @@ -54,7 +54,6 @@ ]]> - @@ -673,7 +672,6 @@ A that represents the union of the current instance and the parameter. If either is , the method returns a that is . If the target is , the method returns a copy of the current . To be added. target is not or of type . - diff --git a/xml/System.Net/WebRequest.xml b/xml/System.Net/WebRequest.xml index 359ab268ea4..91218bf1c59 100644 --- a/xml/System.Net/WebRequest.xml +++ b/xml/System.Net/WebRequest.xml @@ -131,21 +131,7 @@ Initializes a new instance of the class. - - method to initialize new instances. Do not use the constructor. - -## Examples - The following example shows how to create a instance by calling the method on the class. - - :::code language="csharp" source="~/snippets/csharp/System.Net/WebRequest/.ctor/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Net/WebRequest/.ctor/source.vb" id="Snippet1"::: - - ]]> - + To be added. @@ -743,42 +729,7 @@ The URI that identifies the Internet resource. Initializes a new instance for the specified URI scheme. A descendant for the specific URI scheme. - - method returns a descendant of the class determined at run time as the closest registered match for `requestUri`. - - For example, when a URI beginning with `http://` or `https://` is passed in `requestUri`, an is returned by . If a URI beginning with `ftp://` is passed instead, the method will return a instance. If a URI beginning with `file://` is passed instead, the method will return a instance. - - The pre-registered reserve types already registered include the following: - -- `http://` - -- `https://` - -- `ftp://` - -- `file://` - - .NET includes support for the `http://`, `https://`, `ftp://`, and `file://` URI schemes. Custom descendants to handle other requests are registered with the method. - - The method uses the `requestUriString` parameter to create a instance that it passes to the new . - -> [!NOTE] -> This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in the .NET Framework](/dotnet/framework/network-programming/network-tracing). - - - -## Examples - The following example uses to instantiate an instance. A string representing the target URL is used as the constructor parameter. - - :::code language="csharp" source="~/snippets/csharp/System.Net/WebRequest/Create/webresponse_responseuri.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Net/WebRequest/Create/webresponse_responseuri.vb" id="Snippet1"::: - - ]]> - + To be added. The request scheme specified in has not been registered. is . @@ -837,44 +788,7 @@ A containing the URI of the requested resource. Initializes a new instance for the specified URI scheme. A descendant for the specified URI scheme. - - method returns a descendant of the class determined at run time as the closest registered match for `requestUri`. - - For example, if you create a descendant, Handler1, to handle requests to `http://www.contoso.com/text/` and another named Handler2 to handle requests to `http://www.contoso.com/code/`, you can use method to return the WebRequest descendant associated with either specified URI. - - To return a descendant of the class based on only the scheme portion of a URI, use the method. - - For example, when a URI beginning with `http://` or `https://` is passed in `requestUri`, an is returned by . If a URI beginning with `ftp://` is passed instead, the method will return a instance. If a URI beginning with `file://` is passed instead, the method will return a instance. - - The pre-registered reserve types already registered include the following: - -- `http://` - -- `https://` - -- `ftp://` - -- `file://` - - .NET includes support for the `http://`, `https://`, `ftp://`, and `file://` URI schemes. Custom descendants to handle other requests are registered with the method. - -> [!NOTE] -> This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in the .NET Framework](/dotnet/framework/network-programming/network-tracing). - - - -## Examples - The following example uses to instantiate an instance. A Uri representing the target URL is used as the constructor parameter. - - :::code language="csharp" source="~/snippets/csharp/System.Net/WebRequest/Create/webrequest_create.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Net/WebRequest/Create/webrequest_create.vb" id="Snippet1"::: - - ]]> - + To be added. The request scheme specified in is not registered. is . @@ -930,20 +844,7 @@ A containing the URI of the requested resource. Initializes a new instance for the specified URI scheme. A descendant for the specified URI scheme. - - method returns a descendant instance based on only the scheme portion of a URI. - - For example, when a URI beginning with `http://` is passed in `requestUri`, an is returned by . If a URI beginning with `file://` is passed instead, the method will return a . - -> [!NOTE] -> This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET](/dotnet/framework/network-programming/network-tracing). - - ]]> - + To be added. The request scheme specified in is not registered. is . @@ -1008,21 +909,7 @@ A URI string that identifies the Internet resource. Initializes a new instance for the specified URI string. An instance for the specific URI string. - - method returns an instance of the class for the `requestUriString`. - - When a URI that begins with `http://` or `https://` is passed in the `requestUriString` parameter, a is returned by . Any other scheme will throw a . - - The method uses the `requestUriString` parameter to create a instance that it passes to the new . If the method is successful, the property on the returned instance is set to `false`. - - .NET includes support for the `http://` and `https://` URI schemes. Custom descendants to handle other requests are registered with the method. The method can be used to create a descendant of the class for other schemes. - - ]]> - + To be added. The request scheme specified in is the http or https scheme. is . @@ -1078,21 +965,7 @@ A URI that identifies the Internet resource. Initializes a new instance for the specified URI. An instance for the specific URI string. - - method returns an instance of the class for the `requestUri`. - - When a URI that begins with `http://` or `http://` is passed in the `requestUri` parameter, an is returned by . Another other scheme will throw a . - - The method uses the `requestUri` parameter to create a new instance. If the method is successful, the property on the returned instance is set to `false`. - - .NET includes support for the `http://` and `https://` URI schemes. Custom descendants to handle other requests are registered with the method. The method can be used to create a descendant of the class for other schemes. - - ]]> - + To be added. The request scheme specified in is the http or https scheme. is . @@ -1443,15 +1316,7 @@ The to populate with data. A that specifies the destination for this serialization. Populates a with the data needed to serialize the target object. - - are automatically tracked and serialized by the formatter. - - ]]> - + To be added. diff --git a/xml/System.Net/WebResponse.xml b/xml/System.Net/WebResponse.xml index fbac94344e1..355f5ec34ac 100644 --- a/xml/System.Net/WebResponse.xml +++ b/xml/System.Net/WebResponse.xml @@ -199,14 +199,7 @@ An instance of the class that contains the information required to serialize the new instance. An instance of the class that indicates the source of the serialized stream that is associated with the new instance. Initializes a new instance of the class from the specified instances of the and classes. - - interface for the descendant. - - ]]> - + To be added. Any attempt is made to access the constructor, when the constructor is not overridden in a descendant class. @@ -566,14 +559,7 @@ The to populate with data. A that specifies the destination for this serialization. Populates a with the data that is needed to serialize the target object. - - are automatically tracked and serialized by the formatter. - - ]]> - + To be added. diff --git a/xml/System.Net/WriteStreamClosedEventArgs.xml b/xml/System.Net/WriteStreamClosedEventArgs.xml index 1e976715630..89ffe6b0bdc 100644 --- a/xml/System.Net/WriteStreamClosedEventArgs.xml +++ b/xml/System.Net/WriteStreamClosedEventArgs.xml @@ -126,14 +126,7 @@ Gets the error value when a write stream is closed. Returns . - - property is an object, the asynchronous operation did not complete correctly. - - ]]> - + To be added. diff --git a/xml/System.Printing/PrintQueue.xml b/xml/System.Printing/PrintQueue.xml index c86d1e33a8d..7669efe7115 100644 --- a/xml/System.Printing/PrintQueue.xml +++ b/xml/System.Printing/PrintQueue.xml @@ -3790,7 +3790,6 @@ ]]> - @@ -3840,7 +3839,6 @@ ]]> - diff --git a/xml/System.Printing/PrintSystemJobInfo.xml b/xml/System.Printing/PrintSystemJobInfo.xml index 7a366bd119a..ccd206cc015 100644 --- a/xml/System.Printing/PrintSystemJobInfo.xml +++ b/xml/System.Printing/PrintSystemJobInfo.xml @@ -866,14 +866,11 @@ - @@ -1521,7 +1517,6 @@ ]]> - diff --git a/xml/System.Reflection.Emit/AssemblyBuilder.xml b/xml/System.Reflection.Emit/AssemblyBuilder.xml index d6298ad3c29..a76e203feb1 100644 --- a/xml/System.Reflection.Emit/AssemblyBuilder.xml +++ b/xml/System.Reflection.Emit/AssemblyBuilder.xml @@ -203,14 +203,7 @@ The following code example shows how to define and use a dynamic assembly. The e Gets the location of the assembly, as specified originally (such as in an object). The location of the assembly, as specified originally. - - property. - - ]]> - + To be added. This method is not currently supported. The caller does not have the required permission. @@ -2148,7 +2141,6 @@ The following code example shows how to define and use a dynamic assembly. The e ]]> - How to: Load Assemblies into the Reflection-Only Context diff --git a/xml/System.Reflection/Assembly.xml b/xml/System.Reflection/Assembly.xml index fd3a85f34e2..b2bf13bd787 100644 --- a/xml/System.Reflection/Assembly.xml +++ b/xml/System.Reflection/Assembly.xml @@ -227,24 +227,7 @@ Many members of the class provide information Gets the location of the assembly as specified originally, for example, in an object. The location of the assembly as specified originally. - - property instead. - - If the assembly was loaded as a byte array, using an overload of the method that takes an array of bytes, this property returns the location of the caller of the method, not the location of the loaded assembly. - -In .NET 5 and later versions, for bundled assemblies, this property throws an exception. - -## Examples - The following example uses the property. - - :::code language="csharp" source="~/snippets/csharp/System.Reflection/Assembly/CodeBase/codebase1.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Reflection/Assembly/CodeBase/codebase1.vb" id="Snippet1"::: - - ]]> - + To be added. In all cases. diff --git a/xml/System.Reflection/AssemblyFlagsAttribute.xml b/xml/System.Reflection/AssemblyFlagsAttribute.xml index 6c82028303a..409df1d3d59 100644 --- a/xml/System.Reflection/AssemblyFlagsAttribute.xml +++ b/xml/System.Reflection/AssemblyFlagsAttribute.xml @@ -390,14 +390,7 @@ Gets an unsigned integer value representing the combination of flags specified when this attribute instance was created. An unsigned integer value representing a bitwise combination of flags. - - type before using it. - - ]]> - + To be added. diff --git a/xml/System.Reflection/AssemblyName.xml b/xml/System.Reflection/AssemblyName.xml index 5850153c0e6..8ca547ce7aa 100644 --- a/xml/System.Reflection/AssemblyName.xml +++ b/xml/System.Reflection/AssemblyName.xml @@ -416,27 +416,7 @@ ExampleAssembly, Version=1.0.0.0, Culture=en, PublicKeyToken=a5d015c7d5a0b012 Gets or sets the location of the assembly as a URL. A string that is the URL location of the assembly. - - property. - - If the assembly was loaded as a byte array, this property returns the location of the caller of the method overload, not the location of the loaded assembly. - -> [!NOTE] -> Do not use an with only the property set. The property does not supply any elements of the assembly identity (such as name or version), so loading does not occur according to load-by-identity rules, as you would expect from the method. Instead, the assembly is loaded using load-from rules. For information about the disadvantages of using the load-from context, see the method overload or [Best Practices for Assembly Loading](/dotnet/framework/deployment/best-practices-for-assembly-loading). - - - -## Examples - The following example emits a dynamic assembly and saves it to the current directory. When the assembly is created, the property is used to specify the directory where the assembly is saved. - - :::code language="csharp" source="~/snippets/csharp/System.Reflection/AssemblyName/CodeBase/assemblyname_codebase.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Reflection/AssemblyName/CodeBase/assemblyname_codebase.vb" id="Snippet1"::: - - ]]> - + To be added. @@ -1092,22 +1072,7 @@ mylib, Version=1.2.1900.0, Culture=neutral, PublicKeyToken=a14f3033def15840 Gets or sets the hash algorithm used by the assembly manifest. The hash algorithm used by the assembly manifest. - - [!IMPORTANT] -> The property of an object that is returned by the method is if there is no hash algorithm for the referenced assembly, or if the hash algorithm of the referenced assembly is not identified by the enumeration. - -## Examples - The following example emits a dynamic assembly and saves it to the current directory. When the assembly is created, the property is used to set the hash algorithm for the assembly manifest. - - :::code language="csharp" source="~/snippets/csharp/System.Reflection/AssemblyName/CodeBase/assemblyname_codebase.cs" id="Snippet3"::: - :::code language="vb" source="~/snippets/visualbasic/System.Reflection/AssemblyName/CodeBase/assemblyname_codebase.vb" id="Snippet3"::: - - ]]> - + To be added. @@ -1281,7 +1246,6 @@ mylib, Version=1.2.1900.0, Culture=neutral, PublicKeyToken=a14f3033def15840 Implements the interface and is called back by the deserialization event when deserialization is complete. To be added. - @@ -1333,13 +1297,7 @@ mylib, Version=1.2.1900.0, Culture=neutral, PublicKeyToken=a14f3033def15840 Gets or sets a value that identifies the processor and bits-per-word of the platform targeted by an executable. One of the enumeration values that identifies the processor and bits-per-word of the platform targeted by an executable. - - for reference assemblies. - - ]]> - + To be added. @@ -1723,16 +1681,7 @@ This property always returns Gets or sets the information related to the assembly's compatibility with other assemblies. A value that represents information about the assembly's compatibility with other assemblies. - - information indicates, for example, that the assembly cannot execute side-by-side with other versions due to conflicts over a device driver. - - Currently, always returns , and is not used by the loader. This property is reserved for a future feature. - - ]]> - + To be added. diff --git a/xml/System.Reflection/AssemblyTitleAttribute.xml b/xml/System.Reflection/AssemblyTitleAttribute.xml index 02742c2b7b0..507157c17ee 100644 --- a/xml/System.Reflection/AssemblyTitleAttribute.xml +++ b/xml/System.Reflection/AssemblyTitleAttribute.xml @@ -65,9 +65,7 @@ ## Remarks The assembly title is a friendly name, which can include spaces. - In Windows Vista, the information specified for this attribute appears on the **Details** tab of the **Windows File Properties** dialog box for the assembly. The property name is **File description**. In Windows XP, this information appears on the **Version** tab of the **Windows File Properties** dialog box. - - +On Windows, the information specified for this attribute appears on the **Details** tab of the **Windows File Properties** dialog box for the assembly. The property name is **File description**. ## Examples The following example shows how to add attributes, including the attribute, to a dynamic assembly. The example saves the assembly to disk, and the attribute value can be viewed by using the **Windows File Properties** dialog box. @@ -125,7 +123,8 @@ @@ -177,7 +176,8 @@ property appears on the **Details** tab of the **Windows File Properties** dialog box for the assembly. The property name is **File description**. In Windows XP, this property appears on the **Version** tab of the **Windows File Properties** dialog box. + +On Windows, the value of the property appears on the **Details** tab of the **Windows File Properties** dialog box for the assembly. ]]> diff --git a/xml/System.Reflection/CustomAttributeData.xml b/xml/System.Reflection/CustomAttributeData.xml index 371b25dfaf8..78a80995605 100644 --- a/xml/System.Reflection/CustomAttributeData.xml +++ b/xml/System.Reflection/CustomAttributeData.xml @@ -105,7 +105,6 @@ ]]> - @@ -267,7 +266,6 @@ ]]> - @@ -340,7 +338,6 @@ ]]> - @@ -473,7 +470,6 @@ is . - @@ -548,7 +544,6 @@ is . - @@ -673,7 +668,6 @@ is . - @@ -794,7 +788,6 @@ ]]> - diff --git a/xml/System.Reflection/FieldInfo.xml b/xml/System.Reflection/FieldInfo.xml index e19dce1f4da..158068dbc57 100644 --- a/xml/System.Reflection/FieldInfo.xml +++ b/xml/System.Reflection/FieldInfo.xml @@ -1402,22 +1402,7 @@ Myfieldb - B readonly field, IsInitOnly = True Gets a value indicating whether this field has the attribute. if the field has the attribute set; otherwise, . - - - + To be added. diff --git a/xml/System.Reflection/ParameterInfo.xml b/xml/System.Reflection/ParameterInfo.xml index 86e62b52158..c24e1acd2bd 100644 --- a/xml/System.Reflection/ParameterInfo.xml +++ b/xml/System.Reflection/ParameterInfo.xml @@ -846,14 +846,7 @@ The following example defines a method with three parameters. It uses the The serialized stream from which the current object is deserialized. Returns the real object that should be deserialized instead of the object that the serialized stream specifies. The actual object that is put into the graph. - - method. - - ]]> - + To be added. The parameter's position in the parameter list of its associated member is not valid for that member's type. diff --git a/xml/System.Reflection/StrongNameKeyPair.xml b/xml/System.Reflection/StrongNameKeyPair.xml index b2b48aac4b0..622ea161d6f 100644 --- a/xml/System.Reflection/StrongNameKeyPair.xml +++ b/xml/System.Reflection/StrongNameKeyPair.xml @@ -62,19 +62,7 @@ Encapsulates access to a public or private key pair used to sign strong name assemblies. - - - - - + To be added. diff --git a/xml/System.Resources/MissingManifestResourceException.xml b/xml/System.Resources/MissingManifestResourceException.xml index 8a0c2a1b1ae..6a191feba69 100644 --- a/xml/System.Resources/MissingManifestResourceException.xml +++ b/xml/System.Resources/MissingManifestResourceException.xml @@ -287,14 +287,7 @@ For a list of initial property values for an instance of The object that holds the serialized object data. The contextual information about the source or destination of the exception. Initializes a new instance of the class from serialized data. - - - + To be added. diff --git a/xml/System.Resources/MissingSatelliteAssemblyException.xml b/xml/System.Resources/MissingSatelliteAssemblyException.xml index 0affab84352..1f3ab1e6fe0 100644 --- a/xml/System.Resources/MissingSatelliteAssemblyException.xml +++ b/xml/System.Resources/MissingSatelliteAssemblyException.xml @@ -302,14 +302,7 @@ HelloWorld2 The object that holds the serialized object data. The contextual information about the source or destination of the exception. Initializes a new instance of the class from serialized data. - - - + To be added. diff --git a/xml/System.Runtime.CompilerServices/DisablePrivateReflectionAttribute.xml b/xml/System.Runtime.CompilerServices/DisablePrivateReflectionAttribute.xml index a90b0108c47..d97ec61c874 100644 --- a/xml/System.Runtime.CompilerServices/DisablePrivateReflectionAttribute.xml +++ b/xml/System.Runtime.CompilerServices/DisablePrivateReflectionAttribute.xml @@ -55,18 +55,7 @@ Indicates that any private members contained in an assembly's types are not available to reflection. - - [!NOTE] -> The .NET runtime does not consistently enforce this attribute. Don't rely on this attribute to restrict access to an assembly's non-public members. - - Ordinarily, reflection methods, such a or , can be used to get information about private members at runtime. When applies to an assembly, the attribute makes information about private members in that assembly's types unavailable to runtime reflection. - - ]]> - + To be added. diff --git a/xml/System.Runtime.CompilerServices/RuntimeHelpers.xml b/xml/System.Runtime.CompilerServices/RuntimeHelpers.xml index 225ec620851..015422180ad 100644 --- a/xml/System.Runtime.CompilerServices/RuntimeHelpers.xml +++ b/xml/System.Runtime.CompilerServices/RuntimeHelpers.xml @@ -826,14 +826,7 @@ The following example demonstrates the difference between the Gets the offset, in bytes, to the data in the given string. The byte offset, from the start of the object to the first character in the string. - - - + To be added. diff --git a/xml/System.Runtime.CompilerServices/RuntimeWrappedException.xml b/xml/System.Runtime.CompilerServices/RuntimeWrappedException.xml index 358cf77cc60..5921e30fe06 100644 --- a/xml/System.Runtime.CompilerServices/RuntimeWrappedException.xml +++ b/xml/System.Runtime.CompilerServices/RuntimeWrappedException.xml @@ -159,14 +159,7 @@ The object that holds the serialized object data about the exception being thrown. The object that contains contextual information about the source or destination. Sets the object with information about the exception. - - method sets a object with all the exception object data targeted for serialization. During deserialization, the exception is reconstituted from the `SerializationInfo` transmitted over the stream. - - ]]> - + To be added. The parameter is . diff --git a/xml/System.Runtime.CompilerServices/SuppressIldasmAttribute.xml b/xml/System.Runtime.CompilerServices/SuppressIldasmAttribute.xml index 9f70e0df193..5e92419a65c 100644 --- a/xml/System.Runtime.CompilerServices/SuppressIldasmAttribute.xml +++ b/xml/System.Runtime.CompilerServices/SuppressIldasmAttribute.xml @@ -54,26 +54,7 @@ Prevents the Ildasm.exe (IL Disassembler) from disassembling an assembly. This class cannot be inherited. - - attribute to an assembly or module to prevent the assembly or module from being disassembled using the [Ildasm.exe (IL Disassembler)](/dotnet/framework/tools/ildasm-exe-il-disassembler). - - This attribute does not prevent an assembly from being viewed using reflection. - - Note that attribute does not block the [Ildasm.exe (IL Disassembler)](/dotnet/framework/tools/ildasm-exe-il-disassembler) from viewing header information and meta-information. - - - -## Examples - The following code example demonstrates how to apply the attribute to an assembly. - - :::code language="csharp" source="~/snippets/csharp/System.Runtime.CompilerServices/SuppressIldasmAttribute/Overview/sample.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Runtime.CompilerServices/SuppressIldasmAttribute/Overview/sample.vb" id="Snippet1"::: - - ]]> - + To be added. diff --git a/xml/System.Runtime.ConstrainedExecution/Cer.xml b/xml/System.Runtime.ConstrainedExecution/Cer.xml index 7850338d9d5..4d1ecf4f94d 100644 --- a/xml/System.Runtime.ConstrainedExecution/Cer.xml +++ b/xml/System.Runtime.ConstrainedExecution/Cer.xml @@ -50,7 +50,6 @@ Specifies a method's behavior when called within a constrained execution region. To be added. - Reliability Best Practices diff --git a/xml/System.Runtime.ConstrainedExecution/Consistency.xml b/xml/System.Runtime.ConstrainedExecution/Consistency.xml index 77736d54225..f6e70abbd5b 100644 --- a/xml/System.Runtime.ConstrainedExecution/Consistency.xml +++ b/xml/System.Runtime.ConstrainedExecution/Consistency.xml @@ -50,7 +50,6 @@ Specifies a reliability contract. To be added. - Reliability Best Practices diff --git a/xml/System.Runtime.ConstrainedExecution/ReliabilityContractAttribute.xml b/xml/System.Runtime.ConstrainedExecution/ReliabilityContractAttribute.xml index 4890570b7e6..8c6ce30aef5 100644 --- a/xml/System.Runtime.ConstrainedExecution/ReliabilityContractAttribute.xml +++ b/xml/System.Runtime.ConstrainedExecution/ReliabilityContractAttribute.xml @@ -55,8 +55,6 @@ Defines a contract for reliability between the author of some code, and the developers who have a dependency on that code. To be added. - - Reliability Best Practices diff --git a/xml/System.Runtime.InteropServices/COMException.xml b/xml/System.Runtime.InteropServices/COMException.xml index f03cd3e9ee8..dce83e0170e 100644 --- a/xml/System.Runtime.InteropServices/COMException.xml +++ b/xml/System.Runtime.InteropServices/COMException.xml @@ -268,16 +268,7 @@ Although you can use the clas The object that holds the serialized object data. The object that supplies the contextual information about the source or destination. Initializes a new instance of the class from serialization data. - - inherits from . - - ]]> - + To be added. is . diff --git a/xml/System.Runtime.InteropServices/CurrencyWrapper.xml b/xml/System.Runtime.InteropServices/CurrencyWrapper.xml index 3c9338094df..ba179fc2552 100644 --- a/xml/System.Runtime.InteropServices/CurrencyWrapper.xml +++ b/xml/System.Runtime.InteropServices/CurrencyWrapper.xml @@ -60,14 +60,7 @@ Wraps objects the marshaler should marshal as a . - - - + To be added. diff --git a/xml/System.Runtime.InteropServices/ExternalException.xml b/xml/System.Runtime.InteropServices/ExternalException.xml index c5750d1b57f..af47a328ff3 100644 --- a/xml/System.Runtime.InteropServices/ExternalException.xml +++ b/xml/System.Runtime.InteropServices/ExternalException.xml @@ -235,14 +235,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class from serialization data. - - - + To be added. is . diff --git a/xml/System.Runtime.InteropServices/InvalidComObjectException.xml b/xml/System.Runtime.InteropServices/InvalidComObjectException.xml index 03f5c0f0038..13c575d5481 100644 --- a/xml/System.Runtime.InteropServices/InvalidComObjectException.xml +++ b/xml/System.Runtime.InteropServices/InvalidComObjectException.xml @@ -250,16 +250,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class from serialization data. - - . - - `InvalidComObjectException` inherits from . - - ]]> - + To be added. is . diff --git a/xml/System.Runtime.InteropServices/InvalidOleVariantTypeException.xml b/xml/System.Runtime.InteropServices/InvalidOleVariantTypeException.xml index ac39e609e47..750d9b63d49 100644 --- a/xml/System.Runtime.InteropServices/InvalidOleVariantTypeException.xml +++ b/xml/System.Runtime.InteropServices/InvalidOleVariantTypeException.xml @@ -248,16 +248,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class from serialization data. - - . - - `InvalidOleVariantTypeException` inherits from . - - ]]> - + To be added. is . diff --git a/xml/System.Runtime.InteropServices/Marshal.xml b/xml/System.Runtime.InteropServices/Marshal.xml index 1e1f5ce4d95..2776248d6d2 100644 --- a/xml/System.Runtime.InteropServices/Marshal.xml +++ b/xml/System.Runtime.InteropServices/Marshal.xml @@ -3411,14 +3411,7 @@ Retrieves a code that identifies the type of the exception that occurred. The type of the exception. - - is exposed for compiler support of structured exception handling (SEH) only. If this method is called before an exception is thrown, it returns 0x0. - - ]]> - + To be added. @@ -7064,16 +7057,7 @@ This method is functionally equivalent to An additional byte offset, which is added to the parameter before reading. Reads a single byte at a given offset (or index) from unmanaged memory. The byte read from unmanaged memory at the given offset. - - enables direct interaction with an unmanaged C-style byte array, eliminating the expense of copying an entire unmanaged array (using ) to a separate managed array before reading its element values. - - Reading from unaligned memory locations is supported. - - ]]> - + To be added. Base address () plus offset byte () produces a null or invalid address. is an object. This method does not accept parameters. @@ -7257,7 +7241,6 @@ This method is functionally equivalent to Base address () plus offset byte () produces a null or invalid address. - @@ -7325,16 +7308,7 @@ This method is functionally equivalent to An additional byte offset, which is added to the parameter before reading. Reads a 16-bit signed integer at a given offset from unmanaged memory. The 16-bit signed integer read from unmanaged memory at the given offset. - - enables direct interaction with an unmanaged 16-bit signed array, eliminating the expense of copying an entire unmanaged array (using ) to a separate managed array before reading its element values. - - Reading from unaligned memory locations is supported. - - ]]> - + To be added. Base address () plus offset byte () produces a null or invalid address. is an object. This method does not accept parameters. @@ -7518,7 +7492,6 @@ This method is functionally equivalent to Base address () plus offset byte () produces a null or invalid address. - @@ -7586,16 +7559,7 @@ This method is functionally equivalent to An additional byte offset, which is added to the parameter before reading. Reads a 32-bit signed integer at a given offset from unmanaged memory. The 32-bit signed integer read from unmanaged memory at the given offset. - - enables direct interaction with an unmanaged 32-bit signed array, eliminating the expense of copying an entire unmanaged array (using ) to a separate managed array before reading its element values. - - Reading from unaligned memory locations is supported. - - ]]> - + To be added. Base address () plus offset byte () produces a null or invalid address. is an object. This method does not accept parameters. @@ -7779,7 +7743,6 @@ This method is functionally equivalent to Base address () plus offset byte () produces a null or invalid address. - @@ -7847,16 +7810,7 @@ This method is functionally equivalent to An additional byte offset, which is added to the parameter before reading. Reads a 64-bit signed integer at a given offset from unmanaged memory. The 64-bit signed integer read from unmanaged memory at the given offset. - - enables direct interaction with an unmanaged 64-bit signed array, eliminating the expense of copying an entire unmanaged array (using ) to a separate managed array before reading its element values. - - Reading from unaligned memory locations is supported. - - ]]> - + To be added. Base address () plus offset byte () produces a null or invalid address. is an object. This method does not accept parameters. @@ -8032,7 +7986,6 @@ This method is functionally equivalent to Base address () plus offset byte () produces a null or invalid address. - @@ -8100,16 +8053,7 @@ This method is functionally equivalent to An additional byte offset, which is added to the parameter before reading. Reads a processor native-sized integer from unmanaged memory. The integer read from unmanaged memory at the given offset. - - enables direct interaction with an unmanaged C-style `IntPtr` array, eliminating the expense of copying an entire unmanaged array (using ) to a separate managed array before reading its element values. - - Reading from unaligned memory locations is supported. - - ]]> - + To be added. Base address () plus offset byte () produces a null or invalid address. is an object. This method does not accept parameters. @@ -10630,14 +10574,7 @@ public static void ThrowExceptionForHR(interrorCode,IntPtrerrorInfo) An additional byte offset, which is added to the parameter before writing. The value to write. Writes a single byte value to unmanaged memory at a specified offset. - - enables direct interaction with an unmanaged C-style byte array, eliminating the expense of copying an entire unmanaged array (using ) to a separate managed array before setting its element values. - - ]]> - + To be added. Base address () plus offset byte () produces a null or invalid address. is an object. This method does not accept parameters. @@ -11044,16 +10981,7 @@ public static void ThrowExceptionForHR(interrorCode,IntPtrerrorInfo) An additional byte offset, which is added to the parameter before writing. The value to write. Writes a 16-bit signed integer value to unmanaged memory at a specified offset. - - enables direct interaction with an unmanaged 16-bit signed array, eliminating the expense of copying an entire unmanaged array (using ) to a separate managed array before setting its element values. - - Writing to unaligned memory locations is supported. - - ]]> - + To be added. Base address () plus offset byte () produces a null or invalid address. is an object. This method does not accept parameters. @@ -11126,16 +11054,7 @@ public static void ThrowExceptionForHR(interrorCode,IntPtrerrorInfo) An additional byte offset, which is added to the parameter before writing. The value to write. Writes a 16-bit signed integer value to unmanaged memory at a specified offset. - - enables direct interaction with an unmanaged 16-bit signed array, eliminating the expense of copying an entire unmanaged array (using ) to a separate managed array before setting its element values. - - Writing to unaligned memory locations is supported. - - ]]> - + To be added. Base address () plus offset byte () produces a null or invalid address. is an object. This method does not accept parameters. @@ -11382,16 +11301,7 @@ public static void ThrowExceptionForHR(interrorCode,IntPtrerrorInfo) An additional byte offset, which is added to the parameter before writing. The value to write. Writes a 32-bit signed integer value to unmanaged memory at a specified offset. - - enables direct interaction with an unmanaged 32-bit signed array, eliminating the expense of copying an entire unmanaged array (using ) to a separate managed array before setting its element values. - - Writing to unaligned memory locations is supported. - - ]]> - + To be added. Base address () plus offset byte () produces a null or invalid address. is an object. This method does not accept parameters. @@ -11638,16 +11548,7 @@ public static void ThrowExceptionForHR(interrorCode,IntPtrerrorInfo) An additional byte offset, which is added to the parameter before writing. The value to write. Writes a 64-bit signed integer value to unmanaged memory at a specified offset. - - enables direct interaction with an unmanaged 64-bit signed array, eliminating the expense of copying an entire unmanaged array (using ) to a separate managed array before setting its element values. - - Writing to unaligned memory locations is supported. - - ]]> - + To be added. Base address () plus offset byte () produces a null or invalid address. is an object. This method does not accept parameters. @@ -11896,16 +11797,7 @@ public static void ThrowExceptionForHR(interrorCode,IntPtrerrorInfo) An additional byte offset, which is added to the parameter before writing. The value to write. Writes a processor native-sized integer value to unmanaged memory. - - enables direct interaction with an unmanaged C-style byte array, eliminating the expense of copying an entire unmanaged array (using ) to a separate managed array before setting its element values. - - Writing to unaligned memory locations is supported. - - ]]> - + To be added. Base address () plus offset byte () produces a null or invalid address. is an object. This method does not accept parameters. diff --git a/xml/System.Runtime.InteropServices/MarshalDirectiveException.xml b/xml/System.Runtime.InteropServices/MarshalDirectiveException.xml index 6719ab26e9c..c9e83b12afb 100644 --- a/xml/System.Runtime.InteropServices/MarshalDirectiveException.xml +++ b/xml/System.Runtime.InteropServices/MarshalDirectiveException.xml @@ -248,14 +248,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class from serialization data. - - - + To be added. is . diff --git a/xml/System.Runtime.InteropServices/SEHException.xml b/xml/System.Runtime.InteropServices/SEHException.xml index b772da14190..19007d01615 100644 --- a/xml/System.Runtime.InteropServices/SEHException.xml +++ b/xml/System.Runtime.InteropServices/SEHException.xml @@ -285,16 +285,7 @@ catch(…) The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class from serialization data. - - namespace. - - inherits from . - - ]]> - + To be added. is . diff --git a/xml/System.Runtime.InteropServices/SafeArrayRankMismatchException.xml b/xml/System.Runtime.InteropServices/SafeArrayRankMismatchException.xml index 1c7caae9bc8..99cad21c708 100644 --- a/xml/System.Runtime.InteropServices/SafeArrayRankMismatchException.xml +++ b/xml/System.Runtime.InteropServices/SafeArrayRankMismatchException.xml @@ -250,16 +250,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class from serialization data. - - . - - `SafeArrayRankMismatchException` inherits from . - - ]]> - + To be added. is . diff --git a/xml/System.Runtime.InteropServices/SafeArrayTypeMismatchException.xml b/xml/System.Runtime.InteropServices/SafeArrayTypeMismatchException.xml index 22c09165103..63d6b6a74ac 100644 --- a/xml/System.Runtime.InteropServices/SafeArrayTypeMismatchException.xml +++ b/xml/System.Runtime.InteropServices/SafeArrayTypeMismatchException.xml @@ -248,16 +248,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class from serialization data. - - . - - `SafeArrayTypeMismatchException` inherits from . - - ]]> - + To be added. is . diff --git a/xml/System.Runtime.Serialization.Formatters.Binary/BinaryFormatter.xml b/xml/System.Runtime.Serialization.Formatters.Binary/BinaryFormatter.xml index 6d7c7e3bfbb..4d61ebace2b 100644 --- a/xml/System.Runtime.Serialization.Formatters.Binary/BinaryFormatter.xml +++ b/xml/System.Runtime.Serialization.Formatters.Binary/BinaryFormatter.xml @@ -223,7 +223,6 @@ Initializes a new `BinaryFormatter` for serialization or deserialization of obje ]]> - @@ -627,7 +626,6 @@ The surrogate selector is used by to generate - @@ -675,7 +673,6 @@ The surrogate selector is used by to generate - diff --git a/xml/System.Runtime.Serialization.Formatters/FormatterTypeStyle.xml b/xml/System.Runtime.Serialization.Formatters/FormatterTypeStyle.xml index f3f10f2fed5..78c34dcbdb0 100644 --- a/xml/System.Runtime.Serialization.Formatters/FormatterTypeStyle.xml +++ b/xml/System.Runtime.Serialization.Formatters/FormatterTypeStyle.xml @@ -49,15 +49,7 @@ Indicates the format in which type descriptions are laid out in the serialized stream. - - - + To be added. diff --git a/xml/System.Runtime.Serialization.Formatters/TypeFilterLevel.xml b/xml/System.Runtime.Serialization.Formatters/TypeFilterLevel.xml index 42d399afee8..dc0d0b805a2 100644 --- a/xml/System.Runtime.Serialization.Formatters/TypeFilterLevel.xml +++ b/xml/System.Runtime.Serialization.Formatters/TypeFilterLevel.xml @@ -49,15 +49,7 @@ Specifies the level of automatic deserialization for .NET remoting. - - - + To be added. diff --git a/xml/System.Runtime.Serialization/Formatter.xml b/xml/System.Runtime.Serialization/Formatter.xml index aa83c67f61a..c1154c7c7af 100644 --- a/xml/System.Runtime.Serialization/Formatter.xml +++ b/xml/System.Runtime.Serialization/Formatter.xml @@ -62,63 +62,7 @@ Provides base functionality for the common language runtime serialization formatters. - - is the `abstract` base class for all runtime serialization formatters, and provides some helper methods for implementing the interface. The also manages queuing objects for serialization and generating IDs on a per-object basis. - - ]]> - - - When you inherit from , you must override the following members: - -- - -- - -- - -- - -- - -- - -- - -- - -- - -- - -- - -- - -- - -- - -- - -- - -- - -- - -- - -- - -- - -- - -- - + To be added. XML and SOAP Serialization @@ -165,7 +109,6 @@ ]]> - @@ -224,9 +167,6 @@ ]]> - - You must implement this property in a derived class. - @@ -278,9 +218,6 @@ ]]> - - You must implement this property in a derived class. - @@ -347,9 +284,6 @@ When overridden in a derived class, deserializes the stream attached to the formatter when it was created, creating a graph of objects identical to the graph originally serialized into that stream. The top object of the deserialized graph of objects. To be added. - - You must implement this method in a derived class. - XML and SOAP Serialization @@ -405,7 +339,6 @@ ]]> The next object retrieved from the work queue did not have an assigned ID. - @@ -562,7 +495,6 @@ ]]> - @@ -626,9 +558,6 @@ The object at the root of the graph to serialize. When overridden in a derived class, serializes the graph of objects with the specified root to the stream already attached to the formatter. To be added. - - You must implement this method in a derived class. - XML and SOAP Serialization @@ -690,9 +619,6 @@ ]]> - - You must implement this property in a derived class. - @@ -741,9 +667,6 @@ The type of elements that the array holds. When overridden in a derived class, writes an array to the stream already attached to the formatter. To be added. - - You must implement this method in a derived class. - @@ -790,9 +713,6 @@ The name of the member. When overridden in a derived class, writes a Boolean value to the stream already attached to the formatter. To be added. - - You must implement this method in a derived class. - @@ -839,9 +759,6 @@ The name of the member. When overridden in a derived class, writes an 8-bit unsigned integer to the stream already attached to the formatter. To be added. - - You must implement this method in a derived class. - @@ -888,9 +805,6 @@ The name of the member. When overridden in a derived class, writes a Unicode character to the stream already attached to the formatter. To be added. - - You must implement this method in a derived class. - @@ -937,9 +851,6 @@ The name of the member. When overridden in a derived class, writes a value to the stream already attached to the formatter. To be added. - - You must implement this method in a derived class. - @@ -987,9 +898,6 @@ The name of the member. When overridden in a derived class, writes a value to the stream already attached to the formatter. To be added. - - You must implement this method in a derived class. - @@ -1037,9 +945,6 @@ The name of the member. When overridden in a derived class, writes a double-precision floating-point number to the stream already attached to the formatter. To be added. - - You must implement this method in a derived class. - @@ -1086,9 +991,6 @@ The name of the member. When overridden in a derived class, writes a 16-bit signed integer to the stream already attached to the formatter. To be added. - - You must implement this method in a derived class. - @@ -1135,9 +1037,6 @@ The name of the member. When overridden in a derived class, writes a 32-bit signed integer to the stream. To be added. - - You must implement this method in a derived class. - @@ -1184,9 +1083,6 @@ The name of the member. When overridden in a derived class, writes a 64-bit signed integer to the stream. To be added. - - You must implement this method in a derived class. - @@ -1311,9 +1207,6 @@ ]]> - - You must implement this method in a derived class. - @@ -1366,9 +1259,6 @@ The name of the member. When overridden in a derived class, writes an 8-bit signed integer to the stream already attached to the formatter. To be added. - - You must implement this method in a derived class. - @@ -1415,9 +1305,6 @@ The name of the member. When overridden in a derived class, writes a single-precision floating-point number to the stream already attached to the formatter. To be added. - - You must implement this method in a derived class. - @@ -1464,9 +1351,6 @@ The name of the member. When overridden in a derived class, writes a value to the stream already attached to the formatter. To be added. - - You must implement this method in a derived class. - @@ -1520,9 +1404,6 @@ The name of the member. When overridden in a derived class, writes a 16-bit unsigned integer to the stream already attached to the formatter. To be added. - - You must implement this method in a derived class. - @@ -1575,9 +1456,6 @@ The name of the member. When overridden in a derived class, writes a 32-bit unsigned integer to the stream already attached to the formatter. To be added. - - You must implement this method in a derived class. - @@ -1630,9 +1508,6 @@ The name of the member. When overridden in a derived class, writes a 64-bit unsigned integer to the stream already attached to the formatter. To be added. - - You must implement this method in a derived class. - @@ -1681,9 +1556,6 @@ The of the value type. When overridden in a derived class, writes a value of the given type to the stream already attached to the formatter. To be added. - - You must implement this method in a derived class. - diff --git a/xml/System.Runtime.Serialization/FormatterServices.xml b/xml/System.Runtime.Serialization/FormatterServices.xml index 173e2347805..c1beade8ca0 100644 --- a/xml/System.Runtime.Serialization/FormatterServices.xml +++ b/xml/System.Runtime.Serialization/FormatterServices.xml @@ -55,7 +55,6 @@ Provides static methods to aid with the implementation of a for serialization. This class cannot be inherited. To be added. - XML and SOAP Serialization diff --git a/xml/System.Runtime.Serialization/IFormatter.xml b/xml/System.Runtime.Serialization/IFormatter.xml index b7378e4b341..a5b4102e62a 100644 --- a/xml/System.Runtime.Serialization/IFormatter.xml +++ b/xml/System.Runtime.Serialization/IFormatter.xml @@ -48,19 +48,7 @@ Provides functionality for formatting serialized objects. - - architecture. - - Objects controlling their own serialization can do so by implementing the interface. In order for an object to be serialized, you must mark that object as being serializable. You can do this by applying the serializable attribute to a class. If any object in the graph is not serializable, serialization will fail. - - ]]> - - - All formatters must implement this interface. Use to serialize an object or graph of objects. Use to deserialize a stream and create a clone of the original object or graph of objects. - + To be added. XML and SOAP Serialization diff --git a/xml/System.Runtime.Serialization/IObjectReference.xml b/xml/System.Runtime.Serialization/IObjectReference.xml index 3bcbc525c2e..e8f1a8bc33f 100644 --- a/xml/System.Runtime.Serialization/IObjectReference.xml +++ b/xml/System.Runtime.Serialization/IObjectReference.xml @@ -50,9 +50,6 @@ Indicates that the current interface implementer is a reference to another object. To be added. - - Implement this interface on objects that are references to a different object, which cannot be resolved until the current object is completely restored. During the fixup stage, any object implementing is queried for its real object and that object is inserted into the graph. Fixup refers to the process of finalizing references not already completed during the object deserialization process. - diff --git a/xml/System.Runtime.Serialization/ISafeSerializationData.xml b/xml/System.Runtime.Serialization/ISafeSerializationData.xml index 16cca7777d3..b9241dcfc73 100644 --- a/xml/System.Runtime.Serialization/ISafeSerializationData.xml +++ b/xml/System.Runtime.Serialization/ISafeSerializationData.xml @@ -48,7 +48,6 @@ Enables serialization of custom exception data in security-transparent code. To be added. - diff --git a/xml/System.Runtime.Serialization/ISerializable.xml b/xml/System.Runtime.Serialization/ISerializable.xml index 9406c2dc703..f0612d7c013 100644 --- a/xml/System.Runtime.Serialization/ISerializable.xml +++ b/xml/System.Runtime.Serialization/ISerializable.xml @@ -146,17 +146,7 @@ The to populate with data. The destination (see ) for this serialization. Populates a with the data needed to serialize the target object. - - are automatically tracked and serialized by the formatter. - -> [!NOTE] -> It's not guaranteed that this method will be called only once per object instance during serialization. Therefore, the method should be implemented in such a way that its behavior will be the same regardless of the number of times it is called. - - ]]> - + To be added. The caller does not have the required permission. diff --git a/xml/System.Runtime.Serialization/ISurrogateSelector.xml b/xml/System.Runtime.Serialization/ISurrogateSelector.xml index 0ab5596fc89..7cae146593c 100644 --- a/xml/System.Runtime.Serialization/ISurrogateSelector.xml +++ b/xml/System.Runtime.Serialization/ISurrogateSelector.xml @@ -48,14 +48,7 @@ Indicates a serialization surrogate selector class. - - interface to assist formatters in selecting surrogates to delegate to the serialization or deserialization of other objects. - - ]]> - + To be added. diff --git a/xml/System.Runtime.Serialization/InvalidDataContractException.xml b/xml/System.Runtime.Serialization/InvalidDataContractException.xml index 6f6f8bdbafa..4d9b84d2871 100644 --- a/xml/System.Runtime.Serialization/InvalidDataContractException.xml +++ b/xml/System.Runtime.Serialization/InvalidDataContractException.xml @@ -236,14 +236,7 @@ A that contains data needed to serialize and deserialize an object. A that specifies user context during serialization and deserialization. Initializes a new instance of the class with the specified and . - - namespace. - - ]]> - + To be added. diff --git a/xml/System.Runtime.Serialization/ObjectIDGenerator.xml b/xml/System.Runtime.Serialization/ObjectIDGenerator.xml index 9bc9c7c6a17..5bcbfd438b1 100644 --- a/xml/System.Runtime.Serialization/ObjectIDGenerator.xml +++ b/xml/System.Runtime.Serialization/ObjectIDGenerator.xml @@ -54,21 +54,7 @@ Generates IDs for objects. - - keeps track of previously identified objects. When you ask for the ID of an object, the knows whether to return the existing ID, or generate and remember a new ID. - - The IDs are unique for the life of the instance. Generally, a life lasts as long as the that created it. Object IDs have meaning only within a given serialized stream, and are used for tracking which objects have references to others within the serialized object graph. - - Using a hash table, the retains which ID is assigned to which object. The object references, which uniquely identify each object, are addresses in the runtime garbage-collected heap. Object reference values can change during serialization, but the table is updated automatically so the information is correct. - - Object IDs are 64-bit numbers. Allocation starts from one, so zero is never a valid object ID. A formatter can choose a zero value to represent an object reference whose value is `null`. - - ]]> - - + To be added. XML and SOAP Serialization diff --git a/xml/System.Runtime.Serialization/ObjectManager.xml b/xml/System.Runtime.Serialization/ObjectManager.xml index 568eb127dd4..1df95f9c270 100644 --- a/xml/System.Runtime.Serialization/ObjectManager.xml +++ b/xml/System.Runtime.Serialization/ObjectManager.xml @@ -54,23 +54,7 @@ Keeps track of objects as they are deserialized. - - queries the to determine whether a reference to an object in the serialized stream refers to an object that has already been deserialized (a backward reference), or to an object that has not yet been deserialized (a forward reference). If the reference in the serialized stream is a forward reference, then the can register a fixup with the . If the reference in the serialized stream is a backward reference, the immediately completes the reference. Fixup refers to the process of finalizing object references not already completed during the object deserialization process. After the required object has been deserialized, the will complete the reference. - - The follows a set of rules that dictate the fixup order. All objects that implement or have a can expect to have all the objects that they transmitted through available when the object tree is deserialized. However, a parent object cannot presume that all its child objects will be fully completed when it is fully deserialized. All child objects will be present but not all the grandchild objects will necessarily be present. If an object needs to take certain actions that depend on executing code on its child objects, it can delay these actions, implement the interface, and execute the code only when it is called back on this interface. - - - -## Examples - The following code example shows how to use the class to walk through an object graph, traversing to each object only once. - - :::code language="csharp" source="~/snippets/csharp/System.Runtime.Serialization/ObjectManager/ObjectManager.cs" id="Snippet1"::: - - ]]> - + To be added. diff --git a/xml/System.Runtime.Serialization/SafeSerializationEventArgs.xml b/xml/System.Runtime.Serialization/SafeSerializationEventArgs.xml index f89a992906c..035a781c383 100644 --- a/xml/System.Runtime.Serialization/SafeSerializationEventArgs.xml +++ b/xml/System.Runtime.Serialization/SafeSerializationEventArgs.xml @@ -49,16 +49,7 @@ Provides data for the event. - - class. - - ]]> - + To be added. diff --git a/xml/System.Runtime.Serialization/SerializationException.xml b/xml/System.Runtime.Serialization/SerializationException.xml index bcfe80d5abb..14ab8a07836 100644 --- a/xml/System.Runtime.Serialization/SerializationException.xml +++ b/xml/System.Runtime.Serialization/SerializationException.xml @@ -266,14 +266,7 @@ The serialization information object holding the serialized object data in the name-value form. The contextual information about the source or destination of the exception. Initializes a new instance of the class from serialized data. - - - + To be added. The parameter is . diff --git a/xml/System.Runtime.Serialization/SerializationInfo.xml b/xml/System.Runtime.Serialization/SerializationInfo.xml index be6f1d44c6c..80c60b3750f 100644 --- a/xml/System.Runtime.Serialization/SerializationInfo.xml +++ b/xml/System.Runtime.Serialization/SerializationInfo.xml @@ -150,14 +150,7 @@ The of the object to serialize. The used during deserialization. Creates a new instance of the class. - - passed as the `converter` parameter converts data from its internal representation to the form the user requested. The internal representation of the data within the depends on the formatter that created it. - - ]]> - + To be added. or is . diff --git a/xml/System.Runtime.Serialization/SerializationObjectManager.xml b/xml/System.Runtime.Serialization/SerializationObjectManager.xml index 7999bf00cd0..80a6abf5afd 100644 --- a/xml/System.Runtime.Serialization/SerializationObjectManager.xml +++ b/xml/System.Runtime.Serialization/SerializationObjectManager.xml @@ -49,15 +49,7 @@ Manages serialization processes at run time. This class cannot be inherited. - - . The main difference is that the performs its tasks during serialization while the performs its tasks during deserialization. - - ]]> - - + To be added. diff --git a/xml/System.Runtime.Serialization/StreamingContext.xml b/xml/System.Runtime.Serialization/StreamingContext.xml index 3a10ff7a01c..05f406ba1d0 100644 --- a/xml/System.Runtime.Serialization/StreamingContext.xml +++ b/xml/System.Runtime.Serialization/StreamingContext.xml @@ -79,7 +79,6 @@ ]]> - XML and SOAP Serialization @@ -411,14 +410,7 @@ Gets the source or destination of the transmitted data. During serialization, the destination of the transmitted data. During deserialization, the source of the data. - - is . During deserialization, the state indicates the source of the deserialized stream. - - ]]> - + To be added. diff --git a/xml/System.Runtime.Serialization/SurrogateSelector.xml b/xml/System.Runtime.Serialization/SurrogateSelector.xml index 90736c3de61..ab39e917887 100644 --- a/xml/System.Runtime.Serialization/SurrogateSelector.xml +++ b/xml/System.Runtime.Serialization/SurrogateSelector.xml @@ -58,14 +58,7 @@ Assists formatters in selection of the serialization surrogate to delegate the serialization or deserialization process to. - - - + To be added. diff --git a/xml/System.Runtime/ControlledExecution.xml b/xml/System.Runtime/ControlledExecution.xml index 2816417a63c..0b4fedf719f 100644 --- a/xml/System.Runtime/ControlledExecution.xml +++ b/xml/System.Runtime/ControlledExecution.xml @@ -55,11 +55,7 @@ The delegate that represents the code to execute. The cancellation token that can be used to abort execution. Runs code that can be aborted asynchronously. - - This method enables aborting arbitrary managed code in a non-cooperative manner by throwing an exception in the thread executing that code. While the exception may be caught by the code, it is re-thrown at the end of blocks until the execution flow returns to the ControlledExecution.Run method. - Execution of the code is not guaranteed to abort immediately, or at all. This situation can occur, for example, if a thread is stuck executing unmanaged code or the and blocks that are called as part of the abort procedure, thereby indefinitely delaying the abort. Furthermore, execution may not be aborted immediately if the thread is currently executing a or block. - Aborting code at an unexpected location may corrupt the state of data structures in the process and lead to unpredictable results. For that reason, this method should not be used in production code and calling it produces a compile-time warning. - + To be added. The method is not supported on this platform. The argument is . The current thread is already running the method. diff --git a/xml/System.Security.Authentication.ExtendedProtection/ExtendedProtectionPolicy.xml b/xml/System.Security.Authentication.ExtendedProtection/ExtendedProtectionPolicy.xml index be527d7a8e9..60539382764 100644 --- a/xml/System.Security.Authentication.ExtendedProtection/ExtendedProtectionPolicy.xml +++ b/xml/System.Security.Authentication.ExtendedProtection/ExtendedProtectionPolicy.xml @@ -180,16 +180,7 @@ A instance that contains the information that is required to serialize the new instance. A that contains the source of the serialized stream that is associated with the new instance. Initializes a new instance of the class from a object that contains the required data to populate the . - - interface for the class. - - The method can be used to serialize an object. This serialized object can then be used with to construct a new object. - - ]]> - + To be added. Integrated Windows Authentication with Extended Protection diff --git a/xml/System.Security.Cryptography.X509Certificates/PublicKey.xml b/xml/System.Security.Cryptography.X509Certificates/PublicKey.xml index 109582e5fdc..f1d4fc698aa 100644 --- a/xml/System.Security.Cryptography.X509Certificates/PublicKey.xml +++ b/xml/System.Security.Cryptography.X509Certificates/PublicKey.xml @@ -907,22 +907,7 @@ Gets an derived object or a derived object representing the public key. An object representing the public key. - - and keys are supported. Call this property to obtain a certificate's public key. Repeated calls to this property will return the same key. - - - -## Examples - The following code example opens the current user certificate store, selects only active certificates, and then allows the user to select one or more certificates. The example then writes certificate information to the console. - - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography.X509Certificates/PublicKey/Key/certselect.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security.Cryptography.X509Certificates/PublicKey/Key/certselect.vb" id="Snippet1"::: - - ]]> - + To be added. The key algorithm is not supported. diff --git a/xml/System.Security.Cryptography.X509Certificates/X509Certificate.xml b/xml/System.Security.Cryptography.X509Certificates/X509Certificate.xml index 4f58648156e..3953f55b9e6 100644 --- a/xml/System.Security.Cryptography.X509Certificates/X509Certificate.xml +++ b/xml/System.Security.Cryptography.X509Certificates/X509Certificate.xml @@ -163,14 +163,7 @@ Initializes a new instance of the class. - - - + To be added. diff --git a/xml/System.Security.Cryptography.X509Certificates/X509Certificate2.xml b/xml/System.Security.Cryptography.X509Certificates/X509Certificate2.xml index 489a6a2e833..2be69ac50c8 100644 --- a/xml/System.Security.Cryptography.X509Certificates/X509Certificate2.xml +++ b/xml/System.Security.Cryptography.X509Certificates/X509Certificate2.xml @@ -149,22 +149,7 @@ Initializes a new instance of the class. - - object, unlike the other constructors for this class that use certificate information from a byte array, a pointer, or a certificate file. - - - -## Examples - The following code example opens the current user certificate store, selects only active certificates, then allows the user to select one or more certificates. The example then writes certificate information to the console. - - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography.X509Certificates/PublicKey/Key/certselect.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security.Cryptography.X509Certificates/PublicKey/Key/certselect.vb" id="Snippet1"::: - - ]]> - + To be added. @@ -2981,16 +2966,7 @@ The certificate is encoded according to the IETF RFC 7468 "strict" A byte array containing data from an X.509 certificate. Populates an object with data from a byte array. - - object with its associated values. - - Since this method accepts only a byte array, it can be used only for certificate types that do not require a password, including a PEM-encoded or DER-encoded X.509 certificate or a PFX/PKCS12 certificate. Note that a PFX/PKCS12 certificate can contain more than one certificate. In that case, the first certificate associated with a private key is used or, if no private key is found, the first certificate is used. - - ]]> - + To be added. @@ -3047,16 +3023,7 @@ The certificate is encoded according to the IETF RFC 7468 "strict" The name of a certificate. Populates an object with information from a certificate file. - - object with the certificate the file contains. - - This method can be used with several certificate types, including PEM-encoded or DER-encoded X.509 certificates, PFX/PKCS12 certificates, and signer certificates such as Authenticode. Note that a PFX/PKCS12 certificate can contain more than one certificate. In that case, the first certificate associated with a private key is used or, if no private key is found, the first certificate is used. - - ]]> - + To be added. @@ -3129,17 +3096,7 @@ The certificate is encoded according to the IETF RFC 7468 "strict" The password required to access the X.509 certificate data. A bitwise combination of the enumeration values that control where and how to import the certificate. Populates an object using data from a byte array, a password, and a key storage flag. - - [!IMPORTANT] -> Never hard code a password within your source code. Hard-coded passwords can be retrieved from an assembly using the [Ildasm.exe (IL Disassembler)](/dotnet/framework/tools/ildasm-exe-il-disassembler), a hex editor, or by simply opening up the assembly in a text editor such as Notepad.exe. - - ]]> - + To be added. @@ -3208,27 +3165,7 @@ The certificate is encoded according to the IETF RFC 7468 "strict" The password required to access the X.509 certificate data. A bitwise combination of the enumeration values that control where and how to import the certificate. Populates an object using data from a byte array, a password, and flags for determining how to import the private key. - - object using a password for the certificate represented by the byte array. The value can be used to control where and how to import the private key. - - This method accepts a byte array and can be used for certificate types such as PEM-encoded or DER-encoded X.509 certificates or PFX/PKCS12 certificates. Note that a PFX/PKCS12 certificate can contain more than one certificate. In that case, the first certificate associated with a private key is used or, if no private key is found, the first certificate is used. - -> [!IMPORTANT] -> Never hard code a password within your source code. Hard-coded passwords can be retrieved from an assembly using the [Ildasm.exe (IL Disassembler)](/dotnet/framework/tools/ildasm-exe-il-disassembler), a hex editor, or by simply opening up the assembly in a text editor such as Notepad.exe. - - - -## Examples - The following code example creates a command-line executable that takes a certificate file as an argument and prints various certificate properties to the console. - - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography.X509Certificates/PublicKey/Overview/certinfo.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security.Cryptography.X509Certificates/PublicKey/Overview/certinfo.vb" id="Snippet1"::: - - ]]> - + To be added. @@ -3301,14 +3238,7 @@ The certificate is encoded according to the IETF RFC 7468 "strict" The password required to access the X.509 certificate data. A bitwise combination of the enumeration values that control where and how to import the certificate. Populates an object with information from a certificate file, a password, and a key storage flag. - - - + To be added. @@ -3377,17 +3307,7 @@ The certificate is encoded according to the IETF RFC 7468 "strict" The password required to access the X.509 certificate data. A bitwise combination of the enumeration values that control where and how to import the certificate. Populates an object with information from a certificate file, a password, and a value. - - object with information from a certificate file, a password, and an value. - -> [!IMPORTANT] -> Never hard code a password within your source code. Hard-coded passwords can be retrieved from an assembly using the [Ildasm.exe (IL Disassembler)](/dotnet/framework/tools/ildasm-exe-il-disassembler), a hex editor, or by simply opening up the assembly in a text editor such as Notepad.exe. - - ]]> - + To be added. @@ -4420,9 +4340,7 @@ Unlike object. - Note that the default chaining engine can be overridden using the class. On Microsoft Windows Server 2003, the default engine conforms to the specification described in RFC3280, "[Certificate and Certificate Revocation List (CRL) Profile](https://www.ietf.org/rfc/)." - - +The default chaining engine can be overridden using the class. ## Examples The following code example opens the current user certificate store, selects only active certificates, then allows the user to select one or more certificates. The example then writes certificate information to the console. diff --git a/xml/System.Security.Cryptography.X509Certificates/X509ChainElement.xml b/xml/System.Security.Cryptography.X509Certificates/X509ChainElement.xml index 3474980dc32..5727aa417e7 100644 --- a/xml/System.Security.Cryptography.X509Certificates/X509ChainElement.xml +++ b/xml/System.Security.Cryptography.X509Certificates/X509ChainElement.xml @@ -231,16 +231,12 @@ diff --git a/xml/System.Security.Cryptography/Aes.xml b/xml/System.Security.Cryptography/Aes.xml index 1df61eabf70..07fa4e35247 100644 --- a/xml/System.Security.Cryptography/Aes.xml +++ b/xml/System.Security.Cryptography/Aes.xml @@ -272,14 +272,7 @@ The name of the specific implementation of AES to use. Creates a cryptographic object that specifies the implementation of AES to use to perform the symmetric algorithm. A cryptographic object that is used to perform the symmetric algorithm. - - - + To be added. The parameter is . diff --git a/xml/System.Security.Cryptography/AesCryptoServiceProvider.xml b/xml/System.Security.Cryptography/AesCryptoServiceProvider.xml index 835c423fb0c..b7e7cd4c230 100644 --- a/xml/System.Security.Cryptography/AesCryptoServiceProvider.xml +++ b/xml/System.Security.Cryptography/AesCryptoServiceProvider.xml @@ -67,18 +67,7 @@ Performs symmetric encryption and decryption using the Cryptographic Application Programming Interfaces (CAPI) implementation of the Advanced Encryption Standard (AES) algorithm. - - class. - - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/AesCryptoServiceProvider/Overview/program.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security.Cryptography/AesCryptoServiceProvider/Overview/program.vb" id="Snippet1"::: - :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR/aescryptoservprovider/fs/program.fs" id="Snippet1"::: - - ]]> - + To be added. diff --git a/xml/System.Security.Cryptography/AesManaged.xml b/xml/System.Security.Cryptography/AesManaged.xml index 8359c70df16..baead744eac 100644 --- a/xml/System.Security.Cryptography/AesManaged.xml +++ b/xml/System.Security.Cryptography/AesManaged.xml @@ -70,27 +70,7 @@ Provides a managed implementation of the Advanced Encryption Standard (AES) symmetric algorithm. - - class but limits blocks to 128 bits and does not allow feedback modes. - -> [!NOTE] -> If the Windows security policy setting for Federal Information Processing Standards (FIPS)-compliant algorithms is enabled, using this algorithm throws a . - -> [!NOTE] -> Microsoft believes that it's no longer safe to decrypt data encrypted with the Cipher-Block-Chaining (CBC) mode of symmetric encryption (which is the default value of the property) when verifiable padding has been applied without first ensuring the integrity of the ciphertext, except for very specific circumstances. For more information, see [Timing vulnerabilities with CBC-mode symmetric decryption using padding](/dotnet/standard/security/vulnerabilities-cbc-mode). - -## Examples - The following example demonstrates how to encrypt and decrypt sample data using the class. - - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/AesManaged/Overview/program.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security.Cryptography/AesManaged/Overview/program.vb" id="Snippet1"::: - :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR/aesmanaged/fs/program.fs" id="Snippet1"::: - - ]]> - + To be added. diff --git a/xml/System.Security.Cryptography/AsymmetricAlgorithm.xml b/xml/System.Security.Cryptography/AsymmetricAlgorithm.xml index 18916b0a40c..51c0576d10d 100644 --- a/xml/System.Security.Cryptography/AsymmetricAlgorithm.xml +++ b/xml/System.Security.Cryptography/AsymmetricAlgorithm.xml @@ -373,17 +373,7 @@ Creates an instance of the specified implementation of an asymmetric algorithm. A new instance of the specified asymmetric algorithm implementation. - - method in an extended class. This code example is part of a larger example provided for the class. - - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/AsymmetricAlgorithm/Overview/customcrypto.cs" id="Snippet12"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security.Cryptography/AsymmetricAlgorithm/Overview/customcrypto.vb" id="Snippet12"::: - - ]]> - + To be added. Cryptographic Services diff --git a/xml/System.Security.Cryptography/CryptoConfig.xml b/xml/System.Security.Cryptography/CryptoConfig.xml index ccbe12013d1..39f98698581 100644 --- a/xml/System.Security.Cryptography/CryptoConfig.xml +++ b/xml/System.Security.Cryptography/CryptoConfig.xml @@ -578,17 +578,7 @@ The OID to encode. Encodes the specified object identifier (OID). A byte array containing the encoded OID. - - method to encode the specified object identifier. This code example is part of a larger example provided for the class. - - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/CryptoConfig/Overview/members.cs" id="Snippet6"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security.Cryptography/CryptoConfig/Overview/members.vb" id="Snippet6"::: - - ]]> - + To be added. The parameter is . An error occurred while encoding the OID. Cryptographic Services diff --git a/xml/System.Security.Cryptography/CryptographicException.xml b/xml/System.Security.Cryptography/CryptographicException.xml index 6ee7117ed2f..19e85b8481b 100644 --- a/xml/System.Security.Cryptography/CryptographicException.xml +++ b/xml/System.Security.Cryptography/CryptographicException.xml @@ -354,14 +354,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. diff --git a/xml/System.Security.Cryptography/CryptographicUnexpectedOperationException.xml b/xml/System.Security.Cryptography/CryptographicUnexpectedOperationException.xml index a9ea87314a7..0914047b89d 100644 --- a/xml/System.Security.Cryptography/CryptographicUnexpectedOperationException.xml +++ b/xml/System.Security.Cryptography/CryptographicUnexpectedOperationException.xml @@ -273,14 +273,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. diff --git a/xml/System.Security.Cryptography/DESCryptoServiceProvider.xml b/xml/System.Security.Cryptography/DESCryptoServiceProvider.xml index 122b6a24dc1..b6367345113 100644 --- a/xml/System.Security.Cryptography/DESCryptoServiceProvider.xml +++ b/xml/System.Security.Cryptography/DESCryptoServiceProvider.xml @@ -68,25 +68,7 @@ Defines a wrapper object to access the cryptographic service provider (CSP) version of the Data Encryption Standard () algorithm. This class cannot be inherited. - - [!IMPORTANT] -> A newer symmetric encryption algorithm, Advanced Encryption Standard (AES), is available. Consider using the class instead of the class. Use only for compatibility with legacy applications and data. - -## Examples - The following code example uses (an implementation of ) with the specified key () and initialization vector () to encrypt a file specified by `inName`. It then outputs the encrypted result to the file specified by `outName`. - - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/DESCryptoServiceProvider/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security.Cryptography/DESCryptoServiceProvider/Overview/source.vb" id="Snippet1"::: - - Decryption can be handled in the same way; use instead of . The same key () and initialization vector () used to encrypt the file must be used to decrypt it. - - ]]> - + To be added. Cryptographic Services diff --git a/xml/System.Security.Cryptography/DSA.xml b/xml/System.Security.Cryptography/DSA.xml index 279d8847fb5..a230d943c10 100644 --- a/xml/System.Security.Cryptography/DSA.xml +++ b/xml/System.Security.Cryptography/DSA.xml @@ -374,14 +374,7 @@ The name of the specific implementation of to use. Creates the specified cryptographic object used to perform the asymmetric algorithm. A cryptographic object used to perform the asymmetric algorithm. - - , use the name System.Security.Cryptography.DSA. - - ]]> - + To be added. Cryptographic Services diff --git a/xml/System.Security.Cryptography/ECDiffieHellman.xml b/xml/System.Security.Cryptography/ECDiffieHellman.xml index a696331dd6e..2cbc51dcc6c 100644 --- a/xml/System.Security.Cryptography/ECDiffieHellman.xml +++ b/xml/System.Security.Cryptography/ECDiffieHellman.xml @@ -359,23 +359,7 @@ The name of an implementation of the ECDH algorithm. Creates a new instance of the specified implementation of the Elliptic Curve Diffie-Hellman (ECDH) algorithm. A new instance of the specified implementation of this class. If the specified algorithm name does not map to an ECDH implementation, this method returns . - - object, you can use the method overload to create a custom `algorithm` string that specifies your implementation. - - The `algorithm` parameter specifies the name of an implementation of the ECDH algorithm. The following strings all refer to the same implementation, which is the only implementation currently supported in .NET: - -- "ECDH" -- "ECDiffieHellman" -- "ECDiffieHellmanCng" -- "System.Security.Cryptography.ECDiffieHellmanCng" - - You can also provide the name of a custom ECDH implementation for the `algorithm` parameter. If you do that, the object will use it to determine whether an ECDH object can be created. - - ]]> - + To be added. The parameter is . diff --git a/xml/System.Security.Cryptography/ECDiffieHellmanPublicKey.xml b/xml/System.Security.Cryptography/ECDiffieHellmanPublicKey.xml index 622ec47f61d..610924559b5 100644 --- a/xml/System.Security.Cryptography/ECDiffieHellmanPublicKey.xml +++ b/xml/System.Security.Cryptography/ECDiffieHellmanPublicKey.xml @@ -148,14 +148,7 @@ A byte array that represents an object. Initializes a new instance of the class. - - class. The class is the only currently supported implementation. - - ]]> - + To be added. is . diff --git a/xml/System.Security.Cryptography/ECDsa.xml b/xml/System.Security.Cryptography/ECDsa.xml index e054fa7658b..243b5397472 100644 --- a/xml/System.Security.Cryptography/ECDsa.xml +++ b/xml/System.Security.Cryptography/ECDsa.xml @@ -369,16 +369,7 @@ You can also provide the name of a custom ECDSA implementation. Creates a new instance of the specified implementation of the Elliptic Curve Digital Signature Algorithm (ECDSA). A new instance of the specified implementation of this class. If the specified algorithm name does not map to an ECDSA implementation, this method returns . - - object, you can use the method overload to create a custom `algorithm` string that specifies your implementation. - - If you specify a custom value for the `algorithm` parameter, the object will use it to determine whether an ECDSA object can be created. - - ]]> - + To be added. The parameter is . diff --git a/xml/System.Security.Cryptography/HMAC.xml b/xml/System.Security.Cryptography/HMAC.xml index 8804798cfcc..25a589482df 100644 --- a/xml/System.Security.Cryptography/HMAC.xml +++ b/xml/System.Security.Cryptography/HMAC.xml @@ -334,16 +334,7 @@ Creates an instance of the specified implementation of a Hash-based Message Authentication Code (HMAC). A new instance of the specified HMAC implementation. - - - + To be added. diff --git a/xml/System.Security.Cryptography/HMACSHA1.xml b/xml/System.Security.Cryptography/HMACSHA1.xml index 01365118dd0..60435869f31 100644 --- a/xml/System.Security.Cryptography/HMACSHA1.xml +++ b/xml/System.Security.Cryptography/HMACSHA1.xml @@ -274,7 +274,7 @@ Due to collision problems with SHA-1, Microsoft recommends a security model base to use the managed implementation of the SHA-1 algorithm (the class); to use the unmanaged implementation (the class). Initializes a new instance of the class with the specified key data and a value that specifies whether to use the managed version of the SHA-1 algorithm. - Due to collision problems with SHA-1, Microsoft recommends a security model based on SHA-256 or better. + To be added. diff --git a/xml/System.Security.Cryptography/KeyedHashAlgorithm.xml b/xml/System.Security.Cryptography/KeyedHashAlgorithm.xml index 4ec16f6089a..0fdde274342 100644 --- a/xml/System.Security.Cryptography/KeyedHashAlgorithm.xml +++ b/xml/System.Security.Cryptography/KeyedHashAlgorithm.xml @@ -196,16 +196,7 @@ Creates an instance of the default implementation of a keyed hash algorithm. A new instance, unless the default settings have been changed. - - implementation of a keyed hash algorithm. If you want to specify a different implementation, use the overload, which lets you specify an algorithm name, instead. The cryptography configuration system defines the default implementation of the class. - - Due to collision problems with SHA-1, Microsoft recommends a security model based on SHA-256 or better. - - ]]> - + To be added. Cryptographic Services diff --git a/xml/System.Security.Cryptography/MD5.xml b/xml/System.Security.Cryptography/MD5.xml index b6c83e6188c..a3f280f72d9 100644 --- a/xml/System.Security.Cryptography/MD5.xml +++ b/xml/System.Security.Cryptography/MD5.xml @@ -264,14 +264,7 @@ The name of the specific implementation of to use. Creates an instance of the specified implementation of the hash algorithm. A new instance of the specified implementation of . - - - + To be added. The algorithm described by the parameter was used with Federal Information Processing Standards (FIPS) mode enabled, but is not FIPS compatible. Cryptographic Services diff --git a/xml/System.Security.Cryptography/MD5CryptoServiceProvider.xml b/xml/System.Security.Cryptography/MD5CryptoServiceProvider.xml index faa4972c84e..8297f991307 100644 --- a/xml/System.Security.Cryptography/MD5CryptoServiceProvider.xml +++ b/xml/System.Security.Cryptography/MD5CryptoServiceProvider.xml @@ -64,21 +64,7 @@ Computes the hash value for the input data using the implementation provided by the cryptographic service provider (CSP). This class cannot be inherited. - - [!NOTE] -> Newer hash functions such as the Secure Hash Algorithms SHA-256 and SHA-512 are available. Consider using the class or the class instead of the class. Use only for compatibility with legacy applications and data. - - The hash size for the class is 128 bits. - - The methods of the class return the hash as an array of 16 bytes. Note that some MD5 implementations produce a 32-character, hexadecimal-formatted hash. To interoperate with such implementations, format the return value of the methods as a hexadecimal value. - - ]]> - + To be added. Cryptographic Services diff --git a/xml/System.Security.Cryptography/PasswordDeriveBytes.xml b/xml/System.Security.Cryptography/PasswordDeriveBytes.xml index e1ca675892b..9cc82c215ba 100644 --- a/xml/System.Security.Cryptography/PasswordDeriveBytes.xml +++ b/xml/System.Security.Cryptography/PasswordDeriveBytes.xml @@ -923,14 +923,7 @@ The number of pseudo-random key bytes to generate. Returns pseudo-random key bytes. A byte array filled with pseudo-random key bytes. - - - + To be added. Cryptographic Services diff --git a/xml/System.Security.Cryptography/RC2CryptoServiceProvider.xml b/xml/System.Security.Cryptography/RC2CryptoServiceProvider.xml index 7da7229934e..f7f91579dc9 100644 --- a/xml/System.Security.Cryptography/RC2CryptoServiceProvider.xml +++ b/xml/System.Security.Cryptography/RC2CryptoServiceProvider.xml @@ -68,29 +68,7 @@ Defines a wrapper object to access the cryptographic service provider (CSP) implementation of the algorithm. This class cannot be inherited. - - implementation supports key lengths from 40 bits to 128 bits in increments of 8 bits. - - The object is a block cipher that encrypts and decrypts data in blocks of 8 bytes. This class pads the final block of data if it is less than 8 bytes. As a result of this padding, the length of encrypted data could be greater than the original plaintext. - - Note that the object does not use salt. - -> [!NOTE] -> A newer symmetric encryption algorithm, Advanced Encryption Standard (AES), is available. Consider using the algorithm and its derived classes instead of the class. Use only for compatibility with legacy applications and data. - - - -## Examples - The following code example encrypts and then decrypts a string. - - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/RC2CryptoServiceProvider/Overview/class1.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security.Cryptography/RC2CryptoServiceProvider/Overview/class1.vb" id="Snippet1"::: - - ]]> - + To be added. Cryptographic Services diff --git a/xml/System.Security.Cryptography/RNGCryptoServiceProvider.xml b/xml/System.Security.Cryptography/RNGCryptoServiceProvider.xml index fda83110ef4..0ba16b06e41 100644 --- a/xml/System.Security.Cryptography/RNGCryptoServiceProvider.xml +++ b/xml/System.Security.Cryptography/RNGCryptoServiceProvider.xml @@ -68,22 +68,7 @@ Implements a cryptographic Random Number Generator (RNG) using the implementation provided by the cryptographic service provider (CSP). This class cannot be inherited. - - [!IMPORTANT] -> This type implements the interface. When you've finished using the type, you should dispose of it either directly (by calling its `Dispose` method) or indirectly (with a language construct such as `using` in C#). For more information, see [Use an object that implements IDisposable](xref:System.IDisposable#use-an-object-that-implements-idisposable). - -## Examples - The following code example shows how to create a random number with the class. - - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/RNGCryptoServiceProvider/Overview/rngcsp.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security.Cryptography/RNGCryptoServiceProvider/Overview/rngcsp.vb" id="Snippet1"::: - - ]]> - + To be added. This type is thread safe. Cryptographic Services diff --git a/xml/System.Security.Cryptography/RSACryptoServiceProvider.xml b/xml/System.Security.Cryptography/RSACryptoServiceProvider.xml index 638d4d8133b..3ecbdcc0f1e 100644 --- a/xml/System.Security.Cryptography/RSACryptoServiceProvider.xml +++ b/xml/System.Security.Cryptography/RSACryptoServiceProvider.xml @@ -821,7 +821,7 @@ If no key is loaded via the The data to be encrypted. - to perform direct encryption using OAEP padding (only available on a computer running Windows XP or later); otherwise, to use PKCS#1 v1.5 padding. + to perform direct encryption using OAEP padding; to use PKCS#1 v1.5 padding. Encrypts data with the algorithm. The encrypted data. @@ -837,8 +837,6 @@ If no key is loaded via the to decrypt the results of this method. - - ## Examples The following code example initializes an object to the value of a public key (sent by another party), generates a session key using the algorithm, and then encrypts the session key using the object. Using this scheme, the session key could be sent back to the owner of the private RSA key and the two parties could use the session key to exchange encrypted data. diff --git a/xml/System.Security.Cryptography/Rfc2898DeriveBytes.xml b/xml/System.Security.Cryptography/Rfc2898DeriveBytes.xml index 5602e6fc97e..ecfa3c58420 100644 --- a/xml/System.Security.Cryptography/Rfc2898DeriveBytes.xml +++ b/xml/System.Security.Cryptography/Rfc2898DeriveBytes.xml @@ -157,27 +157,7 @@ The password used to derive the key. The key salt used to derive the key. Initializes a new instance of the class using a password and salt to derive the key. - - class can be used to produce a derived key from a base key and other parameters. In a password-based key derivation function, the base key is a password and the other parameters are a salt value and an iteration count. - - For more information about PBKDF2, see [RFC 2898](https://www.rfc-editor.org/info/rfc2898), titled "PKCS #5: Password-Based Cryptography Specification Version 2.0". See section 5.2, "PBKDF2," for complete details. - -> [!IMPORTANT] -> Never hard-code a password within your source code. Hard-coded passwords can be retrieved from an assembly by using the [Ildasm.exe (IL Disassembler)](/dotnet/framework/tools/ildasm-exe-il-disassembler), by using a hexadecimal editor, or by simply opening up the assembly in a text editor such as Notepad.exe. - -## Examples - The following code example uses the class to create two identical keys for the class. It then encrypts and decrypts some data using the keys. - - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/Rfc2898DeriveBytes/Overview/rfc28981.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security.Cryptography/Rfc2898DeriveBytes/Overview/rfc28981.vb" id="Snippet1"::: - - ]]> - + To be added. The specified salt size is smaller than 8 bytes or the iteration count is less than 1. The password or salt is . Cryptographic Services @@ -239,21 +219,7 @@ The password used to derive the key. The size of the random salt that you want the class to generate. Initializes a new instance of the class using the password and salt size to derive the key. - - class can be used to produce a derived key from a base key and other parameters. In a password-based key derivation function, the base key is a password and the other parameters are a salt value and an iteration count. - -For more information about PBKDF2, see [RFC 2898](https://www.rfc-editor.org/info/rfc2898), titled "PKCS #5: Password-Based Cryptography Specification Version 2.0". See section 5.2, "PBKDF2," for complete details. - -> [!IMPORTANT] -> Never hard-code a password within your source code. Hard-coded passwords can be retrieved from an assembly by using the [Ildasm.exe (IL Disassembler)](/dotnet/framework/tools/ildasm-exe-il-disassembler), by using a hexadecimal editor, or by simply opening up the assembly in a text editor such as Notepad.exe. - - ]]> - + To be added. The specified salt size is smaller than 8 bytes. The password or salt is . Cryptographic Services @@ -317,21 +283,7 @@ For more information about PBKDF2, see [RFC 2898](https://www.rfc-editor.org/inf The key salt used to derive the key. The number of iterations for the operation. Initializes a new instance of the class using a password, a salt, and number of iterations to derive the key. - - class can be used to produce a derived key from a base key and other parameters. In a password-based key derivation function, the base key is a password and the other parameters are a salt value and an iteration count. - -For more information about PBKDF2, see [RFC 2898](https://www.rfc-editor.org/info/rfc2898), titled "PKCS #5: Password-Based Cryptography Specification Version 2.0". See section 5.2, "PBKDF2," for complete details. - -> [!IMPORTANT] -> Never hard-code a password within your source code. Hard-coded passwords can be retrieved from an assembly by using the [Ildasm.exe (IL Disassembler)](/dotnet/framework/tools/ildasm-exe-il-disassembler), by using a hexadecimal editor, or by simply opening up the assembly in a text editor such as Notepad.exe. - - ]]> - + To be added. The specified salt size is smaller than 8 bytes or the iteration count is less than 1. The password or salt is . @@ -394,27 +346,7 @@ For more information about PBKDF2, see [RFC 2898](https://www.rfc-editor.org/inf The key salt used to derive the key. The number of iterations for the operation. Initializes a new instance of the class using a password, a salt, and number of iterations to derive the key. - - class can be used to produce a derived key from a base key and other parameters. In a password-based key derivation function, the base key is a password and the other parameters are a salt value and an iteration count. - -For more information about PBKDF2, see [RFC 2898](https://www.rfc-editor.org/info/rfc2898), titled "PKCS #5: Password-Based Cryptography Specification Version 2.0". See section 5.2, "PBKDF2," for complete details. - -> [!IMPORTANT] -> Never hard-code a password within your source code. Hard-coded passwords can be retrieved from an assembly by using the [Ildasm.exe (IL Disassembler)](/dotnet/framework/tools/ildasm-exe-il-disassembler), by using a hexadecimal editor, or by simply opening up the assembly in a text editor such as Notepad.exe. - -## Examples - The following code example uses the class to create two identical keys for the class. It then encrypts and decrypts some data using the keys. - - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/Rfc2898DeriveBytes/Overview/rfc28981.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security.Cryptography/Rfc2898DeriveBytes/Overview/rfc28981.vb" id="Snippet1"::: - - ]]> - + To be added. The specified salt size is smaller than 8 bytes or the iteration count is less than 1. The password or salt is . Cryptographic Services @@ -478,21 +410,7 @@ For more information about PBKDF2, see [RFC 2898](https://www.rfc-editor.org/inf The size of the random salt that you want the class to generate. The number of iterations for the operation. Initializes a new instance of the class using a password, a salt size, and number of iterations to derive the key. - - class can be used to produce a derived key from a base key and other parameters. In a password-based key derivation function, the base key is a password and the other parameters are a salt value and an iteration count. - -For more information about PBKDF2, see [RFC 2898](https://www.rfc-editor.org/info/rfc2898), titled "PKCS #5: Password-Based Cryptography Specification Version 2.0". See section 5.2, "PBKDF2," for complete details. - -> [!IMPORTANT] -> Never hard-code a password within your source code. Hard-coded passwords can be retrieved from an assembly by using the [Ildasm.exe (IL Disassembler)](/dotnet/framework/tools/ildasm-exe-il-disassembler), by using a hexadecimal editor, or by simply opening up the assembly in a text editor such as Notepad.exe. - - ]]> - + To be added. The specified salt size is smaller than 8 bytes or the iteration count is less than 1. The password or salt is . @@ -723,16 +641,7 @@ For more information about PBKDF2, see [RFC 2898](https://www.rfc-editor.org/inf The initialization vector (IV) to use to derive the key. Derives a cryptographic key from the object. The derived key. - - - + To be added. The parameter is incorrect. -or- diff --git a/xml/System.Security.Cryptography/Rijndael.xml b/xml/System.Security.Cryptography/Rijndael.xml index 640a5b820b6..4a3030cbfa4 100644 --- a/xml/System.Security.Cryptography/Rijndael.xml +++ b/xml/System.Security.Cryptography/Rijndael.xml @@ -71,17 +71,7 @@ Represents the base class from which all implementations of the symmetric encryption algorithm must inherit. - - -compatible). - -> [!IMPORTANT] -> The class is the predecessor of the algorithm. You should use the algorithm instead of . For more information, see the entry [The Differences Between Rijndael and AES](https://learn.microsoft.com/archive/blogs/shawnfa/the-differences-between-rijndael-and-aes) in the .NET Security blog. - - ]]> - + To be added. Cryptographic Services @@ -276,14 +266,7 @@ The name of the specific implementation of to create. Creates a cryptographic object to perform the specified implementation of the algorithm. A cryptographic object. - - - + To be added. The algorithm described by the parameter was used with Federal Information Processing Standards (FIPS) mode enabled, but is not FIPS compatible. Cryptographic Services diff --git a/xml/System.Security.Cryptography/RijndaelManaged.xml b/xml/System.Security.Cryptography/RijndaelManaged.xml index bafa51b261d..c1c5a3cd92b 100644 --- a/xml/System.Security.Cryptography/RijndaelManaged.xml +++ b/xml/System.Security.Cryptography/RijndaelManaged.xml @@ -71,24 +71,7 @@ Accesses the managed version of the algorithm. This class cannot be inherited. - - [!IMPORTANT] -> The class is the predecessor of the algorithm. You should use the algorithm instead of . For more information, see the entry [The Differences Between Rijndael and AES](https://learn.microsoft.com/archive/blogs/shawnfa/the-differences-between-rijndael-and-aes) in the .NET Security blog. - -## Examples - The following example demonstrates how to encrypt and decrypt sample data using the `RijndaelManaged` class. - - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/RijndaelManaged/Overview/class1.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security.Cryptography/RijndaelManaged/Overview/class1.vb" id="Snippet1"::: - - ]]> - + To be added. Cryptographic Services diff --git a/xml/System.Security.Cryptography/SHA1.xml b/xml/System.Security.Cryptography/SHA1.xml index 78f56dbe279..48afdaec530 100644 --- a/xml/System.Security.Cryptography/SHA1.xml +++ b/xml/System.Security.Cryptography/SHA1.xml @@ -257,7 +257,7 @@ The name of the specific implementation of to be used. Creates an instance of the specified implementation of . A new instance of using the specified implementation. - Due to collision problems with SHA-1, Microsoft recommends a security model based on SHA-256 or better. + To be added. Cryptographic Services diff --git a/xml/System.Security.Cryptography/SHA1CryptoServiceProvider.xml b/xml/System.Security.Cryptography/SHA1CryptoServiceProvider.xml index 7de3a082bec..0f8266c0ad6 100644 --- a/xml/System.Security.Cryptography/SHA1CryptoServiceProvider.xml +++ b/xml/System.Security.Cryptography/SHA1CryptoServiceProvider.xml @@ -64,19 +64,7 @@ Computes the hash value for the input data using the implementation provided by the cryptographic service provider (CSP). This class cannot be inherited. - - class is 160 bits. - -> [!IMPORTANT] -> This type implements the interface. When you've finished using the type, you should dispose of it either directly (by calling its `Dispose` method) or indirectly (with a language construct such as `using` in C#). For more information, see [Use an object that implements IDisposable](xref:System.IDisposable#use-an-object-that-implements-idisposable). - -Due to collision problems with SHA-1, Microsoft recommends a security model based on SHA-256 or better. - - ]]> - + To be added. Cryptographic Services diff --git a/xml/System.Security.Cryptography/SHA1Managed.xml b/xml/System.Security.Cryptography/SHA1Managed.xml index 2398bdb099c..db4bf705d90 100644 --- a/xml/System.Security.Cryptography/SHA1Managed.xml +++ b/xml/System.Security.Cryptography/SHA1Managed.xml @@ -63,20 +63,7 @@ Computes the hash for the input data using the managed library. - - that does not wrap CAPI. - - The hash size for the algorithm is 160 bits. - - Due to collision problems with SHA-1, Microsoft recommends a security model based on SHA-256 or better. - - ]]> - + To be added. Cryptographic Services diff --git a/xml/System.Security.Cryptography/SHA256Managed.xml b/xml/System.Security.Cryptography/SHA256Managed.xml index 92763b7dce9..1ebc990717a 100644 --- a/xml/System.Security.Cryptography/SHA256Managed.xml +++ b/xml/System.Security.Cryptography/SHA256Managed.xml @@ -63,24 +63,7 @@ Computes the hash for the input data using the managed library. - - algorithm is 256 bits. - - - -## Examples - The following example calculates the SHA-256 hash for all files in a directory. - - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/HashAlgorithm/ComputeHash/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security.Cryptography/HashAlgorithm/ComputeHash/source.vb" id="Snippet1"::: - - ]]> - + To be added. Cryptographic Services diff --git a/xml/System.Security.Cryptography/SHA384Managed.xml b/xml/System.Security.Cryptography/SHA384Managed.xml index a14fed5ff49..a14ba6db442 100644 --- a/xml/System.Security.Cryptography/SHA384Managed.xml +++ b/xml/System.Security.Cryptography/SHA384Managed.xml @@ -63,24 +63,7 @@ Computes the hash for the input data using the managed library. - - algorithm is 384 bits. - - - -## Examples - The following example computes the hash for `data` and stores it in `result`. This example assumes that there is a predefined constant `DATA_SIZE`. - - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/SHA384Managed/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security.Cryptography/SHA384Managed/Overview/source.vb" id="Snippet1"::: - - ]]> - + To be added. Cryptographic Services diff --git a/xml/System.Security.Cryptography/SHA512.xml b/xml/System.Security.Cryptography/SHA512.xml index f90d64aa26b..419404e5ad0 100644 --- a/xml/System.Security.Cryptography/SHA512.xml +++ b/xml/System.Security.Cryptography/SHA512.xml @@ -257,14 +257,7 @@ The name of the specific implementation of to be used. Creates an instance of a specified implementation of . A new instance of using the specified implementation. - - - + To be added. The algorithm described by the parameter was used with Federal Information Processing Standards (FIPS) mode enabled, but is not FIPS compatible. Cryptographic Services diff --git a/xml/System.Security.Cryptography/SHA512Managed.xml b/xml/System.Security.Cryptography/SHA512Managed.xml index daa94224474..4345da264ad 100644 --- a/xml/System.Security.Cryptography/SHA512Managed.xml +++ b/xml/System.Security.Cryptography/SHA512Managed.xml @@ -63,24 +63,7 @@ Computes the hash algorithm for the input data using the managed library. - - algorithm is 512 bits. - - - -## Examples - The following example computes the hash for `data` and stores it in `result`. This example assumes that there is a predefined constant `DATA_SIZE`. - - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/SHA512Managed/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security.Cryptography/SHA512Managed/Overview/source.vb" id="Snippet1"::: - - ]]> - + To be added. Cryptographic Services diff --git a/xml/System.Security.Permissions/CodeAccessSecurityAttribute.xml b/xml/System.Security.Permissions/CodeAccessSecurityAttribute.xml index 6eb9baaea5a..014799eff4d 100644 --- a/xml/System.Security.Permissions/CodeAccessSecurityAttribute.xml +++ b/xml/System.Security.Permissions/CodeAccessSecurityAttribute.xml @@ -146,9 +146,6 @@ One of the values. Initializes a new instance of with the specified . To be added. - - Derived classes must have only one constructor that takes a as its only parameter. - diff --git a/xml/System.Security.Permissions/PermissionSetAttribute.xml b/xml/System.Security.Permissions/PermissionSetAttribute.xml index 987a0d4745a..69b3aba0c03 100644 --- a/xml/System.Security.Permissions/PermissionSetAttribute.xml +++ b/xml/System.Security.Permissions/PermissionSetAttribute.xml @@ -53,7 +53,6 @@ ]]> - Extending Metadata Using Attributes diff --git a/xml/System.Security.Permissions/ResourcePermissionBase.xml b/xml/System.Security.Permissions/ResourcePermissionBase.xml index ac681988a8f..568c749e0f5 100644 --- a/xml/System.Security.Permissions/ResourcePermissionBase.xml +++ b/xml/System.Security.Permissions/ResourcePermissionBase.xml @@ -52,9 +52,6 @@ ]]> - - When you inherit from , you must provide at least three constructors, set two properties, and provide a third property. The required constructors are: a parameterless constructor, one that takes a as a parameter, and as many as needed that take values for the properties. The properties that need to be set are and . The third property that is needed is one that returns the permission entries. For an example of an implementation of this class, see . In , the property is set privately to "Machine" and "Category", the property is privately set to the type of , and the property returns the permission entries. - @@ -555,9 +552,6 @@ To be added. The property value is . The property value is not an enumeration value. - - When you inherit from , you must set this property. For an example of an implementation of this class, see . In , the property is privately set to the type of . - @@ -640,9 +634,6 @@ To be added. The property value is . The length of the array is 0. - - When you inherit from , you must set this property. For an example of an implementation of this class, see . In , the property is set privately to "Machine" and "Category". - diff --git a/xml/System.Security.Permissions/SecurityAttribute.xml b/xml/System.Security.Permissions/SecurityAttribute.xml index 2f030f9dc3b..411c570c4d5 100644 --- a/xml/System.Security.Permissions/SecurityAttribute.xml +++ b/xml/System.Security.Permissions/SecurityAttribute.xml @@ -93,9 +93,6 @@ ]]> - - When you inherit from , you must override . - Extending Metadata Using Attributes diff --git a/xml/System.Security.Permissions/SecurityPermission.xml b/xml/System.Security.Permissions/SecurityPermission.xml index 32fe12f281b..9e43140cb63 100644 --- a/xml/System.Security.Permissions/SecurityPermission.xml +++ b/xml/System.Security.Permissions/SecurityPermission.xml @@ -53,8 +53,6 @@ ]]> - - diff --git a/xml/System.Security.Permissions/SecurityPermissionAttribute.xml b/xml/System.Security.Permissions/SecurityPermissionAttribute.xml index 7d2e8c2e2f0..57afb64a7e8 100644 --- a/xml/System.Security.Permissions/SecurityPermissionAttribute.xml +++ b/xml/System.Security.Permissions/SecurityPermissionAttribute.xml @@ -94,7 +94,6 @@ ]]> - Extending Metadata Using Attributes diff --git a/xml/System.Security.Permissions/SecurityPermissionFlag.xml b/xml/System.Security.Permissions/SecurityPermissionFlag.xml index 63940f55754..4c79949ded6 100644 --- a/xml/System.Security.Permissions/SecurityPermissionFlag.xml +++ b/xml/System.Security.Permissions/SecurityPermissionFlag.xml @@ -93,7 +93,6 @@ ]]> - diff --git a/xml/System.Security.Policy/Evidence.xml b/xml/System.Security.Policy/Evidence.xml index ff05714e8b2..8501eeef427 100644 --- a/xml/System.Security.Policy/Evidence.xml +++ b/xml/System.Security.Policy/Evidence.xml @@ -349,16 +349,7 @@ Any evidence object. Adds the specified assembly evidence to the evidence set. - - [!NOTE] -> This method does not perform a check to prevent adding duplicate types of evidence. Many assembly evidence objects can exist at the same time. - - ]]> - + To be added. is null. @@ -485,16 +476,7 @@ Any evidence object. Adds the specified evidence supplied by the host to the evidence set. - - [!NOTE] -> This method does not perform a check to prevent adding duplicate types of evidence. Many host evidence objects can exist at the same time. - - ]]> - + To be added. is null. diff --git a/xml/System.Security.Principal/WindowsBuiltInRole.xml b/xml/System.Security.Principal/WindowsBuiltInRole.xml index c2210267a65..63db3ee0f6a 100644 --- a/xml/System.Security.Principal/WindowsBuiltInRole.xml +++ b/xml/System.Security.Principal/WindowsBuiltInRole.xml @@ -33,12 +33,11 @@ [!NOTE] -> In Windows Vista, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. When you attempt to perform a task that requires administrative privileges, you can dynamically elevate your role by using the Consent dialog box. The code that executes the method does not display the Consent dialog box. The code returns false if you are in the standard user role, even if you are in the Built-in Administrators group. You can elevate your privileges before you execute the code by right-clicking the application icon and indicating that you want to run as an administrator. +These roles represent the local Windows groups. +> [!NOTE] +> In Windows Vista, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. When you attempt to perform a task that requires administrative privileges, you can dynamically elevate your role by using the Consent dialog box. The code that executes the method does not display the Consent dialog box. The code returns false if you are in the standard user role, even if you are in the Built-in Administrators group. You can elevate your privileges before you execute the code by right-clicking the application icon and indicating that you want to run as an administrator. ## Examples The following example shows the use of the enumeration. diff --git a/xml/System.Security.Principal/WindowsIdentity.xml b/xml/System.Security.Principal/WindowsIdentity.xml index e4f7205b065..832ee18366d 100644 --- a/xml/System.Security.Principal/WindowsIdentity.xml +++ b/xml/System.Security.Principal/WindowsIdentity.xml @@ -215,7 +215,7 @@ A UPN has the format *username*@*domainname*.com, in other words, an email address. The UPN identified in `sUserPrincipalName` is used to retrieve a token for that user through the Windows API `LsaLogonUser` function. In turn that token is used to identify the user. An exception might be returned due to the inability to log on using the supplied UPN. > [!NOTE] -> This constructor is intended for use only on computers joined to Windows Server 2003 or later domains. An exception is thrown for earlier domain types. This restriction is due to the fact that this constructor uses the [KERB_S4U_LOGON structure](https://learn.microsoft.com/windows/win32/api/ntsecapi/ns-ntsecapi-kerb_s4u_logon), which was first introduced in Windows Server 2003. Also, this constructor requires read access to the [token-groups-global-and-universal (TGGAU) attribute](https://support.microsoft.com/en-us/help/331951/some-applications-and-apis-require-access-to-authorization-information) on the target user account. +> This constructor requires read access to the [token-groups-global-and-universal (TGGAU) attribute](https://learn.microsoft.com/troubleshoot/windows-server/active-directory/apps-apis-require-access) on the target user account. ]]> @@ -355,15 +355,7 @@ The object containing the account information for the user. An object that indicates the stream characteristics. Initializes a new instance of the class for the user represented by information in a stream. - - - + To be added. A cannot be serialized across processes. The caller does not have the correct permissions. diff --git a/xml/System.Security/CodeAccessPermission.xml b/xml/System.Security/CodeAccessPermission.xml index 12865399688..b765b83d389 100644 --- a/xml/System.Security/CodeAccessPermission.xml +++ b/xml/System.Security/CodeAccessPermission.xml @@ -135,9 +135,6 @@ -or- There is already an active for the current frame. - - You cannot override this method. - Using the Assert Method @@ -179,9 +176,6 @@ When implemented by a derived class, creates and returns an identical copy of the current permission object. A copy of the current permission object. To be added. - - You must override this method in a derived class. - @@ -227,9 +221,6 @@ -or- A caller higher in the call stack has called on the current permission object. - - You cannot override this method. - @@ -276,9 +267,6 @@ Prevents callers higher in the call stack from using the code that calls this method to access the resource specified by the current instance. To be added. There is already an active for the current frame. - - You cannot override this method. - @@ -367,9 +355,6 @@ -or- The version number of the parameter is not supported. - - You must override this method in a derived class. - @@ -450,9 +435,6 @@ A new permission that represents the intersection of the current permission and the specified permission. This new permission is if the intersection is empty. To be added. The parameter is not and is not an instance of the same class as the current permission. - - You must override this method in a derived class. - @@ -498,9 +480,6 @@ if the current permission is a subset of the specified permission; otherwise, . To be added. The parameter is not and is not of the same type as the current permission. - - You must override this method in a derived class. - @@ -541,9 +520,6 @@ Prevents callers higher in the call stack from using the code that calls this method to access all resources except for the resource specified by the current instance. To be added. There is already an active for the current frame. - - You cannot override this method. - diff --git a/xml/System.Security/PermissionSet.xml b/xml/System.Security/PermissionSet.xml index 62b673475d0..af75842e928 100644 --- a/xml/System.Security/PermissionSet.xml +++ b/xml/System.Security/PermissionSet.xml @@ -265,9 +265,6 @@ The union of the permission added and any permission of the same type that already exists in the . To be added. The method is called from a . - - When you inherit from , you can change the behavior of the method by overriding the method. - @@ -945,9 +942,6 @@ Returns an enumerator for the permissions of the set. An enumerator object for the permissions of the set. To be added. - - When you inherit from , you can change the behavior of the method by overriding the method. - @@ -1100,9 +1094,6 @@ Gets a permission object of the specified type, if it exists in the set. A copy of the permission object of the type specified by the parameter contained in the , or if none exists. To be added. - - When you inherit from , you can change the behavior of the method by overriding the method. - @@ -1578,9 +1569,6 @@ The permission removed from the set. To be added. The method is called from a . - - When you inherit from , you can change the behavior of the method by overriding the method. - @@ -1738,9 +1726,6 @@ The set permission. To be added. The method is called from a . - - When you inherit from , you can change the behavior of the method by overriding the method. - diff --git a/xml/System.Security/SecureString.xml b/xml/System.Security/SecureString.xml index af81e747b4b..599dda30d10 100644 --- a/xml/System.Security/SecureString.xml +++ b/xml/System.Security/SecureString.xml @@ -68,8 +68,6 @@ > [!IMPORTANT] > We recommend that you don't use the `SecureString` class for new development on .NET (Core) or when you migrate from .NET Framework. For more information, see [SecureString shouldn't be used](https://github.com/dotnet/platform-compat/blob/master/docs/DE0001.md). -[!INCLUDE [context](~/includes/context.md)] - is a string type that provides a measure of security. It tries to avoid storing potentially sensitive strings in process memory as plain text. (For limitations, however, see the [How secure is SecureString?](#how-secure-is-securestring) section.) The value of an instance of is automatically protected using a mechanism supported by the underlying platform when the instance is initialized or when the value is modified. Your application can render the instance immutable and prevent further modification by invoking the method. The maximum length of a instance is 65,536 characters. diff --git a/xml/System.Security/SecurityCriticalScope.xml b/xml/System.Security/SecurityCriticalScope.xml index 5f32caf2dac..b357e875695 100644 --- a/xml/System.Security/SecurityCriticalScope.xml +++ b/xml/System.Security/SecurityCriticalScope.xml @@ -49,14 +49,7 @@ Specifies the scope of a . - - - + To be added. diff --git a/xml/System.Security/SecurityException.xml b/xml/System.Security/SecurityException.xml index 1591aa221c8..03db6bd30bd 100644 --- a/xml/System.Security/SecurityException.xml +++ b/xml/System.Security/SecurityException.xml @@ -268,41 +268,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - -- - -- - -- - -- - -- - -- - -- - -- - -- - - - -## Examples - For an example of the use of a constructor, see the example provided for the constructor. - - ]]> - + To be added. is . @@ -723,23 +689,7 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. Sets the with information about the . - - with all the exception object data targeted for serialization. During deserialization, the exception is reconstituted from the `SerializationInfo` transmitted over the stream. - - - -## Examples - The following code shows the use of the method to display the permission state contained in the object. - - :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Security.SecurityException/CPP/form1.cpp" id="Snippet9"::: - :::code language="csharp" source="~/snippets/csharp/System.Security/SecurityException/.ctor/form1.cs" id="Snippet9"::: - :::code language="vb" source="~/snippets/visualbasic/System.Security/SecurityException/.ctor/form1.vb" id="Snippet9"::: - - ]]> - + To be added. The parameter is . diff --git a/xml/System.Security/VerificationException.xml b/xml/System.Security/VerificationException.xml index c37e7771bd0..79dcc1c7677 100644 --- a/xml/System.Security/VerificationException.xml +++ b/xml/System.Security/VerificationException.xml @@ -220,14 +220,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. diff --git a/xml/System.ServiceProcess/ServiceControllerPermission.xml b/xml/System.ServiceProcess/ServiceControllerPermission.xml index 4f14f1aa629..e2cb0f3e752 100644 --- a/xml/System.ServiceProcess/ServiceControllerPermission.xml +++ b/xml/System.ServiceProcess/ServiceControllerPermission.xml @@ -129,7 +129,6 @@ Initializes a new instance of the class with the specified access to resources. To be added. The parameter is not a valid value of . - diff --git a/xml/System.ServiceProcess/ServiceControllerPermissionAttribute.xml b/xml/System.ServiceProcess/ServiceControllerPermissionAttribute.xml index 233e1f24e04..f896e0fc1f6 100644 --- a/xml/System.ServiceProcess/ServiceControllerPermissionAttribute.xml +++ b/xml/System.ServiceProcess/ServiceControllerPermissionAttribute.xml @@ -92,7 +92,6 @@ One of the values. Initializes a new instance of the class. To be added. - diff --git a/xml/System.Text.Json/JsonSerializerOptions.xml b/xml/System.Text.Json/JsonSerializerOptions.xml index 3497339c510..36308be26a9 100644 --- a/xml/System.Text.Json/JsonSerializerOptions.xml +++ b/xml/System.Text.Json/JsonSerializerOptions.xml @@ -169,18 +169,7 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa The generic definition of the specified context type. Appends a new to the metadata resolution of the current instance. - - resolves metadata. - - ]]> - + To be added. @@ -716,15 +705,7 @@ If the instance is locked for modi Gets or sets a value that indicates whether values are ignored during serialization and deserialization. The default value is . if null values are ignored during serialization and deserialization; otherwise, . - - - + To be added. This property was set after serialization or deserialization has occurred. -or- diff --git a/xml/System.Text.RegularExpressions/Regex.xml b/xml/System.Text.RegularExpressions/Regex.xml index bfdf6c9fa96..75c638e44fc 100644 --- a/xml/System.Text.RegularExpressions/Regex.xml +++ b/xml/System.Text.RegularExpressions/Regex.xml @@ -1072,13 +1072,6 @@ The regular expression pattern of one or more objects in contains invalid syntax. or is . - - If you are developing on a system that has .NET Framework 4.5 or its point releases installed, you target .NET Framework 4, and you use the method to create an assembly that contains compiled regular expressions. Trying to use one of the regular expressions in that assembly on a system that has .NET Framework 4 throws an exception. To work around this problem, you can do either of the following: - -- Build the assembly that contains the compiled regular expressions on a system that has .NET Framework 4 instead of later versions installed. - -- Instead of calling and retrieving the compiled regular expression from an assembly, use either static or instance methods with the option when you instantiate a object or call a regular expression pattern matching method. - Compilation and Reuse Creating an assembly of compiled regular expressions is not supported. @@ -1193,13 +1186,6 @@ or is . The parameter designates an invalid Win32 resource file. The file designated by the parameter cannot be found. - - If you are developing on a system that has .NET Framework 4.5 or its point releases installed, you target .NET Framework 4, and you use the method to create an assembly that contains compiled regular expressions. Trying to use one of the regular expressions in that assembly on a system that has .NET Framework 4 throws an exception. To work around this problem, you can do either of the following: - -- Build the assembly that contains the compiled regular expressions on a system that has .NET Framework 4 instead of later versions installed. - -- Instead of calling and retrieving the compiled regular expression from an assembly, use either static or instance methods with the option when you instantiate a object or call a regular expression pattern matching method. - Compilation and Reuse Creating an assembly of compiled regular expressions is not supported. diff --git a/xml/System.Text.RegularExpressions/RegexCompilationInfo.xml b/xml/System.Text.RegularExpressions/RegexCompilationInfo.xml index f94fd4f8c31..49460af10ab 100644 --- a/xml/System.Text.RegularExpressions/RegexCompilationInfo.xml +++ b/xml/System.Text.RegularExpressions/RegexCompilationInfo.xml @@ -140,9 +140,6 @@ ]]> - - This constructor creates a compiled regular expression that uses the default time-out value of the application domain in which it is created. If a time-out value is defined for the application domain, the compiled regular expression uses the value , which prevents a pattern-matching operation from timing out. The recommended constructor for creating a compiled regular expression is , which lets you set the time-out interval. - is , or is , or is . diff --git a/xml/System.Text.RegularExpressions/RegexMatchTimeoutException.xml b/xml/System.Text.RegularExpressions/RegexMatchTimeoutException.xml index 7050a91f2db..a47122bcd82 100644 --- a/xml/System.Text.RegularExpressions/RegexMatchTimeoutException.xml +++ b/xml/System.Text.RegularExpressions/RegexMatchTimeoutException.xml @@ -616,7 +616,6 @@ ]]> - diff --git a/xml/System.Text/Encoding.xml b/xml/System.Text/Encoding.xml index f84914868b1..c5487001432 100644 --- a/xml/System.Text/Encoding.xml +++ b/xml/System.Text/Encoding.xml @@ -5710,20 +5710,7 @@ If multiple providers are registered, Gets an encoding for the UTF-7 format. An encoding for the UTF-7 format. - - - + To be added. How to use character encoding classes in .NET diff --git a/xml/System.Text/Rune.xml b/xml/System.Text/Rune.xml index 01e262d58dc..2b9f5ebe6ab 100644 --- a/xml/System.Text/Rune.xml +++ b/xml/System.Text/Rune.xml @@ -256,7 +256,7 @@ The and Initializes a new instance of the class. - - constructor is equivalent to calling the constructor that takes an `allowOptionals` parameter and specifying `false` for that parameter. - - If an instance allows optional characters, Unicode code points are encoded with a corresponding optional character instead of a modified base 64 character. The optional characters are exclamation point ("!"), backward slash ("\\"), vertical line ("|"), double quote ("""), number sign ("#"), dollar sign ("$"), percent sign ("%"), ampersand ("&"), asterisk ("*"), semicolon (";"), left angle bracket ("\<"), right angle bracket (">"), left curly bracket ("{"), right curly bracket ("}"), left square bracket ("["), right square bracket ("]"), equal sign ("="), at sign ("@"), circumflex accent ("^"), underscore ("_"), and grave accent ("`"). - -> [!NOTE] -> does not provide error detection. For security reasons, your applications are recommended to use , , or and enable error detection. - - - -## Examples - The following code example demonstrates how to create a new instance and display the name of the encoding. - - :::code language="csharp" source="~/snippets/csharp/System.Text/UTF7Encoding/.ctor/ctor.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Text/UTF7Encoding/.ctor/ctor.vb" id="Snippet1"::: - - ]]> - + To be added. @@ -209,25 +189,7 @@ to specify that optional characters are allowed; otherwise, . Initializes a new instance of the class. A parameter specifies whether to allow optional characters. - - "), left curly bracket ("{"), right curly bracket ("}"), left square bracket ("["), right square bracket ("]"), equal sign ("="), at sign ("@"), circumflex accent ("^"), underscore ("_"), and grave accent ("`"). - -> [!NOTE] -> does not provide error detection. For security reasons, your applications are recommended to use , , or and enable error detection. - - - -## Examples - The following code example demonstrates how to create a new instance that allows optional characters. - - :::code language="csharp" source="~/snippets/csharp/System.Text/UTF7Encoding/.ctor/ctor-boolean.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Text/UTF7Encoding/.ctor/ctor-boolean.vb" id="Snippet1"::: - - ]]> - + To be added. diff --git a/xml/System.Threading.Tasks/TaskCanceledException.xml b/xml/System.Threading.Tasks/TaskCanceledException.xml index 17342a92cd9..cdbfae05522 100644 --- a/xml/System.Threading.Tasks/TaskCanceledException.xml +++ b/xml/System.Threading.Tasks/TaskCanceledException.xml @@ -302,14 +302,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. Handling and Throwing Exceptions Task-based Asynchronous Programming Task Cancellation diff --git a/xml/System.Threading.Tasks/TaskSchedulerException.xml b/xml/System.Threading.Tasks/TaskSchedulerException.xml index 1f244edda2d..3fe74042859 100644 --- a/xml/System.Threading.Tasks/TaskSchedulerException.xml +++ b/xml/System.Threading.Tasks/TaskSchedulerException.xml @@ -298,14 +298,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System.Threading/AbandonedMutexException.xml b/xml/System.Threading/AbandonedMutexException.xml index 83ec3673a13..8a4ce21d957 100644 --- a/xml/System.Threading/AbandonedMutexException.xml +++ b/xml/System.Threading/AbandonedMutexException.xml @@ -324,14 +324,7 @@ The object that holds the serialized object data about the exception being thrown. The object that contains contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. Mutex diff --git a/xml/System.Threading/BarrierPostPhaseException.xml b/xml/System.Threading/BarrierPostPhaseException.xml index 8071929296d..68628eb7b30 100644 --- a/xml/System.Threading/BarrierPostPhaseException.xml +++ b/xml/System.Threading/BarrierPostPhaseException.xml @@ -274,14 +274,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System.Threading/LockRecursionException.xml b/xml/System.Threading/LockRecursionException.xml index c94635bb9e3..d0936a02cb3 100644 --- a/xml/System.Threading/LockRecursionException.xml +++ b/xml/System.Threading/LockRecursionException.xml @@ -261,14 +261,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System.Threading/Overlapped.xml b/xml/System.Threading/Overlapped.xml index 487c3a76f33..57274cf017f 100644 --- a/xml/System.Threading/Overlapped.xml +++ b/xml/System.Threading/Overlapped.xml @@ -171,16 +171,7 @@ The handle to an event that is signaled when the I/O operation is complete. An object that implements the interface and provides status information on the I/O operation. Initializes a new instance of the class with the specified file position, the 32-bit integer handle to an event that is signaled when the I/O operation is complete, and an interface through which to return the results of the operation. - - property to get the handle of any managed synchronization event that derives from the class. - - Your implementation of provides status information on the I/O operation. Pass it to the constructor in the `ar` parameter, and retrieve it later with the property. If a callback method is specified for the or method, the callback can retrieve your by unpacking the structure it receives. - - ]]> - + To be added. @@ -336,16 +327,7 @@ Gets or sets the 32-bit integer handle to a synchronization event that is signaled when the I/O operation is complete. An value representing the handle of the synchronization event. - - property instead. - - Use the property to get the handle of any managed synchronization event that derives from the class. - - ]]> - + To be added. @@ -617,17 +599,7 @@ An delegate that represents the callback method invoked when the asynchronous I/O operation completes. Packs the current instance into a structure, specifying the delegate to be invoked when the asynchronous I/O operation is complete. An unmanaged pointer to a structure. - - structure is fixed in physical memory until is called. - -> [!IMPORTANT] -> The caller is responsible for pinning the buffer. If the application domain is unloaded, however, the handle to the pinned buffer is destroyed and the buffer is released, leaving the I/O operation to write to the freed address. For this reason, it is better to use the method overload, in which the runtime pins the buffer. - - ]]> - + To be added. The current has already been packed. diff --git a/xml/System.Threading/SemaphoreFullException.xml b/xml/System.Threading/SemaphoreFullException.xml index 9478a89be8e..dcbf9776cfa 100644 --- a/xml/System.Threading/SemaphoreFullException.xml +++ b/xml/System.Threading/SemaphoreFullException.xml @@ -271,14 +271,7 @@ The object that holds the serialized object data about the exception being thrown. The object that contains contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. Semaphore diff --git a/xml/System.Threading/SynchronizationLockException.xml b/xml/System.Threading/SynchronizationLockException.xml index 0b7ddb866c4..a189a378e6e 100644 --- a/xml/System.Threading/SynchronizationLockException.xml +++ b/xml/System.Threading/SynchronizationLockException.xml @@ -245,14 +245,7 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System.Threading/Thread.xml b/xml/System.Threading/Thread.xml index feade230857..a7715701e11 100644 --- a/xml/System.Threading/Thread.xml +++ b/xml/System.Threading/Thread.xml @@ -822,18 +822,7 @@ Main thread: ThreadProc.Join has returned. Press Enter to end program. Gets or sets the apartment state of this thread. One of the values. The initial value is . - - property is obsolete.** The non-obsolete alternatives are the method to retrieve the apartment state and the method to set the apartment state. - -> [!IMPORTANT] -> New threads are initialized as if their apartment state has not been set before they're started. The main application thread is initialized to by default. - -You can specify the COM threading model for a C++ application using the [/CLRTHREADATTRIBUTE (Set CLR Thread Attribute)](/cpp/build/reference/clrthreadattribute-set-clr-thread-attribute) linker option. - - ]]> - + To be added. An attempt is made to set this property to a state that is not a valid apartment state (a state other than single-threaded apartment () or multithreaded apartment ()). diff --git a/xml/System.Threading/ThreadAbortException.xml b/xml/System.Threading/ThreadAbortException.xml index aa950b0e2ff..de48b7a4052 100644 --- a/xml/System.Threading/ThreadAbortException.xml +++ b/xml/System.Threading/ThreadAbortException.xml @@ -88,7 +88,6 @@ Main ending. ]]> - Destroying threads @@ -149,7 +148,6 @@ Main ending. ]]> - Destroying threads diff --git a/xml/System.Threading/ThreadInterruptedException.xml b/xml/System.Threading/ThreadInterruptedException.xml index 71ea0103d9d..2290992df78 100644 --- a/xml/System.Threading/ThreadInterruptedException.xml +++ b/xml/System.Threading/ThreadInterruptedException.xml @@ -244,14 +244,7 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. Pausing and Resuming Threads diff --git a/xml/System.Threading/ThreadStateException.xml b/xml/System.Threading/ThreadStateException.xml index 71b064bea33..efea6865994 100644 --- a/xml/System.Threading/ThreadStateException.xml +++ b/xml/System.Threading/ThreadStateException.xml @@ -268,14 +268,7 @@ In main. Attempting to restart myThread. The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System.Threading/WaitHandle.xml b/xml/System.Threading/WaitHandle.xml index a40b4b52029..59cf1f2fc5c 100644 --- a/xml/System.Threading/WaitHandle.xml +++ b/xml/System.Threading/WaitHandle.xml @@ -392,16 +392,7 @@ Gets or sets the native operating system handle. An representing the native operating system handle. The default is the value of the field. - - property does not close the previous handle. This can result in a leaked handle. - -Use the property instead. Setting this property to a valid handle also sets the property, but setting it to can result in a leaked handle. - - ]]> - + To be added. @@ -658,7 +649,7 @@ This operation is not guaranteed to be atomic. After the current thread signals If `millisecondsTimeout` is zero, the method does not block. It tests the state of the `toWaitOn` and returns immediately. -[!INCLUDE [Exit the context](~/includes/remarks/System.Threading/WaitHandle/exit-context.md)] +[!INCLUDE [Exit the context](~/includes/waithandle-exit-context.md)] ]]> @@ -735,7 +726,7 @@ If `millisecondsTimeout` is zero, the method does not block. It tests the state If `timeout` is zero, the method does not block. It tests the state of the `toWaitOn` and returns immediately. -[!INCLUDE [Exit the context](~/includes/remarks/System.Threading/WaitHandle/exit-context.md)] +[!INCLUDE [Exit the context](~/includes/waithandle-exit-context.md)] ]]> @@ -1088,7 +1079,7 @@ The method returns when the wait ter > [!NOTE] > The method is not supported on threads in state. -[!INCLUDE [Exit the context](~/includes/remarks/System.Threading/WaitHandle/exit-context.md)] +[!INCLUDE [Exit the context](~/includes/waithandle-exit-context.md)] ## Examples The following code example shows how to use the thread pool to asynchronously create and write to a group of files. Each write operation is queued as a work item and signals when it is finished. The main thread waits for all the items to signal and then exits. @@ -1184,7 +1175,7 @@ The method returns when the wait ter The maximum value for `timeout` is . -[!INCLUDE [Exit the context](~/includes/remarks/System.Threading/WaitHandle/exit-context.md)] +[!INCLUDE [Exit the context](~/includes/waithandle-exit-context.md)] ## Examples The following code example shows how to use the thread pool to asynchronously create and write to a group of files. Each write operation is queued as a work item and signals when it is finished. The main thread waits for all the items to signal and then exits. @@ -1527,7 +1518,7 @@ This method returns when the wait terminates, either when any of the handles are The maximum number of the wait handles is 64, and 63 if the current thread is in state. -[!INCLUDE [Exit the context](~/includes/remarks/System.Threading/WaitHandle/exit-context.md)] +[!INCLUDE [Exit the context](~/includes/waithandle-exit-context.md)] ## Examples The following code example demonstrates how to use the thread pool to simultaneously search for a file on multiple disks. For space considerations, only the root directory of each disk is searched. @@ -1614,7 +1605,7 @@ The maximum number of the wait handles is 64, and 63 if the current thread is in The maximum value for `timeout` is . -[!INCLUDE [Exit the context](~/includes/remarks/System.Threading/WaitHandle/exit-context.md)] +[!INCLUDE [Exit the context](~/includes/waithandle-exit-context.md)] ## Examples The following code example demonstrates how to use the thread pool to simultaneously search for a file on multiple disks. For space considerations, only the root directory of each disk is searched. @@ -1926,7 +1917,7 @@ The caller of this method blocks until the current instance receives a signal or Override this method to customize the behavior of derived classes. -[!INCLUDE [Exit the context](~/includes/remarks/System.Threading/WaitHandle/exit-context.md)] +[!INCLUDE [Exit the context](~/includes/waithandle-exit-context.md)] ## Examples The following example shows how the method overload behaves when it is called within a synchronization domain. First, a thread waits with `exitContext` set to `false` and blocks until the wait timeout expires. A second thread executes after the first thread terminates and waits with `exitContext` set to `true`. The call to signal the wait handle for this second thread is not blocked, and the thread completes before the wait timeout. @@ -2005,7 +1996,7 @@ Override this method to customize the behavior of derived classes. The maximum value for `timeout` is . -[!INCLUDE [Exit the context](~/includes/remarks/System.Threading/WaitHandle/exit-context.md)] +[!INCLUDE [Exit the context](~/includes/waithandle-exit-context.md)] ## Examples The following code example shows how to use a wait handle to keep a process from terminating while it waits for a background thread to finish executing. diff --git a/xml/System.Threading/WaitHandleCannotBeOpenedException.xml b/xml/System.Threading/WaitHandleCannotBeOpenedException.xml index 217058e8b05..fbb412dd485 100644 --- a/xml/System.Threading/WaitHandleCannotBeOpenedException.xml +++ b/xml/System.Threading/WaitHandleCannotBeOpenedException.xml @@ -240,14 +240,7 @@ The object that holds the serialized object data about the exception being thrown. The object that contains contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. diff --git a/xml/System.Web/AspNetHostingPermission.xml b/xml/System.Web/AspNetHostingPermission.xml index 5a09596951e..741d59b758c 100644 --- a/xml/System.Web/AspNetHostingPermission.xml +++ b/xml/System.Web/AspNetHostingPermission.xml @@ -235,7 +235,6 @@ The class of is or an empty string (""). - diff --git a/xml/System.Web/HttpUtility.xml b/xml/System.Web/HttpUtility.xml index c6eafe23ad1..71752c56fd6 100644 --- a/xml/System.Web/HttpUtility.xml +++ b/xml/System.Web/HttpUtility.xml @@ -2208,14 +2208,7 @@ The string to convert. Converts a string into a Unicode string. A Unicode string in % notation. - - are encoded as %3c and %3e. - - ]]> - + To be added. How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings @@ -2279,14 +2272,7 @@ The string to convert. Converts a Unicode string into an array of bytes. A byte array. - - are encoded as %3c and %3e. - - ]]> - + To be added. How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings diff --git a/xml/System.Windows.Data/CollectionView.xml b/xml/System.Windows.Data/CollectionView.xml index e4666aeb3e6..2b0535cd723 100644 --- a/xml/System.Windows.Data/CollectionView.xml +++ b/xml/System.Windows.Data/CollectionView.xml @@ -271,7 +271,6 @@ Clears any pending changes from the change log. To be added. - @@ -2323,7 +2322,6 @@ if it has been necessary to update the change log because a notification has been received on a different thread without first entering the user interface (UI) thread dispatcher; otherwise, . To be added. - diff --git a/xml/System.Windows.Data/ListCollectionView.xml b/xml/System.Windows.Data/ListCollectionView.xml index 7691605e0f3..f9097a1eac1 100644 --- a/xml/System.Windows.Data/ListCollectionView.xml +++ b/xml/System.Windows.Data/ListCollectionView.xml @@ -1936,14 +1936,7 @@ The object that is added to the change log. Called by the base class to notify the derived class that a event has been posted to the message queue. - - - + To be added. If is . diff --git a/xml/System.Windows.Forms/ContextMenu.xml b/xml/System.Windows.Forms/ContextMenu.xml index 4f79c44e451..5af14b00c85 100644 --- a/xml/System.Windows.Forms/ContextMenu.xml +++ b/xml/System.Windows.Forms/ContextMenu.xml @@ -317,9 +317,6 @@ This class is not available in .NET Core 3.1 and later versions. Use - - When overriding the method in a derived class, a control should return to indicate that it has processed the key. For keys that are not processed by the control, the result of calling the base class's method should be returned. Controls will seldom, if ever, need to override this method. - diff --git a/xml/System.Windows.Forms/Control.xml b/xml/System.Windows.Forms/Control.xml index 81f5b6fbe86..e538d4549aa 100644 --- a/xml/System.Windows.Forms/Control.xml +++ b/xml/System.Windows.Forms/Control.xml @@ -2817,9 +2817,6 @@ The following table lists Windows Forms controls and which event ( - - When overriding the property in a derived class, use the base class's property to extend the base implementation. Otherwise, you must provide all the implementation. You are not required to override both the and accessors of the property; you can override only one if needed. - @@ -11410,9 +11407,6 @@ The following code example displays a message box indicating whether the specifi ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - diff --git a/xml/System.Windows.Forms/DataGrid.xml b/xml/System.Windows.Forms/DataGrid.xml index 21689899884..013ab9c3c8c 100644 --- a/xml/System.Windows.Forms/DataGrid.xml +++ b/xml/System.Windows.Forms/DataGrid.xml @@ -3128,9 +3128,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -3190,9 +3187,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -3306,9 +3300,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -3392,9 +3383,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -3428,9 +3416,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -3464,9 +3449,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -3500,9 +3482,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -3536,9 +3515,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -3572,9 +3548,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -3608,9 +3581,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -3644,9 +3614,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -3687,9 +3654,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method. - @@ -3721,9 +3685,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method. - @@ -3755,9 +3716,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method. - @@ -3789,9 +3747,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method. - @@ -3823,9 +3778,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method. - @@ -3883,9 +3835,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method. - @@ -3952,9 +3901,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -4016,9 +3962,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -4050,9 +3993,6 @@ This class is not available in .NET Core 3.1 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method. - diff --git a/xml/System.Windows.Forms/DataGridColumnStyle.xml b/xml/System.Windows.Forms/DataGridColumnStyle.xml index 427b8473b5d..3121cdeaa0e 100644 --- a/xml/System.Windows.Forms/DataGridColumnStyle.xml +++ b/xml/System.Windows.Forms/DataGridColumnStyle.xml @@ -93,9 +93,6 @@ ]]> - - When you inherit from , you must override the following members: , , , and (twice). - @@ -459,13 +456,6 @@ ]]> - - The method should be used by classes derived from the class to reset their editing state, for example, to concede the focus if the hosts an editing control. See the method. - - Call the method when the receives a request to complete editing. If this is not possible without error, return . - - The method is called by the public method of the control. The method is also called by other private methods, for example, when the current row is changed. - diff --git a/xml/System.Windows.Forms/DataGridTableStyle.xml b/xml/System.Windows.Forms/DataGridTableStyle.xml index 445e55e0db1..50da706596b 100644 --- a/xml/System.Windows.Forms/DataGridTableStyle.xml +++ b/xml/System.Windows.Forms/DataGridTableStyle.xml @@ -1648,9 +1648,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -1686,9 +1683,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -1724,9 +1718,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -1762,9 +1753,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -1800,9 +1788,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -1838,9 +1823,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -1876,9 +1858,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -1914,9 +1893,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -1952,9 +1928,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -1990,9 +1963,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -2028,9 +1998,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -2066,9 +2033,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -2104,9 +2068,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -2142,9 +2103,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -2180,9 +2138,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -2218,9 +2173,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -2256,9 +2208,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -2294,9 +2243,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -2332,9 +2278,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -2370,9 +2313,6 @@ private void PrintCurrentListName(DataGrid myDataGrid){ ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - diff --git a/xml/System.Windows.Forms/Form.xml b/xml/System.Windows.Forms/Form.xml index 275aa0a3b87..3ebccf7ee03 100644 --- a/xml/System.Windows.Forms/Form.xml +++ b/xml/System.Windows.Forms/Form.xml @@ -4578,9 +4578,6 @@ By default Windows Forms anchors MDI children to the bottom left of the parent f ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -4644,9 +4641,6 @@ By default Windows Forms anchors MDI children to the bottom left of the parent f ]]> - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - diff --git a/xml/System.Windows.Forms/GridColumnStylesCollection.xml b/xml/System.Windows.Forms/GridColumnStylesCollection.xml index d7599201e03..8f905863a03 100644 --- a/xml/System.Windows.Forms/GridColumnStylesCollection.xml +++ b/xml/System.Windows.Forms/GridColumnStylesCollection.xml @@ -617,9 +617,6 @@ ]]> - - When overriding in a derived class, be sure to call the base class's method. - diff --git a/xml/System.Windows.Forms/MainMenu.xml b/xml/System.Windows.Forms/MainMenu.xml index c7393583e97..7e0fc4e5fd4 100644 --- a/xml/System.Windows.Forms/MainMenu.xml +++ b/xml/System.Windows.Forms/MainMenu.xml @@ -395,9 +395,6 @@ This class is not available in .NET Core 3.1 and later versions. Use - - When overriding in a derived class, be sure to call the base class' method so that registered delegates receive the event. - diff --git a/xml/System.Windows.Forms/MenuItem.xml b/xml/System.Windows.Forms/MenuItem.xml index 9ab3511b735..bf929973568 100644 --- a/xml/System.Windows.Forms/MenuItem.xml +++ b/xml/System.Windows.Forms/MenuItem.xml @@ -1240,9 +1240,6 @@ This class is not available in .NET Core 3.1 and later versions. Use - - When overriding in a derived class, be sure to call the base class's method. - @@ -1276,9 +1273,6 @@ This class is not available in .NET Core 3.1 and later versions. Use - - When overriding in a derived class, be sure to call the base class's method. - @@ -1343,9 +1337,6 @@ This class is not available in .NET Core 3.1 and later versions. Use - - When overriding in a derived class, be sure to call the base class's method. - @@ -1387,9 +1378,6 @@ This class is not available in .NET Core 3.1 and later versions. Use - - When overriding in a derived class, be sure to call the base class's method. - @@ -1430,9 +1418,6 @@ This class is not available in .NET Core 3.1 and later versions. Use - - When overriding in a derived class, be sure to call the base class's method. - diff --git a/xml/System.Windows.Forms/PictureBox.xml b/xml/System.Windows.Forms/PictureBox.xml index c3309f8861b..5a2d0ed3794 100644 --- a/xml/System.Windows.Forms/PictureBox.xml +++ b/xml/System.Windows.Forms/PictureBox.xml @@ -1226,7 +1226,7 @@ @@ -1272,7 +1272,7 @@ If the `url` parameter indicates a local file, the recommended format is a local ### Load behavior changes -[!INCLUDE[drawing](~/includes/System.Windows.Forms.PictureBox/load-behavior-changes.md)] +[!INCLUDE[drawing](~/includes/picturebox-load-behavior-changes.md)] ]]> @@ -1332,7 +1332,7 @@ This method stores in the task it returns all non-usage exceptions that the meth ### Load behavior changes -[!INCLUDE[drawing](~/includes/System.Windows.Forms.PictureBox/load-behavior-changes.md)] +[!INCLUDE[drawing](~/includes/picturebox-load-behavior-changes.md)] ]]> @@ -1379,7 +1379,7 @@ This method stores in the task it returns all non-usage exceptions that the meth ### Load behavior changes -[!INCLUDE[drawing](~/includes/System.Windows.Forms.PictureBox/load-behavior-changes.md)] +[!INCLUDE[drawing](~/includes/picturebox-load-behavior-changes.md)] ## Examples diff --git a/xml/System.Windows.Forms/StatusBar.xml b/xml/System.Windows.Forms/StatusBar.xml index 26acee2ffb7..4b24e3ee6f6 100644 --- a/xml/System.Windows.Forms/StatusBar.xml +++ b/xml/System.Windows.Forms/StatusBar.xml @@ -489,12 +489,6 @@ This class is not available in .NET 5 and later versions. Use the - - - can be called multiple times by other objects. When overriding , be careful not to reference objects that have been previously disposed of in an earlier call to . For more information about how to implement , see Implementing a Dispose Method. - - For more information about and , see Cleaning Up Unmanaged Resources. - @@ -814,9 +808,6 @@ This class is not available in .NET 5 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -884,9 +875,6 @@ This class is not available in .NET 5 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method. - @@ -918,9 +906,6 @@ This class is not available in .NET 5 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method. - @@ -952,9 +937,6 @@ This class is not available in .NET 5 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method. - @@ -990,9 +972,6 @@ This class is not available in .NET 5 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -1026,9 +1005,6 @@ This class is not available in .NET 5 and later versions. Use the - - When overriding in a derived class, be sure to call the base class's method. - diff --git a/xml/System.Windows.Forms/StatusBarPanel.xml b/xml/System.Windows.Forms/StatusBarPanel.xml index 3ec73a2c56e..2014c45407f 100644 --- a/xml/System.Windows.Forms/StatusBarPanel.xml +++ b/xml/System.Windows.Forms/StatusBarPanel.xml @@ -353,12 +353,6 @@ This class is not available in .NET 5 and later versions. Use the - - - can be called multiple times by other objects. When overriding be careful not to reference objects that have been previously disposed of in an earlier call to . For more information about how to implement , see Implementing a Dispose Method. - - For more information about and , see Cleaning Up Unmanaged Resources. - diff --git a/xml/System.Windows.Forms/ToolBar.xml b/xml/System.Windows.Forms/ToolBar.xml index aa62c2a374a..aa87baf4acd 100644 --- a/xml/System.Windows.Forms/ToolBar.xml +++ b/xml/System.Windows.Forms/ToolBar.xml @@ -860,12 +860,6 @@ This class is not available in .NET Core 3.1 and later versions. Use - - - can be called multiple times by other objects. When overriding be careful not to reference objects that have been previously disposed of in an earlier call to . For more information about how to implement , see Implementing a Dispose Method. - - For more information about and , see Cleaning Up Unmanaged Resources. - @@ -1293,9 +1287,6 @@ This class is not available in .NET Core 3.1 and later versions. Use - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - @@ -1333,9 +1324,6 @@ This class is not available in .NET Core 3.1 and later versions. Use - - When overriding in a derived class, be sure to call the base class's method so that registered delegates receive the event. - diff --git a/xml/System.Windows.Forms/ToolBarButton.xml b/xml/System.Windows.Forms/ToolBarButton.xml index 66a089162ce..983d467d612 100644 --- a/xml/System.Windows.Forms/ToolBarButton.xml +++ b/xml/System.Windows.Forms/ToolBarButton.xml @@ -199,12 +199,6 @@ This class is not available in .NET Core 3.1 and later versions. Use - - - can be called multiple times by other objects. When overriding be careful not to reference objects that have been previously disposed of in an earlier call to . For more information about how to implement , see Implementing a Dispose Method. - - For more information about and , see Cleaning Up Unmanaged Resources. - diff --git a/xml/System.Windows.Markup/IReceiveMarkupExtension.xml b/xml/System.Windows.Markup/IReceiveMarkupExtension.xml index 00d0544d800..b5f1b7846ba 100644 --- a/xml/System.Windows.Markup/IReceiveMarkupExtension.xml +++ b/xml/System.Windows.Markup/IReceiveMarkupExtension.xml @@ -27,18 +27,7 @@ Provides a mechanism whereby types can declare that they can receive an expression (or another class) from a markup extension, where the output is a different property type than the target property. Do not use for .NET Framework 4 implementations. - - was a WPF-specific technique for permitting types to enter a different codepath whenever any of its XAML-accessible members where set as markup extensions during XAML parsing. In .NET Framework 4, this interface is obsolete, and is replaced with a .NET Framework XAML Services implementation for how markup extensions can receive services or types can invoke markup-extension specific setter logic. - - For .NET Framework 4 implementations, if types want to perform special processing when setting properties by markup extension rather than by other means, types should be defined with attributes applied. The attribute specifies a callback, which is typically defined as a private member of the type. - - In infrastructure implementations of WPF classes, most cases where is applied reference a `ReceiveMarkupExtension` method that previously implemented this interface, but now instead use context through the callback. - - ]]> - + To be added. Type Converters and Markup Extensions for XAML diff --git a/xml/System.Windows.Media.Effects/BitmapEffect.xml b/xml/System.Windows.Media.Effects/BitmapEffect.xml index f7eaa0cd291..8d28896e6ed 100644 --- a/xml/System.Windows.Media.Effects/BitmapEffect.xml +++ b/xml/System.Windows.Media.Effects/BitmapEffect.xml @@ -185,14 +185,7 @@ Creates a handle to an IMILBitmapEffect object that is used to initialize a custom effect. A handle to an IMILBitmapEffect object. - - method. - - ]]> - + To be added. @@ -345,14 +338,7 @@ The name of the property to change. The value to use to set the property. Sets the specified property to the given value. - - . When you override , use to update unmanaged property values. - - ]]> - + To be added. @@ -389,14 +375,7 @@ The handle to the effect that contains the properties to update. When overridden in a derived class, updates the property states of the unmanaged properties of the effect. - - . - - ]]> - + To be added. diff --git a/xml/System.Windows.Media.Media3D/Viewport3DVisual.xml b/xml/System.Windows.Media.Media3D/Viewport3DVisual.xml index c1f685c8a92..67ea9fbd7b9 100644 --- a/xml/System.Windows.Media.Media3D/Viewport3DVisual.xml +++ b/xml/System.Windows.Media.Media3D/Viewport3DVisual.xml @@ -96,14 +96,7 @@ Gets or sets the applied to the Viewport3DVisual. BitmapEffect applied to the Viewport3DVisual. - - - + To be added. @@ -137,16 +130,7 @@ Gets or sets the applied to the . BitmapEffectInput applied to the Viewport3DVisual. - - applies the given in the property to a specified region of the visual object. - - Bitmap effects are software-rendered. Any object that applies an effect will also be rendered in software. Bitmap effects should not be applied to large visuals or animations as this can degrade performance. - - ]]> - + To be added. diff --git a/xml/System.Windows.Media/DrawingContext.xml b/xml/System.Windows.Media/DrawingContext.xml index 1ac65cc32c7..e9cc5dd6f14 100644 --- a/xml/System.Windows.Media/DrawingContext.xml +++ b/xml/System.Windows.Media/DrawingContext.xml @@ -943,13 +943,7 @@ The effect to apply to subsequent drawings. The area to which the effect is applied, or if the effect is to be applied to the entire area of subsequent drawings. Pushes the specified onto the drawing context. - - command. - - ]]> - + To be added. diff --git a/xml/System.Windows.Media/FormattedText.xml b/xml/System.Windows.Media/FormattedText.xml index 1bf9dbc1176..8d45aff5355 100644 --- a/xml/System.Windows.Media/FormattedText.xml +++ b/xml/System.Windows.Media/FormattedText.xml @@ -2087,7 +2087,6 @@ Example of text decoration types ]]> - diff --git a/xml/System.Windows.Media/Visual.xml b/xml/System.Windows.Media/Visual.xml index fde45be8475..3343d7c4d80 100644 --- a/xml/System.Windows.Media/Visual.xml +++ b/xml/System.Windows.Media/Visual.xml @@ -891,7 +891,6 @@ Visual class hierarchy Gets or sets the value for the . The bitmap effect for this visual object. To be added. - @@ -926,7 +925,6 @@ Visual class hierarchy Gets or sets the value for the . The bitmap effect input value for this visual object. To be added. - diff --git a/xml/System.Windows/UIElement.xml b/xml/System.Windows/UIElement.xml index a1f638052d0..6ac75323b82 100644 --- a/xml/System.Windows/UIElement.xml +++ b/xml/System.Windows/UIElement.xml @@ -942,23 +942,7 @@ Gets or sets a bitmap effect that applies directly to the rendered content for this element. This is a dependency property. The bitmap effect to apply. - - is an abstract type, therefore the XAML usage requires an implemented derived class of , such as . Note that one implemented derived class is a collection type that allows you to specify more than one sequential , using a nested tag syntax. - - No existing derived class of supports a type converter, so the XAML syntax that you use for this property is generally property element syntax. - - -## Dependency Property Information - -| Item | Value | -|-----------------------------------|------------------------------------------------------| -| Identifier field | | -| Metadata properties set to `true` | None | - - ]]> - + To be added. @@ -992,21 +976,7 @@ Gets or sets an input source for the bitmap effect that applies directly to the rendered content for this element. This is a dependency property. The source for bitmap effects. - - -## Dependency Property Information - -| Item | Value | -|-----------------------------------|--------------------------------------------------------| -|Identifier field|| -|Metadata properties set to `true`|None| - - ]]> - + To be added. @@ -11358,16 +11328,7 @@ For this call to be successful, some other element in the application needed to Gets a value that uniquely identifies this element. The unique identifier for this element. - - uniquely identifies each element. An element keeps the same every time the same Extensible Application Markup Language (XAML) is loaded (including binary representations). This identifier is used for internal loading, parsing and serialization requirements. It is not intended to be used by your application code. - - This property has no relationship to the result for any given instance. - - ]]> - + To be added. diff --git a/xml/System.Xml.Schema/XmlSchemaInferenceException.xml b/xml/System.Xml.Schema/XmlSchemaInferenceException.xml index 885d805ce38..9ff4e77f70d 100644 --- a/xml/System.Xml.Schema/XmlSchemaInferenceException.xml +++ b/xml/System.Xml.Schema/XmlSchemaInferenceException.xml @@ -192,14 +192,7 @@ A object. A object. Initializes a new instance of the class with the and objects specified that contain all the properties of the . - - - + To be added. diff --git a/xml/System.Xml.Schema/XmlSchemaType.xml b/xml/System.Xml.Schema/XmlSchemaType.xml index 8b3ce6adf34..efcde981469 100644 --- a/xml/System.Xml.Schema/XmlSchemaType.xml +++ b/xml/System.Xml.Schema/XmlSchemaType.xml @@ -157,17 +157,7 @@ Gets the post-compilation object type or the built-in XML Schema Definition Language (XSD) data type, simpleType element, or complexType element. This is a post-schema-compilation infoset property. The built-in XSD data type, simpleType element, or complexType element. - - [!IMPORTANT] -> The property is obsolete and has been replaced by the property. - - ]]> - + To be added. diff --git a/xml/System.Xml.Schema/XmlSchemaValidationException.xml b/xml/System.Xml.Schema/XmlSchemaValidationException.xml index e590eba6f8c..71865b8f616 100644 --- a/xml/System.Xml.Schema/XmlSchemaValidationException.xml +++ b/xml/System.Xml.Schema/XmlSchemaValidationException.xml @@ -192,14 +192,7 @@ A object. A object. Initializes a new instance of the class with the and objects specified. - - - + To be added. diff --git a/xml/System.Xml/XmlDataDocument.xml b/xml/System.Xml/XmlDataDocument.xml index 792ec081aea..8517b94850c 100644 --- a/xml/System.Xml/XmlDataDocument.xml +++ b/xml/System.Xml/XmlDataDocument.xml @@ -52,20 +52,7 @@ Allows structured data to be stored, retrieved, and manipulated through a relational . - - . It enables you to load either relational data or XML data and manipulate that data using the World Wide Web Consortium (W3C) Document Object Model (DOM). The DOM presents data as a hierarchy of node objects. Because `XmlDataDocument` implements the interface, it can also be used as the source document for the class. - - `XmlDataDocument` has a close affiliation with the `DataSet` class, which provides a relational view of the loaded XML data. Any changes made to the `XmlDataDocument` are reflected in the `DataSet` and vice versa. - - To load a `DataSet` with XML data, use to build a relational mapping. The XML data can then be loaded using or . - - To load relational data, specify the `DataSet` containing the relational data as the parameter in the constructor. - - ]]> - + To be added. diff --git a/xml/System.Xml/XmlReader.xml b/xml/System.Xml/XmlReader.xml index 30586e88de5..7ef5f62d7c3 100644 --- a/xml/System.Xml/XmlReader.xml +++ b/xml/System.Xml/XmlReader.xml @@ -4275,8 +4275,6 @@ An asynchronous method was called without For the asynchronous version of this method, see . - - ## Examples The following example reads an XML file and displays each of the nodes: @@ -4289,7 +4287,7 @@ An asynchronous method was called without **Output:** - [!INCLUDE [xmlreader-read-sample-output](~/includes/xmlreader-read-sample-output.md)] +[!INCLUDE[XmlReader Read output](~/includes/xmlreader-read-output.md)] ]]> diff --git a/xml/System.Xml/XmlReaderSettings.xml b/xml/System.Xml/XmlReaderSettings.xml index fba4d597c77..f95d7142d68 100644 --- a/xml/System.Xml/XmlReaderSettings.xml +++ b/xml/System.Xml/XmlReaderSettings.xml @@ -1180,17 +1180,7 @@ There is an error in XML document (MaxCharactersInDocument, ). Gets or sets a value indicating whether to prohibit document type definition (DTD) processing. This property is obsolete. Use instead. to prohibit DTD processing; otherwise . The default is . - - throws an when any DTD content is encountered. Do not enable DTD processing if you are concerned about Denial of Service issues or if you are dealing with untrusted sources. - - If you have DTD processing enabled, you can use to restrict the resources that the can access. You can also design your application so that the XML processing is memory and time constrained. For example, configure time-out limits in your ASP.NET application. - - This property is obsolete. Use instead. If you had set to its default value `true` set to `Prohibit`. If you had set to `false` set to `Parse`. - - ]]> - + This property is obsolete. Use instead. If you had set to its default value , set to . If you had set to , set to . diff --git a/xml/System.Xml/XmlTextReader.xml b/xml/System.Xml/XmlTextReader.xml index ab9afe6c5a3..0ddf0c9ea04 100644 --- a/xml/System.Xml/XmlTextReader.xml +++ b/xml/System.Xml/XmlTextReader.xml @@ -3575,20 +3575,7 @@ abc Gets or sets a value indicating whether to allow DTD processing. This property is obsolete. Use instead. to disallow DTD processing; otherwise . The default is . - - [!NOTE] -> We recommend that you create instances by using the method to take advantage of new functionality. - - DTD processing is enabled by default for backwards compatibility. However, unless your application requires DTD processing, you should disable this setting. Disabling DTD processing can be useful in preventing certain denial of service attacks. If set to `true`, the reader throws an when any DTD content is encountered. - - If you have DTD processing enabled, you need to be aware of including DTDs from untrusted sources and possible denial of service attacks. Use to restrict the resources that the can access. You can also design your application so that the XML processing is memory and time constrained. For example, configure time-out limits in your ASP.NET application. - - ]]> - + To be added. diff --git a/xml/System/AccessViolationException.xml b/xml/System/AccessViolationException.xml index 0c382dd346f..a7d183412b2 100644 --- a/xml/System/AccessViolationException.xml +++ b/xml/System/AccessViolationException.xml @@ -251,14 +251,7 @@ In either case, you can identify and correct the cause of the The that holds the serialized object data. The that contains contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/AggregateException.xml b/xml/System/AggregateException.xml index a39b7685652..9775602c009 100644 --- a/xml/System/AggregateException.xml +++ b/xml/System/AggregateException.xml @@ -362,14 +362,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. The argument is null. The exception could not be deserialized correctly. XML and SOAP Serialization @@ -742,14 +735,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. The argument is null. XML and SOAP Serialization diff --git a/xml/System/AppDomain.xml b/xml/System/AppDomain.xml index 8579042dbc2..68a480c983a 100644 --- a/xml/System/AppDomain.xml +++ b/xml/System/AppDomain.xml @@ -527,16 +527,7 @@ The Resets the list of directories containing shadow copied assemblies to the empty string (""). - - and [Shadow Copying Assemblies](/dotnet/framework/app-domains/shadow-copy-assemblies). - - ]]> - + To be added. The operation is attempted on an unloaded application domain. Shadow Copying Assemblies @@ -2894,14 +2885,7 @@ The friendly name of the default application domain is the file name of the proc Gets the current thread identifier. A 32-bit signed integer that is the identifier of the current thread. - - property, which is stable even when .NET is hosted by an environment that supports fibers (that is, lightweight threads). - - ]]> - + To be added. @@ -4365,16 +4349,7 @@ The The fully qualified path to the shadow copy location. Establishes the specified directory path as the location where assemblies are shadow copied. - - property is not set. See the property. - - For more information on shadow copying see [Shadow Copying Assemblies](/dotnet/framework/app-domains/shadow-copy-assemblies). - - ]]> - + To be added. The operation is attempted on an unloaded application domain. Shadow Copying Assemblies @@ -4531,14 +4506,7 @@ The The fully qualified path that is the base directory for subdirectories where dynamic assemblies are stored. Establishes the specified directory path as the base directory for subdirectories where dynamically generated files are stored and accessed. - - property of the internal associated with this instance. - - ]]> - + To be added. The operation is attempted on an unloaded application domain. @@ -4665,14 +4633,7 @@ The Turns on shadow copying. - - - + To be added. The operation is attempted on an unloaded application domain. Shadow Copying Assemblies @@ -4737,20 +4698,7 @@ The A list of directory names, where each name is separated by a semicolon. Establishes the specified directory path as the location of assemblies to be shadow copied. - - method restricts the shadow copy to the assemblies in the directories specified by `path`. - - The method does not specify additional directories to be searched for assemblies. Assemblies to be shadow-copied must already be located in the search path, for example under . The method specifies which search paths are eligible to be shadow-copied. - - This method sets the property of the internal associated with this instance. - - For more information on shadow copying, see [Shadow Copying Assemblies](/dotnet/framework/app-domains/shadow-copy-assemblies). - - ]]> - + To be added. The operation is attempted on an unloaded application domain. Shadow Copying Assemblies diff --git a/xml/System/AppDomainUnloadedException.xml b/xml/System/AppDomainUnloadedException.xml index dcfc72e99e9..b411f741658 100644 --- a/xml/System/AppDomainUnloadedException.xml +++ b/xml/System/AppDomainUnloadedException.xml @@ -262,14 +262,7 @@ An that is not handled in user code has The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/ApplicationException.xml b/xml/System/ApplicationException.xml index 3c5f6bf7fd2..26690bfa47b 100644 --- a/xml/System/ApplicationException.xml +++ b/xml/System/ApplicationException.xml @@ -238,15 +238,8 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - - XML and Soap Serialization + To be added. + XML and SOAP serialization @@ -301,10 +294,10 @@ The following table shows the initial property values for an instance of . -|Property|Value| -|--------------|-----------| -||The inner exception reference.| -||The error message string.| +| Property | Value | +|-----------------------------------------|--------------------------------| +| | The inner exception reference. | +| | The error message string. | ]]> diff --git a/xml/System/ArgumentException.xml b/xml/System/ArgumentException.xml index d5c522294fc..31475557ed1 100644 --- a/xml/System/ArgumentException.xml +++ b/xml/System/ArgumentException.xml @@ -278,14 +278,7 @@ The following example demonstrates how to throw and catch an The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization @@ -547,16 +540,7 @@ The following example demonstrates how to throw and catch an The object that holds the serialized object data. The contextual information about the source or destination. Sets the object with the parameter name and additional exception information. - - sets a with all the exception object data targeted for serialization. During deserialization, the exception object is reconstituted from the transmitted over the stream. - - For more information, see . - - ]]> - + To be added. The object is a null reference ( in Visual Basic). XML and SOAP Serialization diff --git a/xml/System/ArgumentNullException.xml b/xml/System/ArgumentNullException.xml index f2244295d41..99ec34ac6c1 100644 --- a/xml/System/ArgumentNullException.xml +++ b/xml/System/ArgumentNullException.xml @@ -257,14 +257,7 @@ The object that holds the serialized object data. An object that describes the source or destination of the serialized data. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/ArgumentOutOfRangeException.xml b/xml/System/ArgumentOutOfRangeException.xml index 634e014cd17..33563d1db0d 100644 --- a/xml/System/ArgumentOutOfRangeException.xml +++ b/xml/System/ArgumentOutOfRangeException.xml @@ -429,14 +429,7 @@ The following example defines a class to contain information about an invited gu The object that holds the serialized object data. An object that describes the source or destination of the serialized data. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization @@ -738,16 +731,7 @@ The following example defines a class to contain information about an invited gu The object that holds the serialized object data. An object that describes the source or destination of the serialized data. Sets the object with the invalid argument value and additional exception information. - - sets a object with all the exception object data targeted for serialization. During deserialization, the exception object is reconstituted from the transmitted over the stream. - - For more information, see . - - ]]> - + To be added. The object is . diff --git a/xml/System/ArithmeticException.xml b/xml/System/ArithmeticException.xml index 3c42fb86800..e45e9e56b7e 100644 --- a/xml/System/ArithmeticException.xml +++ b/xml/System/ArithmeticException.xml @@ -260,14 +260,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/ArrayTypeMismatchException.xml b/xml/System/ArrayTypeMismatchException.xml index db372809b76..514fc80cbce 100644 --- a/xml/System/ArrayTypeMismatchException.xml +++ b/xml/System/ArrayTypeMismatchException.xml @@ -284,14 +284,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/BadImageFormatException.xml b/xml/System/BadImageFormatException.xml index e64b5a99785..11cbb9106eb 100644 --- a/xml/System/BadImageFormatException.xml +++ b/xml/System/BadImageFormatException.xml @@ -287,14 +287,7 @@ For a list of initial property values for an instance of The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. diff --git a/xml/System/CannotUnloadAppDomainException.xml b/xml/System/CannotUnloadAppDomainException.xml index d36f8a1e24d..876aa7d764a 100644 --- a/xml/System/CannotUnloadAppDomainException.xml +++ b/xml/System/CannotUnloadAppDomainException.xml @@ -263,14 +263,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class from serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/DateTime.xml b/xml/System/DateTime.xml index 61eba18e353..3c25710c435 100644 --- a/xml/System/DateTime.xml +++ b/xml/System/DateTime.xml @@ -3820,7 +3820,7 @@ The return value is a whose p ## Remarks > [!IMPORTANT] -> You should not assume that multiple calls to the overloads will return identical data. Depending on the specific overload, the data returned by this method can change if the current culture changes, the user overrides individual cultural settings, or an update occurs to the system's cultural data. +> You should not assume that multiple calls to the overloads will return identical data. Depending on the specific overload, the data returned by this method can change if the current culture changes, the user overrides individual cultural settings, or an update occurs to the system's cultural data. ]]> @@ -3877,7 +3877,7 @@ The return value is a whose p Each element of the return value is formatted using information from the current culture. For more information about culture-specific formatting information for the current culture, see . > [!IMPORTANT] -> Because this method uses culture-sensitive data, you should not assume that multiple calls to the method will return identical data. The data returned by this method can change if the current culture changes, the user overrides individual cultural settings, or an update occurs to the system's cultural data. +> Because this method uses culture-sensitive data, you should not assume that multiple calls to the method will return identical data. The data returned by this method can change if the current culture changes, the user overrides individual cultural settings, or an update occurs to the system's cultural data. @@ -4084,7 +4084,7 @@ July, 2009 Each element of the return value is formatted using information from the current culture. For more information about culture-specific formatting information for the current culture, see . > [!IMPORTANT] -> Because this method uses culture-sensitive data, you should not assume that multiple calls to the method will return identical data. The data returned by this method can change if the current culture changes, the user overrides individual cultural settings, or an update occurs to the system's cultural data. +> Because this method uses culture-sensitive data, you should not assume that multiple calls to the method will return identical data. The data returned by this method can change if the current culture changes, the user overrides individual cultural settings, or an update occurs to the system's cultural data. @@ -4163,7 +4163,7 @@ July, 2009 Each element of the return value is formatted using culture-specific information supplied by `provider`. > [!IMPORTANT] -> Because this method uses culture-sensitive data, you should not assume that multiple calls to the method will return identical data unless `provider` is a object that represents the invariant culture. The data returned by this method can change if the user overrides the individual cultural settings of `provider` or if an update occurs to the system's cultural data for `provider`. +> Because this method uses culture-sensitive data, you should not assume that multiple calls to the method will return identical data unless `provider` is a object that represents the invariant culture. The data returned by this method can change if the user overrides the individual cultural settings of `provider` or if an update occurs to the system's cultural data for `provider`. @@ -4349,7 +4349,7 @@ juillet 2009 Each element of the return value is formatted using culture-specific information supplied by `provider`. > [!IMPORTANT] -> Because this method uses culture-sensitive data, you should not assume that multiple calls to the method will return identical data unless `provider` is a object that represents the invariant culture. The data returned by this method can change if the user overrides the individual cultural settings of `provider` or if an update occurs to the system's cultural data for `provider`. +> Because this method uses culture-sensitive data, you should not assume that multiple calls to the method will return identical data unless `provider` is a object that represents the invariant culture. The data returned by this method can change if the user overrides the individual cultural settings of `provider` or if an update occurs to the system's cultural data for `provider`. @@ -4572,8 +4572,6 @@ juillet 2009 If the current value represents either an ambiguous or an invalid time in the local time zone, the method returns `false`. - On Windows XP systems, the method recognizes only the current adjustment rule when determining whether the current instance is a daylight saving time. As a result, the method may not accurately report whether the current instance is a daylight saving time for periods before the current adjustment rule came into effect. - ]]> @@ -5131,7 +5129,7 @@ juillet 2009 The return value is a whose property returns . > [!NOTE] -> You can also use the property to retrieve the current local date and time. It allows a local time to be expressed unambiguously as a single point in time, which in turn makes that time value portable across computers. +> You can also use the property to retrieve the current local date and time. It allows a local time to be expressed unambiguously as a single point in time, which in turn makes that time value portable across computers. @@ -5641,7 +5639,7 @@ The return value is a whose p The method does not consider the value of the property of the two values when performing the subtraction. Before subtracting objects, ensure that the objects represent times in the same time zone. Otherwise, the result will include the difference between time zones. > [!NOTE] -> The method does consider the difference between time zones when performing the subtraction. +> The method does consider the difference between time zones when performing the subtraction. The equivalent method for this operator is @@ -5768,7 +5766,7 @@ The return value is a whose p The method tries to convert the string representation of a date and time value to its equivalent. It tries to parse the input string completely without throwing a exception. When using overloads that accept an object, it will be used to parse `StringToParse`. If no such object is provided, will be used instead. > [!IMPORTANT] -> If the parsing operation fails because of an unrecognized string format, the method throws a , whereas the method returns `false`. Because exception handling can be expensive, you should use when the parsing operation is expected to succeed because the input source is trusted. is preferable when parsing failures are likely, particularly because an input source is not trusted, or you have reasonable default values to substitute for strings that do not parse successfully. +> If the parsing operation fails because of an unrecognized string format, the method throws a , whereas the method returns `false`. Because exception handling can be expensive, you should use when the parsing operation is expected to succeed because the input source is trusted. is preferable when parsing failures are likely, particularly because an input source is not trusted, or you have reasonable default values to substitute for strings that do not parse successfully. The string to be parsed can take any of the following forms: @@ -5825,15 +5823,15 @@ The following example parses strings in each of these formats by using the forma If you parse a date and time string by using a object with customized settings that are different from those of a standard culture, use the method instead of the method to improve the chances for a successful conversion. A non-standard date and time string can be complicated and difficult to parse. The method tries to parse a string with several implicit parse patterns, all of which might fail. In contrast, the method requires you to explicitly designate one or more exact parse patterns that are likely to succeed. For more information, see the "DateTimeFormatInfo and Dynamic Data" section in the topic. > [!IMPORTANT] -> Note that the formatting conventions for a particular culture are dynamic and can be subject to change. This means that parsing operations that depend on the formatting conventions of the default (current) culture or that specify an object that represents a culture other than the invariant culture can unexpectedly fail if any of the following occurs: +> Note that the formatting conventions for a particular culture are dynamic and can be subject to change. This means that parsing operations that depend on the formatting conventions of the default (current) culture or that specify an object that represents a culture other than the invariant culture can unexpectedly fail if any of the following occurs: > > - The culture-specific data has changed between major or minor versions of .NET or as the result of an update to the existing version of .NET. > - The culture-specific data reflects user preferences, which can vary from machine to machine or session to session. > - The culture-specific data represents a replacement culture that overrides the settings of a standard culture or a custom culture. > -> To prevent the difficulties in parsing data and time strings that are associated with changes in cultural data, you can parse date and time strings by using the invariant culture, or you can call the or method and specify the exact format of the string to be parsed. If you are serializing and deserializing date and time data, you can either use the formatting conventions of the invariant culture, or you can serialize and deserialize the value in a binary format. +> To prevent the difficulties in parsing data and time strings that are associated with changes in cultural data, you can parse date and time strings by using the invariant culture, or you can call the or method and specify the exact format of the string to be parsed. If you are serializing and deserializing date and time data, you can either use the formatting conventions of the invariant culture, or you can serialize and deserialize the value in a binary format. > -> For more information see the "Dynamic culture data" section in the topic and the "Persisting DateTime values" section in the topic. +> For more information see the "Dynamic culture data" section in the topic and the "Persisting DateTime values" section in the topic. ### Parsing and style elements All overloads ignore leading, inner, or trailing white-space characters in the input string (which is represented by `s` in the following table). The date and time can be bracketed with a pair of leading and trailing NUMBER SIGN characters ("#", U+0023), and can be trailed with one or more NULL characters (U+0000). @@ -6351,7 +6349,7 @@ The following example demonstrates the [!NOTE] -> If `format` is a custom format pattern that does not include date or time separators (such as "yyyyMMddHHmm"), use the invariant culture for the `provider` parameter and the widest form of each custom format specifier. For example, if you want to specify hours in the format pattern, specify the wider form, "HH", instead of the narrower form, "H". +> If `format` is a custom format pattern that does not include date or time separators (such as "yyyyMMddHHmm"), use the invariant culture for the `provider` parameter and the widest form of each custom format specifier. For example, if you want to specify hours in the format pattern, specify the wider form, "HH", instead of the narrower form, "H". The particular date and time symbols and strings (such as names of the days of the week in a particular language) used in `s` are defined by the `provider` parameter, as is the precise format of `s` if `format` is a standard format specifier string. The `provider` parameter can be any of the following: @@ -6592,7 +6590,7 @@ The following example demonstrates the [!NOTE] -> Rather than requiring that `s` conform to a single format for the parse operation to succeed, you can call the method and specify multiple permitted formats. This makes the parse operation more likely to succeed. +> Rather than requiring that `s` conform to a single format for the parse operation to succeed, you can call the method and specify multiple permitted formats. This makes the parse operation more likely to succeed. The `styles` parameter includes one or more members of the enumeration that determine whether and where white space not defined by `format` can appear in `s` and that control the precise behavior of the parse operation. The following table describes how each member of the enumeration affects the operation of the method. @@ -6899,7 +6897,7 @@ The following example demonstrates the object consists of a Kind field that indicates whether the time value is based on local time, Coordinated Universal Time (UTC), or neither, and a Ticks field that contains a time value measured in 100-nanosecond ticks. The method creates a new object using the specified `kind` parameter and the original time value. > [!IMPORTANT] -> The returned value does not represent the same instant in time as the `value` parameter, and is not a time zone conversion method. Instead, it leaves the time specified by the `value` parameter unchanged, and sets the property to `kind`. For information about time zone conversions, see [Converting Times Between Time Zones](/dotnet/standard/datetime/converting-between-time-zones). +> The returned value does not represent the same instant in time as the `value` parameter, and is not a time zone conversion method. Instead, it leaves the time specified by the `value` parameter unchanged, and sets the property to `kind`. For information about time zone conversions, see [Converting Times Between Time Zones](/dotnet/standard/datetime/converting-between-time-zones). The method is useful in interoperability scenarios where you receive a object with an unspecified Kind field, but you can determine by independent means that the Ticks field represents local time or UTC. @@ -6982,7 +6980,7 @@ The following example demonstrates the method does not consider the value of the property of the two values when performing the subtraction. Before subtracting objects, ensure that the objects represent times in the same time zone. Otherwise, the result will include the difference between time zones. > [!NOTE] -> The method does consider the difference between time zones when performing the subtraction. +> The method does consider the difference between time zones when performing the subtraction. @@ -8453,24 +8451,19 @@ The return value is a whose p ## Remarks The local time is equal to the Coordinated Universal Time (UTC) time plus the UTC offset. For more information about the UTC offset, see . The conversion also takes into account the daylight saving time rule that applies to the time represented by the current object. -> [!IMPORTANT] -> On Windows XP systems, the method recognizes only the current adjustment rule when converting from UTC to local time. As a result, conversions for periods before the current adjustment rule came into effect may not accurately reflect the difference between UTC and local time. - The value returned by the method is determined by the property of the current object. The following table describes the possible results. -|Kind|Results| -|----------|-------------| -||This instance of is converted to local time.| -||No conversion is performed.| -||This instance of is assumed to be a UTC time, and the conversion is performed as if were .| +| Kind | Results | +|----------------------------------|---------------------------------------------------------------------| +| | This instance of is converted to local time. | +| | No conversion is performed. | +| | This instance of is assumed to be a UTC time, and the conversion is performed as if were . | > [!NOTE] -> The method converts a value from UTC to local time. To convert the time in any designated time zone to local time, use the method. +> The method converts a value from UTC to local time. To convert the time in any designated time zone to local time, use the method. The value returned by the conversion is a whose property always returns . Consequently, a valid result is returned even if is applied repeatedly to the same . - - ## Examples The following example demonstrates the method. Note that the exact output depends on the current culture and the local time zone of the system on which it is run. @@ -8548,7 +8541,7 @@ The value returned by the method is determin The value of the current object is formatted using the pattern defined by the property associated with the current culture. The return value is identical to the value returned by specifying the "D" [standard DateTime format string](/dotnet/standard/base-types/standard-date-and-time-format-strings) with the method. > [!NOTE] -> The string returned by the method is culture-sensitive. It reflects the pattern defined by the current culture's property. For example, for the en-US culture, the standard long date pattern is commonly "dddd, MMMM dd, yyyy"; for the de-DE culture, it is "dddd, d. MMMM yyyy"; for the ja-JP culture, it is "yyyy'年'M'月'd'日'". Note that its value can vary depending on the .NET implementation and its version, the operating system and its version, and user customization. +> The string returned by the method is culture-sensitive. It reflects the pattern defined by the current culture's property. For example, for the en-US culture, the standard long date pattern is commonly "dddd, MMMM dd, yyyy"; for the de-DE culture, it is "dddd, d. MMMM yyyy"; for the ja-JP culture, it is "yyyy'年'M'月'd'日'". Note that its value can vary depending on the .NET implementation and its version, the operating system and its version, and user customization. [!INCLUDE[culture-sensitive formatting](~/includes/thread-formatting.md)] @@ -8618,7 +8611,7 @@ The following example demonstrates the The value of the current object is formatted using the pattern defined by the property associated with the current culture. The return value is identical to the value returned by specifying the "T" [standard date and time format string](/dotnet/standard/base-types/standard-date-and-time-format-strings) with the method. > [!NOTE] -> The string returned by the method is culture-sensitive. It reflects the pattern defined by the current culture's property. For example, for the en-US culture, the standard long time pattern is "h:mm:ss tt"; for the de-DE culture, it is "HH:mm:ss"; for the ja-JP culture, it is "H:mm:ss". Note that its value can vary depending on the .NET implementation and its version, the operating system and its version, and user customization. +> The string returned by the method is culture-sensitive. It reflects the pattern defined by the current culture's property. For example, for the en-US culture, the standard long time pattern is "h:mm:ss tt"; for the de-DE culture, it is "HH:mm:ss"; for the ja-JP culture, it is "H:mm:ss". Note that its value can vary depending on the .NET implementation and its version, the operating system and its version, and user customization. [!INCLUDE[culture-sensitive-formatting](~/includes/thread-formatting.md)] @@ -8745,7 +8738,7 @@ The value of the current object is formatted using the pa The value of the current object is formatted using the pattern defined by the property associated with the current culture. The return value is identical to the value returned by specifying the "d" [standard DateTime format string](/dotnet/standard/base-types/standard-date-and-time-format-strings) with the method. > [!NOTE] -> The string returned by the method is culture-sensitive. It reflects the pattern defined by the current culture's property. For example, for the en-US culture, the standard short date pattern is "M/d/yyyy"; for the de-DE culture, it is "dd.MM.yyyy"; for the ja-JP culture, it is "yyyy/MM/dd". Note that its value can vary depending on the .NET implementation and its version, the operating system and its version, and user customization. +> The string returned by the method is culture-sensitive. It reflects the pattern defined by the current culture's property. For example, for the en-US culture, the standard short date pattern is "M/d/yyyy"; for the de-DE culture, it is "dd.MM.yyyy"; for the ja-JP culture, it is "yyyy/MM/dd". Note that its value can vary depending on the .NET implementation and its version, the operating system and its version, and user customization. [!INCLUDE[culture-sensitive formatting](~/includes/thread-formatting.md)] @@ -8814,7 +8807,7 @@ The value of the current object is formatted using the pa The value of the current object is formatted using the pattern defined by the property associated with the current culture. The return value is identical to the value returned by specifying the "t" [standard DateTime format string](/dotnet/standard/base-types/standard-date-and-time-format-strings) with the method. > [!NOTE] -> The string returned by the method is culture-sensitive. It reflects the pattern defined by the current culture's property. For example, for the en-US culture, the standard short time pattern is "h:mm tt"; for the de-DE culture, it is "HH:mm"; for the ja-JP culture, it is "H:mm". Note that its value can vary depending on the .NET implementation and its version, the operating system and its version, and user customization. +> The string returned by the method is culture-sensitive. It reflects the pattern defined by the current culture's property. For example, for the en-US culture, the standard short time pattern is "h:mm tt"; for the de-DE culture, it is "HH:mm"; for the ja-JP culture, it is "H:mm". Note that its value can vary depending on the .NET implementation and its version, the operating system and its version, and user customization. [!INCLUDE[culture-sensitive formatting](~/includes/thread-formatting.md)] @@ -9295,24 +9288,19 @@ The following example illustrates how the string representation of a . The conversion also takes into account the daylight saving time rule that applies to the time represented by the current object. -> [!IMPORTANT] -> On Windows XP systems, the method recognizes only the current adjustment rule when converting from local time to UTC. As a result, conversions for periods before the current adjustment rule came into effect may not accurately reflect the difference between local time and UTC. - The value returned by the method is determined by the property of the current object. The following table describes the possible results. -|Kind|Results| -|----------|-------------| -||No conversion is performed.| -||The current object is converted to UTC.| -||The current object is assumed to be a local time, and the conversion is performed as if were .| +| Kind | Results | +|----------------------------------------|----------------------------------------------------------------| +| | No conversion is performed. | +| | The current object is converted to UTC. | +| | The current object is assumed to be a local time, and the conversion is performed as if were . | > [!NOTE] -> The method converts a value from local time to UTC. To convert the time in a non-local time zone to UTC, use the method. To convert a time whose offset from UTC is known, use the method. +> The method converts a value from local time to UTC. To convert the time in a non-local time zone to UTC, use the method. To convert a time whose offset from UTC is known, use the method. If the date and time instance value is an ambiguous time, this method assumes that it is a standard time. (An ambiguous time is one that can map either to a standard time or to a daylight saving time in the local time zone) If the date and time instance value is an invalid time, this method simply subtracts the local time from the local time zone's UTC offset to return UTC. (An invalid time is one that does not exist because of the application of daylight saving time adjustment rules.) - - ## Examples The following example demonstrates the method. @@ -9329,15 +9317,7 @@ The value returned by the method is dete ]]> - The method is sometimes used to convert a local time to UTC. The method is then called to restore the original local time. However, if the original time represents an invalid time in the local time zone, the two local time values will not be equal. For additional information and an example, see the method. - - On Windows XP systems, the method recognizes only the current adjustment rule for the local time zone, which it applies to all dates, including down-level dates (that is, dates that are earlier than the starting date of the current adjustment rule). Applications running on Windows XP that require historically accurate local date and time calculations must work around this behavior by using the method to retrieve a object that corresponds to the local time zone and calling its method. - - The following example illustrates the difference between the and methods on a Windows XP system in the U.S. Pacific Time zone. The first two method calls apply the current time zone adjustment rule (which went into effect in 2007) to a date in 2006. The current adjustment rule provides for the transition to daylight saving time on the second Sunday of March; the previous rule, which was in effect in 2006, provided for the transition to daylight saving time to occur on the first Sunday of April. Only the third method call accurately performs this historical date and time conversion. - - :::code language="csharp" source="~/snippets/csharp/System/DateTime/ToUniversalTime/touniversaltime.cs" id="Snippet1"::: - :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.datetime.touniversaltime/fs/touniversaltime.fs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System/DateTime/ToUniversalTime/touniversaltime.vb" id="Snippet1"::: + The method is sometimes used to convert a local time to UTC. The method is then called to restore the original local time. However, if the original time represents an invalid time in the local time zone, the two local time values will not be equal. For additional information and an example, see the method. @@ -10138,7 +10118,7 @@ The following example illustrates the [!NOTE] -> Rather than requiring that `s` conform to a single format for the parse operation to succeed, you can call the method and specify multiple permitted formats. This makes the parse operation more likely to succeed. +> Rather than requiring that `s` conform to a single format for the parse operation to succeed, you can call the method and specify multiple permitted formats. This makes the parse operation more likely to succeed. The particular date and time symbols and strings (such as the names of the days of the week in a particular language) used in `s` are defined by the `provider` parameter, as is the precise format of `s` if `format` is a standard format specifier string. The `provider` parameter can be any of the following: diff --git a/xml/System/DivideByZeroException.xml b/xml/System/DivideByZeroException.xml index 7580053a131..65b5eefdc4d 100644 --- a/xml/System/DivideByZeroException.xml +++ b/xml/System/DivideByZeroException.xml @@ -273,14 +273,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. diff --git a/xml/System/DuplicateWaitObjectException.xml b/xml/System/DuplicateWaitObjectException.xml index 3dd690dcd1d..f75742932d0 100644 --- a/xml/System/DuplicateWaitObjectException.xml +++ b/xml/System/DuplicateWaitObjectException.xml @@ -246,14 +246,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/EntryPointNotFoundException.xml b/xml/System/EntryPointNotFoundException.xml index c966ba8bc06..1a2c01d15b9 100644 --- a/xml/System/EntryPointNotFoundException.xml +++ b/xml/System/EntryPointNotFoundException.xml @@ -287,14 +287,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. diff --git a/xml/System/Enum.xml b/xml/System/Enum.xml index 8eb48380a99..805c8b362bf 100644 --- a/xml/System/Enum.xml +++ b/xml/System/Enum.xml @@ -3922,16 +3922,7 @@ The following example demonstrates using an enumeration to represent named value (Obsolete.) This method overload is obsolete; use . The string representation of the value of this instance as specified by . - - - + To be added. does not contain a valid format specification. diff --git a/xml/System/Exception.xml b/xml/System/Exception.xml index a5358292e6f..9061142fa6b 100644 --- a/xml/System/Exception.xml +++ b/xml/System/Exception.xml @@ -142,10 +142,9 @@ In addition, do not throw an exception when a return code is sufficient; do not In many cases, an exception handler simply wants to pass the exception on to the caller. This most often occurs in: - A class library that in turn wraps calls to methods in the .NET class library or other class libraries. - - An application or library that encounters a fatal exception. The exception handler can log the exception and then re-throw the exception. -The recommended way to re-throw an exception is to simply use the [throw](/dotnet/csharp/language-reference/keywords/throw) statement in C#, the [reraise](/dotnet/fsharp/language-reference/exception-handling/the-raise-function.md#reraising-an-exception) function in F#, and the [Throw](/dotnet/visual-basic/language-reference/statements/throw-statement) statement in Visual Basic without including an expression. This ensures that all call stack information is preserved when the exception is propagated to the caller. The following example illustrates this. A string extension method, `FindOccurrences`, wraps one or more calls to without validating its arguments beforehand. +The recommended way to re-throw an exception is to simply use the [throw](/dotnet/csharp/language-reference/keywords/throw) statement in C#, the [reraise](/dotnet/fsharp/language-reference/exception-handling/the-raise-function#reraising-an-exception) function in F#, and the [Throw](/dotnet/visual-basic/language-reference/statements/throw-statement) statement in Visual Basic without including an expression. This ensures that all call stack information is preserved when the exception is propagated to the caller. The following example illustrates this. A string extension method, `FindOccurrences`, wraps one or more calls to without validating its arguments beforehand. :::code language="csharp" source="~/snippets/csharp/System/Exception/Overview/rethrow1.cs" id="Snippet6"::: :::code language="fsharp" source="~/snippets/fsharp/System/Exception/Overview/rethrow1.fs" id="Snippet6"::: @@ -484,23 +483,7 @@ The following example demonstrates a `catch` (`with` in F#) block that is define The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - , ) constructor. The code serializes the instance to a file, deserializes the file into a new exception, which it throws, and then catches and displays the exception's data. - - :::code language="csharp" source="~/snippets/csharp/System/Exception/.ctor/getobjdata.cs" id="Snippet1"::: - :::code language="fsharp" source="~/snippets/fsharp/System/Exception/.ctor/getobjdata.fs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System/Exception/.ctor/getobjdata.vb" id="Snippet1"::: - - ]]> - + To be added. is . The class name is or is zero (0). @@ -788,23 +771,7 @@ The following example demonstrates how to add and retrieve information using the The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. When overridden in a derived class, sets the with information about the exception. - - with all the exception object data targeted for serialization. During deserialization, the exception is reconstituted from the `SerializationInfo` transmitted over the stream. - - - -## Examples - The following code example defines a derived serializable `Exception` class that implements `GetObjectData`, which makes minor changes to two properties and then calls the base class to perform the serialization. The example forces a divide-by-0 error and then creates an instance of the derived exception. The code serializes the instance to a file, deserializes the file into a new exception, which it throws, and then catches and displays the exception's data. - - :::code language="csharp" source="~/snippets/csharp/System/Exception/.ctor/getobjdata.cs" id="Snippet1"::: - :::code language="fsharp" source="~/snippets/fsharp/System/Exception/.ctor/getobjdata.fs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System/Exception/.ctor/getobjdata.vb" id="Snippet1"::: - - ]]> - + To be added. The parameter is a null reference ( in Visual Basic). @@ -1173,25 +1140,7 @@ The following code example throws and then catches an ex Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception. - - interface. - - When the event is subscribed to, the exception is deserialized and created as an empty exception. The exception's constructor is not run, and the exception state is also deserialized. The callback method of the exception state object is then notified so that it can push deserialized data into the empty exception. - - The event enables transparent exception types to serialize and deserialize exception data. Transparent code can execute commands within the bounds of the permission set it is operating within, but cannot execute, call, derive from, or contain critical code. - - If the event is not subscribed to, deserialization occurs as usual using the constructor. - - Typically, a handler for the event is added in the exception's constructor to provide for its serialization. But because the constructor is not executed when the event handler executes, serializing a deserialized exception can throw a exception when you try to deserialize the exception. To avoid this, you should also add the handler for the event in the method. See the Examples section for an illustration. - - ]]> - - - If this event is subscribed to and used, all derived types that follow in the inheritance hierarchy must implement the same serialization mechanism. - + To be added. diff --git a/xml/System/FieldAccessException.xml b/xml/System/FieldAccessException.xml index 1765a185b91..7f8f10010bb 100644 --- a/xml/System/FieldAccessException.xml +++ b/xml/System/FieldAccessException.xml @@ -242,14 +242,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. diff --git a/xml/System/FormatException.xml b/xml/System/FormatException.xml index 938345a8e64..1e9371d45e4 100644 --- a/xml/System/FormatException.xml +++ b/xml/System/FormatException.xml @@ -348,14 +348,7 @@ The class derives from and The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. diff --git a/xml/System/IDisposable.xml b/xml/System/IDisposable.xml index 29bfcf90493..7a3d3fcc8c8 100644 --- a/xml/System/IDisposable.xml +++ b/xml/System/IDisposable.xml @@ -92,7 +92,7 @@ For more information about the `try`/`finally` pattern, see [try-finally (C#)](/ ## Implement IDisposable -You should implement if your type uses unmanaged resources directly or if you wish to use disposable resources yourself. The consumers of your type can call your implementation to free resources when the instance is no longer needed. To handle cases in which they fail to call , you should either use a class derived from to wrap the unmanaged resources, or you should override the method for a reference type. In either case, you use the method to perform whatever cleanup is necessary after using the unmanaged resources, such as freeing, releasing, or resetting the unmanaged resources. For more information about implementing , see [the Dispose(bool) method overload](/dotnet/standard/garbage-collection/implementing-dispose.md#the-disposebool-method-overload). +You should implement if your type uses unmanaged resources directly or if you wish to use disposable resources yourself. The consumers of your type can call your implementation to free resources when the instance is no longer needed. To handle cases in which they fail to call , you should either use a class derived from to wrap the unmanaged resources, or you should override the method for a reference type. In either case, you use the method to perform whatever cleanup is necessary after using the unmanaged resources, such as freeing, releasing, or resetting the unmanaged resources. For more information about implementing , see [the Dispose(bool) method overload](/dotnet/standard/garbage-collection/implementing-dispose#the-disposebool-method-overload). > [!IMPORTANT] > If you're defining a base class that uses unmanaged resources and that either has, or is likely to have, subclasses that should be disposed, you should implement the method and provide a second overload of `Dispose`, as discussed in the next section. diff --git a/xml/System/InvalidCastException.xml b/xml/System/InvalidCastException.xml index c4ed1cbfd25..5091b5e0dbe 100644 --- a/xml/System/InvalidCastException.xml +++ b/xml/System/InvalidCastException.xml @@ -342,14 +342,7 @@ Call UserControl11_MyCustomEvent(UserControl11(0), New UserControl1.MyCustomEven The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/InvalidOperationException.xml b/xml/System/InvalidOperationException.xml index ae1940301a4..0f28268aef6 100644 --- a/xml/System/InvalidOperationException.xml +++ b/xml/System/InvalidOperationException.xml @@ -491,14 +491,7 @@ If the method invocation failure is due to invalid arguments, then The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/InvalidTimeZoneException.xml b/xml/System/InvalidTimeZoneException.xml index bb30fa247ec..778ca4498ec 100644 --- a/xml/System/InvalidTimeZoneException.xml +++ b/xml/System/InvalidTimeZoneException.xml @@ -244,14 +244,7 @@ The object that contains the serialized data. The stream that contains the serialized data. Initializes a new instance of the class from serialized data. - - object. Instead, it is called by the object's method when deserializing the object from a stream. - - ]]> - + To be added. The parameter is . -or- diff --git a/xml/System/MemberAccessException.xml b/xml/System/MemberAccessException.xml index 5c0cd975220..876e8ea34d0 100644 --- a/xml/System/MemberAccessException.xml +++ b/xml/System/MemberAccessException.xml @@ -258,14 +258,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/MethodAccessException.xml b/xml/System/MethodAccessException.xml index 2e0536c6b09..d43dee18ec3 100644 --- a/xml/System/MethodAccessException.xml +++ b/xml/System/MethodAccessException.xml @@ -244,14 +244,7 @@ This exception is thrown in situations such as the following: The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/MissingFieldException.xml b/xml/System/MissingFieldException.xml index dfa186a44e9..dcf12a1a5ab 100644 --- a/xml/System/MissingFieldException.xml +++ b/xml/System/MissingFieldException.xml @@ -257,14 +257,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/MissingMemberException.xml b/xml/System/MissingMemberException.xml index 0a1af21f4a9..e0ebceea248 100644 --- a/xml/System/MissingMemberException.xml +++ b/xml/System/MissingMemberException.xml @@ -265,14 +265,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization @@ -482,16 +475,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Sets the object with the class name, the member name, the signature of the missing member, and additional exception information. - - sets a with all the exception object data targeted for serialization. During deserialization, the exception object is reconstituted from the transmitted over the stream. - - For more information, see . - - ]]> - + To be added. The object is . diff --git a/xml/System/MissingMethodException.xml b/xml/System/MissingMethodException.xml index 995c4d98be5..6eddb43921d 100644 --- a/xml/System/MissingMethodException.xml +++ b/xml/System/MissingMethodException.xml @@ -258,14 +258,7 @@ The exact timing of when statically referenced methods are loaded is unspecified The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/MulticastDelegate.xml b/xml/System/MulticastDelegate.xml index 5c667151960..4a7c411ab71 100644 --- a/xml/System/MulticastDelegate.xml +++ b/xml/System/MulticastDelegate.xml @@ -542,16 +542,7 @@ An object that holds all the data needed to serialize or deserialize this instance. (Reserved) The location where serialized data is stored and retrieved. Populates a object with all the data needed to serialize this instance. - - - + To be added. is . A serialization error occurred. diff --git a/xml/System/NotFiniteNumberException.xml b/xml/System/NotFiniteNumberException.xml index 5d739395490..328602fdf88 100644 --- a/xml/System/NotFiniteNumberException.xml +++ b/xml/System/NotFiniteNumberException.xml @@ -295,14 +295,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. @@ -541,16 +534,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Sets the object with the invalid number and additional exception information. - - sets a with all the exception object data targeted for serialization. During deserialization, the exception object is reconstituted from the transmitted over the stream. - - For more information, see . - - ]]> - + To be added. The object is . diff --git a/xml/System/NotSupportedException.xml b/xml/System/NotSupportedException.xml index c7845c792d2..6027a7e04b5 100644 --- a/xml/System/NotSupportedException.xml +++ b/xml/System/NotSupportedException.xml @@ -312,14 +312,7 @@ The exception is closely related to two othe The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/NullReferenceException.xml b/xml/System/NullReferenceException.xml index e09656d6d32..3712bcef2b1 100644 --- a/xml/System/NullReferenceException.xml +++ b/xml/System/NullReferenceException.xml @@ -350,14 +350,7 @@ However, there are many situations where handling the error can be useful: The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/OperatingSystem.xml b/xml/System/OperatingSystem.xml index 62dc9c9e063..e967d320453 100644 --- a/xml/System/OperatingSystem.xml +++ b/xml/System/OperatingSystem.xml @@ -264,16 +264,7 @@ The object to populate with serialization information. The place to store and retrieve serialized data. Reserved for future use. Populates a object with the data necessary to deserialize this instance. - - method. - - For more information, see the method. - - ]]> - + To be added. is . diff --git a/xml/System/OperationCanceledException.xml b/xml/System/OperationCanceledException.xml index 25e4a5a4aa2..fea9d6e18cb 100644 --- a/xml/System/OperationCanceledException.xml +++ b/xml/System/OperationCanceledException.xml @@ -329,14 +329,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/OutOfMemoryException.xml b/xml/System/OutOfMemoryException.xml index bc42bd66a20..187e941f128 100644 --- a/xml/System/OutOfMemoryException.xml +++ b/xml/System/OutOfMemoryException.xml @@ -342,14 +342,7 @@ The following Microsoft intermediate (MSIL) instructions throw an The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/OverflowException.xml b/xml/System/OverflowException.xml index 4791c07f76d..2f33a0f45dc 100644 --- a/xml/System/OverflowException.xml +++ b/xml/System/OverflowException.xml @@ -277,14 +277,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. diff --git a/xml/System/RankException.xml b/xml/System/RankException.xml index 2fafa1a7f34..19f06b08c8a 100644 --- a/xml/System/RankException.xml +++ b/xml/System/RankException.xml @@ -250,14 +250,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/RuntimeFieldHandle.xml b/xml/System/RuntimeFieldHandle.xml index 40bd59f7c5a..653bb2a1752 100644 --- a/xml/System/RuntimeFieldHandle.xml +++ b/xml/System/RuntimeFieldHandle.xml @@ -321,16 +321,7 @@ The object to populate with serialization information. (Reserved) The place to store and retrieve serialized data. Populates a with the data necessary to deserialize the field represented by the current instance. - - method. - - ]]> - + To be added. is . The property of the current instance is not a valid handle. diff --git a/xml/System/RuntimeMethodHandle.xml b/xml/System/RuntimeMethodHandle.xml index 57a85584db7..3dd7fc1b35a 100644 --- a/xml/System/RuntimeMethodHandle.xml +++ b/xml/System/RuntimeMethodHandle.xml @@ -368,16 +368,7 @@ The object to populate with serialization information. (Reserved) The place to store and retrieve serialized data. Populates a with the data necessary to deserialize the field represented by this instance. - - method. - - ]]> - + To be added. is . diff --git a/xml/System/RuntimeTypeHandle.xml b/xml/System/RuntimeTypeHandle.xml index b9166b4b3ef..9d7194ce8e9 100644 --- a/xml/System/RuntimeTypeHandle.xml +++ b/xml/System/RuntimeTypeHandle.xml @@ -372,16 +372,7 @@ The object to be populated with serialization information. (Reserved) The location where serialized data will be stored and retrieved. Populates a with the data necessary to deserialize the type represented by the current instance. - - method. - - ]]> - + To be added. is . diff --git a/xml/System/Span`1.xml b/xml/System/Span`1.xml index 142e6e72dfe..4c14c0dd125 100644 --- a/xml/System/Span`1.xml +++ b/xml/System/Span`1.xml @@ -573,18 +573,7 @@ This method copies all of `source` to `destination` even if `source` and `destin Not supported. Calls to this method are not supported. Calls to this method are not supported. - - method are not supported. Calls to the methods produce either of two results: - -- If `obj` is a , the method call generates compiler error CS1503: "cannot convert from 'System.Span' to 'object'." This is because is a [ref struct](/dotnet/csharp/language-reference/builtin-types/ref-struct) that cannot be boxed and therefore cannot be converted to an . - -- If the type of `obj` is not a , the method call throws a . - -To compare two objects for equality, use the comparison operator. - - ]]> - + To be added. Calls to this method are not supported. diff --git a/xml/System/String.xml b/xml/System/String.xml index 051f6bdb669..3a7384d67c6 100644 --- a/xml/System/String.xml +++ b/xml/System/String.xml @@ -165,7 +165,15 @@ Characters in a string are represented by UTF-16 encoded code units, which corre Each character in a string has an associated Unicode character category, which is represented in .NET by the enumeration. The category of a character or a surrogate pair can be determined by calling the method. -[!INCLUDE[character-categories](~/includes/unicode-categories.md)] +.NET maintains its own table of characters and their corresponding categories, which ensures that a specific version of a .NET implementation running on different platforms returns identical character category information. On all .NET versions and across all OS platforms, character category information is provided by the [Unicode Character Database](https://www.unicode.org/ucd/). + +The following table lists .NET versions and the versions of the Unicode Standard on which their character categories are based. + +| .NET version | Version of the Unicode Standard | +|---------------|-----------------------------------------------------------------------------------------| +| .NET Core 2.1 | [The Unicode Standard, Version 8.0.0](https://www.unicode.org/versions/Unicode8.0.0/) | +| .NET Core 3.1 | [The Unicode Standard, Version 11.0.0](https://www.unicode.org/versions/Unicode11.0.0/) | +| .NET 5 | [The Unicode Standard, Version 13.0.0](https://www.unicode.org/versions/Unicode13.0.0/) | In addition, .NET supports string comparison and sorting based on the Unicode standard. String comparison and sorting information is provided by [International Components for Unicode](https://icu.unicode.org/) libraries (except on Windows versions prior to Windows 10 May 2019 Update). @@ -174,7 +182,6 @@ In addition, .NET supports string comparison and sorting based on the Unicode st In .NET, a object can include embedded null characters, which count as a part of the string's length. However, in some languages such as C and C++, a null character indicates the end of a string; it is not considered a part of the string and is not counted as part of the string's length. This means that the following common assumptions that C and C++ programmers or libraries written in C or C++ might make about strings are not necessarily valid when applied to objects: - The value returned by the `strlen` or `wcslen` functions does not necessarily equal . - - The string created by the `strcpy_s` or `wcscpy_s` functions is not necessarily identical to the string being copied. You should ensure that native C and C++ code that instantiates objects, and code that is passed objects through platform invoke, don't assume that an embedded null character marks the end of the string. @@ -284,14 +291,14 @@ Casing operations can be based on the rules of the current culture, a specified - Differences in case mappings between the invariant culture and all other cultures. In these cases, using the casing rules of the invariant culture to change a character to uppercase or lowercase returns the same character. For all other cultures, it returns a different character. Some of the affected characters are listed in the following table. - |Character|If changed to|Returns| - |---------------|-------------------|-------------| - |MICRON SIGN (U+00B5)|Uppercase|GREEK CAPITAL LETTER MU (U+-39C)| - |LATIN CAPITAL LETTER I WITH DOT ABOVE (U+0130)|Lowercase|LATIN SMALL LETTER I (U+0069)| - |LATIN SMALL LETTER DOTLESS I (U+0131)|Uppercase|LATIN CAPITAL LETTER I (U+0049)| - |LATIN SMALL LETTER LONG S (U+017F)|Uppercase|LATIN CAPITAL LETTER S (U+0053)| - |LATIN CAPITAL LETTER D WITH SMALL LETTER Z WITH CARON (U+01C5)|Lowercase|LATIN SMALL LETTER DZ WITH CARON (U+01C6)| - |COMBINING GREEK YPOGEGRAMMENI (U+0345)|Uppercase|GREEK CAPITAL LETTER IOTA (U+0399)| + | Character | If changed to | Return value | + | ---------------------------------------------- | ------------- | -------------------------------- | + | MICRON SIGN (U+00B5) | Uppercase | GREEK CAPITAL LETTER MU (U+039C) | + | LATIN CAPITAL LETTER I WITH DOT ABOVE (U+0130) | Lowercase | LATIN SMALL LETTER I (U+0069) | + | LATIN SMALL LETTER DOTLESS I (U+0131) | Uppercase | LATIN CAPITAL LETTER I (U+0049) | + | LATIN SMALL LETTER LONG S (U+017F) | Uppercase | LATIN CAPITAL LETTER S (U+0053) | + | LATIN CAPITAL LETTER D WITH SMALL LETTER Z WITH CARON (U+01C5) | Lowercase | LATIN SMALL LETTER DZ WITH CARON (U+01C6) | + | COMBINING GREEK YPOGEGRAMMENI (U+0345) | Uppercase | GREEK CAPITAL LETTER IOTA (U+0399) | - Differences in case mappings of two-letter mixed-case pairs in the ASCII character range. In most cultures, a two-letter mixed-case pair is equal to the equivalent two-letter uppercase or lowercase pair. This is not true for the following two-letter pairs in the following cultures, because in each case they are compared to a digraph: @@ -353,11 +360,8 @@ The following example illustrates the difference between culture-sensitive and o Use the following general guidelines to choose an appropriate sorting or string comparison method: - If you want the strings to be ordered based on the user's culture, you should order them based on the conventions of the current culture. If the user's culture changes, the order of sorted strings will also change accordingly. For example, a thesaurus application should always sort words based on the user's culture. - - If you want the strings to be ordered based on the conventions of a specific culture, you should order them by supplying a object that represents that culture to a comparison method. For example, in an application designed to teach students a particular language, you want strings to be ordered based on the conventions of one of the cultures that speaks that language. - - If you want the order of strings to remain unchanged across cultures, you should order them based on the conventions of the invariant culture or use an ordinal comparison. For example, you would use an ordinal sort to organize the names of files, processes, mutexes, or named pipes. - - For a comparison that involves a security decision (such as whether a username is valid), you should always perform an ordinal test for equality by calling an overload of the method. > [!NOTE] @@ -429,12 +433,9 @@ The Unicode standard defines a process called normalization that returns one bin An ordinal comparison is a binary comparison of the Unicode scalar value of corresponding objects in each string. The class includes a number of methods that can perform an ordinal comparison, including the following: - Any overload of the , , , , , and methods that includes a parameter. The method performs an ordinal comparison if you supply a value of or for this parameter. - - The overloads of the method. - - Methods that use ordinal comparison by default, such as , , and . - -- Methods that search for a value or for the elements in a array in a string instance. Such methods include and . +- Methods that search for a value or for the elements in a array in a string instance. Such methods include and . You can determine whether a string is normalized to normalization form C by calling the method, or you can call the method to determine whether a string is normalized to a specified normalization form. You can also call the method to convert a string to normalization form C, or you can call the method to convert a string to a specified normalization form. For step-by-step information about normalizing and comparing strings, see the and methods. @@ -455,9 +456,7 @@ The class provides members for comparing strings, testing s You can compare strings to determine their relative position in the sort order by using the following methods: - returns an integer that indicates the relationship of one string to a second string in the sort order. - - returns an integer that indicates the relationship of one string to a second string based on a comparison of their code points. - - returns an integer that indicates the relationship of the current string instance to a second string in the sort order. The method provides the and implementations for the class. ### Test strings for equality @@ -469,7 +468,6 @@ You call the method to determine whether two string The class includes two kinds of search methods: - Methods that return a value to indicate whether a particular substring is present in a string instance. These include the , , and methods. - - Methods that indicate the starting position of a substring in a string instance. These include the , , , and methods. > [!WARNING] @@ -480,23 +478,14 @@ The class includes two kinds of search methods: The class includes the following methods that appear to modify the value of a string: - inserts a string into the current instance. - - inserts one or more occurrences of a specified character at the beginning of a string. - - inserts one or more occurrences of a specified character at the end of a string. - - deletes a substring from the current instance. - - replaces a substring with another substring in the current instance. - - and convert all the characters in a string to lowercase. - - and convert all the characters in a string to uppercase. - - removes all occurrences of a character from the beginning and end of a string. - - removes all occurrences of a character from the end of a string. - - removes all occurrences of a character from the beginning of a string. > [!IMPORTANT] @@ -622,8 +611,8 @@ Here's a list of exceptions thrown by constructors that don't include pointer pa | Exception | Condition | Thrown by | |-----------|-----------|-----------| -||`value` is `null`.|| -||`startIndex`, `length`, or `count` is less than zero.

-or-

The sum of `startIndex` and `length` is greater than the number of elements in `value`.

-or-

`count` is less than zero.|

| +||`value` is `null`.|| +||`startIndex`, `length`, or `count` is less than zero.

-or-

The sum of `startIndex` and `length` is greater than the number of elements in `value`.

-or-

`count` is less than zero.|

| Here's a list of exceptions thrown by constructors that include pointer parameters. @@ -639,8 +628,8 @@ Here's a list of exceptions thrown by constructors that include pointer paramete | To | Call or use | |----|-------------| |Create a string.|Assignment from a string literal or an existing string ([Example 1: Use string assignment](#example-1-use-string-assignment))| -|Create a string from an entire character array.| ([Example 2: Use a character array](#example-2-use-a-character-array))| -|Create a string from a portion of a character array.| ([Example 3: Use a portion of a character array and repeating a single character](#example-3-use-a-portion-of-a-character-array-and-repeating-a-single-character))| +|Create a string from an entire character array.| ([Example 2: Use a character array](#example-2-use-a-character-array))| +|Create a string from a portion of a character array.| ([Example 3: Use a portion of a character array and repeating a single character](#example-3-use-a-portion-of-a-character-array-and-repeating-a-single-character))| |Create a string that repeats the same character multiple times.| ([Example 3: Use a portion of a character array and repeating a single character](#example-3-use-a-portion-of-a-character-array-and-repeating-a-single-character))| |Create a string from a pointer to a Unicode or wide character array.|| |Create a string from a portion of a Unicode or wide character array by using its pointer.|| @@ -651,7 +640,7 @@ Here's a list of exceptions thrown by constructors that include pointer paramete The most commonly used technique for creating strings programmatically is simple assignment, as illustrated in [Example 1](#example-1-use-string-assignment). The class also includes four types of constructor overloads that let you create strings from the following values: -- From a character array (an array of UTF-16-encoded characters). You can create a new object from the characters in the entire array or a portion of it. The constructor copies all the characters in the array to the new string. The constructor copies the characters from index `startIndex` to index `startIndex` + `length` - 1 to the new string. If `length` is zero, the value of the new string is . +- From a character array (an array of UTF-16-encoded characters). You can create a new object from the characters in the entire array or a portion of it. The constructor copies all the characters in the array to the new string. The constructor copies the characters from index `startIndex` to index `startIndex` + `length` - 1 to the new string. If `length` is zero, the value of the new string is . If your code repeatedly instantiates strings that have the same value, you can improve application performance by using an alternate means of creating strings. For more information, see [Handle repetitive strings](#handle-repetitive-strings). @@ -683,11 +672,11 @@ The most commonly used technique for creating strings programmatically is simple ## Handle repetitive strings -Apps that parse or decode streams of text often use the constructor or the method to convert sequences of characters into a string. Repeatedly creating new strings with the same value instead of creating and reusing one string wastes memory. If you are likely to create the same string value repeatedly by calling the constructor, even if you don't know in advance what those identical string values may be, you can use a lookup table instead. +Apps that parse or decode streams of text often use the constructor or the method to convert sequences of characters into a string. Repeatedly creating new strings with the same value instead of creating and reusing one string wastes memory. If you are likely to create the same string value repeatedly by calling the constructor, even if you don't know in advance what those identical string values may be, you can use a lookup table instead. For example, suppose you read and parse a stream of characters from a file that contains XML tags and attributes. When you parse the stream, you repeatedly encounter certain tokens (that is, sequences of characters that have a symbolic meaning). Tokens equivalent to the strings "0", "1", "true", and "false" are likely to occur frequently in an XML stream. -Instead of converting each token into a new string, you can create a object to hold commonly occurring strings. The object improves performance, because it retrieves stored strings without allocating temporary memory. When you encounter a token, use the method to retrieve the token from the table. If the token exists, the method returns the corresponding string. If the token does not exist, use the method to insert the token into the table and to get the corresponding string. +Instead of converting each token into a new string, you can create a object to hold commonly occurring strings. The object improves performance, because it retrieves stored strings without allocating temporary memory. When you encounter a token, use the method to retrieve the token from the table. If the token exists, the method returns the corresponding string. If the token does not exist, use the method to insert the token into the table and to get the corresponding string. ## Example 1: Use string assignment @@ -1433,7 +1422,6 @@ Because the method simply returns the existing strin ]]> - @@ -4467,39 +4455,7 @@ The following example determines whether the string "fox" is a substring of a fa The string to copy. Creates a new instance of with the same value as a specified . A new string with the same value as . - - object that has the same value as the original string but represents a different object reference. It differs from an assignment operation, which assigns an existing string reference to an additional object variable. - -> [!IMPORTANT] -> This method is obsolete. In some cases, the `Copy` method doesn't create a new string but simply returns a reference to an existing interned string. - -Depending on *why* you want to call the `Copy` method, there are a number of alternatives: - -- If you want a different string instance to use in an operation that modifies the string, use the original string instance. Because strings are immutable, the string operation creates a new string instance, and the original string remains unaffected. In this case, you should not assign the new string reference to the original string variable. The following example provides an illustration. - - :::code language="csharp" source="~/snippets/csharp/System/String/Copy/Program.cs" id="Snippet1"::: - :::code language="fsharp" source="~/snippets/fsharp/System/String/Copy/Program.fs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/api/system/string/copy/program.vb" id="Snippet1"::: - - In this case, calling the `Copy` method to create a new string before calling the method unnecessarily creates a new string instance. - -- If you want to create a mutable buffer with the same contents as the original string, call the or constructor. For example: - - :::code language="csharp" source="~/snippets/csharp/System/String/Copy/Program.cs" id="Snippet2"::: - :::code language="fsharp" source="~/snippets/fsharp/System/String/Copy/Program.fs" id="Snippet2"::: - :::code language="vb" source="~/snippets/visualbasic/api/system/string/copy/program.vb" id="Snippet2"::: - -- If you want to create a mutable copy of the string so that you can use unsafe code to modify the string contents, use method. The following example uses the method to get a pointer to the location of an copied string in unmanaged memory, increments the Unicode code point of each character in the string by one, and copies the resulting string back to a managed string. - - :::code language="csharp" source="~/snippets/csharp/System/String/Copy/Program.cs" id="Snippet3"::: - :::code language="fsharp" source="~/snippets/fsharp/System/String/Copy/Program.fs" id="Snippet3"::: - - ]]> - + To be added. is . @@ -5751,8 +5707,8 @@ The following example is similar to the previous one, except that it left-aligns | Objective | Method to call | |-----------|----------------| -|Format one or more objects by using the conventions of the current culture.|Except for the overloads that include a `provider` parameter, the remaining overloads include a parameter followed by one or more object parameters. Because of this, you don't have to determine which overload you intend to call. Your language compiler selects the appropriate overload from among the overloads that don't have a `provider` parameter, based on your argument list. For example, if your argument list has five arguments, the compiler calls the method.| -|Format one or more objects by using the conventions of a specific culture.|Each overload that begins with a `provider` parameter is followed by a parameter and one or more object parameters. Because of this, you don't have to determine which specific overload you intend to call. Your language compiler selects the appropriate overload from among the overloads that have a `provider` parameter, based on your argument list. For example, if your argument list has five arguments, the compiler calls the method.| +|Format one or more objects by using the conventions of the current culture.|Except for the overloads that include a `provider` parameter, the remaining overloads include a parameter followed by one or more object parameters. Because of this, you don't have to determine which overload you intend to call. Your language compiler selects the appropriate overload from among the overloads that don't have a `provider` parameter, based on your argument list. For example, if your argument list has five arguments, the compiler calls the method.| +|Format one or more objects by using the conventions of a specific culture.|Each overload that begins with a `provider` parameter is followed by a parameter and one or more object parameters. Because of this, you don't have to determine which specific overload you intend to call. Your language compiler selects the appropriate overload from among the overloads that have a `provider` parameter, based on your argument list. For example, if your argument list has five arguments, the compiler calls the method.| |Perform a custom formatting operation either with an implementation or an implementation.|Any of the four overloads with a `provider` parameter. The compiler selects the appropriate overload from among the overloads that have a `provider` parameter, based on your argument list.| ## The Format method in brief @@ -5771,7 +5727,7 @@ A format item has this syntax: {index[,width][:formatString]} ``` -Brackets denote optional elements. The opening and closing braces are required. (To include a literal opening or closing brace in the format string, see the [Escaping Braces](/dotnet/standard/base-types/composite-formatting.md#escaping-braces) section in the [Composite Formatting](/dotnet/standard/base-types/composite-formatting) article.) +Brackets denote optional elements. The opening and closing braces are required. (To include a literal opening or closing brace in the format string, see the [Escaping Braces](/dotnet/standard/base-types/composite-formatting#escaping-braces) section in the [Composite Formatting](/dotnet/standard/base-types/composite-formatting) article.) For example, a format item to format a currency value might appear like this: @@ -5815,16 +5771,13 @@ The following example uses the `width` and `formatString` arguments to produce f Format items are processed sequentially from the beginning of the string. Each format item has an index that corresponds to an object in the method's argument list. The method retrieves the argument and derives its string representation as follows: - If the argument is `null`, the method inserts into the result string. You don't have to be concerned with handling a for null arguments. - -- If you call the overload and the `provider` object's implementation returns a non-null implementation, the argument is passed to its method. If the format item includes a `formatString` argument, it is passed as the first argument to the method. If the implementation is available and produces a non-null string, that string is returned as the string representation of the argument; otherwise, the next step executes. - +- If you call the overload and the `provider` object's implementation returns a non-null implementation, the argument is passed to its method. If the format item includes a `formatString` argument, it is passed as the first argument to the method. If the implementation is available and produces a non-null string, that string is returned as the string representation of the argument; otherwise, the next step executes. - If the argument implements the interface, its implementation is called. - - The argument's parameterless `ToString` method, which either overrides or inherits from a base class implementation, is called. For an example that intercepts calls to the method and allows you to see what information the method passes to a formatting method for each format item in a composite format string, see [Example: An intercept provider and Roman numeral formatter](#example-an-intercept-provider-and-roman-numeral-formatter). -For more information, see [Processing order](/dotnet/standard/base-types/composite-formatting.md#processing-order). +For more information, see [Processing order](/dotnet/standard/base-types/composite-formatting#processing-order). ## Format items that have the same index @@ -5862,7 +5815,7 @@ This example defines a format provider that formats an integer value as a custom This example defines a custom format provider that implements the and interfaces to do two things: -- It displays the parameters passed to its implementation. This enables us to see what parameters the method is passing to the custom formatting implementation for each object that it tries to format. This can be useful when you're debugging your application. +- It displays the parameters passed to its implementation. This enables us to see what parameters the method is passing to the custom formatting implementation for each object that it tries to format. This can be useful when you're debugging your application. - If the object to be formatted is an unsigned byte value that is to be formatted by using the "R" standard format string, the custom formatter formats the numeric value as a Roman numeral. :::code language="csharp" source="~/snippets/csharp/System/FormatException/Overview/interceptor2.cs" id="Snippet11"::: @@ -5938,7 +5891,7 @@ You can pad an integer or floating-point number with leading zeros to produce a ### How many items can I include in the format list? -There is no practical limit. The second parameter of the method is tagged with the attribute, which allows you to include either a delimited list or an object array as your format list. +There is no practical limit. The second parameter of the method is tagged with the attribute, which allows you to include either a delimited list or an object array as your format list. ### How do I include literal braces ("{" and "}") in the result string? @@ -5974,7 +5927,7 @@ For example, the following code throws a exception This is a problem of compiler overload resolution. Because the compiler cannot convert an array of integers to an object array, it treats the integer array as a single argument, so it calls the method. The exception is thrown because there are four format items but only a single item in the format list. -Because neither Visual Basic nor C# can convert an integer array to an object array, you have to perform the conversion yourself before calling the method. The following example provides one implementation. +Because neither Visual Basic nor C# can convert an integer array to an object array, you have to perform the conversion yourself before calling the method. The following example provides one implementation. :::code language="csharp" source="~/snippets/csharp/System/FormatException/Overview/qa21.cs" id="Snippet22"::: :::code language="fsharp" source="~/snippets/fsharp/System/FormatException/Overview/qa21.fs" id="Snippet22"::: @@ -6063,7 +6016,7 @@ Because neither Visual Basic nor C# can convert an integer array to an object ar This method uses the [composite formatting feature](/dotnet/standard/base-types/composite-formatting) to convert the value of an expression to its string representation and to embed that representation in a string. -[!INCLUDE[simple-string-format](~/includes/remarks/System/String/simple-string-format.md)] +[!INCLUDE[simple-string-format](~/includes/simple-string-format.md)] ## Example: Formatting a single argument @@ -6167,7 +6120,7 @@ The index of a format item is not zero. This method uses the [composite formatting feature](/dotnet/standard/base-types/composite-formatting) to convert the value of four or more expressions to their string representations and to embed those representations in a string. Since the `args` parameter is marked with the attribute, you can pass the objects to the method as individual arguments or as an array. -[!INCLUDE[simple-string-format](~/includes/remarks/System/String/simple-string-format.md)] +[!INCLUDE[simple-string-format](~/includes/simple-string-format.md)] ## Example: Format more than three arguments @@ -6335,7 +6288,7 @@ The index of a format item is less than zero, or greater than or equal to the le This method uses the [composite formatting feature](/dotnet/standard/base-types/composite-formatting) to convert the value of an expression to its string representation and to embed that representation in a string. In performing the conversion, the method uses culture-sensitive formatting or a custom formatter. The method converts `arg0` to its string representation by calling its **ToString(IFormatProvider)** method or, if the object's corresponding format item includes a format string, by calling its **ToString(String,IFormatProvider)** method. If these methods don't exist, it calls the object's parameterless **ToString** method. -[!INCLUDE[provider-string-format](~/includes/remarks/System/String/provider-string-format.md)] +[!INCLUDE[provider-string-format](~/includes/provider-string-format.md)] ]]> @@ -6432,11 +6385,11 @@ The index of a format item is not zero. This method uses the [composite formatting feature](/dotnet/standard/base-types/composite-formatting) to convert four or more expressions to their string representations and to embed those representations in a string. In performing the conversion, the method uses culture-sensitive formatting or a custom formatter. The method converts each argument to its string representation by calling its **ToString(IFormatProvider)** method or, if the object's corresponding format item includes a format string, by calling its **ToString(String,IFormatProvider)** method. If these methods don't exist, it calls the object's parameterless **ToString** method. -[!INCLUDE[provider-string-format](~/includes/remarks/System/String/provider-string-format.md)] +[!INCLUDE[provider-string-format](~/includes/provider-string-format.md)] ### Example: Culture-sensitive formatting -This example uses the method to display the string representation of some date and time values and numeric values by using several different cultures. +This example uses the method to display the string representation of some date and time values and numeric values by using several different cultures. :::code language="csharp" source="~/snippets/csharp/System/String/Format/Example2.cs" id="Snippet2"::: :::code language="fsharp" source="~/snippets/fsharp/System/String/Format/Example2.fs" id="Snippet2"::: @@ -6727,7 +6680,7 @@ The index of a format item is less than zero, or greater than or equal to the le This method uses the [composite formatting feature](/dotnet/standard/base-types/composite-formatting) to convert the value of two expressions to their string representations and to embed those representations in a string. -[!INCLUDE[simple-string-format](~/includes/remarks/System/String/simple-string-format.md)] +[!INCLUDE[simple-string-format](~/includes/simple-string-format.md)] ## Example: Format two arguments @@ -6833,7 +6786,7 @@ The index of a format item is not zero or one. This method uses the [composite formatting feature](/dotnet/standard/base-types/composite-formatting) to convert two expressions to their string representations and to embed those representations in a string. In performing the conversion, the method uses culture-sensitive formatting or a custom formatter. The method converts each argument to its string representation by calling its **ToString(IFormatProvider)** method or, if the object's corresponding format item includes a format string, by calling its **ToString(String,IFormatProvider)** method. If these methods don't exist, it calls the object's parameterless **ToString** method. -[!INCLUDE[provider-string-format](~/includes/remarks/System/String/provider-string-format.md)] +[!INCLUDE[provider-string-format](~/includes/provider-string-format.md)] ]]> @@ -6924,7 +6877,7 @@ The index of a format item is not zero or one. This method uses the [composite formatting feature](/dotnet/standard/base-types/composite-formatting) to convert the value of three expressions to their string representations and to embed those representations in a string. -[!INCLUDE[simple-string-format](~/includes/remarks/System/String/simple-string-format.md)] +[!INCLUDE[simple-string-format](~/includes/simple-string-format.md)] ## Example: Format three arguments @@ -7025,7 +6978,7 @@ The index of a format item is less than zero, or greater than two. This method uses the [composite formatting feature](/dotnet/standard/base-types/composite-formatting) to convert three expressions to their string representations and to embed those representations in a string. In performing the conversion, the method uses culture-sensitive formatting or a custom formatter. The method converts each argument to its string representation by calling its **ToString(IFormatProvider)** method or, if the object's corresponding format item includes a format string, by calling its **ToString(String,IFormatProvider)** method. If these methods don't exist, it calls the object's parameterless **ToString** method. -[!INCLUDE[provider-string-format](~/includes/remarks/System/String/provider-string-format.md)] +[!INCLUDE[provider-string-format](~/includes/provider-string-format.md)] ]]> @@ -9882,10 +9835,11 @@ The following example uses the Sieve of Eratosthenes algorithm to calculate the ## Remarks If `separator` is `null` or if any element of `values` other than the first element is `null`, an empty string () is used instead. See the Notes for Callers section if the first element of `values` is `null`. - is a convenience method that lets you concatenate each element in an object array without explicitly converting its elements to strings. The string representation of each object in the array is derived by calling that object's `ToString` method. + is a convenience method that lets you concatenate each element in an object array without explicitly converting its elements to strings. The string representation of each object in the array is derived by calling that object's `ToString` method. ## Examples -The following example uses the Sieve of Eratosthenes algorithm to calculate the prime numbers that are less than or equal to 100. It assigns the result to a integer array, which it then passes to the method. + +The following example uses the Sieve of Eratosthenes algorithm to calculate the prime numbers that are less than or equal to 100. It assigns the result to an integer array, which it then passes to the method. :::code language="csharp" source="~/snippets/csharp/System/String/Join/join1.cs" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System/String/Join/join1.fs" id="Snippet1"::: @@ -13138,7 +13092,7 @@ This method is guaranteed O(n * r) complexity, where n is the length of is used to break a delimited string into substrings. You can use either a character array or a string array to specify zero or more delimiting characters or strings. If no delimiting characters are specified, the string is split at white-space characters. -Overloads of the method allow you to limit the number of substrings returned by the method (the method), to specify whether to include empty strings and/or trim substrings in the result (the and methods), or to do both (the and methods). +Overloads of the method allow you to limit the number of substrings returned by the method (the method), to specify whether to include empty strings and/or trim substrings in the result (the and methods), or to do both (the and methods). > [!TIP] > The method is not always the best way to break a delimited string into substrings. If you don't want to extract all of the substrings of a delimited string, or if you want to parse a string based on a pattern instead of a set of delimiter characters, consider using regular expressions, or combine one of the search methods that returns the index of a character with the method. For more information, see [Extract substrings from a string](/dotnet/standard/base-types/divide-up-strings). @@ -13232,7 +13186,7 @@ The sections for the individual overloads of `String.Split()` contain further ex ## Remarks -When a string is delimited by a known set of characters, you can use the method to separate it into substrings. +When a string is delimited by a known set of characters, you can use the method to separate it into substrings. Delimiter characters are not included in the elements of the returned array. For example, if the separator array includes the character "-" and the value of the current string instance is "aa-bb-cc", the method returns an array that contains three elements: "aa", "bb", and "cc". @@ -13273,9 +13227,9 @@ Because the `separator` parameter is decorated with the method extracts the substrings in this string that are delimited by one or more of the characters in the `separator` array, and returns those substrings as elements of an array. +The method extracts the substrings in this string that are delimited by one or more of the characters in the `separator` array, and returns those substrings as elements of an array. -The method looks for delimiters by performing comparisons using case-sensitive ordinal sort rules. For more information about word, string, and ordinal sorts, see the enumeration. +The method looks for delimiters by performing comparisons using case-sensitive ordinal sort rules. For more information about word, string, and ordinal sorts, see the enumeration. ### Performance considerations @@ -13776,13 +13730,13 @@ In addition, if the same set of characters is used to split strings in multiple ## Examples -The following example illustrates the difference in the arrays returned by calling a string's method with its `options` parameter equal to and . +The following example illustrates the difference in the arrays returned by calling a string's method with its `options` parameter equal to and . :::code language="csharp" source="~/snippets/csharp/System/String/Split/options.cs" id="Snippet2"::: :::code language="fsharp" source="~/snippets/fsharp/System/String/Split/options.fs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/system/string.split/options.vb" id="Snippet1"::: -The following example defines an array of separators that include punctuation and white-space characters. Passing this array along with a value of to the method returns an array that consists of the individual words from the string. +The following example defines an array of separators that include punctuation and white-space characters. Passing this array along with a value of to the method returns an array that consists of the individual words from the string. :::code language="csharp" source="~/snippets/csharp/System/String/Split/options.cs" id="Snippet3"::: :::code language="fsharp" source="~/snippets/fsharp/System/String/Split/options.fs" id="Snippet3"::: @@ -16130,7 +16084,7 @@ This member is an explicit interface member implementation. It can be used only ## Remarks This method copies each character (that is, each object) in a string to a character array. The first character copied is at index zero of the returned character array; the last character copied is at index - 1. -To create a string from the characters in a character array, call the constructor. +To create a string from the characters in a character array, call the constructor. To create a byte array that contains the encoded characters in a string, instantiate the appropriate object and call its method. Some of the standard encodings available in .NET include the following: @@ -16207,13 +16161,13 @@ The following example calls the method to extr constructor. +This method copies the characters in a portion of a string to a character array. To create a string from a range of characters in a character array, call the constructor. The `startIndex` parameter is zero-based. That is, the index of the first character in the string instance is zero. If `length` is zero, the returned array is empty and has a zero length. If this instance is `null` or an empty string (""), the returned array is empty and has a zero length. -To create a byte array that contains the encoded characters in a portion of a string, instantiate the appropriate object and call its method. Some of the standard encodings available in .NET include: +To create a byte array that contains the encoded characters in a portion of a string, instantiate the appropriate object and call its method. Some of the standard encodings available in .NET include: |Encoding|Object| |--------------|------------| @@ -16462,7 +16416,7 @@ If your application depends on the case of a string changing in a predictable wa If you need the lowercase or uppercase version of an operating system identifier, such as a file name, named pipe, or registry key, use the or methods. ## Examples -The following example defines a string array that contains a single word in a number of languages. The method is used to populate the elements of a parallel array with the case-insensitive version of each word. The method is used to sort the case-sensitive array based on the order of elements in the lowercase array to ensure that elements appear in the same order regardless of language. +The following example defines a string array that contains a single word in a number of languages. The method is used to populate the elements of a parallel array with the case-insensitive version of each word. The method is used to sort the case-sensitive array based on the order of elements in the lowercase array to ensure that elements appear in the same order regardless of language. :::code language="csharp" source="~/snippets/csharp/System/String/ToLowerInvariant/tolowerinvariant.cs" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System/String/ToLowerInvariant/tolowerinvariant.fs" id="Snippet1"::: @@ -16835,7 +16789,7 @@ If you need the lowercase or uppercase version of an operating system identifier method is used to populate the elements of a parallel array with the case-insensitive version of each word. The method is used to sort the case-sensitive array based on the order of elements in the uppercase array to ensure that elements appear in the same order regardless of language. +The following example defines a string array that contains a single word in a number of languages. The method is used to populate the elements of a parallel array with the case-insensitive version of each word. The method is used to sort the case-sensitive array based on the order of elements in the uppercase array to ensure that elements appear in the same order regardless of language. :::code language="csharp" source="~/snippets/csharp/System/String/ToUpperInvariant/toupperinvariant.cs" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System/String/ToUpperInvariant/toupperinvariant.fs" id="Snippet1"::: diff --git a/xml/System/SystemException.xml b/xml/System/SystemException.xml index 078275e5114..e83a283bdd0 100644 --- a/xml/System/SystemException.xml +++ b/xml/System/SystemException.xml @@ -240,14 +240,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/TimeZone.xml b/xml/System/TimeZone.xml index 1f08f87b7c2..4f5889b3666 100644 --- a/xml/System/TimeZone.xml +++ b/xml/System/TimeZone.xml @@ -59,24 +59,7 @@ Represents a time zone. - - [!IMPORTANT] -> Whenever possible, use the class instead of the class. - - You can use the class to retrieve information about the current time zone, and to convert times from local time to Coordinated Universal Time (UTC) or vice versa. However, you cannot use the class to represent time zones other than the local zone or to handle date and time conversions from one time zone to another. For this purpose, use the class. You can use this class to retrieve information on any time zone defined on the local system, to create custom time zones, and to convert times from one time zone to another. - - The class supports only a single daylight saving time adjustment rule for the local time zone. As a result, the class can accurately report daylight saving time information or convert between UTC and local time only for the period in which the latest adjustment rule is in effect. In contrast, the class supports multiple adjustment rules, which makes it possible to work with historic time zone data. - - ]]> - - - In addition to providing implementations for its members (those marked in Visual Basic), it is important that classes derived from override the default behavior of the method. For details, see the method. - + To be added. @@ -167,9 +150,6 @@ ]]> - - Local time zone data is cached after is first used to retrieve time zone information. If the system's local time zone subsequently changes, the property does not reflect this change. If you need to handle time zone changes while your application is running, use the class and call its method. - @@ -280,9 +260,6 @@ is less than 1 or greater than 9999. - - Because the class supports only one daylight saving time adjustment rule, the method applies the current adjustment rule to any year, regardless of whether the adjustment rule actually applies to that year. Assuming that the operating system itself has accurate data for a particular year, a more accurate result is available by working with the array of objects returned by the method. The , , and properties correspond to the , , and properties. - @@ -594,9 +571,6 @@ ]]> - - Although it is not required, in most cases derived classes should override the default implementation of this method. The behavior of the default implementation depends on the property of the parameter. If its value is , this method returns unchanged. If its value is either or , this method assumes is UTC and converts it to the local system time without calling the method. - diff --git a/xml/System/TimeZoneInfo+AdjustmentRule.xml b/xml/System/TimeZoneInfo+AdjustmentRule.xml index bd176fa2fac..0b7bb3f9ffe 100644 --- a/xml/System/TimeZoneInfo+AdjustmentRule.xml +++ b/xml/System/TimeZoneInfo+AdjustmentRule.xml @@ -374,15 +374,12 @@ dateVariable.Date > [!IMPORTANT] > Unless there is a compelling reason to do otherwise, you should define the adjustment rule's end date to occur within the time interval during which the time zone observes standard time. Unless there is a compelling reason to do so, you should not define the adjustment rule's end date to occur within the time interval during which the time zone observes daylight saving time. For example, if a time zone's transition from daylight saving time occurs on the third Sunday of March and its transition to daylight saving time occurs on the first Sunday of October, the effective end date of the adjustment rule should not be December 31 of a particular year, since that date occurs within the period of daylight saving time. - By default, the registry in Windows XP defines a single adjustment rule whose end date is Friday, December 31, 9999 (the value of `DateTime.MaxValue.Date`), for each time zone. For time zones in the United States, the registry in Windows Vista defines two adjustment rules: +For time zones in the United States, the registry in Windows defines two adjustment rules: - Monday, January 01, 0001, to Sunday, December 31, 2006. - - Monday, January 01, 2007, to Friday, December 31, 9999. - This means that, although time zone adjustment rules stored in the registry are useful for performing current time zone-related operations, they cannot be reliably used for retrieving historical time zone information. For information about defining a custom time zone with multiple adjustment rules that can be used in a historical time zone-aware application, see [How to: Create Time Zones with Adjustment Rules](/dotnet/standard/datetime/create-time-zones-with-adjustment-rules). - - +Although time zone adjustment rules stored in the registry are useful for performing current time zone-related operations, they cannot be reliably used for retrieving historical time zone information. For information about defining a custom time zone with multiple adjustment rules that can be used in a historical time zone-aware application, see [How to: Create Time Zones with Adjustment Rules](/dotnet/standard/datetime/create-time-zones-with-adjustment-rules). ## Examples The following example displays information about all of the time zones defined in the local computer's system registry, including the starting and ending dates of their adjustment rules. @@ -447,15 +444,12 @@ dateVariable.Date > [!IMPORTANT] > Unless there is a compelling reason to do otherwise, you should define the adjustment rule's start date to occur within the time interval during which the time zone observes standard time. Unless there is a compelling reason to do so, you should not define the adjustment rule's start date to occur within the time interval during which the time zone observes daylight saving time. For example, if a time zone's transition from daylight saving time occurs on the third Sunday of March and its transition to daylight saving time occurs on the first Sunday of October, the effective start date of the adjustment rule should not be January 1 of a particular year, since that date occurs within the period of daylight saving time. - By default, the registry in Windows XP defines a single adjustment rule whose start date is Monday, January 01, 0001 (the value of `DateTime.MinValue.Date`), for each time zone. For time zones in the United States, the registry in Windows Vista defines two adjustment rules: +For time zones in the United States, the registry in Windows defines two adjustment rules: - Monday, January 01, 0001, to Sunday, December 31, 2006. - - Monday, January 01, 2007, to Friday, December 31, 9999. - This means that, although time zone adjustment rules stored in the registry are useful for performing current time zone-related operations, they cannot be reliably used for retrieving historical time zone information. For information about defining a custom time zone with multiple adjustment rules that can be used in a historical time zone-aware application, see [How to: Create Time Zones with Adjustment Rules](/dotnet/standard/datetime/create-time-zones-with-adjustment-rules). - - +Although time zone adjustment rules stored in the registry are useful for performing current time zone-related operations, they cannot be reliably used for retrieving historical time zone information. For information about defining a custom time zone with multiple adjustment rules that can be used in a historical time zone-aware application, see [How to: Create Time Zones with Adjustment Rules](/dotnet/standard/datetime/create-time-zones-with-adjustment-rules). ## Examples The following example displays information about all of the time zones defined in the local computer's system registry, including the starting and ending dates of their adjustment rules. diff --git a/xml/System/TimeZoneNotFoundException.xml b/xml/System/TimeZoneNotFoundException.xml index 93ece6c348f..f90daed2b6a 100644 --- a/xml/System/TimeZoneNotFoundException.xml +++ b/xml/System/TimeZoneNotFoundException.xml @@ -59,15 +59,14 @@ ## Remarks This exception is thrown by the and methods when a time zone identifier cannot be found on the local system, or when there is no data associated with a particular time zone identifier. - Because the registry serves as the repository of time zone information in Windows XP and Windows Vista, this exception indicates that the registry contains no information about a particular time zone. Time zone information is stored in the subkeys of HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Time Zones. + Because the registry serves as the repository of time zone information in Windows, this exception indicates that the registry contains no information about a particular time zone. Time zone information is stored in the subkeys of `HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Time Zones`. If an application depends on the presence of a particular time zone and the attempt to retrieve it throws a , the application can handle the exception in either of two ways: - By calling the method to deserialize a saved object. - - By calling one of the overloads of the method to create a time zone. - See the examples for the and methods. + See the examples for the and methods. ]]> @@ -235,14 +234,7 @@ The object that contains the serialized data. The stream that contains the serialized data. Initializes a new instance of the class from serialized data. - - object. Instead, it is called by the object's method when deserializing the object from a stream. - - ]]> - + To be added. The parameter is . -or- diff --git a/xml/System/TimeoutException.xml b/xml/System/TimeoutException.xml index 0a9a74c7661..157b0b39242 100644 --- a/xml/System/TimeoutException.xml +++ b/xml/System/TimeoutException.xml @@ -257,14 +257,7 @@ The object that contains serialized object data about the exception being thrown. The object that contains contextual information about the source or destination. The parameter is reserved for future use, and can be specified as . Initializes a new instance of the class with serialized data. - - - + To be added. The parameter is . The class name is , or is zero (0). diff --git a/xml/System/Type.xml b/xml/System/Type.xml index 32f5683d7f8..c6859f93001 100644 --- a/xml/System/Type.xml +++ b/xml/System/Type.xml @@ -11563,7 +11563,6 @@ The following table summarizes the interactions between `assemblyResolver`, `typ The current object represents a type that contains open type parameters, that is, returns . The specified member cannot be invoked on . More than one method matches the binding criteria. - The .NET Compact Framework does not currently support this method. The method represented by has one or more unspecified generic type parameters. That is, the method's property returns . @@ -15223,26 +15222,7 @@ The common language runtime supports the embedding of type information for COM t Gets a value indicating whether the is binary serializable. if the is binary serializable; otherwise, . - - . Instead, each .NET implementation determines whether a type is binary serializable. At run time, you can use the property to determine whether that implementation supports binary serialization of an instance of the type. For more information and an example, see [How to determine if a .NET Standard object is serializable](/dotnet/standard/serialization/how-to-determine-if-netstandard-object-is-serializable). - - If the current represents a constructed generic type, this property applies to the generic type definition from which the type was constructed. For example, if the current represents `MyGenericType` (`MyGenericType(Of Integer)` in Visual Basic), the value of this property is determined by `MyGenericType`. - - If the current represents a type parameter in the definition of a generic type or generic method, this property always returns `false`. - -## Examples - The following example creates an instance of `MyTestClass` class, sets the [Serializable] attribute, and checks the `IsSerializable` property for `true` or `false`. - - :::code language="csharp" source="~/snippets/csharp/System/Type/IsSerializable/type_isserializable.cs" id="Snippet1"::: - :::code language="fsharp" source="~/snippets/fsharp/System/Type/IsSerializable/type_isserializable.fs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System/Type/IsSerializable/type_isserializable.vb" id="Snippet1"::: - - ]]> - + To be added. @@ -17243,7 +17223,6 @@ The following example uses the method to cre ]]> - The .NET Compact Framework does not currently support this property. diff --git a/xml/System/TypeAccessException.xml b/xml/System/TypeAccessException.xml index 959cbb38626..5cb776195d4 100644 --- a/xml/System/TypeAccessException.xml +++ b/xml/System/TypeAccessException.xml @@ -232,14 +232,7 @@ The object that holds the serialized data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/TypeLoadException.xml b/xml/System/TypeLoadException.xml index f1320eccd83..768d93dbcf1 100644 --- a/xml/System/TypeLoadException.xml +++ b/xml/System/TypeLoadException.xml @@ -268,22 +268,7 @@ The exact timing of when statically referenced types are loaded is unspecified. The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. The object is . XML and SOAP Serialization @@ -415,25 +400,7 @@ The exact timing of when statically referenced types are loaded is unspecified. The object that holds the serialized object data. The contextual information about the source or destination. Sets the object with the class name, method name, resource ID, and additional exception information. - - sets a with all the exception object data targeted for serialization. During deserialization, the exception object is reconstituted from the transmitted over the stream. - - For more information, see [XML and SOAP Serialization](/dotnet/standard/serialization/xml-and-soap-serialization). - - - -## Examples - - The following example generates an exception, and serializes the exception data to a file, and then reconstitutes the exception. For this code example to run, you must provide the fully qualified assembly name. For information about how to obtain the fully qualified assembly name, see [Assembly Names](/dotnet/standard/assembly/names). - - :::code language="csharp" source="~/snippets/csharp/System/TypeLoadException/.ctor/typeloadexception_getobjectdata.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System/TypeLoadException/.ctor/typeloadexception_getobjectdata.vb" id="Snippet1"::: - - ]]> - + To be added. The object is . XML and SOAP Serialization diff --git a/xml/System/TypeUnloadedException.xml b/xml/System/TypeUnloadedException.xml index d302c2547ae..b026ab22800 100644 --- a/xml/System/TypeUnloadedException.xml +++ b/xml/System/TypeUnloadedException.xml @@ -241,14 +241,7 @@ The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with serialized data. - - - + To be added. XML and SOAP Serialization diff --git a/xml/System/Uri.xml b/xml/System/Uri.xml index 3bcf5e86f49..c7f7e87617c 100644 --- a/xml/System/Uri.xml +++ b/xml/System/Uri.xml @@ -224,7 +224,6 @@ The following code snippet shows example values of the various properties on the - Changes to the System.Uri namespace in Version 2.0 @@ -407,14 +406,7 @@ The following example creates a instance with the URI `http:// The information required to serialize the new instance. The source of the serialized stream associated with the new instance. Initializes a new instance of the class from the specified instances of the and classes. - - interface for the class. - - ]]> - + To be added. The parameter contains a URI. The parameter contains a URI that is empty. @@ -523,21 +515,7 @@ The following example creates a instance with the URI `http:// if is completely escaped; otherwise, . Initializes a new instance of the class with the specified URI, with explicit control of character escaping. - - instance from a URI string. It parses the URI and puts it in canonical format. - -The `dontEscape` parameter controls whether reserved characters are translated into escape sequences. This parameter should be set to `true` only if you are certain that all reserved characters in the URI have been escaped. Setting the value to `true` for a URI that has not been completely escaped can cause unexpected behavior. It is strongly recommended that you always set this parameter to `false`. - -If `dontEscape` is set to `false`, the constructor escapes any reserved characters by checking that all occurrences of percent (%) are followed by a valid escape sequence. If the character sequence following a percent is not valid, the percent is replaced by %25. - -This constructor does not ensure that the refers to an accessible resource. - - ]]> - + To be added. is . @@ -1031,19 +1009,7 @@ For `uriString`, an IPv6 address in string form must be enclosed within brackets if and are completely escaped; otherwise, . Initializes a new instance of the class based on the specified base and relative URIs, with explicit control of character escaping. - - instance by combining `baseUri` and `relativeUri`. If the URI passed in `relativeUri` is an absolute URI (containing a scheme, host name, and optionally a port number), the instance is created using only `relativeUri`. - - The `dontEscape` parameter controls whether reserved characters are translated into escape sequences. This parameter should be set to `true` only if you are certain that all reserved characters in the URI have been escaped. Setting the value to `true` for a URI that has not been completely escaped can cause unexpected behavior. It is strongly recommended that you always set this parameter to `false`. If `dontEscape` is set to `false`, the constructor escapes any reserved characters by checking that all occurrences of percent (%) are followed by a valid escape sequence. If the character sequence following a percent is not valid, the percent is replaced by %25. - - This constructor does not ensure that the refers to an accessible resource. - - ]]> - + To be added. is . @@ -1085,9 +1051,6 @@ For `uriString`, an IPv6 address in string form must be enclosed within brackets -or- The MS-DOS path specified in doesn't start with c:\\\\. - - Because of security concerns, your application should not call this constructor with URI strings from untrusted sources and with set to . Alternately, you can check a URI string for validity by calling the method prior to calling this constructor. - @@ -1319,14 +1282,7 @@ For `uriString`, an IPv6 address in string form must be enclosed within brackets Converts the internally stored URI to canonical form. - - - + To be added. This instance represents a relative URI, and this method is valid only for absolute URIs. The URI is incorrectly formed. @@ -2005,18 +1961,7 @@ If you used an escaped string to construct this instance (for example, `"http:// The string to transform to its escaped representation. Converts a string to its escaped representation. The escaped representation of the string. - - method converts RFC 2396 reserved characters and all characters with a character value greater than 127 to hexadecimal representation. All Unicode characters are converted to UTF-8 format before being escaped. - - By default, the string is escaped according to RFC 2396. If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing is enabled, the string is escaped according to RFC 3986 and RFC 3987. - - For more information on IRI support, see the Remarks section for the class. - - ]]> - + To be added. @@ -2072,22 +2017,7 @@ If you used an escaped string to construct this instance (for example, `"http:// The string to escape. Converts a URI string to its escaped representation. The escaped representation of . - - method to prepare an unescaped URI string to be a parameter to the constructor. - - By default, the method converts all characters, except RFC 2396 unreserved characters, to their hexadecimal representation. If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing is enabled, the method converts all characters, except for RFC 3986 unreserved characters, to their hexadecimal representation. All Unicode characters are converted to UTF-8 format before being escaped. - - This method assumes that `stringToEscape` has no escape sequences in it. - - By default, the string is escaped according to RFC 2396. If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing is enabled, the string is escaped according to RFC 3986 and RFC 3987. See these RFCs for a definition of reserved and unreserved characters. - - For more information on IRI support, see the Remarks section for the class. - - ]]> - + To be added. is . @@ -2866,14 +2796,7 @@ IdnHost is provided as the preferred alternative to using the deprecated Indicates whether a character is invalid in a file system name. if the specified character is invalid; otherwise, . - - - + To be added. @@ -3710,23 +3633,7 @@ IdnHost is provided as the preferred alternative to using the deprecated If the hostname and scheme of this URI instance and are the same, then this method returns a that represents a relative URI that, when appended to the current URI instance, yields the parameter. If the hostname or scheme is different, then this method returns a that represents the parameter. - - . - -|Current URI instance|`toUri`|Return value| -|--------------------------|-------------|------------------| -|`http://www.contoso.com/`|`http://www.contoso.com/test/test.htm`|`test/test.htm`| -|`http://www.contoso.com/test1/`|`http://www.contoso.com/`|`../`| -|`http://www.contoso.com:8000/`|`http://www.contoso.com/test/test.htm`|`http://www.contoso.com/test/test.htm`| -|`http://username@www.contoso.com/`|`http://www.contoso.com/test1/test1.txt`|`test1/test1.txt`| - - User information, if present in the URI, is ignored. - - ]]> - + To be added. is . This instance represents a relative URI, and this method is valid only for absolute URIs. @@ -5201,7 +5108,6 @@ IdnHost is provided as the preferred alternative to using the deprecated is . - diff --git a/xml/System/UriFormatException.xml b/xml/System/UriFormatException.xml index 90dbc600426..c36383e328f 100644 --- a/xml/System/UriFormatException.xml +++ b/xml/System/UriFormatException.xml @@ -224,14 +224,7 @@ A that contains the information that is required to serialize the new . A that contains the source of the serialized stream that is associated with the new . Initializes a new instance of the class from the specified and instances. - - interface for the class. - - ]]> - + To be added. diff --git a/xml/System/WeakReference.xml b/xml/System/WeakReference.xml index 43f49e0b9ce..01682513e38 100644 --- a/xml/System/WeakReference.xml +++ b/xml/System/WeakReference.xml @@ -265,14 +265,7 @@ An object that holds all the data needed to serialize or deserialize the current object. (Reserved) Describes the source and destination of the serialized stream specified by . Initializes a new instance of the class, using deserialized data from the specified serialization and stream objects. - - - + To be added. is . @@ -379,16 +372,7 @@ An object that holds all the data needed to serialize or deserialize the current object. (Reserved) The location where serialized data is stored and retrieved. Populates a object with all the data needed to serialize the current object. - - object. - - The `context` parameter is reserved and is not currently used in the execution of this method. - - ]]> - + To be added. is . diff --git a/xml/ns-IEHost.Execute.xml b/xml/ns-IEHost.Execute.xml deleted file mode 100644 index 428249ed85b..00000000000 --- a/xml/ns-IEHost.Execute.xml +++ /dev/null @@ -1,7 +0,0 @@ - - - To be added. - To be added. - - - diff --git a/xml/ns-Microsoft.Activities.Build.Debugger.xml b/xml/ns-Microsoft.Activities.Build.Debugger.xml deleted file mode 100644 index d9e4475a73a..00000000000 --- a/xml/ns-Microsoft.Activities.Build.Debugger.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Classes related to the build debugger. - To be added. - - \ No newline at end of file diff --git a/xml/ns-Microsoft.Activities.Build.Expressions.xml b/xml/ns-Microsoft.Activities.Build.Expressions.xml deleted file mode 100644 index ade63291b80..00000000000 --- a/xml/ns-Microsoft.Activities.Build.Expressions.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Classes related to build expressions. - To be added. - - \ No newline at end of file diff --git a/xml/ns-Microsoft.Activities.Build.Validation.xml b/xml/ns-Microsoft.Activities.Build.Validation.xml deleted file mode 100644 index 0eda1166ede..00000000000 --- a/xml/ns-Microsoft.Activities.Build.Validation.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - The provides classes related to build validation. - To be added. - - \ No newline at end of file diff --git a/xml/ns-Microsoft.Activities.Build.xml b/xml/ns-Microsoft.Activities.Build.xml deleted file mode 100644 index 5ccafd76603..00000000000 --- a/xml/ns-Microsoft.Activities.Build.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Classes related to workflow build tasks. - To be added. - - \ No newline at end of file diff --git a/xml/ns-Microsoft.Aspnet.Snapin.xml b/xml/ns-Microsoft.Aspnet.Snapin.xml deleted file mode 100644 index 82fc46c0196..00000000000 --- a/xml/ns-Microsoft.Aspnet.Snapin.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that are necessary for the ASP.NET management console application to interact with the Microsoft Management Console (MMC). - To be added. - - diff --git a/xml/ns-Microsoft.Build.Tasks.Windows.xml b/xml/ns-Microsoft.Build.Tasks.Windows.xml deleted file mode 100644 index 8c0eb6c75cc..00000000000 --- a/xml/ns-Microsoft.Build.Tasks.Windows.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains the implementation of all tasks shipping with MSBuild. The types in this namespace support the Windows Presentation Foundation (WPF) infrastructure and are not intended to be used directly from your code. - To be added. - - diff --git a/xml/ns-Microsoft.CSharp.Activities.xml b/xml/ns-Microsoft.CSharp.Activities.xml deleted file mode 100644 index 0ef2ed7287b..00000000000 --- a/xml/ns-Microsoft.CSharp.Activities.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Classes related to C# activities. - To be added. - - \ No newline at end of file diff --git a/xml/ns-Microsoft.IE.xml b/xml/ns-Microsoft.IE.xml deleted file mode 100644 index a9d9a061134..00000000000 --- a/xml/ns-Microsoft.IE.xml +++ /dev/null @@ -1,7 +0,0 @@ - - - To be added. - To be added. - - - diff --git a/xml/ns-Microsoft.JScript.Vsa.xml b/xml/ns-Microsoft.JScript.Vsa.xml deleted file mode 100644 index 532e591f19f..00000000000 --- a/xml/ns-Microsoft.JScript.Vsa.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains interfaces that allow you to integrate Script for the.NET Framework script engines into JScript, and to compile and execute code at run time. - To be added. - - diff --git a/xml/ns-Microsoft.JScript.xml b/xml/ns-Microsoft.JScript.xml deleted file mode 100644 index e200b7f5e9c..00000000000 --- a/xml/ns-Microsoft.JScript.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that support compilation and code generation using the JScript language. - To be added. - - diff --git a/xml/ns-Microsoft.VisualBasic.Activities.XamlIntegration.xml b/xml/ns-Microsoft.VisualBasic.Activities.XamlIntegration.xml deleted file mode 100644 index 4b6c4e81a81..00000000000 --- a/xml/ns-Microsoft.VisualBasic.Activities.XamlIntegration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to Visual Basic XAML integration. - To be added. - - \ No newline at end of file diff --git a/xml/ns-Microsoft.VisualBasic.Activities.xml b/xml/ns-Microsoft.VisualBasic.Activities.xml deleted file mode 100644 index c57d5c2fc28..00000000000 --- a/xml/ns-Microsoft.VisualBasic.Activities.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to Visual Basic activities.h. - To be added. - - \ No newline at end of file diff --git a/xml/ns-Microsoft.VisualBasic.Compatibility.VB6.xml b/xml/ns-Microsoft.VisualBasic.Compatibility.VB6.xml deleted file mode 100644 index 7e1fd30d272..00000000000 --- a/xml/ns-Microsoft.VisualBasic.Compatibility.VB6.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - Contains functions and objects provided use by the tools for upgrading from Visual Basic 6.0 to Visual Basic 2008. - - namespace are provided for use by the tools for upgrading from Visual Basic 6.0 to Visual Basic 2008. In most cases, these functions and objects duplicate functionality that you can find in other namespaces in the .NET Framework. They are necessary only when the Visual Basic 6.0 code model differs significantly from the .NET Framework implementation. - - ]]> - - - diff --git a/xml/ns-Microsoft.VisualBasic.Vsa.xml b/xml/ns-Microsoft.VisualBasic.Vsa.xml deleted file mode 100644 index f2956f83623..00000000000 --- a/xml/ns-Microsoft.VisualBasic.Vsa.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains objects that allow you to integrate Script for the .NET Framework script engines into Visual Basic, and to compile and execute code at run time. - To be added. - - diff --git a/xml/ns-Microsoft.VisualC.StlClr.Generic.xml b/xml/ns-Microsoft.VisualC.StlClr.Generic.xml deleted file mode 100644 index 8e7e970488f..00000000000 --- a/xml/ns-Microsoft.VisualC.StlClr.Generic.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains the classes, interfaces, and iterators that are used to implement the generic interface to the STL/CLR Library. By using this generic interface, other .NET languages, such as C# and Visual Basic, can call code that is written using STL/CLR. - To be added. - - diff --git a/xml/ns-Microsoft.VisualC.StlClr.xml b/xml/ns-Microsoft.VisualC.StlClr.xml deleted file mode 100644 index 683331c30da..00000000000 --- a/xml/ns-Microsoft.VisualC.StlClr.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains the classes, interfaces, and enumerators that are used to implement the STL/CLR Library. - To be added. - - \ No newline at end of file diff --git a/xml/ns-Microsoft.VisualC.xml b/xml/ns-Microsoft.VisualC.xml deleted file mode 100644 index f30cbcc99a5..00000000000 --- a/xml/ns-Microsoft.VisualC.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that support compilation and code generation using the C++ language. - To be added. - - diff --git a/xml/ns-Microsoft.Vsa.Vb.CodeDOM.xml b/xml/ns-Microsoft.Vsa.Vb.CodeDOM.xml deleted file mode 100644 index 2165196deeb..00000000000 --- a/xml/ns-Microsoft.Vsa.Vb.CodeDOM.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - To be added. - To be added. - - diff --git a/xml/ns-Microsoft.Vsa.xml b/xml/ns-Microsoft.Vsa.xml deleted file mode 100644 index c01b079611e..00000000000 --- a/xml/ns-Microsoft.Vsa.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - To be added. - To be added. - - diff --git a/xml/ns-Microsoft_VsaVb.xml b/xml/ns-Microsoft_VsaVb.xml deleted file mode 100644 index 75c8f65c754..00000000000 --- a/xml/ns-Microsoft_VsaVb.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - To be added. - To be added. - - diff --git a/xml/ns-System.Activities.Core.Presentation.Factories.xml b/xml/ns-System.Activities.Core.Presentation.Factories.xml deleted file mode 100644 index ae912502c45..00000000000 --- a/xml/ns-System.Activities.Core.Presentation.Factories.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to presentation factories. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Core.Presentation.Themes.xml b/xml/ns-System.Activities.Core.Presentation.Themes.xml deleted file mode 100644 index 78bddb366cf..00000000000 --- a/xml/ns-System.Activities.Core.Presentation.Themes.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to presentation themes. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Core.Presentation.xml b/xml/ns-System.Activities.Core.Presentation.xml deleted file mode 100644 index d5048fc6145..00000000000 --- a/xml/ns-System.Activities.Core.Presentation.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to presentation. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Debugger.Symbol.xml b/xml/ns-System.Activities.Debugger.Symbol.xml deleted file mode 100644 index 160c1ef6e21..00000000000 --- a/xml/ns-System.Activities.Debugger.Symbol.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to debugger symbols. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Debugger.xml b/xml/ns-System.Activities.Debugger.xml deleted file mode 100644 index 7e343b6baf9..00000000000 --- a/xml/ns-System.Activities.Debugger.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to the system debugger. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.DurableInstancing.xml b/xml/ns-System.Activities.DurableInstancing.xml deleted file mode 100644 index 880a0d90c77..00000000000 --- a/xml/ns-System.Activities.DurableInstancing.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to durable instancing. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.DynamicUpdate.xml b/xml/ns-System.Activities.DynamicUpdate.xml deleted file mode 100644 index b7faaceaf46..00000000000 --- a/xml/ns-System.Activities.DynamicUpdate.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to dynamic updates. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.ExpressionParser.xml b/xml/ns-System.Activities.ExpressionParser.xml deleted file mode 100644 index b11d4f1c300..00000000000 --- a/xml/ns-System.Activities.ExpressionParser.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to expression parsing. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Expressions.xml b/xml/ns-System.Activities.Expressions.xml deleted file mode 100644 index dc67f3deaf5..00000000000 --- a/xml/ns-System.Activities.Expressions.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to expressions. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Hosting.xml b/xml/ns-System.Activities.Hosting.xml deleted file mode 100644 index 599dac32d7f..00000000000 --- a/xml/ns-System.Activities.Hosting.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to hosting. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Persistence.xml b/xml/ns-System.Activities.Persistence.xml deleted file mode 100644 index f438c8fbea0..00000000000 --- a/xml/ns-System.Activities.Persistence.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to persistence. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Presentation.Annotations.xml b/xml/ns-System.Activities.Presentation.Annotations.xml deleted file mode 100644 index 994b2185d57..00000000000 --- a/xml/ns-System.Activities.Presentation.Annotations.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to presentation annotations. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Presentation.Converters.xml b/xml/ns-System.Activities.Presentation.Converters.xml deleted file mode 100644 index c4ab3cf7772..00000000000 --- a/xml/ns-System.Activities.Presentation.Converters.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to converters. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Presentation.Debug.xml b/xml/ns-System.Activities.Presentation.Debug.xml deleted file mode 100644 index da8622d25ce..00000000000 --- a/xml/ns-System.Activities.Presentation.Debug.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to presentation debugging. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Presentation.Expressions.xml b/xml/ns-System.Activities.Presentation.Expressions.xml deleted file mode 100644 index 6941ca1ac8b..00000000000 --- a/xml/ns-System.Activities.Presentation.Expressions.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to expressions. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Presentation.Hosting.xml b/xml/ns-System.Activities.Presentation.Hosting.xml deleted file mode 100644 index 46c500d823b..00000000000 --- a/xml/ns-System.Activities.Presentation.Hosting.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to hosting. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Presentation.Metadata.xml b/xml/ns-System.Activities.Presentation.Metadata.xml deleted file mode 100644 index 263849135fe..00000000000 --- a/xml/ns-System.Activities.Presentation.Metadata.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to presentation metadata. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Presentation.Model.xml b/xml/ns-System.Activities.Presentation.Model.xml deleted file mode 100644 index 4c8de17b629..00000000000 --- a/xml/ns-System.Activities.Presentation.Model.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to presentation model. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Presentation.PropertyEditing.xml b/xml/ns-System.Activities.Presentation.PropertyEditing.xml deleted file mode 100644 index db7c160134b..00000000000 --- a/xml/ns-System.Activities.Presentation.PropertyEditing.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to property editing. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Presentation.Services.xml b/xml/ns-System.Activities.Presentation.Services.xml deleted file mode 100644 index cc3866b4abb..00000000000 --- a/xml/ns-System.Activities.Presentation.Services.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to presentation services. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Presentation.Sqm.xml b/xml/ns-System.Activities.Presentation.Sqm.xml deleted file mode 100644 index 04c87b324c0..00000000000 --- a/xml/ns-System.Activities.Presentation.Sqm.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to SQM. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Presentation.Toolbox.xml b/xml/ns-System.Activities.Presentation.Toolbox.xml deleted file mode 100644 index 88c4b5fa886..00000000000 --- a/xml/ns-System.Activities.Presentation.Toolbox.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Classes related to the presentation toolbox. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Presentation.Validation.xml b/xml/ns-System.Activities.Presentation.Validation.xml deleted file mode 100644 index 8483ea5d2c3..00000000000 --- a/xml/ns-System.Activities.Presentation.Validation.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to validation. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Presentation.View.OutlineView.xml b/xml/ns-System.Activities.Presentation.View.OutlineView.xml deleted file mode 100644 index e13213ba825..00000000000 --- a/xml/ns-System.Activities.Presentation.View.OutlineView.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to the outline view. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Presentation.View.xml b/xml/ns-System.Activities.Presentation.View.xml deleted file mode 100644 index 26b8c8e0502..00000000000 --- a/xml/ns-System.Activities.Presentation.View.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to presentation views. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Presentation.ViewState.xml b/xml/ns-System.Activities.Presentation.ViewState.xml deleted file mode 100644 index 2b459da34f2..00000000000 --- a/xml/ns-System.Activities.Presentation.ViewState.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to view state data and management of view states. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Presentation.xml b/xml/ns-System.Activities.Presentation.xml deleted file mode 100644 index 83b17932810..00000000000 --- a/xml/ns-System.Activities.Presentation.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to presentation. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Statements.Tracking.xml b/xml/ns-System.Activities.Statements.Tracking.xml deleted file mode 100644 index ea2e5312e95..00000000000 --- a/xml/ns-System.Activities.Statements.Tracking.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes for monitoring state machine state executions and state transitions. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Statements.xml b/xml/ns-System.Activities.Statements.xml deleted file mode 100644 index e2afb441842..00000000000 --- a/xml/ns-System.Activities.Statements.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to activity statements. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.Tracking.xml b/xml/ns-System.Activities.Tracking.xml deleted file mode 100644 index 2d4f8b73571..00000000000 --- a/xml/ns-System.Activities.Tracking.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes used to create and interact with workflow tracking records. Tracking records are created by the workflow runtime when a workflow instance executes, and are accessed by classes that inherit from . - To be added. - - diff --git a/xml/ns-System.Activities.Validation.xml b/xml/ns-System.Activities.Validation.xml deleted file mode 100644 index 1bd325bfeb8..00000000000 --- a/xml/ns-System.Activities.Validation.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to custom activity validation. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.XamlIntegration.xml b/xml/ns-System.Activities.XamlIntegration.xml deleted file mode 100644 index c99b293e942..00000000000 --- a/xml/ns-System.Activities.XamlIntegration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that provide support for the serialization of activities into XAML. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Activities.xml b/xml/ns-System.Activities.xml deleted file mode 100644 index 3b8dd231f11..00000000000 --- a/xml/ns-System.Activities.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to system activities. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.AddIn.Contract.Automation.xml b/xml/ns-System.AddIn.Contract.Automation.xml deleted file mode 100644 index d812d3ce6d6..00000000000 --- a/xml/ns-System.AddIn.Contract.Automation.xml +++ /dev/null @@ -1,19 +0,0 @@ - - - Contains interfaces that components use to access type information and invoke type members. - - namespace to enable components to access type information for a remote object without having direct access to the of the remote object. The namespace defines reflection functionality for components that use the interfaces and structures in the , , and namespaces to communicate. The interfaces in these namespaces are also called contracts. All contracts derive from the interface. - - When using contracts to manage the communication between components, you must implement the interface in a type to expose the type information to other components. Components can then access the members of the type by calling the method of the interface to get an . The other interfaces and structures in the namespace provide access to type information for delegates, properties, methods, events, and fields. - - Components can use the contracts in the namespace to access type information for an object that is in a different process or application domain, or in the same process or application domain. - - ]]> - - - - - diff --git a/xml/ns-System.AddIn.Contract.Collections.xml b/xml/ns-System.AddIn.Contract.Collections.xml deleted file mode 100644 index 10290b5cbc0..00000000000 --- a/xml/ns-System.AddIn.Contract.Collections.xml +++ /dev/null @@ -1,23 +0,0 @@ - - - Contains interfaces that define collections of and objects. - - namespace to implement collection classes for and objects. - - The interfaces in the namespace are also called contracts. All contracts derive from the interface. - - The namespace contains two sets of interfaces: - -- Interfaces that define generic and enumerable collections of types that implement the interface. - -- Interfaces that define enumerable collections of objects. - - ]]> - - - - - diff --git a/xml/ns-System.AddIn.Contract.xml b/xml/ns-System.AddIn.Contract.xml deleted file mode 100644 index 1285a6f9fb4..00000000000 --- a/xml/ns-System.AddIn.Contract.xml +++ /dev/null @@ -1,19 +0,0 @@ - - - Contains interfaces and structures that provide the basis for communication between components that are updated independently. - - namespace defines a set of interfaces and structures that can be used by independently updated components, such as an application and an add-in, to communicate. Components can use the interfaces and structures in the namespace to communicate across process or application domain boundaries, or to communicate with other components in the same process or application domain. - - The interfaces in the namespace are also called contracts. All contracts derive from the interface. The purpose that serves for components created using the .NET Framework is similar to the purpose that the `IUnknown` interface serves for components created using COM. To determine whether an object implements a particular contract, components use the method. - - The and namespaces contain additional contracts that supplement the namespace. The namespace contains contracts that components use to access type information and invoke type members. The namespace contains contracts that define collections of and objects. - - ]]> - - - - - diff --git a/xml/ns-System.AddIn.Hosting.xml b/xml/ns-System.AddIn.Hosting.xml deleted file mode 100644 index d9ce06c8eac..00000000000 --- a/xml/ns-System.AddIn.Hosting.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes for discovering, registering, activating, and controlling Add-Ins. - To be added. - - diff --git a/xml/ns-System.AddIn.Pipeline.xml b/xml/ns-System.AddIn.Pipeline.xml deleted file mode 100644 index 3b8a5de812a..00000000000 --- a/xml/ns-System.AddIn.Pipeline.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes for constructing the communication pipeline between a host application and an add-in. - To be added. - - diff --git a/xml/ns-System.AddIn.xml b/xml/ns-System.AddIn.xml deleted file mode 100644 index 9bcbd2f46a8..00000000000 --- a/xml/ns-System.AddIn.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains the attribute for identifying add-ins. - To be added. - - diff --git a/xml/ns-System.ComponentModel.Design.Data.xml b/xml/ns-System.ComponentModel.Design.Data.xml deleted file mode 100644 index 52f8ac07fa4..00000000000 --- a/xml/ns-System.ComponentModel.Design.Data.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes you can use to build custom design-time behavior for data-related components. - To be added. - - diff --git a/xml/ns-System.Configuration.Install.xml b/xml/ns-System.Configuration.Install.xml deleted file mode 100644 index 31fd609416f..00000000000 --- a/xml/ns-System.Configuration.Install.xml +++ /dev/null @@ -1,17 +0,0 @@ - - - Provides classes that allow you to write custom installers for your own components. The class is the base class for all custom installers in .NET Framework. - - property, an installer contains a collection of other installers as children. As the installer is executed, it cycles through its children and calls , , , or . For an example of an object in the collection, see . - - The property contains information about the installation. For example, information about the location of the log file for the installation, the location of the file that saves information required by the method, and the command line that was entered when the installation executable was run. For an example of an installation executable, see [Installutil.exe (Installer Tool)](/dotnet/framework/tools/installutil-exe-installer-tool). - - The , , , and methods are not always called on the same instance of . For example, you might use an to install and commit an application, and then release the reference to that . Later, uninstalling the application creates a new reference to an , which means that the method is called on a different instance of . For this reason, do not save the state of a computer in an installer. Instead, use an that is preserved across calls and passed into the , , , and methods. - - ]]> - - - diff --git a/xml/ns-System.Data.Common.CommandTrees.ExpressionBuilder.Spatial.xml b/xml/ns-System.Data.Common.CommandTrees.ExpressionBuilder.Spatial.xml deleted file mode 100644 index c33d1442a19..00000000000 --- a/xml/ns-System.Data.Common.CommandTrees.ExpressionBuilder.Spatial.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains a class that represent the Entity Data Model (EDM) functions of a spatial. - To be added. - - diff --git a/xml/ns-System.Data.Common.CommandTrees.ExpressionBuilder.xml b/xml/ns-System.Data.Common.CommandTrees.ExpressionBuilder.xml deleted file mode 100644 index 8bf56461169..00000000000 --- a/xml/ns-System.Data.Common.CommandTrees.ExpressionBuilder.xml +++ /dev/null @@ -1,20 +0,0 @@ - - - Provides a command tree API. - - API is used to create expressions, which are represented by objects. The command tree API provided by the class has the following characteristics: - -- Functional: objects are constructed using functional patterns that provide a natural flow of construction. - -- Loosely-coupled: A object is not bound to any specific command tree and can be used in any context where type agreement is satisfied. - -- Immutable: The API consists entirely of immutable types; mutability may be simulated by substituting new values while rebuilding an expression tree. - - ]]> - - - diff --git a/xml/ns-System.Data.Common.CommandTrees.xml b/xml/ns-System.Data.Common.CommandTrees.xml deleted file mode 100644 index 2ec493d2433..00000000000 --- a/xml/ns-System.Data.Common.CommandTrees.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - Provides classes to build expressions that make up a command tree. - - - - - diff --git a/xml/ns-System.Data.Common.EntitySql.xml b/xml/ns-System.Data.Common.EntitySql.xml deleted file mode 100644 index 9b16c052556..00000000000 --- a/xml/ns-System.Data.Common.EntitySql.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Includes the class and other support classes. These classes enable you to parse an Entity SQL query string and create a command tree query. - To be added. - - diff --git a/xml/ns-System.Data.Design.xml b/xml/ns-System.Data.Design.xml deleted file mode 100644 index 787259f0889..00000000000 --- a/xml/ns-System.Data.Design.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that can be used to generate a custom typed-dataset. - To be added. - - diff --git a/xml/ns-System.Data.Entity.Design.AspNet.xml b/xml/ns-System.Data.Entity.Design.AspNet.xml deleted file mode 100644 index a7b2597f356..00000000000 --- a/xml/ns-System.Data.Entity.Design.AspNet.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains the Entity Data Model (EDM) build providers for the ASP.NET build environment. - To be added. - - diff --git a/xml/ns-System.Data.Entity.Design.PluralizationServices.xml b/xml/ns-System.Data.Entity.Design.PluralizationServices.xml deleted file mode 100644 index 53db4fddbdb..00000000000 --- a/xml/ns-System.Data.Entity.Design.PluralizationServices.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes for changing words from singular to plural form, and vice versa. - To be added. - - diff --git a/xml/ns-System.Data.Entity.Design.xml b/xml/ns-System.Data.Entity.Design.xml deleted file mode 100644 index 71e1e4193f0..00000000000 --- a/xml/ns-System.Data.Entity.Design.xml +++ /dev/null @@ -1,12 +0,0 @@ - - - Contains classes to generate Entity Data Model (EDM) files and object source code. - - classes support the EDM tools. - - ]]> - - - diff --git a/xml/ns-System.Data.EntityClient.xml b/xml/ns-System.Data.EntityClient.xml deleted file mode 100644 index 96459704f71..00000000000 --- a/xml/ns-System.Data.EntityClient.xml +++ /dev/null @@ -1,17 +0,0 @@ - - - The namespace is the .NET Framework Data Provider for the Entity Framework. - - [!NOTE] -> For more information about how to use this namespace in Entity Framework applications, see [ADO.NET Entity Framework](/dotnet/framework/data/adonet/ef/). - - ]]> - - EntityClient Provider for Entity Framework - - diff --git a/xml/ns-System.Data.Linq.Mapping.xml b/xml/ns-System.Data.Linq.Mapping.xml deleted file mode 100644 index 616d1337d19..00000000000 --- a/xml/ns-System.Data.Linq.Mapping.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that are used to generate a LINQ to SQL object model that represents the structure and content of a relational database. - To be added. - - diff --git a/xml/ns-System.Data.Linq.SqlClient.Implementation.xml b/xml/ns-System.Data.Linq.SqlClient.Implementation.xml deleted file mode 100644 index 9e8c58b970b..00000000000 --- a/xml/ns-System.Data.Linq.SqlClient.Implementation.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains types that are used for the internal implementation details of a SQL Server provider. - To be added. - - diff --git a/xml/ns-System.Data.Linq.SqlClient.xml b/xml/ns-System.Data.Linq.SqlClient.xml deleted file mode 100644 index 4621b66acc7..00000000000 --- a/xml/ns-System.Data.Linq.SqlClient.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains provider classes for communicating with SQL Server and classes that contain query helper methods. - To be added. - - diff --git a/xml/ns-System.Data.Linq.xml b/xml/ns-System.Data.Linq.xml deleted file mode 100644 index 42884c3c47a..00000000000 --- a/xml/ns-System.Data.Linq.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - Contains classes that support interaction with relational databases in LINQ to SQL applications. - - - - - diff --git a/xml/ns-System.Data.Mapping.xml b/xml/ns-System.Data.Mapping.xml deleted file mode 100644 index e279d1375c4..00000000000 --- a/xml/ns-System.Data.Mapping.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides access to the and classes. - To be added. - - diff --git a/xml/ns-System.Data.Metadata.Edm.xml b/xml/ns-System.Data.Metadata.Edm.xml deleted file mode 100644 index 8f9b5165538..00000000000 --- a/xml/ns-System.Data.Metadata.Edm.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains a set of types that represent concepts throughout the models used by the Entity Framework and a set of classes that help applications to work with metadata. - To be added. - - diff --git a/xml/ns-System.Data.Objects.DataClasses.xml b/xml/ns-System.Data.Objects.DataClasses.xml deleted file mode 100644 index a46240d58a5..00000000000 --- a/xml/ns-System.Data.Objects.DataClasses.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - Includes classes that are base classes for types that are defined in an Entity Data Model (EDM), base classes for the types that are returned by navigation properties, and classes that define attributes that map common language runtime (CLR) objects to types in the conceptual model. - - namespace also includes interfaces that are used to implement custom data classes without inheriting from Entity Framework classes. - - ]]> - - - diff --git a/xml/ns-System.Data.Objects.SqlClient.xml b/xml/ns-System.Data.Objects.SqlClient.xml deleted file mode 100644 index 3567d63029f..00000000000 --- a/xml/ns-System.Data.Objects.SqlClient.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides the class, which contains common language runtime (CLR) methods that translate to database functions. Methods in the class can only be used in LINQ to Entities queries. - To be added. - - diff --git a/xml/ns-System.Data.Objects.xml b/xml/ns-System.Data.Objects.xml deleted file mode 100644 index cc1f401b11d..00000000000 --- a/xml/ns-System.Data.Objects.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Includes classes that provide access to the core functionality of Object Services. These classes enable you to query, insert, update, and delete data by working with strongly typed CLR objects that are instances of entity types. Object Services supports both Language-Integrated Query (LINQ) and Entity SQL queries against types that are defined in an Entity Data Model (EDM). Object Services materializes the returned data as objects and propagates object changes back to the data source. It also provides facilities for tracking changes, binding objects to controls, and handling concurrency. - To be added. - - diff --git a/xml/ns-System.Data.Services.BuildProvider.xml b/xml/ns-System.Data.Services.BuildProvider.xml deleted file mode 100644 index 826f82bb68f..00000000000 --- a/xml/ns-System.Data.Services.BuildProvider.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Classes in this namespace generate C# or Visual Basic code for a WCF Data Services client application based on the metadata returned by the data service. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Data.Services.Client.xml b/xml/ns-System.Data.Services.Client.xml deleted file mode 100644 index 8feb23164f6..00000000000 --- a/xml/ns-System.Data.Services.Client.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Represents the .NET Framework client library that applications can use to interact with WCF Data Services. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Data.Services.Common.xml b/xml/ns-System.Data.Services.Common.xml deleted file mode 100644 index 60a1328d1c5..00000000000 --- a/xml/ns-System.Data.Services.Common.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Implements functionality common to both WCF Data Services client and server runtimes. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Data.Services.Configuration.xml b/xml/ns-System.Data.Services.Configuration.xml deleted file mode 100644 index 203a41c3585..00000000000 --- a/xml/ns-System.Data.Services.Configuration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - This namespace provides configuration settings for WCF data services features. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Data.Services.Design.xml b/xml/ns-System.Data.Services.Design.xml deleted file mode 100644 index e50828f3a77..00000000000 --- a/xml/ns-System.Data.Services.Design.xml +++ /dev/null @@ -1,15 +0,0 @@ - - - Used by the code generation command line tools and tools in Visual Studio to generate strongly-typed client side objects for communicating with data services. - - - - - \ No newline at end of file diff --git a/xml/ns-System.Data.Services.Internal.xml b/xml/ns-System.Data.Services.Internal.xml deleted file mode 100644 index 0221d4a3706..00000000000 --- a/xml/ns-System.Data.Services.Internal.xml +++ /dev/null @@ -1,15 +0,0 @@ - - - This class is not for public use and is used internally by the system to implement support for queries with eager loading of related entities. - - - - - diff --git a/xml/ns-System.Data.Services.Providers.xml b/xml/ns-System.Data.Services.Providers.xml deleted file mode 100644 index 1da4beb3aa4..00000000000 --- a/xml/ns-System.Data.Services.Providers.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - Provides a series of interfaces that are implemented to define a custom data service provider for WCF Data Services. - - - - - \ No newline at end of file diff --git a/xml/ns-System.Data.Services.xml b/xml/ns-System.Data.Services.xml deleted file mode 100644 index 86575616eef..00000000000 --- a/xml/ns-System.Data.Services.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides access to classes used to build WCF Data Services. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Data.Spatial.xml b/xml/ns-System.Data.Spatial.xml deleted file mode 100644 index 2bfd980da60..00000000000 --- a/xml/ns-System.Data.Spatial.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes for spatial database functionality. - To be added. - - diff --git a/xml/ns-System.Data.Sql.xml b/xml/ns-System.Data.Sql.xml deleted file mode 100644 index 026be8ae52a..00000000000 --- a/xml/ns-System.Data.Sql.xml +++ /dev/null @@ -1,14 +0,0 @@ - - - Contains classes that support SQL Server-specific functionality. - - - - - - - diff --git a/xml/ns-System.Deployment.Internal.xml b/xml/ns-System.Deployment.Internal.xml deleted file mode 100644 index 30affc7a59e..00000000000 --- a/xml/ns-System.Deployment.Internal.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains helper classes for accessing the internal members of and objects. - To be added. - - diff --git a/xml/ns-System.Device.Location.xml b/xml/ns-System.Device.Location.xml deleted file mode 100644 index f4599467062..00000000000 --- a/xml/ns-System.Device.Location.xml +++ /dev/null @@ -1,23 +0,0 @@ - - - Allows application developers to easily access the computer's location by using a single API. Location information may come from multiple providers, such as GPS, Wi-Fi triangulation, and cell phone tower triangulation. The classes provide a single API to encapsulate the multiple location providers on a computer and support seamless prioritization and transitioning between them. As a result, application developers who use this API do not need to tailor applications to specific hardware configurations. - - class supplies location data that is based on latitude and longitude coordinates. The and types provide the ability to resolve from a coordinate location to a civic address. Additionally, the interface can be implemented to extend the types of location data that are supplied. - - In Windows 7, all the classes are fully functional if a location provider is installed and can determine the computer's location. On Windows 7 Starter Edition, the Default Location Provider that can be set in Control Panel is the only location provider that is supported. - - **Note** In versions of Windows prior to Windows 7, the following conditions apply: - -- All objects that have constructors can be created, but the property will always have the value . - -- The location indicated by the property of will always be . - -- No location events will be raised. - - ]]> - - - diff --git a/xml/ns-System.Diagnostics.Contracts.Internal.xml b/xml/ns-System.Diagnostics.Contracts.Internal.xml deleted file mode 100644 index 5a45a1ae396..00000000000 --- a/xml/ns-System.Diagnostics.Contracts.Internal.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes that the binary rewriter can use to handle a contract failure. - To be added. - - diff --git a/xml/ns-System.Diagnostics.Design.xml b/xml/ns-System.Diagnostics.Design.xml deleted file mode 100644 index 130bf2a9bf4..00000000000 --- a/xml/ns-System.Diagnostics.Design.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that can be used to extend design-time support for application monitoring and instrumentation. - To be added. - - diff --git a/xml/ns-System.Diagnostics.Eventing.xml b/xml/ns-System.Diagnostics.Eventing.xml deleted file mode 100644 index 4682e564458..00000000000 --- a/xml/ns-System.Diagnostics.Eventing.xml +++ /dev/null @@ -1,5 +0,0 @@ - - - Contains the classes used to instrument your application. The instrumentation, when enabled, logs the event data to the Event Tracing for Windows (ETW) tracing subsystem. For a complete description of ETW, see Event Tracing for Windows. - - diff --git a/xml/ns-System.EnterpriseServices.CompensatingResourceManager.xml b/xml/ns-System.EnterpriseServices.CompensatingResourceManager.xml deleted file mode 100644 index a12682a526d..00000000000 --- a/xml/ns-System.EnterpriseServices.CompensatingResourceManager.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes that allow you to use a Compensating Resource Manager (CRM) in managed code. A CRM is a service provided by COM+ that enables you to include nontransactional objects in Microsoft Distributed Transaction Coordinator (DTC) transactions. Although CRMs do not provide the capabilities of a full resource manager, they do provide transactional atomicity (all or nothing behavior) and durability through the recovery log. - To be added. - - diff --git a/xml/ns-System.EnterpriseServices.Internal.xml b/xml/ns-System.EnterpriseServices.Internal.xml deleted file mode 100644 index 8939f8da502..00000000000 --- a/xml/ns-System.EnterpriseServices.Internal.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides infrastructure support for COM+ services. The classes and interfaces in this namespace are specifically intended to support calls into from the unmanaged COM+ classes. - To be added. - - diff --git a/xml/ns-System.EnterpriseServices.xml b/xml/ns-System.EnterpriseServices.xml deleted file mode 100644 index a4cda23505e..00000000000 --- a/xml/ns-System.EnterpriseServices.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides .NET objects with access to COM+ services making the .NET Framework objects more practical for enterprise applications. - To be added. - - diff --git a/xml/ns-System.IO.Log.xml b/xml/ns-System.IO.Log.xml deleted file mode 100644 index f55b6dfa0fe..00000000000 --- a/xml/ns-System.IO.Log.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Defines an interface for logging to a record-oriented sequential I/O system. - To be added. - - diff --git a/xml/ns-System.IdentityModel.Configuration.xml b/xml/ns-System.IdentityModel.Configuration.xml deleted file mode 100644 index 7f463b11697..00000000000 --- a/xml/ns-System.IdentityModel.Configuration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that provide configuration for applications and services built using the Windows Identity Foundation (WIF). The classes in this namespace represent settings under the <identityConfiguration> element. Classes that configure federation using the WS-Federation protocol are contained primarily in the namespace. These settings appear under the <system.identityModel.services> element in a configuration file. - To be added. - - diff --git a/xml/ns-System.IdentityModel.Metadata.xml b/xml/ns-System.IdentityModel.Metadata.xml deleted file mode 100644 index 675682f5381..00000000000 --- a/xml/ns-System.IdentityModel.Metadata.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that represent elements in a Federation Metadata document. A Federation Metadata document is an XML document that provides information that may be useful to partners when establishing a federation. For more information about federation metadata, see section three of the following specification: Web Services Federation Language (WS-Federation) Version 1.2. - To be added. - - diff --git a/xml/ns-System.IdentityModel.Protocols.WSTrust.xml b/xml/ns-System.IdentityModel.Protocols.WSTrust.xml deleted file mode 100644 index 56a7bd877d6..00000000000 --- a/xml/ns-System.IdentityModel.Protocols.WSTrust.xml +++ /dev/null @@ -1,8 +0,0 @@ - - - Contains classes that represent WS-Trust artifacts. These include the (RST) and (RSTR) classes and several serializers that can serialize and deserialize between WS-Trust artifacts on the wire and their representation in the object model. - - Out-of-the-box, Windows Identity Foundation (WIF) contains support for the following WS-Trust specifications: WS-Trust February 2005, WS-Trust 1.3, or WS-Trust 1.4. - To be added. - - diff --git a/xml/ns-System.IdentityModel.Services.Configuration.xml b/xml/ns-System.IdentityModel.Services.Configuration.xml deleted file mode 100644 index 0d6378357c4..00000000000 --- a/xml/ns-System.IdentityModel.Services.Configuration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that provide configuration for Windows Identity Foundation (WIF) applications that use the WS-Federation protocol. The classes in this namespace represent settings under the <system.identityModel.services> element. The namespace also contains some of the classes that are used to configure WS-Federation. Classes that configure other service and application settings, such as security token handlers, are contained primarily in the namespace. These settings appear under the <identityConfiguration> element in a configuration file. - To be added. - - diff --git a/xml/ns-System.IdentityModel.Services.Tokens.xml b/xml/ns-System.IdentityModel.Services.Tokens.xml deleted file mode 100644 index b4afe0cddf7..00000000000 --- a/xml/ns-System.IdentityModel.Services.Tokens.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - The contains the class and the class. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.IdentityModel.Services.xml b/xml/ns-System.IdentityModel.Services.xml deleted file mode 100644 index d92aa86735f..00000000000 --- a/xml/ns-System.IdentityModel.Services.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that are used in applications built using Windows Identity Foundation (WIF) that perform federated authentication with the WS-Federation protocol. It contains the HTTP Modules, (WSFAM) and (SAM), as well as classes that support their operation. The WSFAM provides handling for the WS-Federation sign-in and sign-out sequences and the SAM provides session management by maintaining and handling cookies. The namespace also contains classes that represent WS-Federation messages (), such as sign-in (, ) and sign-out messages (), as well as serializers that serialize and deserialize between the object model and the on-the-wire representations of these messages. - To be added. - - diff --git a/xml/ns-System.IdentityModel.xml b/xml/ns-System.IdentityModel.xml deleted file mode 100644 index 9e08a11eac0..00000000000 --- a/xml/ns-System.IdentityModel.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that are used to build security token services (STS). These include the and classes, as well as exception several utility classes that provide the ability to perform cookie transforms. - To be added. - - diff --git a/xml/ns-System.Management.Instrumentation.xml b/xml/ns-System.Management.Instrumentation.xml deleted file mode 100644 index 1aaf1075d5a..00000000000 --- a/xml/ns-System.Management.Instrumentation.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides the classes necessary for instrumenting applications for management and exposing their management information and events through WMI to potential consumers. Consumers such as Microsoft Application Center or Microsoft Operations Manager can then manage your application easily, and monitoring and configuring of your application is available for administrator scripts or other applications, both managed as well as unmanaged. Instrumentation of your application is easy to achieve using the InstrumentationClass custom attribute on classes you wish to expose, or using the provided and base classes and the helper class. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Messaging.Design.xml b/xml/ns-System.Messaging.Design.xml deleted file mode 100644 index a5707eb27d3..00000000000 --- a/xml/ns-System.Messaging.Design.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that can be used to extend design-time support for classes. - To be added. - - diff --git a/xml/ns-System.Messaging.xml b/xml/ns-System.Messaging.xml deleted file mode 100644 index d5bf09f3565..00000000000 --- a/xml/ns-System.Messaging.xml +++ /dev/null @@ -1,53 +0,0 @@ - - - Provides classes that allow you to connect to, monitor, and administer message queues on the network and send, receive, or peek messages. - - class include the following methods for reading and writing messages to the queue: - -- The method enables your application to write messages to the queue. Overloads of the method enable you to specify whether to send your message using a (which provides detailed control over the information you send) or any other managed object, including application-specific classes. The method also supports sending messages as part of a transaction. - -- The , , and methods provide functionality for reading messages from a queue. Like the method, these methods provide overloads that support transactional queue processing. These methods also provide overloads with time-out. - - Out parameters that enable processing to continue if the queue is empty. Because these methods are examples of synchronous processing, they interrupt the current thread until a message is available, unless you specify a time-out. - -- The method is similar to , but it does not cause a message to be removed from the queue when it is read. Because does not change the queue contents, there are no overloads to support transactional processing. However, because , like , reads messages synchronously from the queue, overloads of the method do support specifying a time-out in order to prevent the thread from waiting indefinitely. - -- The , , , and methods provide ways to asynchronously read messages from the queue. They do not interrupt the current thread while waiting for a message to arrive in the queue. - - The following methods of the class provide functionality for retrieving lists of queues by specified criteria and determining if specific queues exist: - -- enables the retrieval of the private queues on a computer. - -- , , and provide ways to retrieve public queues by common criteria. An overload of provides even finer detail for selecting queues based on a number of search criteria. - - Other methods of the class provide the following functionality: - -- Creating and deleting Message Queueing queues. - -- Using a message enumerator to step through the messages in a queue. - -- Using a queue enumerator for iterating through the queues on the system. - -- Setting ACL-based access rights. - -- Working with the connection cache. - - The class provides detailed control over the information you send to a queue, and is the object used when receiving or peeking messages from a queue. Besides the message body, the properties of the class include acknowledgment settings, formatter selection, identification, authentication and encryption information, timestamps, indications about using tracing, server journaling, and dead-letter queues, and transaction data. - - The component is associated with the following three formatters, which enable you to serialize and deserialize messages sent and received from queues: - -- The provides loosely coupled messaging, enabling independent versioning of serialized types on the client and server. - -- The is compatible with the MSMQ COM control. It allows you to send types that can be received by the control and to receive types that were sent by the control. - -- The provides a faster alternative to the , but without the benefit of loosely coupled messaging. - - Other classes in the `Messaging` namespace support code-access and ACL-based security, filtering properties when reading messages from a queue, and using transactions when sending and receiving messages. - - ]]> - - - diff --git a/xml/ns-System.Net.Configuration.xml b/xml/ns-System.Net.Configuration.xml deleted file mode 100644 index dd6f9377d1c..00000000000 --- a/xml/ns-System.Net.Configuration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that applications use to programmatically access and update configuration settings for the namespaces. - To be added. - - diff --git a/xml/ns-System.Runtime.Caching.Configuration.xml b/xml/ns-System.Runtime.Caching.Configuration.xml deleted file mode 100644 index 33f449b0b0d..00000000000 --- a/xml/ns-System.Runtime.Caching.Configuration.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - Contains configuration handler classes for the .NET Framework caching feature. - - namespace. - - ]]> - - - diff --git a/xml/ns-System.Runtime.DesignerServices.xml b/xml/ns-System.Runtime.DesignerServices.xml deleted file mode 100644 index d74afb7de4a..00000000000 --- a/xml/ns-System.Runtime.DesignerServices.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes that support application and component designers in integrated development environments. - To be added. - - diff --git a/xml/ns-System.Runtime.DurableInstancing.xml b/xml/ns-System.Runtime.DurableInstancing.xml deleted file mode 100644 index 4e31397bbbf..00000000000 --- a/xml/ns-System.Runtime.DurableInstancing.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - This namespace contains classes that are used by the Windows Communication Foundation (WCF) infrastructure to implement a persistence provider. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Runtime.Hosting.xml b/xml/ns-System.Runtime.Hosting.xml deleted file mode 100644 index 0cc5f647108..00000000000 --- a/xml/ns-System.Runtime.Hosting.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains advanced types that are used in application activation within application domains. - To be added. - - diff --git a/xml/ns-System.Runtime.InteropServices.CustomMarshalers.xml b/xml/ns-System.Runtime.InteropServices.CustomMarshalers.xml deleted file mode 100644 index 9854476a7eb..00000000000 --- a/xml/ns-System.Runtime.InteropServices.CustomMarshalers.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides internal marshaling support for .NET Framework. - To be added. - - diff --git a/xml/ns-System.Runtime.InteropServices.Expando.xml b/xml/ns-System.Runtime.InteropServices.Expando.xml deleted file mode 100644 index 6ba43e7bb58..00000000000 --- a/xml/ns-System.Runtime.InteropServices.Expando.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains the interface, which allows modification of an object by adding or removing its members. - To be added. - - diff --git a/xml/ns-System.Runtime.Remoting.Activation.xml b/xml/ns-System.Runtime.Remoting.Activation.xml deleted file mode 100644 index eb05ebcc8d3..00000000000 --- a/xml/ns-System.Runtime.Remoting.Activation.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes and objects that support server and client activation of remote objects. - To be added. - - diff --git a/xml/ns-System.Runtime.Remoting.Channels.Http.xml b/xml/ns-System.Runtime.Remoting.Channels.Http.xml deleted file mode 100644 index be43c771a89..00000000000 --- a/xml/ns-System.Runtime.Remoting.Channels.Http.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - Contains channels that use the HTTP protocol to transport messages and objects to and from remote locations. By default, the HTTP channels encode objects and method calls in SOAP format for transmission, but other encoding and decoding formatter sinks can be specified in the configuration properties of a channel. One of the most important classes of the namespace is the class. - - class combines the class and the class, and can be used to receive and send messages using the HTTP protocol. - - ]]> - - - diff --git a/xml/ns-System.Runtime.Remoting.Channels.Ipc.xml b/xml/ns-System.Runtime.Remoting.Channels.Ipc.xml deleted file mode 100644 index b7e938935b9..00000000000 --- a/xml/ns-System.Runtime.Remoting.Channels.Ipc.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Defines a communication channel for remoting that uses the interprocess communication (IPC) system of the Windows operating system. Because it does not use network communication, the IPC channel is much faster than the HTTP and TCP channels, but it can only be used for communication between application domains on the same physical computer. - To be added. - - diff --git a/xml/ns-System.Runtime.Remoting.Channels.Tcp.xml b/xml/ns-System.Runtime.Remoting.Channels.Tcp.xml deleted file mode 100644 index bb2a4b1c039..00000000000 --- a/xml/ns-System.Runtime.Remoting.Channels.Tcp.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - Contains channels that use the TCP protocol to transport messages and objects to and from remote locations. By default, the TCP channels encode objects and method calls in binary format for transmission, but other encoding and decoding formatter sinks can be specified in the configuration properties of a channel. One of the most important classes of the namespace is the class. - - class combines the class and the class, and can be used to both receive and send messages using the TCP protocol. - - ]]> - - - diff --git a/xml/ns-System.Runtime.Remoting.Channels.xml b/xml/ns-System.Runtime.Remoting.Channels.xml deleted file mode 100644 index ab07868faa6..00000000000 --- a/xml/ns-System.Runtime.Remoting.Channels.xml +++ /dev/null @@ -1,15 +0,0 @@ - - - Contains classes that support and handle channels and channel sinks, which are used as the transport medium when a client calls a method on a remote object. - - - - - diff --git a/xml/ns-System.Runtime.Remoting.Contexts.xml b/xml/ns-System.Runtime.Remoting.Contexts.xml deleted file mode 100644 index 786c8822c12..00000000000 --- a/xml/ns-System.Runtime.Remoting.Contexts.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - Contains objects that define the contexts all objects reside within. A context is an ordered sequence of properties that defines an environment for the objects within it. Contexts are created during the activation process for objects that are configured to require certain automatic services such synchronization, transactions, just-in-time (JIT) activation, security, and so on. Multiple objects can live inside a context. - - - - - diff --git a/xml/ns-System.Runtime.Remoting.Lifetime.xml b/xml/ns-System.Runtime.Remoting.Lifetime.xml deleted file mode 100644 index c0473761151..00000000000 --- a/xml/ns-System.Runtime.Remoting.Lifetime.xml +++ /dev/null @@ -1,15 +0,0 @@ - - - Contains classes that manage the lifetime of remote objects. - - - - - diff --git a/xml/ns-System.Runtime.Remoting.Messaging.xml b/xml/ns-System.Runtime.Remoting.Messaging.xml deleted file mode 100644 index 4be0f7185c7..00000000000 --- a/xml/ns-System.Runtime.Remoting.Messaging.xml +++ /dev/null @@ -1,17 +0,0 @@ - - - Contains classes used to create and transmit messages. The remoting infrastructure uses messages to communicate with remote objects. Messages are used to transmit remote method calls, to activate remote objects, and to communicate information. A message object carries a set of named properties, including action identifiers, envoy information, and parameters. Some of the most important classes of the namespace are the class, the class, and the class. - - class stores and returns the results of an asynchronous method call. instances contain the `return` value, call status, the delegate used for the call, and the other information about the asynchronous method call. - - The class can be used to control serialization of objects that extend . A selects the surrogate used in serialization and deserialization of such objects. A surrogate is an object that can control serialization or deserialization of an object. - - The class holds information returned after a remote method call. A holds the `return` value and any `out` or `ref` parameters that resulted from the remote method call. - - ]]> - - - diff --git a/xml/ns-System.Runtime.Remoting.Metadata.W3cXsd2001.xml b/xml/ns-System.Runtime.Remoting.Metadata.W3cXsd2001.xml deleted file mode 100644 index c732b59db51..00000000000 --- a/xml/ns-System.Runtime.Remoting.Metadata.W3cXsd2001.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - Contains wrapper classes for the data types that conform to the W3C specification. All date and time types conform to the ISO standards specification. - - - - - diff --git a/xml/ns-System.Runtime.Remoting.Metadata.xml b/xml/ns-System.Runtime.Remoting.Metadata.xml deleted file mode 100644 index eb000b906f9..00000000000 --- a/xml/ns-System.Runtime.Remoting.Metadata.xml +++ /dev/null @@ -1,15 +0,0 @@ - - - Contains classes and attributes that can be used to customize generation and processing of SOAP for objects and fields. The classes of this namespace can be used to indicate the SOAPAction header field, type output, XML element name, and the method XML namespace URI. This information is used by the SOAP serializer during SOAP generation and the Soapsuds Tool (Soapsuds.exe) during Web Services Description Language (WSDL) generation. The information specified by the attributes in this namespace can be used on the receiving end of the generated SOAP to customize processing of the remoted method calls and objects. One of the most important classes of the namespace is class. The class is nonfunctional, and can only be used as the base class for all the metadata attributes. - - - - - - diff --git a/xml/ns-System.Runtime.Remoting.MetadataServices.xml b/xml/ns-System.Runtime.Remoting.MetadataServices.xml deleted file mode 100644 index d590b007e7e..00000000000 --- a/xml/ns-System.Runtime.Remoting.MetadataServices.xml +++ /dev/null @@ -1,15 +0,0 @@ - - - Contains the classes that are used by the Soapsuds Tool (Soapsuds.exe) command-line tool and the user code to convert metadata to and from XML schema for the remoting infrastructure. Some of the most important classes of this namespace are the class and the class. - - class is used by the remoting infrastructure to generate Web Services Description Language (WSDL) on the server side. - - The class provides the functionality of the [Soapsuds Tool (Soapsuds.exe)](https://learn.microsoft.com/previous-versions/dotnet/netframework-4.0/xd176a6c(v=vs.100)) command-line tool, and can be used programmatically to achieve the same outcome. The methods of the class can be used to create XML schemas that describe services that are exposed in source code, and to create C# code from XML schema. - - ]]> - - - diff --git a/xml/ns-System.Runtime.Remoting.Proxies.xml b/xml/ns-System.Runtime.Remoting.Proxies.xml deleted file mode 100644 index f1225c27e0d..00000000000 --- a/xml/ns-System.Runtime.Remoting.Proxies.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - Contains classes that control and provide functionality for proxies. A proxy is a local object that is an image of a remote object. Proxies enable clients to access objects across remoting boundaries. - - namespace is the class, which provides the base functionality for all remoting proxies, and can be used to create custom proxies. - - ]]> - - - diff --git a/xml/ns-System.Runtime.Remoting.Services.xml b/xml/ns-System.Runtime.Remoting.Services.xml deleted file mode 100644 index 38de5379f8f..00000000000 --- a/xml/ns-System.Runtime.Remoting.Services.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - Contains service classes that provide functionality to .NET Framework. One of the most important classes of this namespace is the class. - - class provides a tracking service with pluggable handlers that can detect when objects are marshaled and unmarshaled. Pluggable handlers can be created by implementing the interface. For more information, see the class. - - ]]> - - - diff --git a/xml/ns-System.Runtime.Serialization.Configuration.xml b/xml/ns-System.Runtime.Serialization.Configuration.xml deleted file mode 100644 index fb10ce3ed68..00000000000 --- a/xml/ns-System.Runtime.Serialization.Configuration.xml +++ /dev/null @@ -1,8 +0,0 @@ - - - Contains classes used to read the values found in application configuration under system.xml.serialization section. - - The classes in this namespace are used by the serialization infrastructure to handle the configuration elements and cannot be used directly. Instead, to configure the DataContractSerializer, create an application configuration file and use the following XML elements. <system.xml.serialization><dataContractSerializer><declaredTypes><add> element for <declaredTypes><knownType> element. - To be added. - - diff --git a/xml/ns-System.Runtime.Serialization.Formatters.Soap.xml b/xml/ns-System.Runtime.Serialization.Formatters.Soap.xml deleted file mode 100644 index 666922f3b66..00000000000 --- a/xml/ns-System.Runtime.Serialization.Formatters.Soap.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains the class, which can be used to serialize and deserialize objects in the SOAP format. When building applications that uses the types in this namespace, you must reference the System.Runtime.Serialization.Formatters.Soap.dll assembly. - To be added. - - diff --git a/xml/ns-System.Security.Authentication.ExtendedProtection.Configuration.xml b/xml/ns-System.Security.Authentication.ExtendedProtection.Configuration.xml deleted file mode 100644 index 01d896a8f46..00000000000 --- a/xml/ns-System.Security.Authentication.ExtendedProtection.Configuration.xml +++ /dev/null @@ -1,8 +0,0 @@ - - - Provides support for configuration of authentication using extended protection for applications. - To be added. - - Integrated Windows Authentication with Extended Protection - - diff --git a/xml/ns-System.ServiceModel.Activation.Configuration.xml b/xml/ns-System.ServiceModel.Activation.Configuration.xml deleted file mode 100644 index d5380aa1450..00000000000 --- a/xml/ns-System.ServiceModel.Activation.Configuration.xml +++ /dev/null @@ -1,8 +0,0 @@ - - - Represents the configuration settings for the SMSvcHost.exe tool. - - This namespace represents the configuration elements that can be configured in the SMSvcHost.exe.config file. Specifically, it includes all machine-wide settings that need to be configured. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.ServiceModel.Activation.xml b/xml/ns-System.ServiceModel.Activation.xml deleted file mode 100644 index 198f1e575ce..00000000000 --- a/xml/ns-System.ServiceModel.Activation.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to service model activation. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.ServiceModel.Activities.Activation.xml b/xml/ns-System.ServiceModel.Activities.Activation.xml deleted file mode 100644 index fdfe2ce4cef..00000000000 --- a/xml/ns-System.ServiceModel.Activities.Activation.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains the that provides instances of in managed hosting environments where the host instance is created dynamically in response to incoming messages. - To be added. - - diff --git a/xml/ns-System.ServiceModel.Activities.Configuration.xml b/xml/ns-System.ServiceModel.Activities.Configuration.xml deleted file mode 100644 index 5786701b858..00000000000 --- a/xml/ns-System.ServiceModel.Activities.Configuration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes used to configure workflow services. These classes allow you to apply service and endpoint behaviors and configure tracking. - To be added. - - diff --git a/xml/ns-System.ServiceModel.Activities.Description.xml b/xml/ns-System.ServiceModel.Activities.Description.xml deleted file mode 100644 index a48dbc0df9b..00000000000 --- a/xml/ns-System.ServiceModel.Activities.Description.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that enable you to control various behaviors related to workflow services. - To be added. - - diff --git a/xml/ns-System.ServiceModel.Activities.Presentation.Factories.xml b/xml/ns-System.ServiceModel.Activities.Presentation.Factories.xml deleted file mode 100644 index d8fc4b012f1..00000000000 --- a/xml/ns-System.ServiceModel.Activities.Presentation.Factories.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains factories that create Receive/SendReply and Send/ReceiveReply activity pairs. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.ServiceModel.Activities.Presentation.xml b/xml/ns-System.ServiceModel.Activities.Presentation.xml deleted file mode 100644 index dbbafd57cb1..00000000000 --- a/xml/ns-System.ServiceModel.Activities.Presentation.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to service model presentation activities. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.ServiceModel.Activities.Tracking.Configuration.xml b/xml/ns-System.ServiceModel.Activities.Tracking.Configuration.xml deleted file mode 100644 index 56980c55fc4..00000000000 --- a/xml/ns-System.ServiceModel.Activities.Tracking.Configuration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes used to configure tracking for service hosted workflows. These classes allow you to specify the tracking information you want your workflow service to generate. - To be added. - - diff --git a/xml/ns-System.ServiceModel.Activities.Tracking.xml b/xml/ns-System.ServiceModel.Activities.Tracking.xml deleted file mode 100644 index 6e21d6d9935..00000000000 --- a/xml/ns-System.ServiceModel.Activities.Tracking.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes used to create tracking records for a workflow service instance. Tracking records are created by created by the workflow runtime during the execution of a workflow instance, and are sent to registered tracking participants. - To be added. - - diff --git a/xml/ns-System.ServiceModel.Activities.xml b/xml/ns-System.ServiceModel.Activities.xml deleted file mode 100644 index 7fb8a8cad24..00000000000 --- a/xml/ns-System.ServiceModel.Activities.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that allow you to send messages to and receive messages from workflows. These activities are used when writing workflow services and allow you to define how messages are sent and received in a workflow. - To be added. - - diff --git a/xml/ns-System.ServiceModel.ComIntegration.xml b/xml/ns-System.ServiceModel.ComIntegration.xml deleted file mode 100644 index 77cbcbee98b..00000000000 --- a/xml/ns-System.ServiceModel.ComIntegration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Defines classes needed for integration with COM applications. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.ServiceModel.Configuration.xml b/xml/ns-System.ServiceModel.Configuration.xml deleted file mode 100644 index 0abd15acd39..00000000000 --- a/xml/ns-System.ServiceModel.Configuration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to service model configuration. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.ServiceModel.Diagnostics.xml b/xml/ns-System.ServiceModel.Diagnostics.xml deleted file mode 100644 index a62bca7cb94..00000000000 --- a/xml/ns-System.ServiceModel.Diagnostics.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains an enumeration that is used to configure performance counters for diagnostics purposes. - To be added. - - diff --git a/xml/ns-System.ServiceModel.Discovery.Configuration.xml b/xml/ns-System.ServiceModel.Discovery.Configuration.xml deleted file mode 100644 index 770a256322f..00000000000 --- a/xml/ns-System.ServiceModel.Discovery.Configuration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that allow you to configure discovery settings in a configuration file. - To be added. - - diff --git a/xml/ns-System.ServiceModel.Discovery.Version11.xml b/xml/ns-System.ServiceModel.Discovery.Version11.xml deleted file mode 100644 index 46886d86306..00000000000 --- a/xml/ns-System.ServiceModel.Discovery.Version11.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains the classes required for the creation and use of discoverable services. These classes implement the WS-Discovery version 1.1 protocol for Windows Communication Foundation (WCF). - To be added. - - diff --git a/xml/ns-System.ServiceModel.Discovery.VersionApril2005.xml b/xml/ns-System.ServiceModel.Discovery.VersionApril2005.xml deleted file mode 100644 index 295de9129c3..00000000000 --- a/xml/ns-System.ServiceModel.Discovery.VersionApril2005.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains the classes required for the creation and use of discoverable services. These classes implement the April 2005 version of the WS-Discovery protocol for Windows Communication Foundation (WCF). - To be added. - - diff --git a/xml/ns-System.ServiceModel.Discovery.VersionCD1.xml b/xml/ns-System.ServiceModel.Discovery.VersionCD1.xml deleted file mode 100644 index fb60d293e52..00000000000 --- a/xml/ns-System.ServiceModel.Discovery.VersionCD1.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains the classes required for the creation and use of discoverable services. These classes implement the Committee Draft 1 version of the WS-Discovery protocol for Windows Communication Foundation (WCF). - To be added. - - diff --git a/xml/ns-System.ServiceModel.Discovery.xml b/xml/ns-System.ServiceModel.Discovery.xml deleted file mode 100644 index 64d0bfc6f13..00000000000 --- a/xml/ns-System.ServiceModel.Discovery.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains the classes required for the creation and use of discoverable services. These classes implement the WS-Discovery protocol for Windows Communication Foundation (WCF). - To be added. - - diff --git a/xml/ns-System.ServiceModel.MsmqIntegration.xml b/xml/ns-System.ServiceModel.MsmqIntegration.xml deleted file mode 100644 index 6327eaabdf7..00000000000 --- a/xml/ns-System.ServiceModel.MsmqIntegration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that relate to Microsoft Message Queuing Service (MSMQ) integration, which allows communication between MSMQ applications and Windows Communication Foundation (WCF) applications. - To be added. - - diff --git a/xml/ns-System.ServiceModel.PeerResolvers.xml b/xml/ns-System.ServiceModel.PeerResolvers.xml deleted file mode 100644 index 1db8dc29884..00000000000 --- a/xml/ns-System.ServiceModel.PeerResolvers.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that allow developers to customize and extend the Peer Name Resolution Protocol service. - To be added. - - diff --git a/xml/ns-System.ServiceModel.Persistence.xml b/xml/ns-System.ServiceModel.Persistence.xml deleted file mode 100644 index 381aca0cf7a..00000000000 --- a/xml/ns-System.ServiceModel.Persistence.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that allow workflow services (WCF services implemented as workflows) to be persisted into the persistence store. - To be added. - - diff --git a/xml/ns-System.ServiceModel.Routing.Configuration.xml b/xml/ns-System.ServiceModel.Routing.Configuration.xml deleted file mode 100644 index febd1fa6f5c..00000000000 --- a/xml/ns-System.ServiceModel.Routing.Configuration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - This namespace contains configuration classes that are used by the Windows Communication Foundation (WCF) infrastructure to convert XML into Common Language Runtime (CLR) types. You can also manipulate these classes directly for extensibility purposes. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.ServiceModel.Routing.xml b/xml/ns-System.ServiceModel.Routing.xml deleted file mode 100644 index a03488d9bf4..00000000000 --- a/xml/ns-System.ServiceModel.Routing.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - This namespace contains classes that are used to configure and manage the WCF . - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.ServiceModel.Web.xml b/xml/ns-System.ServiceModel.Web.xml deleted file mode 100644 index 0c5c721320a..00000000000 --- a/xml/ns-System.ServiceModel.Web.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to using the service model on the web. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.ServiceModel.XamlIntegration.xml b/xml/ns-System.ServiceModel.XamlIntegration.xml deleted file mode 100644 index 840371ebb0a..00000000000 --- a/xml/ns-System.ServiceModel.XamlIntegration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides utility classes to enable the serialization of Windows Communication Foundation (WCF) entities to XAML. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.ServiceProcess.Design.xml b/xml/ns-System.ServiceProcess.Design.xml deleted file mode 100644 index 4be51f18e66..00000000000 --- a/xml/ns-System.ServiceProcess.Design.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that can be used to extend design-time support for Windows services applications. - To be added. - - diff --git a/xml/ns-System.Transactions.Configuration.xml b/xml/ns-System.Transactions.Configuration.xml deleted file mode 100644 index a247f973a80..00000000000 --- a/xml/ns-System.Transactions.Configuration.xml +++ /dev/null @@ -1,24 +0,0 @@ - - - Contains classes that describe configuration options used by classes. - - - - - - - -``` - - This example specifies the default values of a transaction. Specifically, it sets the computer name of the Distributed Transaction Coordinator (MSDTC) that is responsible for coordinating all distributed transactions started locally, and the default time after which a transaction times out. In addition, it specifies a setting that can only be modified at the machine level, which is the maximum amount of time allowed before a transaction times out. - - ]]> - - - diff --git a/xml/ns-System.Web.ApplicationServices.xml b/xml/ns-System.Web.ApplicationServices.xml deleted file mode 100644 index a1a3de8688f..00000000000 --- a/xml/ns-System.Web.ApplicationServices.xml +++ /dev/null @@ -1,21 +0,0 @@ - - - Provides classes that enable you to access ASP.NET forms authentication, roles, and profiles application services as Windows Communication Foundation (WCF) services. - - , , and classes contain methods that let you log on users, check which roles the current user belongs to, and retrieve profile properties for the user through WCF services. The namespace also includes the following classes: - -- , which is used to customize the authentication cookie from the class. - -- , which is used to select the membership provider at run time. - -- , which is used to select the role provider at run time. - -- , which is used to create custom validation for user profile properties. - - ]]> - - - diff --git a/xml/ns-System.Web.Caching.xml b/xml/ns-System.Web.Caching.xml deleted file mode 100644 index 0cb93afe033..00000000000 --- a/xml/ns-System.Web.Caching.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - Provides classes for caching frequently used data on the server. - - class, a dictionary that enables you to store data objects such as hash tables and data sets. It also provides expiration functionality for those objects, and methods that enable you to add and remove the objects. You can add the objects to the cache with a dependency on other files or cache entries. In that case, the object can invoke a callback method to notify your application when an object is removed from the cache. - - ]]> - - - diff --git a/xml/ns-System.Web.ClientServices.Providers.xml b/xml/ns-System.Web.ClientServices.Providers.xml deleted file mode 100644 index 21b82c935ed..00000000000 --- a/xml/ns-System.Web.ClientServices.Providers.xml +++ /dev/null @@ -1,17 +0,0 @@ - - - Contains client service providers and other classes that support access in Windows-based applications to the Microsoft Ajax authentication, roles, and profile services. - - namespace include client application service providers that enable Windows-based applications to use the Microsoft Ajax authentication, roles, and profile services. You can enable these services and specify client service providers in your application configuration file, and then access the services through existing .NET membership, identity, and application settings infrastructures. The client service providers also support occasional connectivity by storing and retrieving user information in a local data cache when the application is offline. For more information, see [Client Application Services](/dotnet/framework/common-client-technologies/client-application-services). - - To access the login service, you can use either Windows or Forms authentication by specifying the or in your application configuration. Windows authentication uses the identity supplied when a user logs in to the operating system. Forms authentication requires that you to retrieve login information from the user and pass it to the service. You can do this by specifying an implementation with your configuration. The method returns a object that contains user login information. You can populate this object, for example, by displaying a login dialog box in the method. - - To access the roles and profile services, specify the and in your application configuration. - - ]]> - - - diff --git a/xml/ns-System.Web.ClientServices.xml b/xml/ns-System.Web.ClientServices.xml deleted file mode 100644 index c4f58e8dc23..00000000000 --- a/xml/ns-System.Web.ClientServices.xml +++ /dev/null @@ -1,20 +0,0 @@ - - - Provides classes that support access in Windows-based applications to the Microsoft Ajax authentication, roles, and profiles services. - - namespace support the client application service providers in the namespace. These service providers enable Windows-based applications to use the Microsoft Ajax authentication, roles, and profiles services through existing .NET membership, identity, and application settings infrastructures. The client service providers also support occasional connectivity by storing and retrieving user information in a local data cache when the application is offline. For more information, see [Client Application Services](/dotnet/framework/common-client-technologies/client-application-services). - - The and classes provide properties and methods related to a user's identity, role, and authentication state. - - The class enables you to store the status of the user's network connection in the local data cache. The connectivity status indicates whether the client service providers will use the offline cache or attempt to access the application services. - -> [!NOTE] -> The class contains no logic to determine the actual status of the network connection. You are responsible for determining the connectivity status of your application according to your own criteria and setting the property accordingly. For example, Windows-based applications often provide an option in the user interface so that users can work in offline mode or attempt to go online. - - ]]> - - - diff --git a/xml/ns-System.Web.Compilation.xml b/xml/ns-System.Web.Compilation.xml deleted file mode 100644 index 40519ce8285..00000000000 --- a/xml/ns-System.Web.Compilation.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes for generating and compiling custom file types within the ASP.NET build environment. - To be added. - - diff --git a/xml/ns-System.Web.Configuration.Internal.xml b/xml/ns-System.Web.Configuration.Internal.xml deleted file mode 100644 index 37652b5bffc..00000000000 --- a/xml/ns-System.Web.Configuration.Internal.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains configuration types intended for internal use only. - To be added. - - diff --git a/xml/ns-System.Web.Configuration.xml b/xml/ns-System.Web.Configuration.xml deleted file mode 100644 index 24906d9c669..00000000000 --- a/xml/ns-System.Web.Configuration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that are used to set up ASP.NET configuration. - To be added. - - diff --git a/xml/ns-System.Web.DynamicData.Design.xml b/xml/ns-System.Web.DynamicData.Design.xml deleted file mode 100644 index d2d914078fb..00000000000 --- a/xml/ns-System.Web.DynamicData.Design.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that provide design-time support for the classes in the namespace. - To be added. - - diff --git a/xml/ns-System.Web.DynamicData.ModelProviders.xml b/xml/ns-System.Web.DynamicData.ModelProviders.xml deleted file mode 100644 index 11335171f8a..00000000000 --- a/xml/ns-System.Web.DynamicData.ModelProviders.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that define the core functionality for ASP.NET Dynamic Data providers. - To be added. - - diff --git a/xml/ns-System.Web.DynamicData.xml b/xml/ns-System.Web.DynamicData.xml deleted file mode 100644 index 4964baae743..00000000000 --- a/xml/ns-System.Web.DynamicData.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that provide the core functionality for ASP.NET Dynamic Data. It also provides extensibility features that let you customize dynamic data behavior. - To be added. - - diff --git a/xml/ns-System.Web.Globalization.xml b/xml/ns-System.Web.Globalization.xml deleted file mode 100644 index b2b9bc9a92a..00000000000 --- a/xml/ns-System.Web.Globalization.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes and interfaces for localization providers. - To be added. - - diff --git a/xml/ns-System.Web.Handlers.xml b/xml/ns-System.Web.Handlers.xml deleted file mode 100644 index c51b227f436..00000000000 --- a/xml/ns-System.Web.Handlers.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains HTTP handler classes that process HTTP requests to a Web server. - To be added. - - diff --git a/xml/ns-System.Web.Hosting.xml b/xml/ns-System.Web.Hosting.xml deleted file mode 100644 index 969ffbf1506..00000000000 --- a/xml/ns-System.Web.Hosting.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides the functionality for hosting ASP.NET applications from managed applications outside Microsoft Internet Information Services (IIS). - To be added. - - diff --git a/xml/ns-System.Web.Instrumentation.xml b/xml/ns-System.Web.Instrumentation.xml deleted file mode 100644 index b9ca86bf93a..00000000000 --- a/xml/ns-System.Web.Instrumentation.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains types that provide information about current page execution, that include execution listeners and instrumentation, and that include methods that are called before and after view engine renders output. - To be added. - - diff --git a/xml/ns-System.Web.Mail.xml b/xml/ns-System.Web.Mail.xml deleted file mode 100644 index 36a951a80ac..00000000000 --- a/xml/ns-System.Web.Mail.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that enable you to construct and send messages using the CDOSYS (Collaboration Data Objects for Windows 2000) message component. The mail message is delivered either through the SMTP mail service built into Microsoft Windows 2000 or through an arbitrary SMTP server. The classes in this namespace can be used from ASP.NET or from any managed application. - To be added. - - diff --git a/xml/ns-System.Web.Management.xml b/xml/ns-System.Web.Management.xml deleted file mode 100644 index 61c0da27741..00000000000 --- a/xml/ns-System.Web.Management.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes and interfaces for managing and monitoring the health of Web applications. - To be added. - - diff --git a/xml/ns-System.Web.Mobile.xml b/xml/ns-System.Web.Mobile.xml deleted file mode 100644 index 871c3ddd340..00000000000 --- a/xml/ns-System.Web.Mobile.xml +++ /dev/null @@ -1,15 +0,0 @@ - - - Contains the core capabilities, including authentication and error handling, required for building ASP.NET mobile Web applications. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site. - - class provides a single source for accessing capability information about a client device and for performing queries against device capabilities. The class supports cookieless devices by appending appropriate authentication information to the appropriate URLs. - - ]]> - - - - - diff --git a/xml/ns-System.Web.ModelBinding.xml b/xml/ns-System.Web.ModelBinding.xml deleted file mode 100644 index 70ba71e94df..00000000000 --- a/xml/ns-System.Web.ModelBinding.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - Provides classes that enable you to bind data objects to ASP.NET Web Forms server controls. - - - - - diff --git a/xml/ns-System.Web.Profile.xml b/xml/ns-System.Web.Profile.xml deleted file mode 100644 index a10609b5fd8..00000000000 --- a/xml/ns-System.Web.Profile.xml +++ /dev/null @@ -1,17 +0,0 @@ - - - Contains classes that are used to work with ASP.NET user profiles in Web server applications. - - class, or in a custom data source by using an implementation of the abstract class. - - ASP.NET profiles are configured by using the [profile](https://learn.microsoft.com/previous-versions/dotnet/netframework-4.0/ms164644(v%3dvs.100)) configuration section. - - When an application starts that has profiles enabled, ASP.NET creates a new class of type `ProfileCommon`, which inherits from the class. Strongly typed accessors are added to the `ProfileCommon` class for each property that is defined in the [profile](https://learn.microsoft.com/previous-versions/dotnet/netframework-4.0/ms164644(v%3dvs.100)) configuration section. An instance of the `ProfileCommon` class is set as the value of the property of the current object. You can create a custom profile implementation that inherits from the abstract class and that defines properties for the user profile that are not specified in the [profile](https://learn.microsoft.com/previous-versions/dotnet/netframework-4.0/ms164644(v%3dvs.100)) configuration element. - - ]]> - - - diff --git a/xml/ns-System.Web.Query.Dynamic.xml b/xml/ns-System.Web.Query.Dynamic.xml deleted file mode 100644 index 93824653d9b..00000000000 --- a/xml/ns-System.Web.Query.Dynamic.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that are used to parse expressions from a control into a language-integrated query (LINQ). - To be added. - - diff --git a/xml/ns-System.Web.RegularExpressions.xml b/xml/ns-System.Web.RegularExpressions.xml deleted file mode 100644 index be3f5891aa5..00000000000 --- a/xml/ns-System.Web.RegularExpressions.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides precompiled regular expressions that can be used to parse ASP.NET files. All members of the namespace are descendants of the class. - To be added. - - diff --git a/xml/ns-System.Web.Routing.xml b/xml/ns-System.Web.Routing.xml deleted file mode 100644 index a9fc15ce015..00000000000 --- a/xml/ns-System.Web.Routing.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes that are used with URL routing, which enables you to use URLs that do not map to a physical file. - To be added. - - diff --git a/xml/ns-System.Web.Script.Serialization.xml b/xml/ns-System.Web.Script.Serialization.xml deleted file mode 100644 index 921d7879bd6..00000000000 --- a/xml/ns-System.Web.Script.Serialization.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that provide JavaScript Object Notation (JSON) serialization and deserialization for managed types. It also provides extensibility features to customize serialization behavior. - To be added. - - diff --git a/xml/ns-System.Web.Script.Services.xml b/xml/ns-System.Web.Script.Services.xml deleted file mode 100644 index 70e10366e68..00000000000 --- a/xml/ns-System.Web.Script.Services.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides attributes that let you customize Web service support for AJAX functionality in ASP.NET. - To be added. - - diff --git a/xml/ns-System.Web.Script.xml b/xml/ns-System.Web.Script.xml deleted file mode 100644 index 1feb62d4314..00000000000 --- a/xml/ns-System.Web.Script.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that provide script resource information. - To be added. - - diff --git a/xml/ns-System.Web.Security.AntiXss.xml b/xml/ns-System.Web.Security.AntiXss.xml deleted file mode 100644 index bcdf517cc03..00000000000 --- a/xml/ns-System.Web.Security.AntiXss.xml +++ /dev/null @@ -1,14 +0,0 @@ - - - Contains methods that you can use to encode strings in order help you protect your application against cross-site scripting (XSS) attacks and LDAP injection attacks. - - - - - diff --git a/xml/ns-System.Web.Security.xml b/xml/ns-System.Web.Security.xml deleted file mode 100644 index 044b98dce47..00000000000 --- a/xml/ns-System.Web.Security.xml +++ /dev/null @@ -1,23 +0,0 @@ - - - Contains classes that are used to implement ASP.NET security in Web server applications. - - class is used by ASP.NET applications to validate user credentials and manage user settings such as passwords and email addresses. The class enables you to manage authorization for your application based on groups of users assigned to roles in the Web application. - - Both the class and the class work with providers, classes that access your application's data store to retrieve membership and role information. Membership and role information can be stored in a Microsoft SQL Server database using the and classes; in an Active Directory using the and classes, or in a custom data source using implementations of the and classes. - - You configure ASP.NET membership using the [membership Element (ASP.NET Settings Schema)](https://learn.microsoft.com/previous-versions/dotnet/netframework-4.0/1b9hw62f(v=vs.100)). When an application using membership is accessed, ASP.NET creates an instance of the class that you can use to query membership information. Provider-specific implementations of the class contain information about the user accessing the page. You can create custom implementations of the class for your application. - - You configure ASP.NET roles using the [roleManager Element (ASP.NET Settings Schema)](https://learn.microsoft.com/previous-versions/dotnet/netframework-4.0/ms164660(v=vs.100)). ASP.NET creates an instance of the class that contains information about the role membership of the current user. - - ASP.NET provides server controls that interact with the class and the class. The , , and controls work with the class to simplify creating an authenticated Web application, and the control uses role-specific templates to customize Web pages for specific groups of users. - - ]]> - - Introduction to Membership - Understanding Role Management - - diff --git a/xml/ns-System.Web.Services.Discovery.xml b/xml/ns-System.Web.Services.Discovery.xml deleted file mode 100644 index 1201034a204..00000000000 --- a/xml/ns-System.Web.Services.Discovery.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that allows XML Web service clients to locate the available XML Web services on a Web server through a process called XML Web services Discovery. - To be added. - - diff --git a/xml/ns-System.Web.Services.Protocols.xml b/xml/ns-System.Web.Services.Protocols.xml deleted file mode 100644 index 226d0883274..00000000000 --- a/xml/ns-System.Web.Services.Protocols.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that define the protocols used to transmit data across the wire during the communication between XML Web service clients and XML Web services created using ASP.NET. - To be added. - - diff --git a/xml/ns-System.Web.SessionState.xml b/xml/ns-System.Web.SessionState.xml deleted file mode 100644 index b85b1f85f5f..00000000000 --- a/xml/ns-System.Web.SessionState.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - Provides classes and interfaces that enable storage of data specific to a single client within a web application on the server. The session-state data is used to give the client the appearance of a persistent connection with the application. State information can be stored within local process memory or, for web farm configurations, it can be stored out of process using either the ASP.NET State service or a Microsoft SQL Server database. - - - - - diff --git a/xml/ns-System.Web.UI.Adapters.xml b/xml/ns-System.Web.UI.Adapters.xml deleted file mode 100644 index 142ace2eb33..00000000000 --- a/xml/ns-System.Web.UI.Adapters.xml +++ /dev/null @@ -1,16 +0,0 @@ - - - Contains the base classes for control adapters and page adapters. You can use these adapters to override the life-cycle states of pages and controls. This is useful if you want to modify a control's markup or behavior for new markup standards or for specific browsers. - - class inherits from the class. The and classes inherit from the class. - - ]]> - - - - Architectural Overview of Adaptive Control Behavior - - diff --git a/xml/ns-System.Web.UI.DataVisualization.Charting.xml b/xml/ns-System.Web.UI.DataVisualization.Charting.xml deleted file mode 100644 index c5c4b65a3f5..00000000000 --- a/xml/ns-System.Web.UI.DataVisualization.Charting.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains methods and properties for the Chart Web server control. - To be added. - - diff --git a/xml/ns-System.Web.UI.Design.Directives.xml b/xml/ns-System.Web.UI.Design.Directives.xml deleted file mode 100644 index b3d870453f2..00000000000 --- a/xml/ns-System.Web.UI.Design.Directives.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that can be used to extend design-time support for ASP.NET Web page directives. - To be added. - - diff --git a/xml/ns-System.Web.UI.Design.MobileControls.Converters.xml b/xml/ns-System.Web.UI.Design.MobileControls.Converters.xml deleted file mode 100644 index 81905ca6085..00000000000 --- a/xml/ns-System.Web.UI.Design.MobileControls.Converters.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that provide design-time support for data type converters in mobile controls. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site. - To be added. - - diff --git a/xml/ns-System.Web.UI.Design.MobileControls.xml b/xml/ns-System.Web.UI.Design.MobileControls.xml deleted file mode 100644 index aa1d05ebd6a..00000000000 --- a/xml/ns-System.Web.UI.Design.MobileControls.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that provide design-time support for the classes in the namespace. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site. - To be added. - - diff --git a/xml/ns-System.Web.UI.Design.WebControls.WebParts.xml b/xml/ns-System.Web.UI.Design.WebControls.WebParts.xml deleted file mode 100644 index 706c064b8ff..00000000000 --- a/xml/ns-System.Web.UI.Design.WebControls.WebParts.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that provide design-time support for controls derived from classes in the namespace. - To be added. - - diff --git a/xml/ns-System.Web.UI.Design.WebControls.xml b/xml/ns-System.Web.UI.Design.WebControls.xml deleted file mode 100644 index 80af62ddb9f..00000000000 --- a/xml/ns-System.Web.UI.Design.WebControls.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that can be used to extend design-time support for Web server controls. - To be added. - - diff --git a/xml/ns-System.Web.UI.Design.xml b/xml/ns-System.Web.UI.Design.xml deleted file mode 100644 index 24db30c7bbc..00000000000 --- a/xml/ns-System.Web.UI.Design.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that can be used to extend design-time support for ASP.NET Web pages and for Web server controls. - To be added. - - diff --git a/xml/ns-System.Web.UI.HtmlControls.xml b/xml/ns-System.Web.UI.HtmlControls.xml deleted file mode 100644 index 8c91ac98f07..00000000000 --- a/xml/ns-System.Web.UI.HtmlControls.xml +++ /dev/null @@ -1,9 +0,0 @@ - - - Contains classes that allow you to create HTML server controls on a Web Forms page. HTML server controls run on the server and map directly to standard HTML tags supported by most browsers. This allows you to programmatically control the HTML elements on a Web Forms page. - To be added. - - HTML Controls for ASP.NET Web Pages - Standard Toolbox Controls - - diff --git a/xml/ns-System.Web.UI.MobileControls.Adapters.XhtmlAdapters.xml b/xml/ns-System.Web.UI.MobileControls.Adapters.XhtmlAdapters.xml deleted file mode 100644 index 761a5802880..00000000000 --- a/xml/ns-System.Web.UI.MobileControls.Adapters.XhtmlAdapters.xml +++ /dev/null @@ -1,18 +0,0 @@ - - - Contains classes you can use to override the life-cycle stages of a mobile control to modify its default XHTML markup or behavior for new markup standards or for specific browsers and mobile devices. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site. - - is inherited by all adapter classes in the namespace, including and . - - ]]> - - - - - Introduction to Mobile Application Development in ASP.NET - Introduction to Device Filtering in ASP.NET - - diff --git a/xml/ns-System.Web.UI.MobileControls.Adapters.xml b/xml/ns-System.Web.UI.MobileControls.Adapters.xml deleted file mode 100644 index 84f0d0b19a2..00000000000 --- a/xml/ns-System.Web.UI.MobileControls.Adapters.xml +++ /dev/null @@ -1,18 +0,0 @@ - - - Contains classes you can use to override the life-cycle stages of a mobile control to modify its default HTML, CHTML, or WML markup or behavior for new markup standards or for specific browsers and mobile devices. The APIs in this namespace are obsolete. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site. - - class is directly or indirectly inherited by all other adapter classes in this namespace, such as and , as well as , , and . - - ]]> - - - - - Introduction to Mobile Application Development in ASP.NET - Introduction to Device Filtering in ASP.NET - - diff --git a/xml/ns-System.Web.UI.MobileControls.xml b/xml/ns-System.Web.UI.MobileControls.xml deleted file mode 100644 index 6aa63a9bd04..00000000000 --- a/xml/ns-System.Web.UI.MobileControls.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains a set of ASP.NET server controls that can render your application for different mobile devices. The APIs in this namespace are obsolete. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site. - To be added. - - diff --git a/xml/ns-System.Web.UI.WebControls.Adapters.xml b/xml/ns-System.Web.UI.WebControls.Adapters.xml deleted file mode 100644 index 5ce42e36e85..00000000000 --- a/xml/ns-System.Web.UI.WebControls.Adapters.xml +++ /dev/null @@ -1,15 +0,0 @@ - - - Contains classes that you can use to override the life-cycle stages of a Web control. The classes enable you to modify a control's markup or behavior for new markup standards or for specific browsers. - - class is inherited by and classes. - - ]]> - - - Introduction to Device Filtering in ASP.NET - - diff --git a/xml/ns-System.Web.UI.WebControls.Expressions.xml b/xml/ns-System.Web.UI.WebControls.Expressions.xml deleted file mode 100644 index 4b88ed425e1..00000000000 --- a/xml/ns-System.Web.UI.WebControls.Expressions.xml +++ /dev/null @@ -1,15 +0,0 @@ - - - Provides classes that enable you to filter data in a Web page by using the control. - - control to filter data in a Web page using declarative syntax. The classes in this namespace include , , , and . - - ]]> - - - QueryExtender Web Server Control Overview - - \ No newline at end of file diff --git a/xml/ns-System.Web.UI.WebControls.WebParts.xml b/xml/ns-System.Web.UI.WebControls.WebParts.xml deleted file mode 100644 index cffbf7966f4..00000000000 --- a/xml/ns-System.Web.UI.WebControls.WebParts.xml +++ /dev/null @@ -1,9 +0,0 @@ - - - Contains classes and interfaces known collectively as the Web Parts control set. You can use these classes to create Web pages whose appearance and behavior can be modified (personalized) by end users. Each user's personalized settings for a page are saved for future browser sessions. - To be added. - ASP.NET Web Parts Overview - Web Parts Control Set Overview - ASP.NET Web Parts Controls - - diff --git a/xml/ns-System.Web.UI.WebControls.xml b/xml/ns-System.Web.UI.WebControls.xml deleted file mode 100644 index 027cab27460..00000000000 --- a/xml/ns-System.Web.UI.WebControls.xml +++ /dev/null @@ -1,17 +0,0 @@ - - - Contains classes that allow you to create Web server controls on a Web page. Web server controls run on the server and include form controls such as buttons and text boxes. They also include special-purpose controls such as a calendar. Because Web server controls run on the server, you can programmatically control these elements. Although Web server controls are rendered as HTML, their object model does not necessarily reflect HTML syntax. - - namespace contains classes that are rendered as HTML tags, such as the control and the control. The namespace also contains classes that are not rendered on the Web page, but support data operations, such as the and classes. Other controls, such as the and controls, support data display and editing. The class serves as the base class for many of the classes in the namespace. - - ]]> - - Working with ASP.NET Web Server Controls - Standard Controls for ASP.NET Mobile Pages - Navigation Toolbox Controls - Login Toolbox Controls - - diff --git a/xml/ns-System.Web.UI.xml b/xml/ns-System.Web.UI.xml deleted file mode 100644 index 7d4701dcaef..00000000000 --- a/xml/ns-System.Web.UI.xml +++ /dev/null @@ -1,15 +0,0 @@ - - - Provides classes and interfaces that enable you to create ASP.NET server controls and ASP.NET Web pages for the user interface of your ASP.NET Web applications. - - class, which provides a common set of functionality for all server controls, which includes HTML server controls, Web server controls, and user controls. It also includes the class. This class is generated automatically whenever a request is made for an .aspx file in an ASP.NET Web application. You can inherit from both of these classes. - - The namespace also includes classes that provide the server controls with data-binding functionality, the ability to save the view state of a given control or page, and parsing functionality. - - ]]> - - - diff --git a/xml/ns-System.Web.Util.xml b/xml/ns-System.Web.Util.xml deleted file mode 100644 index 66d5ce29767..00000000000 --- a/xml/ns-System.Web.Util.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes that enable callback methods to be run under the scope of a transaction and that enable work to be posted to separate threads. - To be added. - - diff --git a/xml/ns-System.Web.WebSockets.xml b/xml/ns-System.Web.WebSockets.xml deleted file mode 100644 index acb7b11eddb..00000000000 --- a/xml/ns-System.Web.WebSockets.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that support adding WebSocket functionality to ASP.NET Web Forms applications. - To be added. - - diff --git a/xml/ns-System.Windows.Forms.DataVisualization.Charting.xml b/xml/ns-System.Windows.Forms.DataVisualization.Charting.xml deleted file mode 100644 index 1526f092237..00000000000 --- a/xml/ns-System.Windows.Forms.DataVisualization.Charting.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains methods and properties for the Chart Windows forms control. - To be added. - - diff --git a/xml/ns-System.Workflow.Activities.Configuration.xml b/xml/ns-System.Workflow.Activities.Configuration.xml deleted file mode 100644 index 314cb935180..00000000000 --- a/xml/ns-System.Workflow.Activities.Configuration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes that represent sections of the configuration file. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Workflow.Activities.Rules.Design.xml b/xml/ns-System.Workflow.Activities.Rules.Design.xml deleted file mode 100644 index 610dd657e9e..00000000000 --- a/xml/ns-System.Workflow.Activities.Rules.Design.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains a set of classes that manage the Rule Set Editor and the Rule Condition Editor dialog boxes. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Workflow.Activities.Rules.xml b/xml/ns-System.Workflow.Activities.Rules.xml deleted file mode 100644 index c628407afc8..00000000000 --- a/xml/ns-System.Workflow.Activities.Rules.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains a set of classes that define the conditions and actions that form a rule. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Workflow.Activities.xml b/xml/ns-System.Workflow.Activities.xml deleted file mode 100644 index 36b131948ce..00000000000 --- a/xml/ns-System.Workflow.Activities.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to Windows Workflow Foundation activities. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Workflow.ComponentModel.Compiler.xml b/xml/ns-System.Workflow.ComponentModel.Compiler.xml deleted file mode 100644 index 595d031a846..00000000000 --- a/xml/ns-System.Workflow.ComponentModel.Compiler.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to the Windows Workflow Foundation component model compiler. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Workflow.ComponentModel.Design.xml b/xml/ns-System.Workflow.ComponentModel.Design.xml deleted file mode 100644 index 5b5b4d1a135..00000000000 --- a/xml/ns-System.Workflow.ComponentModel.Design.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to the Windows Workflow Foundation component model designers. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Workflow.ComponentModel.Serialization.xml b/xml/ns-System.Workflow.ComponentModel.Serialization.xml deleted file mode 100644 index 3d87a35bbb3..00000000000 --- a/xml/ns-System.Workflow.ComponentModel.Serialization.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides the infrastructure for managing the serialization of activities and workflows to and from extensible Application Markup Language (XAML) and CodeDOM. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Workflow.ComponentModel.xml b/xml/ns-System.Workflow.ComponentModel.xml deleted file mode 100644 index 54d766c0430..00000000000 --- a/xml/ns-System.Workflow.ComponentModel.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to the Windows Workflow Foundation component model. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Workflow.Runtime.Configuration.xml b/xml/ns-System.Workflow.Runtime.Configuration.xml deleted file mode 100644 index 7b2cba26400..00000000000 --- a/xml/ns-System.Workflow.Runtime.Configuration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that are used to configure the workflow runtime engine. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Workflow.Runtime.DebugEngine.xml b/xml/ns-System.Workflow.Runtime.DebugEngine.xml deleted file mode 100644 index 0c628651152..00000000000 --- a/xml/ns-System.Workflow.Runtime.DebugEngine.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes and interfaces for use in debugging workflow instances. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Workflow.Runtime.Hosting.xml b/xml/ns-System.Workflow.Runtime.Hosting.xml deleted file mode 100644 index 9decdcc5918..00000000000 --- a/xml/ns-System.Workflow.Runtime.Hosting.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to Windows Workflow Foundation runtime hosting. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Workflow.Runtime.Tracking.xml b/xml/ns-System.Workflow.Runtime.Tracking.xml deleted file mode 100644 index 72a6a5bf8a5..00000000000 --- a/xml/ns-System.Workflow.Runtime.Tracking.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes and an interface related to tracking services. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Workflow.Runtime.xml b/xml/ns-System.Workflow.Runtime.xml deleted file mode 100644 index 3bc2c53e3e9..00000000000 --- a/xml/ns-System.Workflow.Runtime.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Provides classes related to workflow runtime. - To be added. - - \ No newline at end of file diff --git a/xml/ns-System.Xml.Serialization.Advanced.xml b/xml/ns-System.Xml.Serialization.Advanced.xml deleted file mode 100644 index cde452c935a..00000000000 --- a/xml/ns-System.Xml.Serialization.Advanced.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains classes that allow you to customize the code generated from a Web Services Description Language (WSDL) document. - To be added. - - diff --git a/xml/ns-System.Xml.Serialization.Configuration.xml b/xml/ns-System.Xml.Serialization.Configuration.xml deleted file mode 100644 index 3f7e76e76ad..00000000000 --- a/xml/ns-System.Xml.Serialization.Configuration.xml +++ /dev/null @@ -1,25 +0,0 @@ - - - Contains classes used to read the values found in application configuration files under the <system.xml.serialization> Element section. - - or , create an application configuration file and use the following XML elements: - -- [<system.xml.serialization> Element](/dotnet/standard/serialization/system-xml-serialization-element) - -- [<schemaImporterExtensions> Element](/dotnet/standard/serialization/schemaimporterextensions-element) - -- [<add> Element for <xmlSchemaImporterExtensions>](/dotnet/standard/serialization/add-element-for-xmlschemaimporterextensions) - -- [<dateTimeSerialization> Element](/dotnet/standard/serialization/datetimeserialization-element) - -- [<xmlSerializer> Element](/dotnet/standard/serialization/xmlserializer-element) - - ]]> - - - diff --git a/xml/ns-System.Xml.XmlConfiguration.xml b/xml/ns-System.Xml.XmlConfiguration.xml deleted file mode 100644 index 4653c26f56d..00000000000 --- a/xml/ns-System.Xml.XmlConfiguration.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains sections of XML configuration. - To be added. - - diff --git a/xml/ns-System.Xml.Xsl.Runtime.xml b/xml/ns-System.Xml.Xsl.Runtime.xml deleted file mode 100644 index 046b0fc2f10..00000000000 --- a/xml/ns-System.Xml.Xsl.Runtime.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - Contains types that are used by the XSL transformation engine. - To be added. - - \ No newline at end of file diff --git a/xml/ns-XamlGeneratedNamespace.xml b/xml/ns-XamlGeneratedNamespace.xml deleted file mode 100644 index 9d6d3079961..00000000000 --- a/xml/ns-XamlGeneratedNamespace.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - Contains compiler-generated types that are not intended to be used directly from your code. - - class is an internal helper that the XAML markup compiler produces for XAML type resolution against assemblies. - - ]]> - - - \ No newline at end of file