, a "scope" attribute with value "col" is added and a table header cell (\| ) is rendered instead of a table cell (\ | ) for the header cells when the is rendered. This attribute can be used by screen readers.
-
+ , a "scope" attribute with value "col" is added and a table header cell (\| ) is rendered instead of a table cell (\ | ) for the header cells when the is rendered. This attribute can be used by screen readers.
+
]]>
diff --git a/xml/System.Web.UI/ChtmlTextWriter.xml b/xml/System.Web.UI/ChtmlTextWriter.xml
index 798cbb58fbb..97d6ad70303 100644
--- a/xml/System.Web.UI/ChtmlTextWriter.xml
+++ b/xml/System.Web.UI/ChtmlTextWriter.xml
@@ -17,35 +17,27 @@
Writes a series of cHTML-specific characters and text to the output stream of an ASP.NET server control. The class provides formatting capabilities that ASP.NET server controls use when rendering cHTML content to clients.
- class derives from the class and much of its functionality is provided by the and the base class for all markup text writers, which is the class.
-
-
-
-## Examples
- The following code example demonstrates how to create a class named `CustomChtmlTextWriter` that is derived from the class. It creates two constructors and overrides the method to prevent the `bgcolor` style attribute from being written to the output stream of the object. It also creates a class named `ChtmlCustomPageAdapter` that defines one method, `CreateCustomChtmlTextWriter`, which creates and returns an instance of the `CustomChtmlTextWriter` class. The `CustomChtmlTextWriter` then renders cHTML content for a page to devices with browsers that use cHTML markup.
-
+ class derives from the class and much of its functionality is provided by the and the base class for all markup text writers, which is the class.
+
+## Examples
+ The following code example demonstrates how to create a class named `CustomChtmlTextWriter` that is derived from the class. It creates two constructors and overrides the method to prevent the `bgcolor` style attribute from being written to the output stream of the object. It also creates a class named `ChtmlCustomPageAdapter` that defines one method, `CreateCustomChtmlTextWriter`, which creates and returns an instance of the `CustomChtmlTextWriter` class. The `CustomChtmlTextWriter` then renders cHTML content for a page to devices with browsers that use cHTML markup.
+
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample4/cs/chtmltextwriter.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample4/vb/chtmltextwriter.vb" id="Snippet1":::
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample4/vb/chtmltextwriter.vb" id="Snippet1":::
+
]]>
@@ -86,27 +78,24 @@
The that renders the markup content.
Initializes a new instance of the class that uses the constant to indent lines.
- class has two constructors, which is standard for all classes that derive directly or indirectly from the class.
-
- The constructor, which takes an instance of the class as a parameter, calls the second constructor and passes it two parameter values:
-
-- The .
-
-- The string value that is specified in the field, which defines the tab spacing that is used by the XHTML text writer.
-
-
-
-## Examples
- The following code example demonstrates how to create a class named `ChtmlCustomPageAdapter` and defines one method, `CreateCustomChtmlTextWriter`, which creates and returns an instance of the `CustomChtmlTextWriter` class. The `CustomChtmlTextWriter` then renders cHTML content for pages to devices with browsers that use cHTML markup.
-
- This code example is part of a larger example provided for the class.
-
+ class has two constructors, which is standard for all classes that derive directly or indirectly from the class.
+
+ The constructor, which takes an instance of the class as a parameter, calls the second constructor and passes it two parameter values:
+
+- The .
+- The string value that is specified in the field, which defines the tab spacing that is used by the XHTML text writer.
+
+## Examples
+ The following code example demonstrates how to create a class named `ChtmlCustomPageAdapter` and defines one method, `CreateCustomChtmlTextWriter`, which creates and returns an instance of the `CustomChtmlTextWriter` class. The `CustomChtmlTextWriter` then renders cHTML content for pages to devices with browsers that use cHTML markup.
+
+ This code example is part of a larger example provided for the class.
+
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample4/cs/chtmltextwriter.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample4/vb/chtmltextwriter.vb" id="Snippet3":::
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample4/vb/chtmltextwriter.vb" id="Snippet3":::
+
]]>
@@ -133,19 +122,17 @@
The number of spaces defined in the .
Initializes a new instance of the class with the specified line indentation.
- constructor, which takes both an instance of the class and a string as parameters, calls the constructor that takes the same parameters when it creates an instance of the class.
-
-
-
-## Examples
- The following code example demonstrates how to create a custom class named `CustomChtmlTextWriter` that is derived from the class. It creates two constructors that you can use to create an instance of the custom class with the same pattern as all classes that derive, directly or indirectly, from the class.
-
+ constructor, which takes both an instance of the class and a string as parameters, calls the constructor that takes the same parameters when it creates an instance of the class.
+
+## Examples
+ The following code example demonstrates how to create a custom class named `CustomChtmlTextWriter` that is derived from the class. It creates two constructors that you can use to create an instance of the custom class with the same pattern as all classes that derive, directly or indirectly, from the class.
+
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample4/cs/chtmltextwriter.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample4/vb/chtmltextwriter.vb" id="Snippet1":::
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample4/vb/chtmltextwriter.vb" id="Snippet1":::
+
]]>
@@ -175,11 +162,11 @@
The attribute to add to .
Adds an attribute to a cHTML element of the object.
- method adds an attribute to a cHTML element. The recognized attribute is stored in the recognized attributes collection of the object that is referenced by the property.
-
+ method adds an attribute to a cHTML element. The recognized attribute is stored in the recognized attributes collection of the object that is referenced by the property.
+
]]>
@@ -212,19 +199,22 @@
Gets a object of globally suppressed attributes that cannot be rendered on cHTML elements.
A of globally suppressed cHTML attributes.
- class is created.
-
-|||
-|-|-|
-|`onclick`|`onmousemove`|
-|`ondblclick`|`onmouseout`|
-|`onmousedown`|`onkeypress`|
-|`onmouseup`|`onkeydown`|
-|`onmouseover`|`onkeyup`|
-
+ class is created.
+
+- `onclick`
+- `onmousemove`
+- `ondblclick`
+- `onmouseout`
+- `onmousedown`
+- `onkeypress`
+- `onmouseup`
+- `onkeydown`
+- `onmouseover`
+- `onkeyup`
+
]]>
@@ -260,21 +250,21 @@
to write the attribute and its value to the output stream; otherwise, .
- method prevents globally suppressed attributes that are listed in the property and element-specific, suppressed attributes that are listed in the property from being written to the output stream. You can override the behavior of the method in classes that are derived from the class.
-
-
-
-## Examples
- The following code example demonstrates how to use a custom class that overrides the method to prevent the `bgcolor` attribute from being written to the cHTML output stream. It then calls the functionality that is provided by the base method from the class to ensure that its default behavior is used, too.
-
- This code example is part of a larger example provided for the class.
-
+ method prevents globally suppressed attributes that are listed in the property and element-specific, suppressed attributes that are listed in the property from being written to the output stream. You can override the behavior of the method in classes that are derived from the class.
+
+
+
+## Examples
+ The following code example demonstrates how to use a custom class that overrides the method to prevent the `bgcolor` attribute from being written to the cHTML output stream. It then calls the functionality that is provided by the base method from the class to ensure that its default behavior is used, too.
+
+ This code example is part of a larger example provided for the class.
+
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample4/cs/chtmltextwriter.cs" id="Snippet2":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample4/vb/chtmltextwriter.vb" id="Snippet2":::
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample4/vb/chtmltextwriter.vb" id="Snippet2":::
+
]]>
@@ -309,11 +299,11 @@
if the style can be rendered; otherwise, .
- method returns `false` when `key` is equal to the field and the value is `"line-through"`.
-
+ method returns `false` when `key` is equal to the field and the value is `"line-through"`.
+
]]>
@@ -347,11 +337,11 @@
if the specified cHTML markup element can be rendered; otherwise, .
- method returns `false`. For all other tags, it returns `true`.
-
+ method returns `false`. For all other tags, it returns `true`.
+
]]>
@@ -383,11 +373,11 @@
Gets a object of recognized attributes that could be rendered on cHTML elements.
A of recognized cHTML attributes.
- method to add recognized attributes to the recognized attributes collection.
-
+ method to add recognized attributes to the recognized attributes collection.
+
]]>
@@ -426,11 +416,11 @@
The attribute to remove from .
Removes an attribute of a cHTML element of the object.
- method removes an attribute from a cHTML element. The recognized attribute is removed from the recognized attributes collection of the object that is referenced by the property.
-
+ method removes an attribute from a cHTML element. The recognized attribute is removed from the recognized attributes collection of the object that is referenced by the property.
+
]]>
@@ -462,26 +452,26 @@
Gets a object of user-specified suppressed attributes that are not rendered on cHTML elements.
A of suppressed cHTML attributes.
- method to add attributes to the suppressed attributes collection.
-
- The following list shows the default suppressed attributes that are set for a `div` element when a new instance of the class is created.
-
-|||
-|-|-|
-|`accesskey`|`gridlines`|
-|`cellspacing`|`rules`|
-|`cellpadding`||
-
- The following list shows the default suppressed attributes that are set for a `span` element when a new instance of the class is created.
-
-|||
-|-|-|
-|`cellspacing`|`gridlines`|
-|`cellpadding`|`rules`|
-
+ method to add attributes to the suppressed attributes collection.
+
+ The following list shows the default suppressed attributes that are set for a `div` element when a new instance of the class is created.
+
+- `accesskey`
+- `gridlines`
+- `cellspacing`
+- `rules`
+- `cellpadding`
+
+ The following list shows the default suppressed attributes that are set for a `span` element when a new instance of the class is created.
+
+- `cellspacing`
+- `gridlines`
+- `cellpadding`
+- `rules`
+
]]>
@@ -509,45 +499,45 @@
Writes a element to the cHTML output stream.
- method to insert a line break into a stream of cHTML.
-
-
-
-## Examples
- This section contains two code examples. The first code example demonstrates how to create a cHTML class and custom properties. The second code example demonstrates how to use a custom class on a Web page.
-
- To use the custom `ChtmlSimplelabelAdapter` adapter, add the following code to either the appropriate machine-wide file in the subdirectory for the browser of the .NET Framework configuration directory or to a custom browser file in the App_Browsers directory under the Web application root.
-
-```
-
-
-
-```
-
- The following code example demonstrates how to create a cHTML adapter class named `ChtmlSimpleLabelAdapter` for a class named `SimpleLabel`. It creates a custom `Control` property that allows the `ChtmlSimpleLabelAdapter` class to access the members of the `SimpleLabel` class, and then overrides the method. In the override, the following things occur:
-
-- It creates a reference to a object, named `w`, which is derived from the object that is passed as the `writer` parameter for the method.
-
-- It creates a string and sets it equal to the `SimpleLabel.Text` value.
-
-- It calls the method to apply the styles that are defined by the property of the label to the cHTML output stream.
-
-- It writes the `Text` property value to the stream and closes the style block by calling the method.
-
-- It calls the method to render a `br` element to the output stream after the text and styles render.
-
+ method to insert a line break into a stream of cHTML.
+
+
+
+## Examples
+ This section contains two code examples. The first code example demonstrates how to create a cHTML class and custom properties. The second code example demonstrates how to use a custom class on a Web page.
+
+ To use the custom `ChtmlSimplelabelAdapter` adapter, add the following code to either the appropriate machine-wide file in the subdirectory for the browser of the .NET Framework configuration directory or to a custom browser file in the App_Browsers directory under the Web application root.
+
+```
+
+
+
+```
+
+ The following code example demonstrates how to create a cHTML adapter class named `ChtmlSimpleLabelAdapter` for a class named `SimpleLabel`. It creates a custom `Control` property that allows the `ChtmlSimpleLabelAdapter` class to access the members of the `SimpleLabel` class, and then overrides the method. In the override, the following things occur:
+
+- It creates a reference to a object, named `w`, which is derived from the object that is passed as the `writer` parameter for the method.
+
+- It creates a string and sets it equal to the `SimpleLabel.Text` value.
+
+- It calls the method to apply the styles that are defined by the property of the label to the cHTML output stream.
+
+- It writes the `Text` property value to the stream and closes the style block by calling the method.
+
+- It calls the method to render a `br` element to the output stream after the text and styles render.
+
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample1/cs/chtmltestlabel.cs" id="Snippet2":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample1/VB/chtmltestlabel.vb" id="Snippet2":::
-
- The following example demonstrates how to use the `SimpleLabel` class in a Web page.
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample1/VB/chtmltestlabel.vb" id="Snippet2":::
+
+ The following example demonstrates how to use the `SimpleLabel` class in a Web page.
+
:::code language="aspx-csharp" source="~/snippets/csharp/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample1/cs/chtmltestlabel.aspx" id="Snippet3":::
- :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample1/VB/chtmltestlabel.aspx" id="Snippet3":::
-
+ :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.ChtmlTextWriter_Sample1/VB/chtmltestlabel.aspx" id="Snippet3":::
+
]]>
@@ -576,15 +566,15 @@
The text string to encode and write to the output stream.
Encodes the specified text for the requesting device, and then writes it to the output stream.
- method is `null` or has a length of zero, then nothing is written.
-
- Use the method when a string contains angle brackets (\< or >) or an ampersand (&) and you want to ensure that they are rendered correctly on the requesting device.
-
- The method uses the base class's method.
-
+ method is `null` or has a length of zero, then nothing is written.
+
+ Use the method when a string contains angle brackets (\< or >) or an ampersand (&) and you want to ensure that they are rendered correctly on the requesting device.
+
+ The method uses the base class's method.
+
]]>
diff --git a/xml/System.Web.UI/ObjectStateFormatter.xml b/xml/System.Web.UI/ObjectStateFormatter.xml
index bbc642260e3..8e061a59372 100644
--- a/xml/System.Web.UI/ObjectStateFormatter.xml
+++ b/xml/System.Web.UI/ObjectStateFormatter.xml
@@ -27,41 +27,53 @@
Serializes and deserializes object graphs that represent the state of an object. This class cannot be inherited.
- class serializes and deserializes object state graphs in a compact format.
-
- is used by the class and classes that derive from it to serialize view state and control state. It is also used by the class to provide object state graph formatting for various parts of the ASP.NET infrastructure.
-
- The class is optimized to serialize and format many common .NET Framework reference types, as well as constants. The following table lists the types that are optimized.
-
-|||||
-|-|-|-|-|
-|||||
-||||String []|
-|||null (`Nothing`)||
-|||||
-|||||
-|||||
-
- Additionally, while conventional string types and string arrays are written to and from a serialized binary writer unaltered, some strings are optimized by creating internal string tables. Strings are optimized using these tables if the string has an associated object or if the string is actually an instance of the class.
-
- Other types not listed above are binary-serialized using a object if they implement the interface or are decorated with the attribute. The class is not optimized for any of these serializable types.
-
- If the class encounters a type that is not serializable, an exception is thrown.
-
-
-
-## Examples
- The following code example demonstrates how a class that derives from the class accesses the property to retrieve an instance to serialize view state and control state to a stream. This code example is part of a larger example provided for the class.
-
+ The class serializes and deserializes object state graphs in a compact format.
+
+ is used by the class and classes that derive from it to serialize view state and control state. It is also used by the class to provide object state graph formatting for various parts of the ASP.NET infrastructure.
+
+ The class is optimized to serialize and format many common .NET Framework reference types, as well as constants. The following types are optimized:
+
+-
+-
+-
+-
+-
+-
+-
+- `String[]`
+-
+-
+- `null` (`Nothing`)
+-
+-
+-
+-
+-
+-
+-
+-
+-
+-
+-
+
+ Additionally, while conventional string types and string arrays are written to and from a serialized binary writer unaltered, some strings are optimized by creating internal string tables. Strings are optimized using these tables if the string has an associated object or if the string is actually an instance of the class.
+
+ Other types not listed above are binary-serialized using a object if they implement the interface or are decorated with the attribute. The class is not optimized for any of these serializable types.
+
+ If the class encounters a type that is not serializable, an exception is thrown.
+
+## Examples
+ The following code example demonstrates how a class that derives from the class accesses the property to retrieve an instance to serialize view state and control state to a stream. This code example is part of a larger example provided for the class.
+
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_WebNet/Samples.AspNet.Alexkr.TextFilePageStatePersister_1/CS/textfilepagestatepersister.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/Samples.AspNet.Alexkr.TextFilePageStatePersister_1/VB/textfilepagestatepersister.vb" id="Snippet3":::
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/Samples.AspNet.Alexkr.TextFilePageStatePersister_1/VB/textfilepagestatepersister.vb" id="Snippet3":::
+
]]>
@@ -98,12 +110,12 @@
Deserializes an object state graph from serialized form.
-
@@ -134,19 +146,19 @@
Deserializes an object state graph from its binary-serialized form that is contained in the specified object.
An object that represents a deserialized object state graph.
- method can be deserialized with the method. The method is used to restore an object state graph stored in a , such as a .
-
-[!INCLUDE [untrusted-data-method-note](~/includes/untrusted-data-method-note.md)]
-
-## Examples
- The following code example demonstrates how a class that derives from the class initializes the collection. In this example, the collection has been assigned to the field of a object, and serialized to a file using the class. When the method is called, the method is used to deserialize view state from the file, and the property is initialized. This code example is part of a larger example provided for the class.
-
+ method can be deserialized with the method. The method is used to restore an object state graph stored in a , such as a .
+
+[!INCLUDE [untrusted-data-method-note](~/includes/untrusted-data-method-note.md)]
+
+## Examples
+ The following code example demonstrates how a class that derives from the class initializes the collection. In this example, the collection has been assigned to the field of a object, and serialized to a file using the class. When the method is called, the method is used to deserialize view state from the file, and the property is initialized. This code example is part of a larger example provided for the class.
+
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_WebNet/Samples.AspNet.Alexkr.TextFilePageStatePersister_1/CS/textfilepagestatepersister.cs" id="Snippet2":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/Samples.AspNet.Alexkr.TextFilePageStatePersister_1/VB/textfilepagestatepersister.vb" id="Snippet2":::
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/Samples.AspNet.Alexkr.TextFilePageStatePersister_1/VB/textfilepagestatepersister.vb" id="Snippet2":::
+
]]>
The specified is .
@@ -177,19 +189,19 @@
Deserializes an object state graph from its serialized base64-encoded string form.
An object that represents a deserialized object state graph.
- method can be deserialized with the method. The method is used to restore an object state graph stored in base64-encoded string form.
-
-[!INCLUDE [untrusted-data-method-note](~/includes/untrusted-data-method-note.md)]
-
-## Examples
- The following code example demonstrates how to implement a method that deserializes a base64-encoded string and returns an collection of property settings. This code example relies on the property settings having been serialized with the class, as shown in the method.
-
+ method can be deserialized with the method. The method is used to restore an object state graph stored in base64-encoded string form.
+
+[!INCLUDE [untrusted-data-method-note](~/includes/untrusted-data-method-note.md)]
+
+## Examples
+ The following code example demonstrates how to implement a method that deserializes a base64-encoded string and returns an collection of property settings. This code example relies on the property settings having been serialized with the class, as shown in the method.
+
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_WebNet/System.Web.UI.ObjectStateFormatter_1/CS/objectstateformattertest.cs" id="Snippet2":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.ObjectStateFormatter_1/VB/objectstateformattertest.vb" id="Snippet2":::
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.ObjectStateFormatter_1/VB/objectstateformattertest.vb" id="Snippet2":::
+
]]>
The specified is or has a of 0.
@@ -230,19 +242,19 @@
Serializes an object state graph to a base64-encoded string.
A base-64 encoded string that represents the serialized object state of the parameter.
- method can be deserialized with the method. The method is used to serialize an object state graph to a base64-encoded string form.
-
-
-
-## Examples
- The following code example demonstrates how to serialize the values of a set of control properties to a base64-encoded string using the method. The string can be deserialized at a later time with the method.
-
+ method can be deserialized with the method. The method is used to serialize an object state graph to a base64-encoded string form.
+
+
+
+## Examples
+ The following code example demonstrates how to serialize the values of a set of control properties to a base64-encoded string using the method. The string can be deserialized at a later time with the method.
+
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_WebNet/System.Web.UI.ObjectStateFormatter_1/CS/objectstateformattertest.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.ObjectStateFormatter_1/VB/objectstateformattertest.vb" id="Snippet1":::
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.ObjectStateFormatter_1/VB/objectstateformattertest.vb" id="Snippet1":::
+
]]>
@@ -272,19 +284,19 @@
The object to serialize.
Serializes an object state graph to the specified object.
- method can be deserialized with the method. The method is used to serialize an object state graph to a binary object.
-
-
-
-## Examples
- The following code example demonstrates how a class retrieves an instance to serialize view state and control state to a stream using the method. This code example is part of a larger example provided for the class.
-
+ method can be deserialized with the method. The method is used to serialize an object state graph to a binary object.
+
+
+
+## Examples
+ The following code example demonstrates how a class retrieves an instance to serialize view state and control state to a stream using the method. This code example is part of a larger example provided for the class.
+
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_WebNet/Samples.AspNet.Alexkr.TextFilePageStatePersister_1/CS/textfilepagestatepersister.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/Samples.AspNet.Alexkr.TextFilePageStatePersister_1/VB/textfilepagestatepersister.vb" id="Snippet3":::
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/Samples.AspNet.Alexkr.TextFilePageStatePersister_1/VB/textfilepagestatepersister.vb" id="Snippet3":::
+
]]>
The specified is .
@@ -313,13 +325,13 @@
For a description of this member, see .
The that performs type lookups during deserialization.
- instance is cast to an interface.
-
+
+ This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
+
]]>
@@ -347,13 +359,13 @@
For a description of this member, see .
The used for serialization and deserialization.
- instance is cast to an interface.
-
+
+ This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
+
]]>
@@ -391,11 +403,11 @@
For a description of this member, see .
The top object of the deserialized graph.
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -434,11 +446,11 @@
The object, or root of the object graph, to serialize. All child objects of this root object are automatically serialized.
For a description of this member, see .
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -466,13 +478,13 @@
For a description of this member, see .
The used by this formatter.
- instance is cast to an interface.
-
+
+ This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
+
]]>
@@ -510,11 +522,11 @@
For a description of this member, see .
An object that represents the state of an ASP.NET server control.
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -552,11 +564,11 @@
For a description of this member, see .
A string that represents a Web server control's view state.
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
diff --git a/xml/System.Workflow.Activities/WorkflowServiceAttributes.xml b/xml/System.Workflow.Activities/WorkflowServiceAttributes.xml
index 461a2e4cfe3..098cca210a7 100644
--- a/xml/System.Workflow.Activities/WorkflowServiceAttributes.xml
+++ b/xml/System.Workflow.Activities/WorkflowServiceAttributes.xml
@@ -35,27 +35,26 @@
Builds the service behavior for the workflow service that it decorates.
- [!NOTE]
-> [!INCLUDE[DeprecatedContent](~/includes/deprecatedcontent-md.md)]
-
- The WorkflowServiceAttributes class is used to define service attributes for a activity.
-
- Some of the attributes have default values, as shown below.
-
-|||
-|-|-|
-|Attribute|Default Value|
-|AddressFilterMode|Exact|
-|IgnoreExtensionDataObject|False|
-|IncludeExceptionDetailInFault|False|
-|MaxItemsInObjectGraph|2147483647|
-|UseSynchronizationContext|True|
-|ValidateMustUnderstand|True|
-
+> [!INCLUDE[DeprecatedContent](~/includes/deprecatedcontent-md.md)]
+
+ The WorkflowServiceAttributes class is used to define service attributes for a activity.
+
+ Some of the attributes have default values, as shown below.
+
+| Attribute | Default value |
+|-------------------------------|---------------|
+| AddressFilterMode | Exact |
+| IgnoreExtensionDataObject | False |
+| IncludeExceptionDetailInFault | False |
+| MaxItemsInObjectGraph | 2147483647 |
+| UseSynchronizationContext | True |
+| ValidateMustUnderstand | True |
+
]]>
@@ -76,19 +75,19 @@
Initializes a new instance of the class.
- activity is created.
-
-
-
-## Examples
- The following example demonstrates how to create a new instance of the class.
-
+ activity is created.
+
+
+
+## Examples
+ The following example demonstrates how to create a new instance of the class.
+
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/workflowserviceattributes/cs/snippets.cs" id="Snippet0":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/workflowserviceattributes/vb/snippets.vb" id="Snippet0":::
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/workflowserviceattributes/vb/snippets.vb" id="Snippet0":::
+
]]>
@@ -119,19 +118,19 @@
Gets or sets the enumeration that is used by the dispatcher to route incoming messages to the correct endpoint.
An enumeration value that is used by the dispatcher to route incoming messages to the correct endpoint.
-
@@ -162,19 +161,19 @@
Gets or sets the value used to locate the service element in an application configuration file.
The value to locate in the configuration file.
-
@@ -206,19 +205,19 @@
if unknown serialization data is never sent; otherwise, .
-
@@ -250,19 +249,19 @@
if unhandled exceptions are to be returned as SOAP faults; otherwise, .
-
@@ -293,19 +292,19 @@
Gets or sets the maximum number of items allowed in a serialized object.
The maximum number of items allowed in an object.
- .
-
-
-
-## Examples
- The following example demonstrates how to access the `MaxItemsInObjectGraph` property.
-
+ .
+
+
+
+## Examples
+ The following example demonstrates how to access the `MaxItemsInObjectGraph` property.
+
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/workflowserviceattributes/cs/snippets.cs" id="Snippet5":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/workflowserviceattributes/vb/snippets.vb" id="Snippet5":::
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/workflowserviceattributes/vb/snippets.vb" id="Snippet5":::
+
]]>
@@ -336,19 +335,19 @@
Gets or sets the value of the name attribute in the service element in Web Services Description Language (WSDL).
The value of the Name property.
- ` element when exported. The default value is null.
-
-
-
-## Examples
- The following example demonstrates how to access the `Name` property.
-
+ ` element when exported. The default value is null.
+
+
+
+## Examples
+ The following example demonstrates how to access the `Name` property.
+
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/workflowserviceattributes/cs/snippets.cs" id="Snippet6":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/workflowserviceattributes/vb/snippets.vb" id="Snippet6":::
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/workflowserviceattributes/vb/snippets.vb" id="Snippet6":::
+
]]>
@@ -379,19 +378,19 @@
Gets or sets the value of the target namespace for the service in Web Services Description Language (WSDL).
The value of the Namespace property.
- ` element that contains the `` element when exported. The default value is null.
-
-
-
-## Examples
- The following example demonstrates how to access the `Namespace` property.
-
+ ` element that contains the `` element when exported. The default value is null.
+
+
+
+## Examples
+ The following example demonstrates how to access the `Namespace` property.
+
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/workflowserviceattributes/cs/snippets.cs" id="Snippet7":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/workflowserviceattributes/vb/snippets.vb" id="Snippet7":::
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/workflowserviceattributes/vb/snippets.vb" id="Snippet7":::
+
]]>
@@ -423,19 +422,19 @@
if all calls to the service must run on the thread specified by the ; otherwise, .
-
@@ -467,19 +466,19 @@
if the system is to perform SOAP header processing; otherwise , which indicates that the application performs this processing.
-
diff --git a/xml/System.Xml/XmlTextReader.xml b/xml/System.Xml/XmlTextReader.xml
index 2aab7eb45d6..be0e3baefa1 100644
--- a/xml/System.Xml/XmlTextReader.xml
+++ b/xml/System.Xml/XmlTextReader.xml
@@ -1495,7 +1495,7 @@ XmlTextReader reader = new XmlTextReader(s);
## Remarks
> [!NOTE]
-> Starting with the .NET Framework 2.0, we recommend that you create instances by using the method to take advantage of new functionality.
+> We recommend that you create instances by using the method to take advantage of newer functionality.
Because uses the class, `XmlTextReader` also supports all encodings supported by that class. The exception to this is any encoding, such as UTF-7 or EBCDIC, that maps the ` is set to `Significant` or `All`, the "doc" element expands the character entity and returns the general entity as a node:
-|Depth|Node type|Name|Value|
-|-----------|---------------|----------|-----------|
-|1|`Text`||A|
-|1|`EntityReference`|num||
-|1|`SignificantWhitespace`|||
+| Depth | Node type | Name | Value |
+|-------|-------------------------|------|-------|
+| 1 | `Text` | | A |
+| 1 | `EntityReference` | num | |
+| 1 | `SignificantWhitespace` | | |
]]>
diff --git a/xml/System.Xml/XmlValidatingReader.xml b/xml/System.Xml/XmlValidatingReader.xml
index fb557be618c..b4474c51243 100644
--- a/xml/System.Xml/XmlValidatingReader.xml
+++ b/xml/System.Xml/XmlValidatingReader.xml
@@ -70,20 +70,20 @@
- Represents a reader that provides document type definition (DTD), XML-Data Reduced (XDR) schema, and XML Schema definition language (XSD) validation.
-
+ Represents a reader that provides document type definition (DTD), XML-Data Reduced (XDR) schema, and XML Schema definition language (XSD) validation.
+
This class is obsolete. Starting with the .NET Framework 2.0, we recommend that you use the class and the method to create a validating XML reader.
- class and provides support for data validation. Use the property to have the reader validate by using schema files that are cached in an . The property specifies what type of validation the reader should perform. Setting the property to ValidationType.None creates a non-validating reader.
-
- throws an on XML parse errors. After an exception is thrown the state of the reader is not predictable. For example, the reported node type may be different than the actual node type of the current node. Use the property to check whether a reader is in error state.
-
+ class and provides support for data validation. Use the property to have the reader validate by using schema files that are cached in an . The property specifies what type of validation the reader should perform. Setting the property to ValidationType.None creates a non-validating reader.
+
+ throws an on XML parse errors. After an exception is thrown the state of the reader is not predictable. For example, the reported node type may be different than the actual node type of the current node. Use the property to check whether a reader is in error state.
+
> [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
]]>
@@ -140,40 +140,40 @@
The to read from while validating. The current implementation supports only .
Initializes a new instance of the class that validates the content returned from the given .
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- All nodes returned from the given `XmlReader` are also returned from this validating reader, so there is no information loss in the process. New nodes not returned from the underlying reader may be added by this reader (for example, default attributes and the children of an entity reference). Any properties set on the given `XmlTextReader` also apply to this validating reader. For example, if the supplied reader had WhitespaceHandling.None set, this validating reader also ignores white space.
-
- When external document type definitions (DTDs) or schemas are needed for validation, the property sets the object to use for resolving external resources.
-
-
-
-## Examples
- The following example validates two documents.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ All nodes returned from the given `XmlReader` are also returned from this validating reader, so there is no information loss in the process. New nodes not returned from the underlying reader may be added by this reader (for example, default attributes and the children of an entity reference). Any properties set on the given `XmlTextReader` also apply to this validating reader. For example, if the supplied reader had WhitespaceHandling.None set, this validating reader also ignores white space.
+
+ When external document type definitions (DTDs) or schemas are needed for validation, the property sets the object to use for resolving external resources.
+
+
+
+## Examples
+ The following example validates two documents.
+
[!code-cpp[XmlValidatingReader.Cctor#1](~/snippets/cpp/VS_Snippets_Data/XmlValidatingReader.Cctor/CPP/valid_xsd2.cpp#1)]
[!code-csharp[XmlValidatingReader.Cctor#1](~/snippets/csharp/System.Xml/XmlValidatingReader/.ctor/valid_xsd2.cs#1)]
- [!code-vb[XmlValidatingReader.Cctor#1](~/snippets/visualbasic/VS_Snippets_Data/XmlValidatingReader.Cctor/VB/valid_xsd2.vb#1)]
-
- The sample uses the following input files:
-
- `notValidXSD.xml`
-
- [!code-xml[XmlValidatingReader.Cctor#2](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.Cctor/XML/notvalidxsd.xml#2)]
-
- `books.xsd`
-
- [!code-xml[XmlValidatingReader.Cctor#3](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.Cctor/XML/books.xsd#3)]
-
- `inlineXSD.xml`
-
- [!code-xml[XmlValidatingReader.Cctor#4](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.Cctor/XML/inlinexsd.xml#4)]
-
+ [!code-vb[XmlValidatingReader.Cctor#1](~/snippets/visualbasic/VS_Snippets_Data/XmlValidatingReader.Cctor/VB/valid_xsd2.vb#1)]
+
+ The sample uses the following input files:
+
+ `notValidXSD.xml`
+
+ [!code-xml[XmlValidatingReader.Cctor#2](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.Cctor/XML/notvalidxsd.xml#2)]
+
+ `books.xsd`
+
+ [!code-xml[XmlValidatingReader.Cctor#3](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.Cctor/XML/books.xsd#3)]
+
+ `inlineXSD.xml`
+
+ [!code-xml[XmlValidatingReader.Cctor#4](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.Cctor/XML/inlinexsd.xml#4)]
+
]]>
The reader specified is not an .
@@ -223,38 +223,38 @@
The in which the XML fragment is to be parsed. This includes the to use, encoding, namespace scope, current , and scope.
Initializes a new instance of the class with the specified values.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This constructor parses the given string as a fragment of XML. If the XML fragment is an element or attribute, you can bypass the root level rules for well-formed XML documents.
-
- The following table lists valid values for `fragType` and how the reader parses each of the different node types.
-
-|XmlNodeType|Fragment May Contain|
-|-----------------|--------------------------|
-|Element|Any valid element content (for example, any combination of elements, comments, processing instructions, cdata, text, and entity references).|
-|Attribute|The value of an attribute (the part inside the quotes).|
-|Document|The contents of an entire XML document; this enforces document level rules.|
-
- The reader uses the following steps to determine the encoding of the stream:
-
-1. Checks the property to determine the encoding.
-
-2. If the `Encoding` property is `null`, the reader checks for a byte-order mark at the beginning of the stream.
-
-3. If the `Encoding` property is `null`, and no byte-order mark is found, the reader assumes the stream is encoded in UTF-8.
-
- If this reader will be validating using document type definition (DTD) (that is, is set to ValidationType.DTD or ValidationType.Auto), the `XmlParserContext` specified in the constructor must supply all the necessary DocumentType information.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This constructor parses the given string as a fragment of XML. If the XML fragment is an element or attribute, you can bypass the root level rules for well-formed XML documents.
+
+ The following table lists valid values for `fragType` and how the reader parses each of the different node types.
+
+|XmlNodeType|Fragment May Contain|
+|-----------------|--------------------------|
+|Element|Any valid element content (for example, any combination of elements, comments, processing instructions, cdata, text, and entity references).|
+|Attribute|The value of an attribute (the part inside the quotes).|
+|Document|The contents of an entire XML document; this enforces document level rules.|
+
+ The reader uses the following steps to determine the encoding of the stream:
+
+1. Checks the property to determine the encoding.
+
+2. If the `Encoding` property is `null`, the reader checks for a byte-order mark at the beginning of the stream.
+
+3. If the `Encoding` property is `null`, and no byte-order mark is found, the reader assumes the stream is encoded in UTF-8.
+
+ If this reader will be validating using document type definition (DTD) (that is, is set to ValidationType.DTD or ValidationType.Auto), the `XmlParserContext` specified in the constructor must supply all the necessary DocumentType information.
+
> [!NOTE]
-> It is not possible to validate a fragment by using a DTD. By definition a DTD requires an entire document to be loaded for validation.
-
- If this reader will be validating by using XML-Data Reduced (XDR) or XML Schema definition language (XSD) schemas, use the property to specify the that contains the schemas (that is, the `XmlParserContext` does not need to supply the DocumentType information).
-
+> It is not possible to validate a fragment by using a DTD. By definition a DTD requires an entire document to be loaded for validation.
+
+ If this reader will be validating by using XML-Data Reduced (XDR) or XML Schema definition language (XSD) schemas, use the property to specify the that contains the schemas (that is, the `XmlParserContext` does not need to supply the DocumentType information).
+
]]>
@@ -311,38 +311,38 @@
The in which the XML fragment is to be parsed. This includes the to use, encoding, namespace scope, current xml:lang, and xml:space scope.
Initializes a new instance of the class with the specified values.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This constructor parses the given string as a fragment of XML. If the XML fragment is an element or attribute, you can bypass the root level rules for well-formed XML documents. This constructor can handle strings returned from .
-
- The following table lists valid values for `fragType` and how the reader parses each of the different node types.
-
-|XmlNodeType|Fragment May Contain|
-|-----------------|--------------------------|
-|Element|Any valid element content (for example, any combination of elements, comments, processing instructions, cdata, text, and entity references).|
-|Attribute|The value of an attribute (the part inside the quotes).|
-|Document|The contents of an entire XML document; this enforces document level rules.|
-
- If this reader will be validating by using document type definition (DTD) (that is, is set to ValidationType.DTD or ValidationType.Auto), the `XmlParserContext` specified in the constructor must supply all the necessary DocumentType information.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This constructor parses the given string as a fragment of XML. If the XML fragment is an element or attribute, you can bypass the root level rules for well-formed XML documents. This constructor can handle strings returned from .
+
+ The following table lists valid values for `fragType` and how the reader parses each of the different node types.
+
+|XmlNodeType|Fragment May Contain|
+|-----------------|--------------------------|
+|Element|Any valid element content (for example, any combination of elements, comments, processing instructions, cdata, text, and entity references).|
+|Attribute|The value of an attribute (the part inside the quotes).|
+|Document|The contents of an entire XML document; this enforces document level rules.|
+
+ If this reader will be validating by using document type definition (DTD) (that is, is set to ValidationType.DTD or ValidationType.Auto), the `XmlParserContext` specified in the constructor must supply all the necessary DocumentType information.
+
> [!NOTE]
-> It is not possible to validate a fragment by using DTD. By definition DTD requires an entire document to be loaded for validation.
-
- If this reader will be validating by using XML-Data Reduced (XDR) or XML Schema definition language (XSD) schemas, use the property to specify the that contains the schemas (the `XmlParserContext` does not need to supply the DocumentType information).
-
-
-
-## Examples
- The following example reads an XML fragment. It uses an `XmlParserContext` and its to handle namespace matching.
-
+> It is not possible to validate a fragment by using DTD. By definition DTD requires an entire document to be loaded for validation.
+
+ If this reader will be validating by using XML-Data Reduced (XDR) or XML Schema definition language (XSD) schemas, use the property to specify the that contains the schemas (the `XmlParserContext` does not need to supply the DocumentType information).
+
+
+
+## Examples
+ The following example reads an XML fragment. It uses an `XmlParserContext` and its to handle namespace matching.
+
[!code-csharp[Classic WebData XmlParserContext.XmlParserContext Example#1](~/snippets/csharp/System.Xml/XmlParserContext/.ctor/source.cs#1)]
- [!code-vb[Classic WebData XmlParserContext.XmlParserContext Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlParserContext.XmlParserContext Example/VB/source.vb#1)]
-
+ [!code-vb[Classic WebData XmlParserContext.XmlParserContext Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlParserContext.XmlParserContext Example/VB/source.vb#1)]
+
]]>
@@ -388,24 +388,24 @@
Gets the number of attributes on the current node.
The number of attributes on the current node. This number includes default attributes.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This property is relevant to `Element`, `DocumentType`, and `XmlDeclaration` nodes only. (Other node types do not have attributes.)
-
-
-
-## Examples
- The following example reads all the elements on the root node.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This property is relevant to `Element`, `DocumentType`, and `XmlDeclaration` nodes only. (Other node types do not have attributes.)
+
+
+
+## Examples
+ The following example reads all the elements on the root node.
+
[!code-cpp[Classic WebData XmlValidatingReader.AttributeCount Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.AttributeCount Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.AttributeCount Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/AttributeCount/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.AttributeCount Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.AttributeCount Example/VB/source.vb#1)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.AttributeCount Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.AttributeCount Example/VB/source.vb#1)]
+
]]>
@@ -450,30 +450,30 @@
Gets the base URI of the current node.
The base URI of the current node.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- A networked XML document is comprised of chunks of data aggregated by using various World Wide Web Consortium (W3C) standard inclusion mechanisms and therefore contains nodes that come from different places. document type definition (DTD) entities are an example of this, but this is not limited to DTDs. The base URI tells you where these nodes came from. If there is no base URI for the nodes being returned (for example, they were parsed from an in-memory string), String.Empty is returned.
-
-
-
-## Examples
- The following example parses a file and displays the base URI of each node.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ A networked XML document is comprised of chunks of data aggregated by using various World Wide Web Consortium (W3C) standard inclusion mechanisms and therefore contains nodes that come from different places. document type definition (DTD) entities are an example of this, but this is not limited to DTDs. The base URI tells you where these nodes came from. If there is no base URI for the nodes being returned (for example, they were parsed from an in-memory string), String.Empty is returned.
+
+
+
+## Examples
+ The following example parses a file and displays the base URI of each node.
+
[!code-cpp[Classic WebData XmlValidatingReader.BaseURI Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.BaseURI Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.BaseURI Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/BaseURI/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.BaseURI Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.BaseURI Example/VB/source.vb#1)]
-
- The example uses the file, `uri.xml`, as input.
-
- [!code-xml[Classic WebData XmlValidatingReader.BaseURI Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.BaseURI Example/XML/source.xml#2)]
-
- The `style.xml` file contains the XML text ``.
-
+ [!code-vb[Classic WebData XmlValidatingReader.BaseURI Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.BaseURI Example/VB/source.vb#1)]
+
+ The example uses the file, `uri.xml`, as input.
+
+ [!code-xml[Classic WebData XmlValidatingReader.BaseURI Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.BaseURI Example/XML/source.xml#2)]
+
+ The `style.xml` file contains the XML text ``.
+
]]>
@@ -517,15 +517,15 @@
if the binary content read methods are implemented; otherwise . The class returns .
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- The binary content read methods include the , , , and methods.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ The binary content read methods include the , , , and methods.
+
]]>
@@ -570,13 +570,13 @@
if the reader can parse and resolve entities; otherwise, . always returns .
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
]]>
@@ -620,17 +620,17 @@
Changes the to Closed.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This method also releases any resources held while reading. If this reader was constructed by using an , this method also calls `Close` on the underlying reader. If this reader was constructed by using a stream, this method also calls `Close` on the underlying stream.
-
- If `Close` has already been called, no action is performed.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This method also releases any resources held while reading. If this reader was constructed by using an , this method also calls `Close` on the underlying reader. If this reader was constructed by using a stream, this method also calls `Close` on the underlying stream.
+
+ If `Close` has already been called, no action is performed.
+
]]>
@@ -674,22 +674,22 @@
Gets the depth of the current node in the XML document.
The depth of the current node in the XML document.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
-
-
-## Examples
- The following example displays each node including its depth, line number, and line position.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+
+
+## Examples
+ The following example displays each node including its depth, line number, and line position.
+
[!code-cpp[IXmlLineInfo#1](~/snippets/cpp/VS_Snippets_Data/IXmlLineInfo/CPP/lineinfo.cpp#1)]
[!code-csharp[IXmlLineInfo#1](~/snippets/csharp/System.Xml/IXmlLineInfo/Overview/lineinfo.cs#1)]
- [!code-vb[IXmlLineInfo#1](~/snippets/visualbasic/VS_Snippets_Data/IXmlLineInfo/VB/lineinfo.vb#1)]
-
+ [!code-vb[IXmlLineInfo#1](~/snippets/visualbasic/VS_Snippets_Data/IXmlLineInfo/VB/lineinfo.vb#1)]
+
]]>
@@ -741,17 +741,17 @@
Gets the encoding attribute for the document.
The encoding value. If no encoding attribute exists, and there is not byte-order mark, this defaults to UTF-8.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- When any external reference is read (such as expanding an entity in a document type definition (DTD) file or reading a schema file) the encoding property is set to the encoding value of the external reference. If encoding is not specified in the external reference, and there is no byte-order mark, this defaults to UTF-8.
-
- All the encoding standards that the underlying operating system supports are supported.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ When any external reference is read (such as expanding an entity in a document type definition (DTD) file or reading a schema file) the encoding property is set to the encoding value of the external reference. If encoding is not specified in the external reference, and there is no byte-order mark, this defaults to UTF-8.
+
+ All the encoding standards that the underlying operating system supports are supported.
+
]]>
@@ -795,51 +795,49 @@
Gets or sets a value that specifies how the reader handles entities.
One of the values. If no is specified, it defaults to EntityHandling.ExpandEntities.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This property can be changed and takes effect after the next call.
-
- When `EntityHandling` is set to `ExpandCharEntities`, attribute values are only partially normalized. The reader normalizes each individual text node independently from the content of adjacent entity reference nodes.
-
- To illustrate the difference between the entity handling modes consider the following XML:
-
-```xml
-]>
- A #
-```
-
- When `EntityHandling` is set to `ExpandEntities` the "doc" element node contains one text node with the expanded entity text:
-
-|Depth|NodeType|Name|Value|
-|-----------|--------------|----------|-----------|
-|1|Text||A 123|
-
- When `EntityHandling` is set to `ExpandCharEntities`, and is set to Significant or All, the "doc" element expands the character entity and returns the general entity as a node:
-
-|Depth|NodeType|Name|Value|
-|-----------|--------------|----------|-----------|
-|1|Text||A|
-|1|EntityReference|num||
-|1|SignificantWhitespace|||
-
-
-
-## Examples
- The following example uses the `ResolveEntity` method to expand a general entity.
-
- [!code-cpp[Classic WebData XmlValidatingReader.ResolveEntity Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.ResolveEntity Example/CPP/source.cpp#1)]
- [!code-csharp[Classic WebData XmlValidatingReader.ResolveEntity Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/EntityHandling/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.ResolveEntity Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.ResolveEntity Example/VB/source.vb#1)]
-
- The example uses the file, `book1.xml`, as input.
-
- [!code-xml[Classic WebData XmlValidatingReader.ResolveEntity Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.ResolveEntity Example/XML/source.xml#2)]
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This property can be changed and takes effect after the next call.
+
+ When `EntityHandling` is set to `ExpandCharEntities`, attribute values are only partially normalized. The reader normalizes each individual text node independently from the content of adjacent entity reference nodes.
+
+ To illustrate the difference between the entity handling modes consider the following XML:
+
+```xml
+]>
+ A #
+```
+
+ When `EntityHandling` is set to `ExpandEntities` the "doc" element node contains one text node with the expanded entity text:
+
+| Depth | NodeType | Name | Value |
+|-------|----------|------|-------|
+| 1 | Text | | A 123 |
+
+ When `EntityHandling` is set to `ExpandCharEntities`, and is set to Significant or All, the "doc" element expands the character entity and returns the general entity as a node:
+
+| Depth | NodeType | Name | Value |
+|-------|-----------------------|------|-------|
+| 1 | Text | | A |
+| 1 | EntityReference | num | |
+| 1 | SignificantWhitespace | | |
+
+## Examples
+ The following example uses the `ResolveEntity` method to expand a general entity.
+
+ [!code-cpp[Classic WebData XmlValidatingReader.ResolveEntity Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.ResolveEntity Example/CPP/sour| [!code-cpp[Classic WebData XmlValidatingReader.ResolveEntity Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.ResolveEntity Example/CPP/source.cpp#1)] |
+|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|cs#1)]
+ [!code-vb[Classic WebData XmlValidatingReader.ResolveEntity Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.ResolveEntity Example/VB/source.vb#1)]
+
+ The example uses the file, `book1.xml`, as input.
+
+ [!code-xml[Classic WebData XmlValidatingReader.ResolveEntity Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.ResolveEntity Example/XML/source.xml#2)]
+
]]>
Invalid value was specified.
@@ -885,13 +883,13 @@
if the reader is positioned at the end of the stream; otherwise, .
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
]]>
@@ -949,14 +947,14 @@
Gets the value of the attribute with the specified index.
The value of the specified attribute.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
]]>
The parameter is less than 0 or greater than or equal to .
@@ -1006,30 +1004,30 @@
Gets the value of the attribute with the specified name.
The value of the specified attribute. If the attribute is not found, is returned.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This method does not move the reader.
-
- If the reader is positioned on a `DocumentType` node, this method can be used to get the PUBLIC and SYSTEM literals, for example, `reader.GetAttribute("PUBLIC")`
-
-
-
-## Examples
- The following example gets the value of the ISBN attribute.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This method does not move the reader.
+
+ If the reader is positioned on a `DocumentType` node, this method can be used to get the PUBLIC and SYSTEM literals, for example, `reader.GetAttribute("PUBLIC")`
+
+
+
+## Examples
+ The following example gets the value of the ISBN attribute.
+
[!code-cpp[Classic WebData XmlValidatingReader.GetAttribute Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.GetAttribute Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.GetAttribute Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/GetAttribute/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.GetAttribute Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.GetAttribute Example/VB/source.vb#1)]
-
- The example uses the file, `attrs.xml`, as input.
-
- [!code-xml[Classic WebData XmlValidatingReader.GetAttribute Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.GetAttribute Example/XML/attrs.xml#2)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.GetAttribute Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.GetAttribute Example/VB/source.vb#1)]
+
+ The example uses the file, `attrs.xml`, as input.
+
+ [!code-xml[Classic WebData XmlValidatingReader.GetAttribute Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.GetAttribute Example/XML/attrs.xml#2)]
+
]]>
@@ -1087,35 +1085,35 @@
Gets the value of the attribute with the specified local name and namespace Uniform Resource Identifier (URI).
The value of the specified attribute. If the attribute is not found, is returned. This method does not move the reader.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- The following XML contains an attribute in a specific namespace:
-
-```xml
-
-```
-
- You can look up the `dt:type` attribute by using one argument (prefix and local name) or two arguments (local name and namespace URI):
-
-```csharp
-String dt = reader.GetAttribute("dt:type");
-String dt2 = reader.GetAttribute("type","urn:datatypes");
-```
-
- To look up the `xmlns:dt` attribute, use one of the following arguments:
-
-```csharp
-String dt3 = reader.GetAttribute("xmlns:dt");
-String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);
-```
-
- You can also get this information by using the property.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ The following XML contains an attribute in a specific namespace:
+
+```xml
+
+```
+
+ You can look up the `dt:type` attribute by using one argument (prefix and local name) or two arguments (local name and namespace URI):
+
+```csharp
+String dt = reader.GetAttribute("dt:type");
+String dt2 = reader.GetAttribute("type","urn:datatypes");
+```
+
+ To look up the `xmlns:dt` attribute, use one of the following arguments:
+
+```csharp
+String dt3 = reader.GetAttribute("xmlns:dt");
+String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);
+```
+
+ You can also get this information by using the property.
+
]]>
@@ -1163,13 +1161,13 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);
if the class can return line information; otherwise, .
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
]]>
@@ -1214,36 +1212,36 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);
if the node on which the reader is currently positioned can have a ; otherwise, .
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- The following table lists node types that have a value to return.
-
-|Node Type|Value|
-|---------------|-----------|
-|`Attribute`|The value of the attribute.|
-|`CDATA`|The content of the CDATA section.|
-|`Comment`|The content of the comment.|
-|`DocumentType`|The internal subset.|
-|`ProcessingInstruction`|The entire content, excluding the target.|
-|`SignificantWhitespace`|The white space between markup in a mixed content model.|
-|`Text`|The content of the text node.|
-|`Whitespace`|The white space between markup.|
-|`XmlDeclaration`|The content of the declaration.|
-
-
-
-## Examples
- The following example reads in XML with various data types and displays each of the nodes.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ The following table lists node types that have a value to return.
+
+|Node Type|Value|
+|---------------|-----------|
+|`Attribute`|The value of the attribute.|
+|`CDATA`|The content of the CDATA section.|
+|`Comment`|The content of the comment.|
+|`DocumentType`|The internal subset.|
+|`ProcessingInstruction`|The entire content, excluding the target.|
+|`SignificantWhitespace`|The white space between markup in a mixed content model.|
+|`Text`|The content of the text node.|
+|`Whitespace`|The white space between markup.|
+|`XmlDeclaration`|The content of the declaration.|
+
+
+
+## Examples
+ The following example reads in XML with various data types and displays each of the nodes.
+
[!code-cpp[Classic WebData XmlValidatingReader.HasValue Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.HasValue Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.HasValue Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/HasValue/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.HasValue Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.HasValue Example/VB/source.vb#1)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.HasValue Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.HasValue Example/VB/source.vb#1)]
+
]]>
@@ -1288,33 +1286,33 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);
if the current node is an attribute whose value was generated from the default value defined in the DTD or schema; if the attribute value was explicitly set.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
-
-
-## Examples
- The following example displays all attributes nodes on the root element.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+
+
+## Examples
+ The following example displays all attributes nodes on the root element.
+
[!code-cpp[XmlValidatingReader.IsDefault#1](~/snippets/cpp/VS_Snippets_Data/XmlValidatingReader.IsDefault/CPP/readdefattr.cpp#1)]
[!code-csharp[XmlValidatingReader.IsDefault#1](~/snippets/csharp/System.Xml/XmlValidatingReader/IsDefault/readdefattr.cs#1)]
- [!code-vb[XmlValidatingReader.IsDefault#1](~/snippets/visualbasic/VS_Snippets_Data/XmlValidatingReader.IsDefault/VB/readdefattr.vb#1)]
-
- The example uses the following files as input.
-
- `book4.xml`
-
- [!code-xml[XmlValidatingReader.IsDefault#2](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.IsDefault/XML/book4.xml#2)]
-
- `book.dtd`
-
- [!code-xml[XmlValidatingReader.IsDefault#3](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.IsDefault/XML/book.dtd#3)]
-
+ [!code-vb[XmlValidatingReader.IsDefault#1](~/snippets/visualbasic/VS_Snippets_Data/XmlValidatingReader.IsDefault/VB/readdefattr.vb#1)]
+
+ The example uses the following files as input.
+
+ `book4.xml`
+
+ [!code-xml[XmlValidatingReader.IsDefault#2](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.IsDefault/XML/book4.xml#2)]
+
+ `book.dtd`
+
+ [!code-xml[XmlValidatingReader.IsDefault#3](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.IsDefault/XML/book.dtd#3)]
+
]]>
@@ -1359,36 +1357,36 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);
if the current node is an element ( equals ) that ends with />; otherwise, .
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This property enables you to determine the difference between the following:
-
- `- ` (`IsEmptyElement` is `false`, although element content is empty).
-
- A corresponding `EndElement` node is not generated for empty elements.
-
- If default content has been added to an element due to schema validation, `IsEmptyElement` still returns `true`. It has no bearing on whether or not the element has a default value. In other words, `IsEmptyElement` simply reports whether or not the element in the source document had an end element tag.
-
-
-
-## Examples
- The following example displays the text content of each element.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This property enables you to determine the difference between the following:
+
+ `
- ` (`IsEmptyElement` is `false`, although element content is empty).
+
+ A corresponding `EndElement` node is not generated for empty elements.
+
+ If default content has been added to an element due to schema validation, `IsEmptyElement` still returns `true`. It has no bearing on whether or not the element has a default value. In other words, `IsEmptyElement` simply reports whether or not the element in the source document had an end element tag.
+
+
+
+## Examples
+ The following example displays the text content of each element.
+
[!code-cpp[Classic WebData XmlValidatingReader.IsEmptyElement Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.IsEmptyElement Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.IsEmptyElement Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/IsEmptyElement/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.IsEmptyElement Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.IsEmptyElement Example/VB/source.vb#1)]
-
- The example uses the file, `elems.xml`, as input.
-
- [!code-xml[Classic WebData XmlValidatingReader.IsEmptyElement Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.IsEmptyElement Example/XML/source.xml#2)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.IsEmptyElement Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.IsEmptyElement Example/VB/source.vb#1)]
+
+ The example uses the file, `elems.xml`, as input.
+
+ [!code-xml[Classic WebData XmlValidatingReader.IsEmptyElement Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.IsEmptyElement Example/XML/source.xml#2)]
+
]]>
@@ -1454,14 +1452,14 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);
Gets the value of the attribute with the specified name.
The value of the specified attribute. If the attribute is not found, returns .
-
@@ -1539,15 +1537,15 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
Gets the current line number.
The current line number. The starting value for this property is 1.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This property is most commonly used for error reporting, but can be called at any time. The starting value for this property is 1. Combined with , a value of 1,1 indicates the start of the document.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This property is most commonly used for error reporting, but can be called at any time. The starting value for this property is 1. Combined with , a value of 1,1 indicates the start of the document.
+
]]>
@@ -1593,27 +1591,27 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
Gets the current line position.
The current line position. The starting value for this property is 1.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This property is most commonly used for error reporting, but can be called at any time. The starting value for this property is `1`.
-
- The position indicated is the first character of text in the markup.
-
-```xml
-
- abc
-
-```
-
- On the first line of the preceding XML text, a `LinePosition` of `2` corresponds to the character `r`; on the second line, a `LinePosition` of `5` corresponds to the character `t`; and on the third line, a `LinePosition` of `3` corresponds to the character `r`.
-
- Combined with , a value of `1,1` indicates the start of the document.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This property is most commonly used for error reporting, but can be called at any time. The starting value for this property is `1`.
+
+ The position indicated is the first character of text in the markup.
+
+```xml
+
+ abc
+
+```
+
+ On the first line of the preceding XML text, a `LinePosition` of `2` corresponds to the character `r`; on the second line, a `LinePosition` of `5` corresponds to the character `t`; and on the third line, a `LinePosition` of `3` corresponds to the character `r`.
+
+ Combined with , a value of `1,1` indicates the start of the document.
+
]]>
@@ -1655,25 +1653,25 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
Gets the local name of the current node.
- The name of the current node with the prefix removed. For example, is for the element <bk:book>.
-
+ The name of the current node with the prefix removed. For example, is for the element <bk:book>.
+
For node types that do not have a name (like , , and so on), this property returns String.Empty.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
-
-
-## Examples
- The following example reads an XML fragment.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+
+
+## Examples
+ The following example reads an XML fragment.
+
[!code-csharp[Classic WebData XmlParserContext.XmlParserContext Example#1](~/snippets/csharp/System.Xml/XmlParserContext/.ctor/source.cs#1)]
- [!code-vb[Classic WebData XmlParserContext.XmlParserContext Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlParserContext.XmlParserContext Example/VB/source.vb#1)]
-
+ [!code-vb[Classic WebData XmlParserContext.XmlParserContext Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlParserContext.XmlParserContext Example/VB/source.vb#1)]
+
]]>
@@ -1722,23 +1720,23 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
Resolves a namespace prefix in the current element's scope.
The namespace URI to which the prefix maps or if no matching prefix is found.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- In the following XML string, if the reader is positioned on the `href` attribute, the prefix `a` is resolved by calling `reader.LookupNamespace("a", true)`. The returned string is `urn:456`.
-
-```xml
-
- -
-
-
-```
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ In the following XML string, if the reader is positioned on the `href` attribute, the prefix `a` is resolved by calling `reader.LookupNamespace("a", true)`. The returned string is `urn:456`.
+
+```xml
+
+ -
+
+
+```
+
]]>
@@ -1795,23 +1793,23 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
The index of the attribute.
Moves to the attribute with the specified index.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
-
-
-## Examples
- The following example reads all the elements on the root node.
-
- [!code-cpp[Classic WebData XmlValidatingReader.AttributeCount Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.AttributeCount Example/CPP/source.cpp#1)]
- [!code-csharp[Classic WebData XmlValidatingReader.AttributeCount Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/AttributeCount/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.AttributeCount Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.AttributeCount Example/VB/source.vb#1)]
-
- ]]>
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+
+
+## Examples
+ The following example reads all the elements on the root node.
+
+ [!code-cpp[Classic WebData XmlValidatingReader.AttributeCount Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.AttributeCount Example/CPP/source.cpp#1)]
+ [!code-csharp[Classic WebData XmlValidatingReader.AttributeCount Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/AttributeCount/source.cs#1)]
+ [!code-vb[Classic WebData XmlValidatingReader.AttributeCount Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.AttributeCount Example/VB/source.vb#1)]
+
+ ]]>
The parameter is less than 0 or greater than or equal to .
@@ -1860,24 +1858,24 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
if the attribute is found; otherwise, . If , the position of the reader does not change.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- After calling this method, the , , and properties reflect the properties of that attribute.
-
-
-
-## Examples
- The following example reads an attribute with text and entity reference nodes.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ After calling this method, the , , and properties reflect the properties of that attribute.
+
+
+
+## Examples
+ The following example reads an attribute with text and entity reference nodes.
+
[!code-cpp[Classic WebData XmlValidatingReader.MoveToAttribute Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.MoveToAttribute Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.MoveToAttribute Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/MoveToAttribute/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.MoveToAttribute Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.MoveToAttribute Example/VB/source.vb#1)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.MoveToAttribute Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.MoveToAttribute Example/VB/source.vb#1)]
+
]]>
@@ -1936,15 +1934,15 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
if the attribute is found; otherwise, . If , the position of the reader does not change.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- After calling this method, the , , and properties reflect the properties of that attribute.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ After calling this method, the , , and properties reflect the properties of that attribute.
+
]]>
@@ -1990,24 +1988,24 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
if the reader is positioned on an attribute (the reader moves to the element that owns the attribute); if the reader is not positioned on an attribute (the position of the reader does not change).
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- Use this method to return to an element after navigating through its attributes. This method moves the reader to one of the following node types: `Element`, `DocumentType`, or `XmlDeclaration`.
-
-
-
-## Examples
- The following example reads all the elements on the root node.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ Use this method to return to an element after navigating through its attributes. This method moves the reader to one of the following node types: `Element`, `DocumentType`, or `XmlDeclaration`.
+
+
+
+## Examples
+ The following example reads all the elements on the root node.
+
[!code-cpp[Classic WebData XmlValidatingReader.AttributeCount Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.AttributeCount Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.AttributeCount Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/AttributeCount/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.AttributeCount Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.AttributeCount Example/VB/source.vb#1)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.AttributeCount Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.AttributeCount Example/VB/source.vb#1)]
+
]]>
@@ -2053,22 +2051,22 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
if an attribute exists (the reader moves to the first attribute); otherwise, (the position of the reader does not change).
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
-
-
-## Examples
- The following example reads an XML fragment.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+
+
+## Examples
+ The following example reads an XML fragment.
+
[!code-cpp[Classic WebData XmlValidatingReader.MoveToFirstAttribute Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.MoveToFirstAttribute Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.MoveToFirstAttribute Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/MoveToFirstAttribute/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.MoveToFirstAttribute Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.MoveToFirstAttribute Example/VB/source.vb#1)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.MoveToFirstAttribute Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.MoveToFirstAttribute Example/VB/source.vb#1)]
+
]]>
@@ -2114,24 +2112,24 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
if there is a next attribute; if there are no more attributes.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- If the current node is an element node, this method is equivalent to . If `MoveToNextAttribute` returns `true`, the reader moves to the next attribute; otherwise, the position of the reader does not change.
-
-
-
-## Examples
- The following example reads an XML fragment.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ If the current node is an element node, this method is equivalent to . If `MoveToNextAttribute` returns `true`, the reader moves to the next attribute; otherwise, the position of the reader does not change.
+
+
+
+## Examples
+ The following example reads an XML fragment.
+
[!code-cpp[Classic WebData XmlValidatingReader.MoveToFirstAttribute Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.MoveToFirstAttribute Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.MoveToFirstAttribute Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/MoveToFirstAttribute/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.MoveToFirstAttribute Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.MoveToFirstAttribute Example/VB/source.vb#1)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.MoveToFirstAttribute Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.MoveToFirstAttribute Example/VB/source.vb#1)]
+
]]>
@@ -2173,48 +2171,48 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
Gets the qualified name of the current node.
- The qualified name of the current node. For example, is for the element <bk:book>.
-
- The name returned is dependent on the of the node. The following node types return the listed values. All other node types return an empty string.
-
- Node Type
-
- Name
-
- - The name of the attribute.
-
-
- The document type name.
-
-
- The tag name.
-
-
- The name of the entity referenced.
-
-
- The target of the processing instruction.
-
-
- The literal string .
-
+ The qualified name of the current node. For example, is for the element <bk:book>.
+
+ The name returned is dependent on the of the node. The following node types return the listed values. All other node types return an empty string.
+
+
Node Type
+
+ Name
+
+ - The name of the attribute.
+
+
- The document type name.
+
+
- The tag name.
+
+
- The name of the entity referenced.
+
+
- The target of the processing instruction.
+
+
- The literal string .
+
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
-
-
-## Examples
- The following example reads an XML file and displays each of the nodes.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+
+
+## Examples
+ The following example reads an XML file and displays each of the nodes.
+
[!code-cpp[Classic WebData XmlValidatingReader.Name Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.Name Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/Name/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.Name Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/VB/source.vb#1)]
-
- The example uses the file, `items.xml`, as input.
-
- [!code-xml[Classic WebData XmlValidatingReader.Name Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/XML/source.xml#2)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.Name Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/VB/source.vb#1)]
+
+ The example uses the file, `items.xml`, as input.
+
+ [!code-xml[Classic WebData XmlValidatingReader.Name Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/XML/source.xml#2)]
+
]]>
@@ -2259,13 +2257,13 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
to do namespace support; otherwise, . The default is .
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
]]>
@@ -2309,22 +2307,22 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
Gets the namespace Uniform Resource Identifier (URI) (as defined in the World Wide Web Consortium (W3C) Namespace specification) of the node on which the reader is positioned.
The namespace URI of the current node; otherwise an empty string.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
-
-
-## Examples
- The following example reads an XML fragment.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+
+
+## Examples
+ The following example reads an XML fragment.
+
[!code-csharp[Classic WebData XmlParserContext.XmlParserContext Example#1](~/snippets/csharp/System.Xml/XmlParserContext/.ctor/source.cs#1)]
- [!code-vb[Classic WebData XmlParserContext.XmlParserContext Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlParserContext.XmlParserContext Example/VB/source.vb#1)]
-
+ [!code-vb[Classic WebData XmlParserContext.XmlParserContext Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlParserContext.XmlParserContext Example/VB/source.vb#1)]
+
]]>
@@ -2369,15 +2367,15 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
that enables you to get the atomized version of a string within the node.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- All node and attribute names returned from are atomized by using the `NameTable`. When the same name is returned multiple times (for example, `Customer`), the same `String` object will be returned for that name. This makes it possible for you to write efficient code that does object comparisons on these strings instead of expensive string comparisons.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ All node and attribute names returned from are atomized by using the `NameTable`. When the same name is returned multiple times (for example, `Customer`), the same `String` object will be returned for that name. This makes it possible for you to write efficient code that does object comparisons on these strings instead of expensive string comparisons.
+
]]>
@@ -2422,28 +2420,28 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
Gets the type of the current node.
One of the values representing the type of the current node.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This property never returns the following `XmlNodeType` types: `Document`, `DocumentFragment`, `Entity`, or `Notation`.
-
-
-
-## Examples
- The following example reads an XML file and displays each of the nodes.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This property never returns the following `XmlNodeType` types: `Document`, `DocumentFragment`, `Entity`, or `Notation`.
+
+
+
+## Examples
+ The following example reads an XML file and displays each of the nodes.
+
[!code-cpp[Classic WebData XmlValidatingReader.Name Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.Name Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/Name/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.Name Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/VB/source.vb#1)]
-
- The example uses the file, `items.xml`, as input.
-
- [!code-xml[Classic WebData XmlValidatingReader.Name Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/XML/source.xml#2)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.Name Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/VB/source.vb#1)]
+
+ The example uses the file, `items.xml`, as input.
+
+ [!code-xml[Classic WebData XmlValidatingReader.Name Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/XML/source.xml#2)]
+
]]>
@@ -2487,21 +2485,21 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
Gets the namespace prefix associated with the current node.
The namespace prefix associated with the current node.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
-
-
-## Examples
- The following example reads an XML fragment.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+
+
+## Examples
+ The following example reads an XML fragment.
+
[!code-csharp[Classic WebData XmlParserContext.XmlParserContext Example#1](~/snippets/csharp/System.Xml/XmlParserContext/.ctor/source.cs#1)]
- [!code-vb[Classic WebData XmlParserContext.XmlParserContext Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlParserContext.XmlParserContext Example/VB/source.vb#1)]
-
+ [!code-vb[Classic WebData XmlParserContext.XmlParserContext Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlParserContext.XmlParserContext Example/VB/source.vb#1)]
+
]]>
@@ -2545,14 +2543,14 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
Gets the quotation mark character used to enclose the value of an attribute node.
The quotation mark character (" or ') used to enclose the value of an attribute node.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
]]>
@@ -2598,28 +2596,28 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
if the next node was read successfully; if there are no more nodes to read.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- When a reader is first created and initialized, there is no information available. You must call `Read` to read the first node.
-
-
-
-## Examples
- The following example reads an XML file and displays each node.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ When a reader is first created and initialized, there is no information available. You must call `Read` to read the first node.
+
+
+
+## Examples
+ The following example reads an XML file and displays each node.
+
[!code-cpp[Classic WebData XmlValidatingReader.Name Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.Name Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/Name/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.Name Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/VB/source.vb#1)]
-
- The example uses the file, `items.xml`, as input.
-
- [!code-xml[Classic WebData XmlValidatingReader.Name Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/XML/source.xml#2)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.Name Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/VB/source.vb#1)]
+
+ The example uses the file, `items.xml`, as input.
+
+ [!code-xml[Classic WebData XmlValidatingReader.Name Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/XML/source.xml#2)]
+
]]>
@@ -2663,57 +2661,57 @@ If the reader is positioned on a `DocumentType` node, this method can be used to
Parses the attribute value into one or more , , or nodes.
- if there are nodes to return.
-
- if the reader is not positioned on an attribute node when the initial call is made or if all the attribute values have been read.
-
+ if there are nodes to return.
+
+ if the reader is not positioned on an attribute node when the initial call is made or if all the attribute values have been read.
+
An empty attribute, such as, misc="", returns with a single node with a value of String.Empty.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- Use this method after calling to read through the text or entity reference nodes that make up the attribute value. The of the attribute value nodes is one plus the depth of the attribute node. The `Depth` increments and decrements by one when you step into and out of general entity references.
-
- For example, suppose you have the following XML: ``
-
- where the entity `b` is defined in the document type definition (DTD) as follows: ``
-
- If is set to `ExpandCharEntities`, the following C# code returns the attribute value as two text nodes and one entity reference node:
-
-```csharp
-reader.MoveToAttribute("name");
- while (reader.ReadAttributeValue())
- {
- if (reader.NodeType == XmlNodeType.Text)
- {
- // at this point reader.Value == "a " or " c"
- }
- else if (reader.NodeType == XmlNodeType.EntityReference)
- {
- // at this point reader.Name == "b"
- reader.ResolveEntity();
- while (reader.ReadAttributeValue() &&
- reader.NodeType != XmlNodeType.EndEntity)
- {
- // reader.Value == "123"
- }
- }
- }
-```
-
-
-
-## Examples
- The following example reads an attribute with text and entity reference nodes.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ Use this method after calling to read through the text or entity reference nodes that make up the attribute value. The of the attribute value nodes is one plus the depth of the attribute node. The `Depth` increments and decrements by one when you step into and out of general entity references.
+
+ For example, suppose you have the following XML: ``
+
+ where the entity `b` is defined in the document type definition (DTD) as follows: ``
+
+ If is set to `ExpandCharEntities`, the following C# code returns the attribute value as two text nodes and one entity reference node:
+
+```csharp
+reader.MoveToAttribute("name");
+ while (reader.ReadAttributeValue())
+ {
+ if (reader.NodeType == XmlNodeType.Text)
+ {
+ // at this point reader.Value == "a " or " c"
+ }
+ else if (reader.NodeType == XmlNodeType.EntityReference)
+ {
+ // at this point reader.Name == "b"
+ reader.ResolveEntity();
+ while (reader.ReadAttributeValue() &&
+ reader.NodeType != XmlNodeType.EndEntity)
+ {
+ // reader.Value == "123"
+ }
+ }
+ }
+```
+
+
+
+## Examples
+ The following example reads an attribute with text and entity reference nodes.
+
[!code-cpp[Classic WebData XmlValidatingReader.MoveToAttribute Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.MoveToAttribute Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.MoveToAttribute Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/MoveToAttribute/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.MoveToAttribute Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.MoveToAttribute Example/VB/source.vb#1)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.MoveToAttribute Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.MoveToAttribute Example/VB/source.vb#1)]
+
]]>
@@ -2764,26 +2762,26 @@ reader.MoveToAttribute("name");
Reads the content and returns the Base64 decoded binary bytes.
The number of bytes written to the buffer.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This method streams the content, decodes the Base64 content, and returns the decoded binary bytes (for example, an inline Base64 encoded GIF image) into the buffer. This method can be called successively to read large streams of embedded text. For more information, see RFC 1521, "MIME (Multipurpose Internet Mail Extensions) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Bodies". You can obtain RFCs from the [Request for Comments Web site](https://www.rfc-editor.org).
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This method streams the content, decodes the Base64 content, and returns the decoded binary bytes (for example, an inline Base64 encoded GIF image) into the buffer. This method can be called successively to read large streams of embedded text. For more information, see RFC 1521, "MIME (Multipurpose Internet Mail Extensions) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Bodies". You can obtain RFCs from the [Request for Comments Web site](https://www.rfc-editor.org).
+
> [!NOTE]
-> You should not access any of the reader properties between calls to the method until the method returns the value 0.
-
- This method has the following behavior:
-
-- returns the value 0 when it has reached the end of the byte stream it was operating on. The reader is positioned on the first non-content node.
-
-- If you ask for fewer, or the exact number, of bytes than are left in the stream, the reader remains in its current position.
-
-- is not supported on the following XML node types: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, and DocumentFragment.
-
+> You should not access any of the reader properties between calls to the method until the method returns the value 0.
+
+ This method has the following behavior:
+
+- returns the value 0 when it has reached the end of the byte stream it was operating on. The reader is positioned on the first non-content node.
+
+- If you ask for fewer, or the exact number, of bytes than are left in the stream, the reader remains in its current position.
+
+- is not supported on the following XML node types: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, and DocumentFragment.
+
]]>
The value is .
@@ -2840,26 +2838,26 @@ reader.MoveToAttribute("name");
Reads the content and returns the BinHex decoded binary bytes.
The number of bytes written to the buffer.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This method streams the content, decodes the BinHex content, and returns the decoded binary bytes (for example, an inline BinHex encoded GIF image) into the buffer. This method can be called successively to read large streams of embedded text.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This method streams the content, decodes the BinHex content, and returns the decoded binary bytes (for example, an inline BinHex encoded GIF image) into the buffer. This method can be called successively to read large streams of embedded text.
+
> [!NOTE]
-> You should not access any of the reader properties between calls to the method until the method returns the value 0.
-
- This method has the following behavior:
-
-- returns the value 0 when it has reached the end of the byte stream it was operating on. The reader is positioned on the first non-content node.
-
-- If you ask for fewer, or the exact number, of bytes than are left in the stream, the reader remains in its current position.
-
-- is not supported on the following XML node types: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, and DocumentFragment.
-
+> You should not access any of the reader properties between calls to the method until the method returns the value 0.
+
+ This method has the following behavior:
+
+- returns the value 0 when it has reached the end of the byte stream it was operating on. The reader is positioned on the first non-content node.
+
+- If you ask for fewer, or the exact number, of bytes than are left in the stream, the reader remains in its current position.
+
+- is not supported on the following XML node types: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, and DocumentFragment.
+
]]>
The value is .
@@ -2917,23 +2915,23 @@ reader.MoveToAttribute("name");
Reads the element and decodes the Base64 content.
The number of bytes written to the buffer.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This method reads the element content, decodes it using Base64 encoding, and returns the decoded binary bytes (for example, an inline Base64 encoded GIF image) into the buffer. For more information, see RFC 1521, "MIME (Multipurpose Internet Mail Extensions) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Bodies". You can obtain RFCs from the [Request for Comments Web site](https://www.rfc-editor.org).
-
- This method can read only simple-content elements. The element can contain text, white space, significant white space, CDATA sections, comments, and processing instructions. It can also contain entity references, which are automatically expanded. The element cannot have child elements.
-
- This method is very similar to the method except that it can be called only on element node types.
-
- If the `count` value is higher than the number of bytes in the document, or if it is equal to the number of bytes in the document, the reads all the remaining bytes in the document and returns the number of bytes read. The next method call returns a zero and moves the reader to the node following the .
-
- If you call before all of the element content is consumed, the reader may behave as if the first content was consumed and then the method was called. This means that the reader will read all the text until the end element is encountered. It will then read the end tag node, read the next node, and then position itself on the next subsequent node.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This method reads the element content, decodes it using Base64 encoding, and returns the decoded binary bytes (for example, an inline Base64 encoded GIF image) into the buffer. For more information, see RFC 1521, "MIME (Multipurpose Internet Mail Extensions) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Bodies". You can obtain RFCs from the [Request for Comments Web site](https://www.rfc-editor.org).
+
+ This method can read only simple-content elements. The element can contain text, white space, significant white space, CDATA sections, comments, and processing instructions. It can also contain entity references, which are automatically expanded. The element cannot have child elements.
+
+ This method is very similar to the method except that it can be called only on element node types.
+
+ If the `count` value is higher than the number of bytes in the document, or if it is equal to the number of bytes in the document, the reads all the remaining bytes in the document and returns the number of bytes read. The next method call returns a zero and moves the reader to the node following the .
+
+ If you call before all of the element content is consumed, the reader may behave as if the first content was consumed and then the method was called. This means that the reader will read all the text until the end element is encountered. It will then read the end tag node, read the next node, and then position itself on the next subsequent node.
+
]]>
The value is .
@@ -2991,23 +2989,23 @@ reader.MoveToAttribute("name");
Reads the element and decodes the BinHex content.
The number of bytes written to the buffer.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This method reads the element content, decodes it using BinHex encoding, and returns the decoded binary bytes (for example, an inline BinHex encoded GIF image) into the buffer.
-
- This method can read only simple-content elements. The element can contain text, white space, significant white space, CDATA sections, comments, and processing instructions. It can also contain entity references, which are automatically expanded. The element cannot have child elements.
-
- This method is very similar to the method except that it can be called only on element node types.
-
- If the `count` value is higher than the number of bytes in the document, or if it is equal to the number of bytes in the document, the reads all the remaining bytes in the document and returns the number of bytes read. The next method call returns a zero and moves the reader to the node following the .
-
- If you call before all of the element content is consumed, the reader may behave as if the first content was consumed and then the method was called. This means that the reader will read all the text until the end element is encountered. It will then read the end tag node, read the next node, and then position itself on the next subsequent node.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This method reads the element content, decodes it using BinHex encoding, and returns the decoded binary bytes (for example, an inline BinHex encoded GIF image) into the buffer.
+
+ This method can read only simple-content elements. The element can contain text, white space, significant white space, CDATA sections, comments, and processing instructions. It can also contain entity references, which are automatically expanded. The element cannot have child elements.
+
+ This method is very similar to the method except that it can be called only on element node types.
+
+ If the `count` value is higher than the number of bytes in the document, or if it is equal to the number of bytes in the document, the reads all the remaining bytes in the document and returns the number of bytes read. The next method call returns a zero and moves the reader to the node following the .
+
+ If you call before all of the element content is consumed, the reader may behave as if the first content was consumed and then the method was called. This means that the reader will read all the text until the end element is encountered. It will then read the end tag node, read the next node, and then position itself on the next subsequent node.
+
]]>
The value is .
@@ -3058,17 +3056,17 @@ reader.MoveToAttribute("name");
Gets the used to construct this .
The specified in the constructor.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This property allows the user to access properties specific to the supplied reader. It returns a typed `XmlReader`. The user should query for the type before casting.
-
- Changing the state of the returned reader (for example, calling one of the read methods) can lead to unpredictable results.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This property allows the user to access properties specific to the supplied reader. It returns a typed `XmlReader`. The user should query for the type before casting.
+
+ Changing the state of the returned reader (for example, calling one of the read methods) can lead to unpredictable results.
+
]]>
@@ -3112,13 +3110,13 @@ reader.MoveToAttribute("name");
Gets the state of the reader.
One of the values.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
]]>
@@ -3163,39 +3161,39 @@ reader.MoveToAttribute("name");
Reads the contents of an element or text node as a string.
The contents of the element or text node. This can be an empty string if the reader is positioned on something other than an element or text node, or if there is no more text content to return in the current context.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- If positioned on an element, `ReadString` concatenates all text, significant white space, white space, and CDATA section node types together and returns the concatenated data as the element content. The reader stops when any markup is encountered, including comments and processing instructions. This could occur in a mixed content model, or when an element end tag is read.
-
- If positioned on a text node, `ReadString` performs the same concatenation from the text node to the element end tag. If the reader is positioned on an attribute text node, `ReadString` has the same functionality as if the reader were position on the element start tag. It returns all the concatenated element text nodes.
-
- The property determines how `ReadString` works as follows:
-
-|Value|Description|
-|-----------|-----------------|
-|ExpandEntities|Returns expanded character and general entities. This is the default.|
-|ExpandCharEntities|Returns the text content up to but not including a general entity reference. This means a general entity causes ReadString to stop. You must call `Read` to step over the entity reference.|
-
-
-
-## Examples
- The following example displays the text content of each of the elements.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ If positioned on an element, `ReadString` concatenates all text, significant white space, white space, and CDATA section node types together and returns the concatenated data as the element content. The reader stops when any markup is encountered, including comments and processing instructions. This could occur in a mixed content model, or when an element end tag is read.
+
+ If positioned on a text node, `ReadString` performs the same concatenation from the text node to the element end tag. If the reader is positioned on an attribute text node, `ReadString` has the same functionality as if the reader were position on the element start tag. It returns all the concatenated element text nodes.
+
+ The property determines how `ReadString` works as follows:
+
+|Value|Description|
+|-----------|-----------------|
+|ExpandEntities|Returns expanded character and general entities. This is the default.|
+|ExpandCharEntities|Returns the text content up to but not including a general entity reference. This means a general entity causes ReadString to stop. You must call `Read` to step over the entity reference.|
+
+
+
+## Examples
+ The following example displays the text content of each of the elements.
+
[!code-cpp[Classic WebData XmlValidatingReader.IsEmptyElement Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.IsEmptyElement Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.IsEmptyElement Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/IsEmptyElement/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.IsEmptyElement Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.IsEmptyElement Example/VB/source.vb#1)]
-
- The example uses the file, `elems.xml`, as input.
-
- [!code-xml[Classic WebData XmlValidatingReader.IsEmptyElement Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.IsEmptyElement Example/XML/source.xml#2)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.IsEmptyElement Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.IsEmptyElement Example/VB/source.vb#1)]
+
+ The example uses the file, `elems.xml`, as input.
+
+ [!code-xml[Classic WebData XmlValidatingReader.IsEmptyElement Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.IsEmptyElement Example/XML/source.xml#2)]
+
]]>
@@ -3241,42 +3239,42 @@ The text node can be either an element or an attribute text node.
Gets the common language runtime type for the specified XML Schema definition language (XSD) type.
The common language runtime type for the specified XML Schema type.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- For example, if the schema type is defined as `xsd:int`, the runtime type `int32` is returned for the object. This can be tested using the method and cast accordingly. The method always returns a type that is derived from the class. It never returns the type.
-
- If the reader is positioned on an attribute, this method returns the runtime typed object, but does not change the position of the reader. If the reader is positioned on an element, `ReadTypedValue` reads any CDATA, text, white space, significant white space, and comment nodes, returns the runtime typed object and positions the reader on the end tag. Any types that do not have a direct mapping, for example `NMTOKENS`, are returned as strings.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ For example, if the schema type is defined as `xsd:int`, the runtime type `int32` is returned for the object. This can be tested using the method and cast accordingly. The method always returns a type that is derived from the class. It never returns the type.
+
+ If the reader is positioned on an attribute, this method returns the runtime typed object, but does not change the position of the reader. If the reader is positioned on an element, `ReadTypedValue` reads any CDATA, text, white space, significant white space, and comment nodes, returns the runtime typed object and positions the reader on the end tag. Any types that do not have a direct mapping, for example `NMTOKENS`, are returned as strings.
+
> [!NOTE]
-> If has been set to ValidationType.None, data type information is not provided from either schemas or document type definitions (DTDs).
-
+> If has been set to ValidationType.None, data type information is not provided from either schemas or document type definitions (DTDs).
+
> [!CAUTION]
-> After calling , `ReadTypedValue` will return `null`.
-
-
-
-## Examples
- The following example displays the type information for each of the elements in the XML document.
-
+> After calling , `ReadTypedValue` will return `null`.
+
+
+
+## Examples
+ The following example displays the type information for each of the elements in the XML document.
+
[!code-cpp[XmlValidatingReader.SchemaType#1](~/snippets/cpp/VS_Snippets_Data/XmlValidatingReader.SchemaType/CPP/schematype.cpp#1)]
[!code-csharp[XmlValidatingReader.SchemaType#1](~/snippets/csharp/System.Xml/XmlValidatingReader/ReadTypedValue/schematype.cs#1)]
- [!code-vb[XmlValidatingReader.SchemaType#1](~/snippets/visualbasic/VS_Snippets_Data/XmlValidatingReader.SchemaType/VB/schematype.vb#1)]
-
- The example uses the following input files.
-
- `booksSchema.xml`
-
- [!code-xml[XmlValidatingReader.SchemaType#2](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.SchemaType/XML/booksschema.xml#2)]
-
- `books.xsd`
-
- [!code-xml[XmlValidatingReader.SchemaType#3](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.SchemaType/XML/books.xsd#3)]
-
+ [!code-vb[XmlValidatingReader.SchemaType#1](~/snippets/visualbasic/VS_Snippets_Data/XmlValidatingReader.SchemaType/VB/schematype.vb#1)]
+
+ The example uses the following input files.
+
+ `booksSchema.xml`
+
+ [!code-xml[XmlValidatingReader.SchemaType#2](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.SchemaType/XML/booksschema.xml#2)]
+
+ `books.xsd`
+
+ [!code-xml[XmlValidatingReader.SchemaType#3](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.SchemaType/XML/books.xsd#3)]
+
]]>
@@ -3320,31 +3318,31 @@ The text node can be either an element or an attribute text node.
Resolves the entity reference for nodes.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- If the reader is positioned on an `EntityReference` node (`XmlNodeType.EntityReference`), if is called after calling this method, the entity replacement text is parsed. After the entity replacement text is finished, an `EndEntity` node is returned to close the entity reference scope.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ If the reader is positioned on an `EntityReference` node (`XmlNodeType.EntityReference`), if is called after calling this method, the entity replacement text is parsed. After the entity replacement text is finished, an `EndEntity` node is returned to close the entity reference scope.
+
> [!NOTE]
-> After calling this method, if the entity is part of an attribute value, you must call to step into the entity.
-
-
-
-## Examples
- The following example uses `ResolveEntity` to expand a general entity.
-
+> After calling this method, if the entity is part of an attribute value, you must call to step into the entity.
+
+
+
+## Examples
+ The following example uses `ResolveEntity` to expand a general entity.
+
[!code-cpp[Classic WebData XmlValidatingReader.ResolveEntity Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.ResolveEntity Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.ResolveEntity Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/EntityHandling/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.ResolveEntity Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.ResolveEntity Example/VB/source.vb#1)]
-
- The example uses the file, `book1.xml`, as input.
-
- [!code-xml[Classic WebData XmlValidatingReader.ResolveEntity Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.ResolveEntity Example/XML/source.xml#2)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.ResolveEntity Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.ResolveEntity Example/VB/source.vb#1)]
+
+ The example uses the file, `book1.xml`, as input.
+
+ [!code-xml[Classic WebData XmlValidatingReader.ResolveEntity Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.ResolveEntity Example/XML/source.xml#2)]
+
]]>
The reader is not positioned on an node.
@@ -3390,53 +3388,53 @@ The text node can be either an element or an attribute text node.
Gets a to use for validation.
The to use for validation.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- The `XmlSchemaCollection` holds pre-loaded XML-Data Reduced (XDR) and XML Schema definition language (XSD) schemas. This property gives the reader access to the cache of schemas and allows it to validate without having to re-load schemas every time. The reader does not add anything to the `XmlSchemaCollection`.
-
- If the `XmlSchemaCollection` includes an XML schema (XSD) which contains `include` or `import` elements that reference other namespaces, the schemas for these other namespaces are loaded for validation purposes only. Unless these schemas were explicitly added to the schema collection, they will not be accessible using any of the collection methods or properties. For example, if the collection contains the schema file `a.xsd`, which contains a reference to the schema file `b.xsd`, you must add `b.xsd` to the schema collection before you can access it using any of the collection methods or properties.
-
- When the `XmlSchemaCollection` is accessed using the `Schemas` property, the method uses the specified by the property.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ The `XmlSchemaCollection` holds pre-loaded XML-Data Reduced (XDR) and XML Schema definition language (XSD) schemas. This property gives the reader access to the cache of schemas and allows it to validate without having to re-load schemas every time. The reader does not add anything to the `XmlSchemaCollection`.
+
+ If the `XmlSchemaCollection` includes an XML schema (XSD) which contains `include` or `import` elements that reference other namespaces, the schemas for these other namespaces are loaded for validation purposes only. Unless these schemas were explicitly added to the schema collection, they will not be accessible using any of the collection methods or properties. For example, if the collection contains the schema file `a.xsd`, which contains a reference to the schema file `b.xsd`, you must add `b.xsd` to the schema collection before you can access it using any of the collection methods or properties.
+
+ When the `XmlSchemaCollection` is accessed using the `Schemas` property, the method uses the specified by the property.
+
> [!NOTE]
-> The schemas must be added to the `XmlSchemaCollection` before the first `Read` call.
-
-
-
-## Examples
- The following example validates three XML files using schemas stored in the XmlSchemaCollection.
-
+> The schemas must be added to the `XmlSchemaCollection` before the first `Read` call.
+
+
+
+## Examples
+ The following example validates three XML files using schemas stored in the XmlSchemaCollection.
+
[!code-cpp[Classic WebData XmlValidatingReader.Schemas Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.Schemas Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.Schemas Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/Schemas/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.Schemas Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.Schemas Example/VB/source.vb#1)]
-
- The sample uses the following five input files:
-
- `booksSchema.xml`
-
- [!code-xml[Classic WebData XmlValidatingReader.Schemas Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Schemas Example/XML/source.xml#2)]
-
- `booksSchemaFail.xml`
-
- [!code-xml[Classic WebData XmlValidatingReader.Schemas Example#3](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Schemas Example/XML/source.xml#3)]
-
- `newbooks.xml`
-
- [!code-xml[Classic WebData XmlValidatingReader.Schemas Example#4](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Schemas Example/XML/source.xml#4)]
-
- `books.xsd`
-
- [!code-xml[Classic WebData XmlValidatingReader.Schemas Example#5](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Schemas Example/XML/source.xml#5)]
-
- `schema1.xdr`
-
- [!code-xml[Classic WebData XmlValidatingReader.Schemas Example#6](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Schemas Example/XML/source.xml#6)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.Schemas Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.Schemas Example/VB/source.vb#1)]
+
+ The sample uses the following five input files:
+
+ `booksSchema.xml`
+
+ [!code-xml[Classic WebData XmlValidatingReader.Schemas Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Schemas Example/XML/source.xml#2)]
+
+ `booksSchemaFail.xml`
+
+ [!code-xml[Classic WebData XmlValidatingReader.Schemas Example#3](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Schemas Example/XML/source.xml#3)]
+
+ `newbooks.xml`
+
+ [!code-xml[Classic WebData XmlValidatingReader.Schemas Example#4](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Schemas Example/XML/source.xml#4)]
+
+ `books.xsd`
+
+ [!code-xml[Classic WebData XmlValidatingReader.Schemas Example#5](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Schemas Example/XML/source.xml#5)]
+
+ `schema1.xdr`
+
+ [!code-xml[Classic WebData XmlValidatingReader.Schemas Example#6](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Schemas Example/XML/source.xml#6)]
+
]]>
@@ -3488,63 +3486,63 @@ The text node can be either an element or an attribute text node.
, , or depending whether the node value is a built in XML Schema definition language (XSD) type or a user defined simpleType or complexType; if the current node has no schema type.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- The user needs to test for the returned type. For example,
-
-```csharp
-object obj = vreader.SchemaType;
- if (obj is XmlSchemaType)
- {
- XmlSchemaType st = (XmlSchemaType)obj;
- // use XmlSchemaType object
- }
- if (obj is XmlSchemaDatatype)
- {
- XmlSchemaDatatype sd = (XmlSchemaDatatype)obj;
- Type vt = sd.ValueType;
- // use XmlSchemaDatatype object
- }
-```
-
- If XML Schema validation is being performed, the `XmlSchemaType` or `XmlSchemaDatatype` corresponds to the current element being read. If document type definition (DTD validation) is being performed, this property returns `null`.
-
- `XmlSchemaDatatype` is returned if the current element, or attribute, is a simple type that can specify special validation constraints on the simple types, like min and max.
-
- `XmlSchemaSimpleType` is returned if the current element, or attribute, is a user defined simpleType.
-
- `XmlSchemaComplexType` is returned if the current element is a user defined complexType. This type cannot be returned by attributes.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ The user needs to test for the returned type. For example,
+
+```csharp
+object obj = vreader.SchemaType;
+ if (obj is XmlSchemaType)
+ {
+ XmlSchemaType st = (XmlSchemaType)obj;
+ // use XmlSchemaType object
+ }
+ if (obj is XmlSchemaDatatype)
+ {
+ XmlSchemaDatatype sd = (XmlSchemaDatatype)obj;
+ Type vt = sd.ValueType;
+ // use XmlSchemaDatatype object
+ }
+```
+
+ If XML Schema validation is being performed, the `XmlSchemaType` or `XmlSchemaDatatype` corresponds to the current element being read. If document type definition (DTD validation) is being performed, this property returns `null`.
+
+ `XmlSchemaDatatype` is returned if the current element, or attribute, is a simple type that can specify special validation constraints on the simple types, like min and max.
+
+ `XmlSchemaSimpleType` is returned if the current element, or attribute, is a user defined simpleType.
+
+ `XmlSchemaComplexType` is returned if the current element is a user defined complexType. This type cannot be returned by attributes.
+
> [!NOTE]
-> If has been set to ValidationType.None, no data type information is provided from either schemas or DTDs.
-
+> If has been set to ValidationType.None, no data type information is provided from either schemas or DTDs.
+
> [!CAUTION]
-> After calling , SchemaType will return Null.
-
-
-
-## Examples
- The following example displays the type information for each of the elements in the XML document.
-
+> After calling , SchemaType will return Null.
+
+
+
+## Examples
+ The following example displays the type information for each of the elements in the XML document.
+
[!code-cpp[XmlValidatingReader.SchemaType#1](~/snippets/cpp/VS_Snippets_Data/XmlValidatingReader.SchemaType/CPP/schematype.cpp#1)]
[!code-csharp[XmlValidatingReader.SchemaType#1](~/snippets/csharp/System.Xml/XmlValidatingReader/ReadTypedValue/schematype.cs#1)]
- [!code-vb[XmlValidatingReader.SchemaType#1](~/snippets/visualbasic/VS_Snippets_Data/XmlValidatingReader.SchemaType/VB/schematype.vb#1)]
-
- The example uses the following input files.
-
- `booksSchema.xml`
-
- [!code-xml[XmlValidatingReader.SchemaType#2](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.SchemaType/XML/booksschema.xml#2)]
-
- `books.xsd`
-
- [!code-xml[XmlValidatingReader.SchemaType#3](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.SchemaType/XML/books.xsd#3)]
-
+ [!code-vb[XmlValidatingReader.SchemaType#1](~/snippets/visualbasic/VS_Snippets_Data/XmlValidatingReader.SchemaType/VB/schematype.vb#1)]
+
+ The example uses the following input files.
+
+ `booksSchema.xml`
+
+ [!code-xml[XmlValidatingReader.SchemaType#2](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.SchemaType/XML/booksschema.xml#2)]
+
+ `books.xsd`
+
+ [!code-xml[XmlValidatingReader.SchemaType#3](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.SchemaType/XML/books.xsd#3)]
+
]]>
@@ -3578,11 +3576,11 @@ object obj = vreader.SchemaType;
[!NOTE]
-> The class is obsolete in .NET Framework version 2.0.
-> You can create a validating instance by using the class and the method.
+> The class is obsolete in .NET Framework version 2.0.
+> You can create a validating instance by using the class and the method.
> For more information, see [Validating XML Data with XmlReader](https://learn.microsoft.com/previous-versions/dotnet/netframework-4.0/hdf992b8(v=vs.100)).
]]>
@@ -3665,11 +3663,11 @@ object obj = vreader.SchemaType;
For a description of this member, see .
An object that identifies the namespaces in scope.
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -3718,11 +3716,11 @@ object obj = vreader.SchemaType;
For a description of this member, see .
A string value that contains the namespace Uri that is associated with the prefix.
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -3772,11 +3770,11 @@ object obj = vreader.SchemaType;
For a description of this member, see .
A string value that contains the namespace prefix that is associated with the .
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -3817,41 +3815,41 @@ object obj = vreader.SchemaType;
Sets an event handler for receiving information about document type definition (DTD), XML-Data Reduced (XDR) schema, and XML Schema definition language (XSD) schema validation errors.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- These events occur during and only if a of DTD, XDR, Schema, or Auto is specified.
-
- If no event handler is provided, an is thrown on the first validation error (Severity is equal to XmlSeverityType.Error).
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ These events occur during and only if a of DTD, XDR, Schema, or Auto is specified.
+
+ If no event handler is provided, an is thrown on the first validation error (Severity is equal to XmlSeverityType.Error).
+
> [!NOTE]
-> If an element reports a validation error, the rest of the content model for that element is not validated, however, its children are validated. The reader only reports the first error for a given element.
-
- The callback handler can use the property to guarantee that an XML instance document is validated against a schema. The `Severity` property allows you to distinguish between validation errors (Severity is equal to XmlSeverityType.Error) that indicate a fatal error, and validation warnings (Severity is equal to XmlSeverityType.Warning) that indicate that no schema information is available.
-
-
-
-## Examples
- The following example validates a file against an XML Schema.
-
+> If an element reports a validation error, the rest of the content model for that element is not validated, however, its children are validated. The reader only reports the first error for a given element.
+
+ The callback handler can use the property to guarantee that an XML instance document is validated against a schema. The `Severity` property allows you to distinguish between validation errors (Severity is equal to XmlSeverityType.Error) that indicate a fatal error, and validation warnings (Severity is equal to XmlSeverityType.Warning) that indicate that no schema information is available.
+
+
+
+## Examples
+ The following example validates a file against an XML Schema.
+
[!code-cpp[Classic WebData XmlValidatingReader.ValidationEventHandler Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationEventHandler Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.ValidationEventHandler Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/ValidationEventHandler/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.ValidationEventHandler Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationEventHandler Example/VB/source.vb#1)]
-
- The sample uses the following two input files:
-
- `notValidXSD.xml` (The `xsi:schemaLocation` attribute identifies the XML Schema for the reader.)
-
- [!code-xml[Classic WebData XmlValidatingReader.ValidationEventHandler Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationEventHandler Example/XML/source.xml#2)]
-
- `books.xsd`
-
- [!code-xml[Classic WebData XmlValidatingReader.ValidationEventHandler Example#3](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationEventHandler Example/XML/source.xml#3)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.ValidationEventHandler Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationEventHandler Example/VB/source.vb#1)]
+
+ The sample uses the following two input files:
+
+ `notValidXSD.xml` (The `xsi:schemaLocation` attribute identifies the XML Schema for the reader.)
+
+ [!code-xml[Classic WebData XmlValidatingReader.ValidationEventHandler Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationEventHandler Example/XML/source.xml#2)]
+
+ `books.xsd`
+
+ [!code-xml[Classic WebData XmlValidatingReader.ValidationEventHandler Example#3](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationEventHandler Example/XML/source.xml#3)]
+
]]>
@@ -3896,44 +3894,44 @@ object obj = vreader.SchemaType;
Gets or sets a value indicating the type of validation to perform.
One of the values. If this property is not set, it defaults to ValidationType.Auto.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This property must be set before the first call to . Setting this property to ValidationType.None creates a non-validating reader.
-
- If external document type definitions (DTDs) or schemas are needed for validation, the is used.
-
-
-
-## Examples
- The following example validates two files.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This property must be set before the first call to . Setting this property to ValidationType.None creates a non-validating reader.
+
+ If external document type definitions (DTDs) or schemas are needed for validation, the is used.
+
+
+
+## Examples
+ The following example validates two files.
+
[!code-cpp[Classic WebData XmlValidatingReader.ValidationType Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationType Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.ValidationType Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/ValidationType/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.ValidationType Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationType Example/VB/source.vb#1)]
-
- The sample uses the following four input files:
-
- `notValid.xml` (The "x-schema:" prefix identifies the XML-Data Reduced (XDR) schema for the reader.)
-
- [!code-xml[Classic WebData XmlValidatingReader.ValidationType Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationType Example/XML/source.xml#2)]
-
- `schema1.xdr`
-
- [!code-xml[Classic WebData XmlValidatingReader.ValidationType Example#3](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationType Example/XML/source.xml#3)]
-
- `cdDTD.xml`
-
- [!code-xml[Classic WebData XmlValidatingReader.ValidationType Example#4](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationType Example/XML/source.xml#4)]
-
- `book1.xml`
-
- [!code-xml[Classic WebData XmlValidatingReader.ValidationType Example#5](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationType Example/XML/source.xml#5)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.ValidationType Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationType Example/VB/source.vb#1)]
+
+ The sample uses the following four input files:
+
+ `notValid.xml` (The "x-schema:" prefix identifies the XML-Data Reduced (XDR) schema for the reader.)
+
+ [!code-xml[Classic WebData XmlValidatingReader.ValidationType Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationType Example/XML/source.xml#2)]
+
+ `schema1.xdr`
+
+ [!code-xml[Classic WebData XmlValidatingReader.ValidationType Example#3](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationType Example/XML/source.xml#3)]
+
+ `cdDTD.xml`
+
+ [!code-xml[Classic WebData XmlValidatingReader.ValidationType Example#4](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationType Example/XML/source.xml#4)]
+
+ `book1.xml`
+
+ [!code-xml[Classic WebData XmlValidatingReader.ValidationType Example#5](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.ValidationType Example/XML/source.xml#5)]
+
]]>
Setting the property after a Read has been called.
@@ -3976,52 +3974,52 @@ object obj = vreader.SchemaType;
Gets the text value of the current node.
- The value returned depends on the of the node. The following table lists node types that have a value to return. All other node types return String.Empty.
-
- Node Type
-
- Value
-
- - The value of the attribute.
-
-
- The content of the CDATA section.
-
-
- The content of the comment.
-
-
- The internal subset.
-
-
- The entire content, excluding the target.
-
-
- The white space between markup in a mixed content model.
-
-
- The content of the text node.
-
-
- The white space between markup.
-
-
- The content of the declaration.
-
+ The value returned depends on the of the node. The following table lists node types that have a value to return. All other node types return String.Empty.
+
+
Node Type
+
+ Value
+
+ - The value of the attribute.
+
+
- The content of the CDATA section.
+
+
- The content of the comment.
+
+
- The internal subset.
+
+
- The entire content, excluding the target.
+
+
- The white space between markup in a mixed content model.
+
+
- The content of the text node.
+
+
- The white space between markup.
+
+
- The content of the declaration.
+
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
-
-
-## Examples
- The following example reads an XML file and displays each node.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+
+
+## Examples
+ The following example reads an XML file and displays each node.
+
[!code-cpp[Classic WebData XmlValidatingReader.Name Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/CPP/source.cpp#1)]
[!code-csharp[Classic WebData XmlValidatingReader.Name Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/Name/source.cs#1)]
- [!code-vb[Classic WebData XmlValidatingReader.Name Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/VB/source.vb#1)]
-
- The example uses the file, `items.xml`, as input.
-
- [!code-xml[Classic WebData XmlValidatingReader.Name Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/XML/source.xml#2)]
-
+ [!code-vb[Classic WebData XmlValidatingReader.Name Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/VB/source.vb#1)]
+
+ The example uses the file, `items.xml`, as input.
+
+ [!code-xml[Classic WebData XmlValidatingReader.Name Example#2](~/snippets/xml/VS_Snippets_Data/Classic WebData XmlValidatingReader.Name Example/XML/source.xml#2)]
+
]]>
@@ -4065,23 +4063,23 @@ object obj = vreader.SchemaType;
Gets the current scope.
The current scope.
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- This property represents the xml:lang scope within which the current node resides. For example, here is an XML fragment with `xml:lang` set to U.S. English in the root element:
-
-```xml
-
-Fred
-
-```
-
- When the reader is positioned on the `name` element, you can use this property to find that it is in the scope of a U.S. English `xml:lang` attribute.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ This property represents the xml:lang scope within which the current node resides. For example, here is an XML fragment with `xml:lang` set to U.S. English in the root element:
+
+```xml
+
+Fred
+
+```
+
+ When the reader is positioned on the `name` element, you can use this property to find that it is in the scope of a U.S. English `xml:lang` attribute.
+
]]>
@@ -4123,48 +4121,48 @@ object obj = vreader.SchemaType;
Sets the used for resolving external document type definition (DTD) and schema location references. The is also used to handle any import or include elements found in XML Schema definition language (XSD) schemas.
- The to use. If set to , external resources are not resolved.
-
+ The to use. If set to , external resources are not resolved.
+
In version 1.1 of the .NET Framework, the caller must be fully trusted to specify an .
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
- The `XmlResolver` is used to load any DTDs, entities, or schemas needed to complete the validation process.
-
- This property can be set at any time and takes affect after the next call. If this property is set to `null`, the reader assumes the user is not interested in resolving external references. In this case, the reader only validates against internal resources, if the resource is present.
-
- In version 1.1 of .NET Framework , if this property is not set, the trust level of the application determines the default behavior.
-
- `Fully trusted code:` The reader uses a default with no user credentials. If authentication is required to access a network resource, use the `XmlResolver` property to specify an `XmlResolver` with the necessary credentials.
-
- `Semi-trusted code:` The `XmlResolver` property is set to `null`. External resources are not resolved.
-
- When validating using schemas, you can avoid the expensive load process by providing an using the property.
-
-
-
-## Examples
- The following example uses the `XmlResolver` property to specify the credentials necessary to access the networked DTD file.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
+ The `XmlResolver` is used to load any DTDs, entities, or schemas needed to complete the validation process.
+
+ This property can be set at any time and takes affect after the next call. If this property is set to `null`, the reader assumes the user is not interested in resolving external references. In this case, the reader only validates against internal resources, if the resource is present.
+
+ In version 1.1 of .NET Framework , if this property is not set, the trust level of the application determines the default behavior.
+
+ `Fully trusted code:` The reader uses a default with no user credentials. If authentication is required to access a network resource, use the `XmlResolver` property to specify an `XmlResolver` with the necessary credentials.
+
+ `Semi-trusted code:` The `XmlResolver` property is set to `null`. External resources are not resolved.
+
+ When validating using schemas, you can avoid the expensive load process by providing an using the property.
+
+
+
+## Examples
+ The following example uses the `XmlResolver` property to specify the credentials necessary to access the networked DTD file.
+
[!code-cpp[XmlValidatingReader.XmlResolver#1](~/snippets/cpp/VS_Snippets_Data/XmlValidatingReader.XmlResolver/CPP/vrdr_resolver.cpp#1)]
[!code-csharp[XmlValidatingReader.XmlResolver#1](~/snippets/csharp/System.Xml/XmlValidatingReader/XmlResolver/vrdr_resolver.cs#1)]
- [!code-vb[XmlValidatingReader.XmlResolver#1](~/snippets/visualbasic/VS_Snippets_Data/XmlValidatingReader.XmlResolver/VB/vrdr_resolver.vb#1)]
-
- The example uses the following files as input.
-
- `book5.xml`
-
- [!code-xml[XmlValidatingReader.XmlResolver#2](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.XmlResolver/XML/book5.xml#2)]
-
- `books.dtd`
-
- [!code-xml[XmlValidatingReader.XmlResolver#3](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.XmlResolver/XML/books.dtd#3)]
-
+ [!code-vb[XmlValidatingReader.XmlResolver#1](~/snippets/visualbasic/VS_Snippets_Data/XmlValidatingReader.XmlResolver/VB/vrdr_resolver.vb#1)]
+
+ The example uses the following files as input.
+
+ `book5.xml`
+
+ [!code-xml[XmlValidatingReader.XmlResolver#2](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.XmlResolver/XML/book5.xml#2)]
+
+ `books.dtd`
+
+ [!code-xml[XmlValidatingReader.XmlResolver#3](~/snippets/xml/VS_Snippets_Data/XmlValidatingReader.XmlResolver/XML/books.dtd#3)]
+
]]>
@@ -4212,13 +4210,13 @@ object obj = vreader.SchemaType;
Gets the current scope.
One of the values. If no scope exists, this property defaults to .
- [!NOTE]
-> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
-
+> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page.
+
]]>
diff --git a/xml/System/BitConverter.xml b/xml/System/BitConverter.xml
index fca608f71ce..c942c167864 100644
--- a/xml/System/BitConverter.xml
+++ b/xml/System/BitConverter.xml
@@ -65,11 +65,11 @@
Converts base data types to an array of bytes, and an array of bytes to base data types.
- class helps manipulate value types in their fundamental form, as a series of bytes. A byte is defined as an 8-bit unsigned integer. The class includes static methods to convert each of the primitive types to and from an array of bytes, as the following table illustrates.
-
+ class helps manipulate value types in their fundamental form, as a series of bytes. A byte is defined as an 8-bit unsigned integer. The class includes static methods to convert each of the primitive types to and from an array of bytes, as the following table illustrates.
+
| Type | To byte conversion | From byte conversion |
|-----------------------|--------------------------------------------------------|-----------------------------------------|
| | | |
@@ -83,40 +83,40 @@
| | | |
| | | |
| | | |
-
+
If you use methods to round-trip data, make sure that the overload and the `To`*Type* method specify the same type. As the following example illustrates, restoring an array that represents a signed integer by calling the method can result in a value that is different from the original. For more information, see [Working with Signed Non-Decimal and Bitwise Values](/archive/blogs/bclteam/working-with-signed-non-decimal-and-bitwise-values-ron-petrusha).
-
+
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/Overview/example1.cs" interactive="try-dotnet" id="Snippet3":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.Class/FS/example1.fs" id="Snippet3":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.BitConverter.Class/VB/example1.vb" id="Snippet3":::
-
- The order of bytes in the array returned by the method overloads (as well as the order of bits in the integer returned by the method) depends on whether the computer architecture is little-endian or big-endian. Similarly, the order of bytes in the array and returned by the `To`*IntegerValue* methods and the method depends on whether the computer architecture is little-endian or big-endian. The endianness of an architecture is indicated by the property, which returns `true` on little-endian systems and `false` on big-endian systems. On little-endian systems, lower-order bytes precede higher-order bytes. On big-endian system, higher-order bytes precede lower-order bytes. The following table illustrates the difference in the byte arrays that result from passing the integer 1,234,567,890 (0x499602D2) to the method. The bytes are listed in order from the byte at index 0 to the byte at index 3.
-
-|||
-|-|-|
-|Little-endian|D2-02-96-49|
-|Big-endian|49-96-02-D2|
-
- Because the return value of some methods depends on system architecture, be careful when transmitting byte data beyond machine boundaries:
-
-- If all systems sending and receiving data are guaranteed to have the same endianness, nothing has to be done to the data.
-
-- If systems sending and receiving data can have different endianness, always transmit data in a particular order. This means that the order of bytes in the array may have to be reversed either before sending them or after receiving them. A common convention is to transmit data in network byte order (big-endian order). The following example provides an implementation for sending an integer value in network byte order.
-
+
+ The order of bytes in the array returned by the method overloads (as well as the order of bits in the integer returned by the method) depends on whether the computer architecture is little-endian or big-endian. Similarly, the order of bytes in the array and returned by the `To`*IntegerValue* methods and the method depends on whether the computer architecture is little-endian or big-endian. The endianness of an architecture is indicated by the property, which returns `true` on little-endian systems and `false` on big-endian systems. On little-endian systems, lower-order bytes precede higher-order bytes. On big-endian system, higher-order bytes precede lower-order bytes. The following table illustrates the difference in the byte arrays that result from passing the integer 1,234,567,890 (0x499602D2) to the method. The bytes are listed in order from the byte at index 0 to the byte at index 3.
+
+| Architecture | Byte array |
+|---------------|-------------|
+| Little-endian | D2-02-96-49 |
+| Big-endian | 49-96-02-D2 |
+
+ Because the return value of some methods depends on system architecture, be careful when transmitting byte data beyond machine boundaries:
+
+- If all systems sending and receiving data are guaranteed to have the same endianness, nothing has to be done to the data.
+
+- If systems sending and receiving data can have different endianness, always transmit data in a particular order. This means that the order of bytes in the array may have to be reversed either before sending them or after receiving them. A common convention is to transmit data in network byte order (big-endian order). The following example provides an implementation for sending an integer value in network byte order.
+
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/Overview/networkorder1.cs" interactive="try-dotnet" id="Snippet4":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.Class/FS/networkorder1.fs" id="Snippet4":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.BitConverter.Class/VB/networkorder1.vb" id="Snippet4":::
-
+
- If systems sending and receiving data can have different endianness and the data to be transmitted consists of signed integers, call the method to convert the data to network byte order and the method to convert it to the order required by the recipient.
-
-## Examples
- The following code example illustrates the use of several class methods.
-
+
+## Examples
+ The following code example illustrates the use of several class methods.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.Class/CPP/bitconv.cpp" id="Snippet1":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/Overview/bitconv.cs" interactive="try-dotnet" id="Snippet1":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.Class/FS/bitconv.fs" id="Snippet1":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.BitConverter.Class/VB/bitconv.vb" id="Snippet1":::
-
+
]]>
@@ -176,14 +176,14 @@
Converts the specified double-precision floating point number to a 64-bit signed integer.
A 64-bit signed integer whose value is equivalent to .
- method depends on whether the computer architecture is little-endian or big-endian.
-
-## Examples
- The following code example converts the bit patterns of several values to values with the `DoubleToInt64Bits` method.
-
+
+## Examples
+ The following code example converts the bit patterns of several values to values with the `DoubleToInt64Bits` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.DoubleInt64/CPP/dbltobits.cpp" id="Snippet2":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/DoubleToInt64Bits/dbltobits.cs" interactive="try-dotnet" id="Snippet2":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.DoubleInt64/FS/dbltobits.fs" id="Snippet2":::
@@ -297,18 +297,18 @@
Returns the specified Boolean value as a byte array.
A byte array with length 1.
- value by calling the method.
-
-## Examples
- The following example converts the bit patterns of values to arrays with the `GetBytes` method.
-
- :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.Others/CPP/bytesbool.cpp" id="Snippet1":::
- :::code language="csharp" source="~/snippets/csharp/System/BitConverter/GetBytes/bytesbool.cs" interactive="try-dotnet" id="Snippet1":::
- :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.Others/FS/bytesbool.fs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.BitConverter.GetBytes.Others/VB/bytesbool.vb" id="Snippet1":::
+
+## Examples
+ The following example converts the bit patterns of values to arrays with the `GetBytes` method.
+
+ :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.Others/CPP/bytesbool.cpp" id="Snippet1":::
+ :::code language="csharp" source="~/snippets/csharp/System/BitConverter/GetBytes/bytesbool.cs" interactive="try-dotnet" id="Snippet1":::
+ :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.Others/FS/bytesbool.fs" id="Snippet1":::
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.BitConverter.GetBytes.Others/VB/bytesbool.vb" id="Snippet1":::
]]>
@@ -363,14 +363,14 @@
Returns the specified Unicode character value as an array of bytes.
An array of bytes with length 2.
- method depends on whether the computer architecture is little-endian or big-endian.
-## Examples
- The following code example converts the bit patterns of values (Unicode characters) to arrays with the `GetBytes` method.
-
+## Examples
+ The following code example converts the bit patterns of values (Unicode characters) to arrays with the `GetBytes` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.Others/CPP/byteschar.cpp" id="Snippet2":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/GetBytes/byteschar.cs" interactive="try-dotnet" id="Snippet2":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.Others/FS/byteschar.fs" id="Snippet2":::
@@ -435,14 +435,14 @@
Returns the specified double-precision floating-point value as an array of bytes.
An array of bytes with length 8.
- method depends on whether the computer architecture is little-endian or big-endian.
-
-## Examples
- The following code example converts the bit patterns of values to arrays with the `GetBytes` method.
-
+
+## Examples
+ The following code example converts the bit patterns of values to arrays with the `GetBytes` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.Others/CPP/bytesdouble.cpp" id="Snippet4":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/GetBytes/bytesdouble.cs" interactive="try-dotnet" id="Snippet4":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.Others/FS/bytesdouble.fs" id="Snippet4":::
@@ -578,14 +578,14 @@
Returns the specified 16-bit signed integer value as an array of bytes.
An array of bytes with length 2.
- method depends on whether the computer architecture is little-endian or big-endian.
-
-## Examples
- The following code example converts the bit patterns of values to arrays with the `GetBytes` method.
-
+
+## Examples
+ The following code example converts the bit patterns of values to arrays with the `GetBytes` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.SInts/CPP/bytesint16.cpp" id="Snippet3":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/GetBytes/bytesint16.cs" interactive="try-dotnet" id="Snippet3":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.SInts/FS/bytesint16.fs" id="Snippet3":::
@@ -650,14 +650,14 @@
Returns the specified 32-bit signed integer value as an array of bytes.
An array of bytes with length 4.
- method depends on whether the computer architecture is little-endian or big-endian.
-
-## Examples
- The following code example converts the bit patterns of values to arrays with the `GetBytes` method.
-
+
+## Examples
+ The following code example converts the bit patterns of values to arrays with the `GetBytes` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.SInts/CPP/bytesint32.cpp" id="Snippet2":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/GetBytes/bytesint32.cs" interactive="try-dotnet" id="Snippet2":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.SInts/FS/bytesint32.fs" id="Snippet2":::
@@ -722,14 +722,14 @@
Returns the specified 64-bit signed integer value as an array of bytes.
An array of bytes with length 8.
- method depends on whether the computer architecture is little-endian or big-endian.
-
-## Examples
- The following example calls the method to convert each element in an array to a arrays.
-
+
+## Examples
+ The following example calls the method to convert each element in an array to a arrays.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.SInts/CPP/bytesint64.cpp" id="Snippet1":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/GetBytes/bytesint64.cs" interactive="try-dotnet" id="Snippet1":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.SInts/FS/bytesint64.fs" id="Snippet1":::
@@ -794,14 +794,14 @@
Returns the specified single-precision floating point value as an array of bytes.
An array of bytes with length 4.
- method depends on whether the computer architecture is little-endian or big-endian.
-
-## Examples
- The following code example converts the bit patterns of values to arrays with the `GetBytes` method.
-
+
+## Examples
+ The following code example converts the bit patterns of values to arrays with the `GetBytes` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.Others/CPP/bytessingle.cpp" id="Snippet3":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/GetBytes/bytessingle.cs" interactive="try-dotnet" id="Snippet3":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.Others/FS/bytessingle.fs" id="Snippet3":::
@@ -906,14 +906,14 @@
Returns the specified 16-bit unsigned integer value as an array of bytes.
An array of bytes with length 2.
- method depends on whether the computer architecture is little-endian or big-endian.
-
-## Examples
- The following code example converts the bit patterns of values to arrays with the `GetBytes` method.
-
+
+## Examples
+ The following code example converts the bit patterns of values to arrays with the `GetBytes` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.UInts/CPP/bytesuint16.cpp" id="Snippet3":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/GetBytes/bytesuint16.cs" interactive="try-dotnet" id="Snippet3":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.UInts/FS/bytesuint16.fs" id="Snippet3":::
@@ -978,14 +978,14 @@
Returns the specified 32-bit unsigned integer value as an array of bytes.
An array of bytes with length 4.
- method depends on whether the computer architecture is little-endian or big-endian.
-
-## Examples
- The following code example converts the bit patterns of values to arrays with the `GetBytes` method.
-
+
+## Examples
+ The following code example converts the bit patterns of values to arrays with the `GetBytes` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.UInts/CPP/bytesuint32.cpp" id="Snippet2":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/GetBytes/bytesuint32.cs" interactive="try-dotnet" id="Snippet2":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.UInts/FS/bytesuint32.fs" id="Snippet2":::
@@ -1050,14 +1050,14 @@
Returns the specified 64-bit unsigned integer value as an array of bytes.
An array of bytes with length 8.
- method depends on whether the computer architecture is little-endian or big-endian.
-
-## Examples
- The following code example converts the bit patterns of values to arrays with the `GetBytes` method.
-
+
+## Examples
+ The following code example converts the bit patterns of values to arrays with the `GetBytes` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.UInts/CPP/bytesuint64.cpp" id="Snippet1":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/GetBytes/bytesuint64.cs" interactive="try-dotnet" id="Snippet1":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.GetBytes.UInts/FS/bytesuint64.fs" id="Snippet1":::
@@ -1281,19 +1281,19 @@
Reinterprets the specified 64-bit signed integer to a double-precision floating point number.
A double-precision floating point number whose value is equivalent to .
- method.
-
-## Examples
- The following code example converts the bit patterns of several values to values with the `Int64BitsToDouble` method.
-
+
+## Examples
+ The following code example converts the bit patterns of several values to values with the `Int64BitsToDouble` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.DoubleInt64/CPP/bitstodbl.cpp" id="Snippet1":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/DoubleToInt64Bits/bitstodbl.cs" id="Snippet1":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.DoubleInt64/FS/bitstodbl.fs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.BitConverter.DoubleInt64/VB/bitstodbl.vb" id="Snippet1":::
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.BitConverter.DoubleInt64/VB/bitstodbl.vb" id="Snippet1":::
+
]]>
@@ -1342,17 +1342,17 @@
Indicates the byte order ("endianness") in which data is stored in this computer architecture.
- [!NOTE]
> You can convert from network byte order to the byte order of the host computer without retrieving the value of the field by passing a 16-bit, 32-bit, or 64 bit integer to the method.
-
-## Examples
- The following code example illustrates the use of the `IsLittleEndian` field.
-
+
+## Examples
+ The following code example illustrates the use of the `IsLittleEndian` field.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.Class/CPP/littleend.cpp" id="Snippet2":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/Overview/littleend.cs" interactive="try-dotnet" id="Snippet2":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.Class/FS/littleend.fs" id="Snippet2":::
@@ -1540,19 +1540,19 @@
if the byte at in is nonzero; otherwise, .
- value to its byte representation, call the method.
-
-## Examples
- The following code example converts elements of arrays to values with the `ToBoolean` method.
-
+
+## Examples
+ The following code example converts elements of arrays to values with the `ToBoolean` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.Others/CPP/batobool.cpp" id="Snippet1":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/ToBoolean/batobool.cs" interactive="try-dotnet" id="Snippet1":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.Others/FS/batobool.fs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.BitConverter.ToXXX.Others/VB/batobool.vb" id="Snippet1":::
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.BitConverter.ToXXX.Others/VB/batobool.vb" id="Snippet1":::
+
]]>
@@ -1654,19 +1654,19 @@
Returns a Unicode character converted from two bytes at a specified position in a byte array.
The character formed by two bytes beginning at .
- method converts the bytes from index `startIndex` to `startIndex` + 1 to a value. The order of bytes in the array must reflect the endianness of the computer system's architecture. For more information, see the Remarks section of the class topic.
-
-## Examples
- The following code example converts elements of arrays to values (Unicode characters) with the `ToChar` method.
-
+
+## Examples
+ The following code example converts elements of arrays to values (Unicode characters) with the `ToChar` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.Others/CPP/batochar.cpp" id="Snippet2":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/ToBoolean/batochar.cs" interactive="try-dotnet" id="Snippet2":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.Others/FS/batochar.fs" id="Snippet2":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.BitConverter.ToXXX.Others/VB/batochar.vb" id="Snippet2":::
-
+
]]>
@@ -1776,19 +1776,19 @@
Returns a double-precision floating point number converted from eight bytes at a specified position in a byte array.
A double-precision floating point number formed by eight bytes beginning at .
- method converts the bytes from index `startIndex` to `startIndex` + 7 to a value. The order of bytes in the array must reflect the endianness of the computer system's architecture. For more information, see the Remarks section of the class topic.
-
-## Examples
- The following code example converts elements of arrays to values with the `ToDouble` method.
-
+
+## Examples
+ The following code example converts elements of arrays to values with the `ToDouble` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.Others/CPP/batodouble.cpp" id="Snippet3":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/ToBoolean/batodouble.cs" interactive="try-dotnet" id="Snippet3":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.Others/FS/batodouble.fs" id="Snippet3":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.BitConverter.ToXXX.Others/VB/batodouble.vb" id="Snippet3":::
-
+
]]>
@@ -2059,14 +2059,14 @@
Returns a 16-bit signed integer converted from two bytes at a specified position in a byte array.
A 16-bit signed integer formed by two bytes beginning at .
- method converts the bytes from index `startIndex` to `startIndex` + 1 to an value. The order of bytes in the array must reflect the endianness of the computer system's architecture. For more information, see the Remarks section of the class topic.
-
-## Examples
- The following code example converts elements of arrays to values with the `ToInt16` method.
-
+
+## Examples
+ The following code example converts elements of arrays to values with the `ToInt16` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.SInts/CPP/batoint16.cpp" id="Snippet1":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/ToInt16/batoint16.cs" interactive="try-dotnet" id="Snippet1":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.SInts/FS/batoint16.fs" id="Snippet1":::
@@ -2181,14 +2181,14 @@
Returns a 32-bit signed integer converted from four bytes at a specified position in a byte array.
A 32-bit signed integer formed by four bytes beginning at .
- method converts the bytes from index `startIndex` to `startIndex` + 3 to an value. The order of bytes in the array must reflect the endianness of the computer system's architecture. For more information, see the Remarks section of .
-
-## Examples
- The following example uses the method to create values from a four-byte array and from the upper four bytes of an eight-byte array. It also uses the and methods to round-trip an value.
-
+
+## Examples
+ The following example uses the method to create values from a four-byte array and from the upper four bytes of an eight-byte array. It also uses the and methods to round-trip an value.
+
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/ToInt32/toint32.cs" interactive="try-dotnet" id="Snippet1":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.bitconverter.toint32/fs/toint32.fs" id="Snippet1":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.bitconverter.toint32/vb/toint32.vb" id="Snippet1":::
@@ -2302,14 +2302,14 @@
Returns a 64-bit signed integer converted from eight bytes at a specified position in a byte array.
A 64-bit signed integer formed by eight bytes beginning at .
- method converts the bytes from index `startIndex` to `startIndex` + 7 to a value. The order of bytes in the array must reflect the endianness of the computer system's architecture. For more information, see the Remarks section of the class topic.
-
-## Examples
- The following code example converts elements of arrays to values with the `ToInt64` method.
-
+
+## Examples
+ The following code example converts elements of arrays to values with the `ToInt64` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.SInts/CPP/batoint64.cpp" id="Snippet3":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/ToInt16/batoint64.cs" interactive="try-dotnet" id="Snippet3":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.SInts/FS/batoint64.fs" id="Snippet3":::
@@ -2424,14 +2424,14 @@
Returns a single-precision floating point number converted from four bytes at a specified position in a byte array.
A single-precision floating point number formed by four bytes beginning at .
- method converts the bytes from index `startIndex` to `startIndex` + 3 to a value. The order of bytes in the array must reflect the endianness of the computer system's architecture. For more information, see the Remarks section of .
-
-## Examples
- The following code example converts elements of arrays to values with the `ToSingle` method.
-
+
+## Examples
+ The following code example converts elements of arrays to values with the `ToSingle` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.Others/CPP/batosingle.cpp" id="Snippet4":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/ToBoolean/batosingle.cs" interactive="try-dotnet" id="Snippet4":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.Others/FS/batosingle.fs" id="Snippet4":::
@@ -2508,14 +2508,14 @@
Converts the numeric value of each element of a specified array of bytes to its equivalent hexadecimal string representation.
A string of hexadecimal pairs separated by hyphens, where each pair represents the corresponding element in ; for example, "7F-2C-4A-00".
- arrays to objects with the `ToString` method.
-
+
+## Examples
+ The following code example converts arrays to objects with the `ToString` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.ToString/CPP/batostring.cpp" id="Snippet1":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/ToString/batostring.cs" interactive="try-dotnet" id="Snippet1":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.ToString/FS/batostring.fs" id="Snippet1":::
@@ -2577,14 +2577,14 @@
Converts the numeric value of each element of a specified subarray of bytes to its equivalent hexadecimal string representation.
A string of hexadecimal pairs separated by hyphens, where each pair represents the corresponding element in a subarray of ; for example, "7F-2C-4A-00".
- array starting at the specified `startIndex` to a with the `ToString` method.
-
+
+## Examples
+ The following code example converts the part of a array starting at the specified `startIndex` to a with the `ToString` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.ToString/CPP/batostringii.cpp" id="Snippet2":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/ToString/batostringii.cs" interactive="try-dotnet" id="Snippet2":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.ToString/FS/batostringii.fs" id="Snippet2":::
@@ -2650,28 +2650,28 @@
Converts the numeric value of each element of a specified subarray of bytes to its equivalent hexadecimal string representation.
A string of hexadecimal pairs separated by hyphens, where each pair represents the corresponding element in a subarray of ; for example, "7F-2C-4A-00".
- .
-
-## Examples
- The following example uses the method to convert part of a byte array, starting at the specified `startIndex` and with the specified `length`, to a string.
-
+
+## Examples
+ The following example uses the method to convert part of a byte array, starting at the specified `startIndex` and with the specified `length`, to a string.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.ToString/CPP/batostringii.cpp" id="Snippet2":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/ToString/batostringii.cs" interactive="try-dotnet" id="Snippet2":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.ToString/FS/batostringii.fs" id="Snippet2":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.BitConverter.ToString/VB/batostringii.vb" id="Snippet2":::
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.BitConverter.ToString/VB/batostringii.vb" id="Snippet2":::
]]>
is .
- or is less than zero.
-
- -or-
-
+ or is less than zero.
+
+ -or-
+
is greater than zero and is greater than or equal to the length of .
The combination of and does not specify a position within ; that is, the parameter is greater than the length of minus the parameter.
@@ -2870,14 +2870,14 @@
Returns a 16-bit unsigned integer converted from two bytes at a specified position in a byte array.
A 16-bit unsigned integer formed by two bytes beginning at .
- method converts the bytes from index `startIndex` to `startIndex` + 1 to a value. The order of bytes in the array must reflect the endianness of the computer system's architecture. For more information, see the Remarks section of the class topic.
-
-## Examples
- The following code example converts elements of arrays to values with the `ToUInt16` method.
-
+
+## Examples
+ The following code example converts elements of arrays to values with the `ToUInt16` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.UInts/CPP/batouint16.cpp" id="Snippet1":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/ToUInt16/batouint16.cs" interactive="try-dotnet" id="Snippet1":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.UInts/FS/batouint16.fs" id="Snippet1":::
@@ -2998,14 +2998,14 @@
Returns a 32-bit unsigned integer converted from four bytes at a specified position in a byte array.
A 32-bit unsigned integer formed by four bytes beginning at .
- method converts the bytes from index `startIndex` to `startIndex` + 3 to a value. The order of bytes in the array must reflect the endianness of the computer system's architecture. For more information, see the Remarks section of the class topic.
-
-## Examples
- The following code example converts elements of arrays to values with the `ToUInt32` method.
-
+
+## Examples
+ The following code example converts elements of arrays to values with the `ToUInt32` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.UInts/CPP/batouint32.cpp" id="Snippet2":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/ToUInt16/batouint32.cs" interactive="try-dotnet" id="Snippet2":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.UInts/FS/batouint32.fs" id="Snippet2":::
@@ -3126,14 +3126,14 @@
Returns a 64-bit unsigned integer converted from eight bytes at a specified position in a byte array.
A 64-bit unsigned integer formed by the eight bytes beginning at .
- method converts the bytes from index `startIndex` to `startIndex` + 7 to a value. The order of bytes in the array must reflect the endianness of the computer system's architecture. For more information, see the Remarks section of the class topic.
-
-## Examples
- The following code example converts elements of arrays to values with the `ToUInt64` method.
-
+
+## Examples
+ The following code example converts elements of arrays to values with the `ToUInt64` method.
+
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.UInts/CPP/batouint64.cpp" id="Snippet3":::
:::code language="csharp" source="~/snippets/csharp/System/BitConverter/ToUInt16/batouint64.cs" interactive="try-dotnet" id="Snippet3":::
:::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.BitConverter.ToXXX.UInts/FS/batouint64.fs" id="Snippet3":::
diff --git a/xml/System/Char.xml b/xml/System/Char.xml
index 421112328ec..6373ff80de7 100644
--- a/xml/System/Char.xml
+++ b/xml/System/Char.xml
@@ -3018,34 +3018,103 @@ The following code example demonstrates .
: `ConnectorPunctuation`, `DashPunctuation`, `OpenPunctuation`, `ClosePunctuation`, `InitialQuotePunctuation`, `FinalQuotePunctuation`, or `OtherPunctuation`. They include characters with the Unicode code points listed in the following table.
-
-|||||
-|-|-|-|-|
-|U+0021 to U+0023|U+060C and U+060D|U+1800 to U+180A|U+3014 to U+301F|
-|U+0025 to U+002A|U+061B|U+1944 and U+1945|U+3030|
-|U+002C to U+002F|U+061E and U+061F|U+19DE and U+19DF|U+303D|
-|U+003A and U+003B|U+066A to U+066D|U+1A1E and U+1A1F|U+30A0|
-|U+003F and U+0040|U+06D4|U+1B5A to U+1B60|U+30FB|
-|U+005B to U+005D|U+0700 to U+070D|U+2010 to U+2027|U+A874 to U+A877|
-|U+005F|U+07F7 to U+07F9|U+2030 to U+2043|U+FD3E and U+FD3F|
-|U+007B|U+0964 and U+0965|U+2045 to U+2051|U+FE10 to U+FE19|
-|U+007D|U+0970|U+2053 to U+205E|U+FE30 to U+FE52|
-|U+00A1|U+0DF4|U+207D and U+207E|U+FE54 to U+FE61|
-|U+00AB|U+0E4F to U+0E5B|U+208D and U+208E|U+FE63|
-|U+00AD|U+0F04 to U+0F12|U+2329 and U+232A|U+FE68|
-|U+00B7|U+0F3A to U+0F3D|U+2768 to U+2775|U+FE6A and U+FE6B|
-|U+00BB|U+0F85|U+27C5 to U+27C6|U+FF01 to U+FF03|
-|U+00BF|U+0FD0 and U+0FD1|U+27E6 to U+27EB|U+FF05 to U+FF0A|
-|U+037E|U+104A to U+104F|U+2983 to U+2998|U+FF0C to U+FF0F|
-|U+0387|U+10FB|U+29D8 to U+29DB|U+FF1A and U+FF1B|
-|U+055A to U+055F|U+1361 to U+1368|U+29FC and U+29FD|U+FF1F and U+FF20|
-|U+0589 and U+058A|U+166D and U+166E|U+2CF9 to U+2CFC|U+FF3B to U+FF3D|
-|U+05BE|U+169B and U+169C|U+2CFE and U+2CFF|U+FF3F|
-|U+05C0|U+16EB to U+16ED|U+2E00 to U+2E17|U+FF5B|
-|U+05C3|U+1735 and U+1736|U+2E1C and U+2E1D|U+FF5D|
-|U+05C6|U+17D4 to U+17D6|U+3001 to U+3003|U+FF5F to U+FF65|
-|U+05F3 and U+05F4|U+17D8 to U+17DA|U+3008 to U+3011||
+ Valid punctuation marks are members of the following categories in : `ConnectorPunctuation`, `DashPunctuation`, `OpenPunctuation`, `ClosePunctuation`, `InitialQuotePunctuation`, `FinalQuotePunctuation`, or `OtherPunctuation`. They include characters with the following Unicode code points:
+
+- U+0021 to U+0023
+- U+060C and U+060D
+- U+1800 to U+180A
+- U+3014 to U+301F
+- U+0025 to U+002A
+- U+061B
+- U+1944 and U+1945
+- U+3030
+- U+002C to U+002F
+- U+061E and U+061F
+- U+19DE and U+19DF
+- U+303D
+- U+003A and U+003B
+- U+066A to U+066D
+- U+1A1E and U+1A1F
+- U+30A0
+- U+003F and U+0040
+- U+06D4
+- U+1B5A to U+1B60
+- U+30FB
+- U+005B to U+005D
+- U+0700 to U+070D
+- U+2010 to U+2027
+- U+A874 to U+A877
+- U+005F
+- U+07F7 to U+07F9
+- U+2030 to U+2043
+- U+FD3E and U+FD3F
+- U+007B
+- U+0964 and U+0965
+- U+2045 to U+2051
+- U+FE10 to U+FE19
+- U+007D
+- U+0970
+- U+2053 to U+205E
+- U+FE30 to U+FE52
+- U+00A1
+- U+0DF4
+- U+207D and U+207E
+- U+FE54 to U+FE61
+- U+00AB
+- U+0E4F to U+0E5B
+- U+208D and U+208E
+- U+FE63
+- U+00AD
+- U+0F04 to U+0F12
+- U+2329 and U+232A
+- U+FE68
+- U+00B7
+- U+0F3A to U+0F3D
+- U+2768 to U+2775
+- U+FE6A and U+FE6B
+- U+00BB
+- U+0F85
+- U+27C5 to U+27C6
+- U+FF01 to U+FF03
+- U+00BF
+- U+0FD0 and U+0FD1
+- U+27E6 to U+27EB
+- U+FF05 to U+FF0A
+- U+037E
+- U+104A to U+104F
+- U+2983 to U+2998
+- U+FF0C to U+FF0F
+- U+0387
+- U+10FB
+- U+29D8 to U+29DB
+- U+FF1A and U+FF1B
+- U+055A to U+055F
+- U+1361 to U+1368
+- U+29FC and U+29FD
+- U+FF1F and U+FF20
+- U+0589 and U+058A
+- U+166D and U+166E
+- U+2CF9 to U+2CFC
+- U+FF3B to U+FF3D
+- U+05BE
+- U+169B and U+169C
+- U+2CFE and U+2CFF
+- U+FF3F
+- U+05C0
+- U+16EB to U+16ED
+- U+2E00 to U+2E17
+- U+FF5B
+- U+05C3
+- U+1735 and U+1736
+- U+2E1C and U+2E1D
+- U+FF5D
+- U+05C6
+- U+17D4 to U+17D6
+- U+3001 to U+3003
+- U+FF5F to U+FF65
+- U+05F3 and U+05F4
+- U+17D8 to U+17DA
+- U+3008 to U+3011
## Examples
The following code example demonstrates .
@@ -3109,34 +3178,103 @@ The following code example demonstrates .
: `ConnectorPunctuation`, `DashPunctuation`, `OpenPunctuation`, `ClosePunctuation`, `InitialQuotePunctuation`, `FinalQuotePunctuation`, or `OtherPunctuation`. They include characters with the Unicode code points listed in the following table.
-
-|||||
-|-|-|-|-|
-|U+0021 to U+0023|U+060C and U+060D|U+1800 to U+180A|U+3014 to U+301F|
-|U+0025 to U+002A|U+061B|U+1944 and U+1945|U+3030|
-|U+002C to U+002F|U+061E and U+061F|U+19DE and U+19DF|U+303D|
-|U+003A and U+003B|U+066A to U+066D|U+1A1E and U+1A1F|U+30A0|
-|U+003F and U+0040|U+06D4|U+1B5A to U+1B60|U+30FB|
-|U+005B to U+005D|U+0700 to U+070D|U+2010 to U+2027|U+A874 to U+A877|
-|U+005F|U+07F7 to U+07F9|U+2030 to U+2043|U+FD3E and U+FD3F|
-|U+007B|U+0964 and U+0965|U+2045 to U+2051|U+FE10 to U+FE19|
-|U+007D|U+0970|U+2053 to U+205E|U+FE30 to U+FE52|
-|U+00A1|U+0DF4|U+207D and U+207E|U+FE54 to U+FE61|
-|U+00AB|U+0E4F to U+0E5B|U+208D and U+208E|U+FE63|
-|U+00AD|U+0F04 to U+0F12|U+2329 and U+232A|U+FE68|
-|U+00B7|U+0F3A to U+0F3D|U+2768 to U+2775|U+FE6A and U+FE6B|
-|U+00BB|U+0F85|U+27C5 to U+27C6|U+FF01 to U+FF03|
-|U+00BF|U+0FD0 and U+0FD1|U+27E6 to U+27EB|U+FF05 to U+FF0A|
-|U+037E|U+104A to U+104F|U+2983 to U+2998|U+FF0C to U+FF0F|
-|U+0387|U+10FB|U+29D8 to U+29DB|U+FF1A and U+FF1B|
-|U+055A to U+055F|U+1361 to U+1368|U+29FC and U+29FD|U+FF1F and U+FF20|
-|U+0589 and U+058A|U+166D and U+166E|U+2CF9 to U+2CFC|U+FF3B to U+FF3D|
-|U+05BE|U+169B and U+169C|U+2CFE and U+2CFF|U+FF3F|
-|U+05C0|U+16EB to U+16ED|U+2E00 to U+2E17|U+FF5B|
-|U+05C3|U+1735 and U+1736|U+2E1C and U+2E1D|U+FF5D|
-|U+05C6|U+17D4 to U+17D6|U+3001 to U+3003|U+FF5F to U+FF65|
-|U+05F3 and U+05F4|U+17D8 to U+17DA|U+3008 to U+3011||
+ Valid punctuation marks are members of the following categories in : `ConnectorPunctuation`, `DashPunctuation`, `OpenPunctuation`, `ClosePunctuation`, `InitialQuotePunctuation`, `FinalQuotePunctuation`, or `OtherPunctuation`. They include characters with the following Unicode code points:
+
+- U+0021 to U+0023
+- U+060C and U+060D
+- U+1800 to U+180A
+- U+3014 to U+301F
+- U+0025 to U+002A
+- U+061B
+- U+1944 and U+1945
+- U+3030
+- U+002C to U+002F
+- U+061E and U+061F
+- U+19DE and U+19DF
+- U+303D
+- U+003A and U+003B
+- U+066A to U+066D
+- U+1A1E and U+1A1F
+- U+30A0
+- U+003F and U+0040
+- U+06D4
+- U+1B5A to U+1B60
+- U+30FB
+- U+005B to U+005D
+- U+0700 to U+070D
+- U+2010 to U+2027
+- U+A874 to U+A877
+- U+005F
+- U+07F7 to U+07F9
+- U+2030 to U+2043
+- U+FD3E and U+FD3F
+- U+007B
+- U+0964 and U+0965
+- U+2045 to U+2051
+- U+FE10 to U+FE19
+- U+007D
+- U+0970
+- U+2053 to U+205E
+- U+FE30 to U+FE52
+- U+00A1
+- U+0DF4
+- U+207D and U+207E
+- U+FE54 to U+FE61
+- U+00AB
+- U+0E4F to U+0E5B
+- U+208D and U+208E
+- U+FE63
+- U+00AD
+- U+0F04 to U+0F12
+- U+2329 and U+232A
+- U+FE68
+- U+00B7
+- U+0F3A to U+0F3D
+- U+2768 to U+2775
+- U+FE6A and U+FE6B
+- U+00BB
+- U+0F85
+- U+27C5 to U+27C6
+- U+FF01 to U+FF03
+- U+00BF
+- U+0FD0 and U+0FD1
+- U+27E6 to U+27EB
+- U+FF05 to U+FF0A
+- U+037E
+- U+104A to U+104F
+- U+2983 to U+2998
+- U+FF0C to U+FF0F
+- U+0387
+- U+10FB
+- U+29D8 to U+29DB
+- U+FF1A and U+FF1B
+- U+055A to U+055F
+- U+1361 to U+1368
+- U+29FC and U+29FD
+- U+FF1F and U+FF20
+- U+0589 and U+058A
+- U+166D and U+166E
+- U+2CF9 to U+2CFC
+- U+FF3B to U+FF3D
+- U+05BE
+- U+169B and U+169C
+- U+2CFE and U+2CFF
+- U+FF3F
+- U+05C0
+- U+16EB to U+16ED
+- U+2E00 to U+2E17
+- U+FF5B
+- U+05C3
+- U+1735 and U+1736
+- U+2E1C and U+2E1D
+- U+FF5D
+- U+05C6
+- U+17D4 to U+17D6
+- U+3001 to U+3003
+- U+FF5F to U+FF65
+- U+05F3 and U+05F4
+- U+17D8 to U+17DA
+- U+3008 to U+3011
]]>
@@ -3204,34 +3342,103 @@ The following code example demonstrates .
## Remarks
Character positions in a string are indexed starting from zero.
- Valid punctuation marks are members of the following categories in : `ConnectorPunctuation`, `DashPunctuation`, `OpenPunctuation`, `ClosePunctuation`, `InitialQuotePunctuation`, `FinalQuotePunctuation`, or `OtherPunctuation`. They include characters with the Unicode code points listed in the following table.
-
-|||||
-|-|-|-|-|
-|U+0021 to U+0023|U+060C and U+060D|U+1800 to U+180A|U+3014 to U+301F|
-|U+0025 to U+002A|U+061B|U+1944 and U+1945|U+3030|
-|U+002C to U+002F|U+061E and U+061F|U+19DE and U+19DF|U+303D|
-|U+003A and U+003B|U+066A to U+066D|U+1A1E and U+1A1F|U+30A0|
-|U+003F and U+0040|U+06D4|U+1B5A to U+1B60|U+30FB|
-|U+005B to U+005D|U+0700 to U+070D|U+2010 to U+2027|U+A874 to U+A877|
-|U+005F|U+07F7 to U+07F9|U+2030 to U+2043|U+FD3E and U+FD3F|
-|U+007B|U+0964 and U+0965|U+2045 to U+2051|U+FE10 to U+FE19|
-|U+007D|U+0970|U+2053 to U+205E|U+FE30 to U+FE52|
-|U+00A1|U+0DF4|U+207D and U+207E|U+FE54 to U+FE61|
-|U+00AB|U+0E4F to U+0E5B|U+208D and U+208E|U+FE63|
-|U+00AD|U+0F04 to U+0F12|U+2329 and U+232A|U+FE68|
-|U+00B7|U+0F3A to U+0F3D|U+2768 to U+2775|U+FE6A and U+FE6B|
-|U+00BB|U+0F85|U+27C5 to U+27C6|U+FF01 to U+FF03|
-|U+00BF|U+0FD0 and U+0FD1|U+27E6 to U+27EB|U+FF05 to U+FF0A|
-|U+037E|U+104A to U+104F|U+2983 to U+2998|U+FF0C to U+FF0F|
-|U+0387|U+10FB|U+29D8 to U+29DB|U+FF1A and U+FF1B|
-|U+055A to U+055F|U+1361 to U+1368|U+29FC and U+29FD|U+FF1F and U+FF20|
-|U+0589 and U+058A|U+166D and U+166E|U+2CF9 to U+2CFC|U+FF3B to U+FF3D|
-|U+05BE|U+169B and U+169C|U+2CFE and U+2CFF|U+FF3F|
-|U+05C0|U+16EB to U+16ED|U+2E00 to U+2E17|U+FF5B|
-|U+05C3|U+1735 and U+1736|U+2E1C and U+2E1D|U+FF5D|
-|U+05C6|U+17D4 to U+17D6|U+3001 to U+3003|U+FF5F to U+FF65|
-|U+05F3 and U+05F4|U+17D8 to U+17DA|U+3008 to U+3011||
+ Valid punctuation marks are members of the following categories in : `ConnectorPunctuation`, `DashPunctuation`, `OpenPunctuation`, `ClosePunctuation`, `InitialQuotePunctuation`, `FinalQuotePunctuation`, or `OtherPunctuation`. They include characters with the following Unicode code points:
+
+- U+0021 to U+0023
+- U+060C and U+060D
+- U+1800 to U+180A
+- U+3014 to U+301F
+- U+0025 to U+002A
+- U+061B
+- U+1944 and U+1945
+- U+3030
+- U+002C to U+002F
+- U+061E and U+061F
+- U+19DE and U+19DF
+- U+303D
+- U+003A and U+003B
+- U+066A to U+066D
+- U+1A1E and U+1A1F
+- U+30A0
+- U+003F and U+0040
+- U+06D4
+- U+1B5A to U+1B60
+- U+30FB
+- U+005B to U+005D
+- U+0700 to U+070D
+- U+2010 to U+2027
+- U+A874 to U+A877
+- U+005F
+- U+07F7 to U+07F9
+- U+2030 to U+2043
+- U+FD3E and U+FD3F
+- U+007B
+- U+0964 and U+0965
+- U+2045 to U+2051
+- U+FE10 to U+FE19
+- U+007D
+- U+0970
+- U+2053 to U+205E
+- U+FE30 to U+FE52
+- U+00A1
+- U+0DF4
+- U+207D and U+207E
+- U+FE54 to U+FE61
+- U+00AB
+- U+0E4F to U+0E5B
+- U+208D and U+208E
+- U+FE63
+- U+00AD
+- U+0F04 to U+0F12
+- U+2329 and U+232A
+- U+FE68
+- U+00B7
+- U+0F3A to U+0F3D
+- U+2768 to U+2775
+- U+FE6A and U+FE6B
+- U+00BB
+- U+0F85
+- U+27C5 to U+27C6
+- U+FF01 to U+FF03
+- U+00BF
+- U+0FD0 and U+0FD1
+- U+27E6 to U+27EB
+- U+FF05 to U+FF0A
+- U+037E
+- U+104A to U+104F
+- U+2983 to U+2998
+- U+FF0C to U+FF0F
+- U+0387
+- U+10FB
+- U+29D8 to U+29DB
+- U+FF1A and U+FF1B
+- U+055A to U+055F
+- U+1361 to U+1368
+- U+29FC and U+29FD
+- U+FF1F and U+FF20
+- U+0589 and U+058A
+- U+166D and U+166E
+- U+2CF9 to U+2CFC
+- U+FF3B to U+FF3D
+- U+05BE
+- U+169B and U+169C
+- U+2CFE and U+2CFF
+- U+FF3F
+- U+05C0
+- U+16EB to U+16ED
+- U+2E00 to U+2E17
+- U+FF5B
+- U+05C3
+- U+1735 and U+1736
+- U+2E1C and U+2E1D
+- U+FF5D
+- U+05C6
+- U+17D4 to U+17D6
+- U+3001 to U+3003
+- U+FF5F to U+FF65
+- U+05F3 and U+05F4
+- U+17D8 to U+17DA
+- U+3008 to U+3011
]]>
From a87be4abdcdb90aaba1301cda924511d3fe7ffe4 Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Thu, 19 Dec 2024 21:17:31 -0800
Subject: [PATCH 2/2] oopsies
---
xml/System.Xml/XmlValidatingReader.xml | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/xml/System.Xml/XmlValidatingReader.xml b/xml/System.Xml/XmlValidatingReader.xml
index b4474c51243..97d3b093579 100644
--- a/xml/System.Xml/XmlValidatingReader.xml
+++ b/xml/System.Xml/XmlValidatingReader.xml
@@ -830,8 +830,8 @@
## Examples
The following example uses the `ResolveEntity` method to expand a general entity.
- [!code-cpp[Classic WebData XmlValidatingReader.ResolveEntity Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.ResolveEntity Example/CPP/sour| [!code-cpp[Classic WebData XmlValidatingReader.ResolveEntity Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.ResolveEntity Example/CPP/source.cpp#1)] |
-|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|cs#1)]
+[!code-cpp[Classic WebData XmlValidatingReader.ResolveEntity Example#1](~/snippets/cpp/VS_Snippets_Data/Classic WebData XmlValidatingReader.ResolveEntity Example/CPP/source.cpp#1)]
+ [!code-csharp[Classic WebData XmlValidatingReader.ResolveEntity Example#1](~/snippets/csharp/System.Xml/XmlValidatingReader/EntityHandling/source.cs#1)]
[!code-vb[Classic WebData XmlValidatingReader.ResolveEntity Example#1](~/snippets/visualbasic/VS_Snippets_Data/Classic WebData XmlValidatingReader.ResolveEntity Example/VB/source.vb#1)]
The example uses the file, `book1.xml`, as input.
| |