XML System.Xml [00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ] 1.0.5000.0 2.0.0.0 4.0.0.0 All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe. System.Xml.XmlReader Mono.Xml.IHasXmlParserContext System.Xml.IXmlLineInfo System.Xml.IXmlNamespaceResolver

In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

provides forward-only, read-only access to a stream of XML data. The current node refers to the node on which the reader is positioned. The reader is advanced using any of the read methods and properties reflect the value of the current node.

This class implements and conforms to the W3C Extensible Markup Language (XML) 1.0 and the Namespaces in XML recommendations. XmlTextReader provides the following functionality:

Enforces the rules of well-formed XML.

XmlTextReader does not provide data validation.

Checks that DocumentType nodes are well-formed. XmlTextReader checks the DTD for well-formedness, but does not validate using the DTD.

For nodes where is XmlNodeType.EntityReference, a single empty EntityReference node is returned (that is, the property is String.Empty).

The actual declarations of entities in the DTD are called Entity nodes. When you refer to these nodes in your data, they are called EntityReference nodes.

Does not expand default attributes.

Because the XmlTextReader does not perform the extra checks required for data validation, it provides a fast well-formedness parser.

To perform data validation, use a validating . For more information, see Validating XML Data with XmlReader.

To read XML data from an , use .

XmlTextReader 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.

For further discussion on the XmlReader classes, see Reading XML with the XmlReader.

## Security Considerations

The following are things to consider when using the class.

Exceptions thrown the can disclose path information that you do not want bubbled up to the application. Your applications must catch exceptions and process them appropriately.

DTD processing is enabled by default. Disable DTD processing if you are concerned about Denial of Service issues or if you are dealing with untrusted sources. Set the property to to disable DTD processing.

If you have DTD processing enabled, you can use the to restrict the resources that the can access. You can also design your application so that the XML processing is memory and time constrained. For example, configure time-out limits in your ASP.NET application.

XML data can include references to external resources such as a DTD file. By default external resources are resolved using an object with no user credentials. You can secure this further by doing one of the following:

Restrict the resources that the can access by setting the property to an object.

Do not allow the to open any external resources by setting the property to null.

XML data can contain a large number of attributes, namespace declarations, nested elements and so on that require a substantial amount of time to process. To limit the size of the input that is sent to the , create a custom IStream implementation and supply it the .

The method can be used to handle large streams of data. This method reads a small number of characters at a time instead of allocating a single string for the whole value.

By default general entities are not expanded. General entities are expanded when you call the method.

Represents a reader that provides fast, non-cached, forward-only access to XML data.

- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  To be added.

  Initializes a new instance of the XmlTextReader.

  0
- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  is .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  The decodes the stream using .

  Initializes a new instance of the class with the specified stream.

  The stream containing the XML data to read.
  0
- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  It is assumed that the TextReader is already set to the correct encoding. This is used by clients that have already read some things from the stream in a multi-part MIME scenario.

  Initializes a new instance of the class with the specified .

  The TextReader containing the XML data to read.
  0
- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  is .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  If the file is located on a resource that requires access credentials, use the property to specify the necessary credentials.

  In version 1.1 of the dnprdnshort, partially trusted code cannot set the XmlResolver property. The workaround is to create an with the necessary credentials, pass the URI to the method, and then construct the XmlTextReader using the resulting object. The workaround is described in the following C# code.

  // Create a resolver with the necessary credentials. XmlUrlResolver resolver = new XmlUrlResolver(); NetworkCredential nc = new NetworkCredential(SecurelyStoredUserName, SecurelyStoredPassword, SecurelyStoredDomain); resolver.Credentials = nc; // Get a Stream object containing the XML file. Uri myUri = new Uri ("http://myServer/data/books.xml"); Stream s=(Stream)resolver.GetEntity(myUri, null, typeof(Stream)); // Construct a reader using the Stream object. XmlTextReader reader = new XmlTextReader(s);

  Initializes a new instance of the class with the specified file.

  The URL for the file containing the XML data. The is set to this value.
  0
- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  is .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Initializes a new instance of the class with the specified .

  The XmlNameTable to use.
  0
- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  or is .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  The decodes the stream using .

  If you specify a name table, this constructor uses the names defined already in that table.

  Initializes a new instance of the class with the specified stream and .

  The stream containing the XML data to read.
  The XmlNameTable to use.
  0
- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  is .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  It is assumed that the TextReader is already set to the correct encoding. This is used by clients that have already read some things from the stream in a multi-part MIME scenario.

  Initializes a new instance of the class with the specified and .

  The TextReader containing the XML data to read.
  The XmlNameTable to use.
  0
- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  is .
  The stream containing the XML data to read.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Initializes a new instance of the class with the specified URL and stream.

  The URL to use for resolving external resources. The is set to this value.
  The stream containing the XML data to read.
  0
- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  The TextReader containing the XML data to read.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  It is assumed that the TextReader is already set to the correct encoding. This is used by clients that have already read some things from the stream in a multi-part MIME scenario.

  Initializes a new instance of the class with the specified URL and .

  The URL to use for resolving external resources. The is set to this value.
  The TextReader containing the XML data to read.
  0
- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  is .
  is .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Initializes a new instance of the class with the specified file and .

  The URL for the file containing the XML data to read.
  The XmlNameTable to use.
  0
- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  is .
  is not an , , or .
  The of the XML fragment. This also determines what the fragment can contain. (See table below.)
  The in which the is to be parsed. This includes the to use, encoding, namespace scope, the current xml:lang, and the xml:space scope.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  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 .

  XmlNodeType

  Fragment May Contain

  Element

  Any valid element content (for example, any combination of elements, comments, processing instructions, CDATA sections, text, and entity references).

  An XML declaration can also be supplied. This allows you to specify the encoding for the XML fragment, rather than having to set it on the object.

  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 to determine the encoding of the stream.

  Checks the property to determine the encoding.

  If the Encoding property is null, the reader checks for a byte-order mark at the beginning of the stream.

  If the Encoding property is null, and no byte-order mark is found, the reader assumes the stream is encoded in UTF-8.

  Initializes a new instance of the class with the specified stream, , and .

  The stream containing the XML fragment to parse.
  The of the XML fragment. This also determines what the fragment can contain. (See table below.)
  The in which the is to be parsed. This includes the to use, encoding, namespace scope, the current xml:lang, and the xml:space scope.
  0
- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  or is .
  The URL to use for resolving external resources. The is set to this value. If is null, BaseURI is set to String.Empty.
  The XmlNameTable to use.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Initializes a new instance of the class with the specified URL, stream and .

  The URL to use for resolving external resources. The is set to this value. If is null, BaseURI is set to String.Empty.
  The stream containing the XML data to read.
  The XmlNameTable to use.
  0
- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  is .
  The TextReader containing the XML data to read.
  The XmlNameTable to use.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  It is assumed that the TextReader is already set to the correct encoding. This is used by clients that have already read some things from the stream in a multi-part MIME scenario.

  Initializes a new instance of the class with the specified URL, and .

  The URL to use for resolving external resources. The is set to this value. If is null, BaseURI is set to String.Empty.
  The TextReader containing the XML data to read.
  The XmlNameTable to use.
  0
- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  is .
  is not an , , or .
  The of the XML fragment. This also determines what the fragment string can contain. (See table below.)
  The in which the is to be parsed. This includes the to use, encoding, namespace scope, the current xml:lang, and the xml:space scope.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  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 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 sections, text, and entity references).

  An XML declaration can also be supplied. This allows you to specify the encoding for the XML fragment, rather than having to set it on the object.

  Attribute

  The value of an attribute (the part inside the quotes).

  Document

  The contents of an entire XML document. This enforces document level rules.

  Initializes a new instance of the class with the specified string, , and .

  The string containing the XML fragment to parse.
  The of the XML fragment. This also determines what the fragment string can contain. (See table below.)
  The in which the is to be parsed. This includes the to use, encoding, namespace scope, the current xml:lang, and the xml:space scope.
  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Int32

  A containing the number of attributes on the current node, or zero if the current node does not support attributes.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  This property is relevant to Element, DocumentType and XmlDeclaration nodes only. (Other node types do not have attributes.)

  Gets the number of attributes on the current node.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String

  The base URI of the current node.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  A networked XML document is comprised of chunks of data aggregated using various W3C standard inclusion mechanisms and therefore contains nodes that come from different places. 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.

  Gets the base URI of the current node.

  0
- Property
  2.0.0.0
  4.0.0.0
  System.Boolean To be added.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  The binary content read methods include the , , , and methods.

  Gets a value indicating whether the implements the binary content read methods.

- Property
  2.0.0.0
  4.0.0.0
  System.Boolean To be added.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  The throws a if the method is called.

  Gets a value indicating whether the implements the method.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean To be added.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  This is a change in the dnprdnext release. In previous versions, the XmlTextReader class could not resolve entities and CanResolveEntity always returned false.

  Gets a value indicating whether this reader can parse and resolve entities.

- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Void

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  This method also releases any resources held while reading. If this reader was constructed using a stream, this method also calls Close on the underlying stream.

  If Close has already been called, no action is performed.

  Changes the to Closed.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Int32

  A containing the depth of the current node in the XML document.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Gets the depth of the current node in the XML document.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Text.Encoding

  If the is , a ; otherwise .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  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 <?xml sequence to different byte values than UTF-8.

  Gets the encoding of the document.

  0
- Property
  2.0.0.0
  4.0.0.0
  System.Xml.EntityHandling To be added.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  This property can be changed on the fly 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:

  `<!DOCTYPE doc [<!ENTITY num "123">]> <doc> &#65; &num; </doc>`

  When EntityHandling is set to ExpandEntities the "doc" element node contains one text node with the expanded entity text:

  Depth

  Node type

  Name

  Value

  1

  Text

  A 123

  When EntityHandling is set to ExpandCharEntites, and 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

  Gets or sets a value that specifies how the reader handles entities.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean

  A where indicates the reader is positioned at the end of the stream; otherwise, .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Gets a value indicating whether the reader is positioned at the end of the stream.

  0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String `` is less than 0, or greater than or equal to the of the containing element.

  returns zero for all node types except , , , and . Therefore, this exception is thrown if the reader is not positioned on one of these node types.

  See the (, ) method for an example using all three overloads of this method.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  This method does not move the reader.

  Gets the value of the attribute with the specified index.

  The value of the specified attribute.

  The index of the attribute. The index is zero-based. (The first attribute has index 0.) 0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String ``

  See the (, ) method for an example using all three overloads of this method.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  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")

  Gets the value of the attribute with the specified name.

  The value of the specified attribute. If the attribute is not found, null is returned.

  The qualified name of the attribute. 0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String `` ``

  This example writes the value of the attributes from the following XML fragment to the console:

  <test xmlns:dt="urn:datatypes" dt:type="int"/>

  The second attribute value is retrieved using all three overloads of this method.

  `using System; using System.Xml; public class Reader { public static void Main() { string xmlFragment = @"<test xmlns:dt=""urn:datatypes"" dt:type=""int""/>"; NameTable nameTable = new NameTable(); XmlNamespaceManager xmlNsMan = new XmlNamespaceManager(nameTable); XmlParserContext xmlPContext = new XmlParserContext(null, xmlNsMan, null, XmlSpace.None); XmlTextReader xmlTReader = new XmlTextReader(xmlFragment,XmlNodeType.Element, xmlPContext); xmlTReader.Read(); Console.WriteLine( "{0}", xmlTReader.GetAttribute(0) ); string str1 = xmlTReader.GetAttribute(1); string str2 = xmlTReader.GetAttribute("dt:type"); string str3 = xmlTReader.GetAttribute("type", "urn:datatypes"); Console.WriteLine("{0} - {1} - {2}", str1, str2, str3); } }`

  The output is

  urn:datatypes

  int - int - int

  The namespace URI of the attribute.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  The following XML contains an attribute in a specific namespace:

  `<test xmlns:dt="urn:datatypes" dt:type="int"/>`

  You can lookup the dt:type attribute using one argument (prefix and local name) or two arguments (local name and namespace URI):

  `String dt = reader.GetAttribute("dt:type"); String dt2 = reader.GetAttribute("type","urn:datatypes");`

  To lookup the xmlns:dt attribute, use one of the following arguments:

  `String dt3 = reader.GetAttribute("xmlns:dt"); String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);`

  You can also get this information using the property.

  Gets the value of the attribute with the specified local name and namespace URI.

  The value of the specified attribute. If the attribute is not found, null is returned. This method does not move the reader.

  The local name of the attribute. The namespace URI of the attribute. 0
- Method
  2.0.0.0
  4.0.0.0
  System.Collections.Generic.IDictionary<System.String,System.String> ``

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  The dictionary consists of a collection of namespace names keyed by prefix. It can be used to enumerate the in-scope namespaces. The dictionary is a disconnected copy of the namespace list of the reader. It remains unchanged as the reader position, current in-scope namespace list, changes.

  The following table describes how the enumeration value affects the whether or not the default and built-in namespaces are returned by .

  XmlNamespaceScope Value

  xmlns:xml

  xmlns:xmlns

  xmlns=""

  All

  yes

  no

  no

  ExcludeXml

  no

  no

  no

  Local

  no

  no

  yes

  Gets a collection that contains all namespaces currently in-scope.

  An object that contains all the current in-scope namespaces. If the reader is not positioned on an element, an empty dictionary (no namespaces) is returned.

  An value that specifies the type of namespace nodes to return.
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.IO.TextReader

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Because does a buffered Read, it must be able to return the remainder of the unused buffer so that no data is lost. This allows protocols (such as multi-part MIME) to package XML in the same stream as other things.

  After calling this method, is set to true.

  Gets the remainder of the buffered XML.

  A containing the remainder of the buffered XML.

  0
- Method
  2.0.0.0
  4.0.0.0
  System.Boolean

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Gets a value indicating whether the class can return line information.

  true if the class can return line information; otherwise, false.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean

  A where indicates the node on which the reader is currently positioned can have an associated text value; otherwise, .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  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.

  Gets a value indicating whether the current node can have a other than String.Empty.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean

  This property always returns the value .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  This property applies only to attribute nodes.

  Gets a value indicating whether the current node is an attribute that was generated from the default value defined in the DTD or schema.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean

  A where indicates the current node is an element ( equals ) that ends with "/>"; otherwise,.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  This property enables you to determine the difference between the following:

  <item num="123"/> (IsEmptyElement is true).

  <item num="123"> (IsEmptyElement is false, although element content is empty).

  A corresponding EndElement node is not generated for empty elements.

  IsEmptyElement simply reports whether or not the element in the source document had an end element tag.

  Gets a value indicating whether the current node is an empty element (for example, <MyElement/>).

  0
- Property
  System.String `` A specifying the zero-based index of the attribute relative to the containing element.

  Retrieves the value of the attribute with the specified index relative to the containing element.

  A containing the value of the attribute.

  This property is read-only.

  This property does not move the reader.

  This property overrides the indexer.

  is less than 0 or greater than or equal to the of the containing element.

  returns zero for all node types except , , , and . Therefore, this exception is thrown if the reader is not positioned on one of these node types.

  0
  1.0.5000.0
  2.0.0.0
- Property
  System.String `` A specifying the qualified name of the attribute.

  Retrieves the value of the attribute with the specified qualified name.

  A containing the value of the specified attribute, or if the attribute is not found.

  This property is read-only.

  This property does not move the reader.

  If the reader is positioned on a node, this method can be used to get the PUBLIC and SYSTEM literals.

  This property overrides the indexer.

  0
  1.0.5000.0
  2.0.0.0
- Property
  System.String `` `` To be added. To be added.

  Retrieves the value of the attribute with the specified local name and namespace URI.

  A containing the value of the specified attribute, or if the attribute is not found.

  This property is read-only.

  This property does not move the reader.

  This property overrides the indexer.

  0
  1.0.5000.0
  2.0.0.0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Int32

  A containing the current line number.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  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.

  Gets the current line number.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Int32

  A containing the current line position.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  This property is most commonly used for error reporting, but can be called at any time. The property's starting value is 1.

  The position indicated is the first character of text in the markup.

  `<root> abc<tag/> </root>`

  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.

  Gets the current line position.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String

  A containing the local name of the current node or, for node types that do not have a name (like , , and so on), .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Gets the local name of the current node.

  0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String `` The property of the current instance is and is .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  In the following XML, if the reader is positioned on the href attribute, the prefix a is resolved by calling reader.LookupNamespace("a"). The returned string is urn:456.

  `<root xmlns:a="urn:456"> <item> <ref href="a:b"/> </item> </root>`

  Resolves a namespace prefix in the current element's scope.

  The namespace URI to which the prefix maps or null if no matching prefix is found.

  The prefix whose namespace URI you want to resolve. To match the default namespace, pass an empty string. This string does not have to be atomized. 0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Xml.XmlParserContext To be added. To be added. To be added.
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Void `` is less than 0 or greater than or equal to the of the containing element.

  returns zero for all node types except , , , and . Therefore, this exception is thrown if the reader is not positioned on one of these node types.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Moves to the attribute with the specified index.

  The index of the attribute. 0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean ``

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  After calling MoveToAttribute, the , , and properties reflects the properties of that attribute.

  Moves to the attribute with the specified name.

  true if the attribute is found; otherwise, false. If false, the reader's position does not change.

  The qualified name of the attribute. 0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean `` ``

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  After calling MoveToAttribute, the , , and properties reflects the properties of that attribute.

  Moves to the attribute with the specified local name and namespace URI.

  true if the attribute is found; otherwise, false. If false, the reader's position does not change.

  The local name of the attribute. The namespace URI of the attribute. 0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  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.

  Moves to the element that contains the current attribute node.

  true if the reader is positioned on an attribute (the reader moves to the element that owns the attribute); false if the reader is not positioned on an attribute (the position of the reader does not change).

  0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Moves to the first attribute.

  true if an attribute exists (the reader moves to the first attribute); otherwise, false (the position of the reader does not change).

  0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  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.

  Moves to the next attribute.

  true if there is a next attribute; false if there are no more attributes.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String

  A containing the qualified name of the current node or, for node types that do not have a name (like , , and so on), .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Gets the qualified name of the current node.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean

  A where indicates the reader supports namespaces; otherwise, . The default is .

  When attempting to set the property, the was not .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  This property determines whether the reader supports the W3C Namespaces in XML recommendation located at www.w3.org/TR/REC-xml-names.

  The Namespaces property cannot be set after a read operation has occurred.

  Gets or sets a value indicating whether to do namespace support.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String

  A containing the namespace URI of the current node or, if no namespace URI is associated with the current node, .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  This property is relevant to Element and Attribute nodes only.

  Gets the namespace URI (as defined in the W3C Namespace specification) of the node on which the reader is positioned.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Xml.XmlNameTable

  The used by the current instance.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  All node and attribute names returned from are atomized using the NameTable. When the same name is returned multiple times (for example, Customer), then the same String object is 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.

  Gets the associated with this implementation.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Xml.XmlNodeType

  One of the members of the enumeration representing the type of the current node.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  This property never returns the following XmlNodeType types: Document, DocumentFragment, Entity, EndEntity, or Notation.

  Gets the type of the current node.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean

  A where indicates to normalize; otherwise, . The default is .

  When attempting to set the property, the current instance has been closed.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  This property can be changed at any time and takes effect on the next read operation.

  If the is used to construct an , to normalize attribute values, Normalization must be set to true.

  If Normalization is set to false, this also disables character range checking for numeric entities. As a result, character entities, such as &#0;, are allowed.

  The following describes attribute value normalization:

  For a character reference, append the referenced character to the attribute value.

  For an entity reference, recursively process the replacement text of the entity.

  For a white space character (#x20, #xD, #xA, #x9), append #x20 to the normalized value. (Only a single #x20 is appended for a "#xD#xA" sequence that is part of an external parsed entity or the literal entity value of an internal parsed entity.)

  Process other characters by appending them to the normalized value.

  If the declared value is not CDATA, discard any leading and trailing space (#x20) characters and replace sequences of space (#x20) characters with a single space (#x20) character.

  The XmlTextReader only performs attribute or CDATA normalization. It does not do DTD-specific normalization unless wrapped within an XmlValidatingReader.

  Refer to the W3C XML 1.0 recommendation for further discussion on normalization.

  Gets or sets a value indicating whether to normalize white space and attribute values.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String

  A containing the namespace prefix associated with the current node.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Gets the namespace prefix associated with the current node.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean To be added.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  DTD processing is enabled by default for backwards compatibility. However, unless your application requires DTD processing, you should disable this setting. Disabling DTD processing can be useful in preventing certain denial of service attacks. If set to true, the reader throws an when any DTD content is encountered.

  If you have DTD processing enabled, you need to be aware of including DTDs from untrusted sources and possible denial of service attacks. Use the to restrict the resources that the can access. You can also design your application so that the XML processing is memory and time constrained. For example, configure time-out limits in your ASP.NET application

  For more information, see Security and Your System.Xml Applications.

  Gets or sets a value indicating whether to allow DTD processing. This property is obsolete. Use instead.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Char

  A specifying the quotation mark character (" or ') used to enclose the value of an attribute.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  This property applies only to an attribute node.

  Gets the quotation mark character used to enclose the value of an attribute node.

  0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean An error occurred while parsing the XML.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  When a reader is first created and initialized, there is no information available. You must call Read to read the first node.

  This method requires at least four bytes from the data stream in order to begin parsing. If fewer than four bytes are returned and there is no more data in the stream, the method will fail. If there is more data in the stream, the method will block parsing until receipt of the fourth byte.

  Reads the next node from the stream.

  true if the next node was read successfully; false if there are no more nodes to read.

  0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Use this method after calling MoveToAttribute 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; it increments and decrements by one when you step into and out of general entity references.

  Parses the attribute value into one or more Text, EntityReference, or EndEntity nodes.

  true if there are nodes to return.

  false 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 true with a single node with a value of String.Empty.

  0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Int32 `` `` `` is .

  < 0, or < 0.

  - or -

  > . - .

  The Base64 sequence is not valid. The zero-based index into the array specifying where the method can begin to write to the buffer.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Like , this method can be called successively to read large streams of embedded text. It decodes Base64 content and returns the decoded binary bytes (for example, an inline Base64 encoded GIF image) into the buffer. See RFC 1521. (You can obtain RFCs from the Request for Comments Web site at http://www.rfc-editor.org)

  Decodes Base64 and returns the decoded binary bytes.

  The number of bytes written to the buffer.

  The array of characters that serves as the buffer to which the text contents are written. The zero-based index into the array specifying where the method can begin to write to the buffer. The number of bytes to write into the buffer. 0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Int32 `` `` `` is .

  < 0, or < 0.

  -or-

  > . - .

  The BinHex sequence is not valid. The zero-based index into the array specifying where the method can begin to write to the buffer.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Like , this method can be called successively to read large streams of embedded text. It decodes BinHex content and returns the decoded binary bytes (for example, an inline BinHex encoded GIF image) into the buffer.

  Decodes BinHex and returns the decoded binary bytes.

  The number of bytes written to your buffer.

  The byte array that serves as the buffer to which the decoded binary bytes are written. The zero-based index into the array specifying where the method can begin to write to the buffer. The number of bytes to write into the buffer. 0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Int32 `` `` ``

  > . - .

  is .

  < 0, or < 0.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  This is the most efficient way to process very large streams of text embedded in an XML document. Rather than allocating large string objects, ReadChars returns text content a buffer at a time. This method is designed to work only on element nodes. Other node types cause ReadChars to return 0.

  In the following XML, if the reader is positioned on the start tag, ReadChars returns test and positions the reader after the end tag.

  `<Item>test</Item>`

  ReadChars has the following functionality:

  This method is designed to work on element nodes only. Other node types cause ReadChars to return 0.

  This method returns the actual character content. There is no attempt to resolve entities, CDATA, or any other markup encountered. ReadChars returns everything between the start tag and the end tag, including markup.

  ReadChars ignores XML markup that is not well-formed. For example, when reading the following XML string <A>1<A>2</A>, ReadChars returns 1<A>2</A>. (It returns markup from the matching element pair and ignores others.)

  This method does not do any normalization.

  When ReadChars has reached the end of the character stream, it returns the value 0 and the reader is positioned after the end tag.

  Attribute read methods are not available while using ReadChars.

  For example, using the following XML:

  `<thing> some text </thing> <item> </item>`

  The reader is positioned on the <item> element at the end of the while loop.

  `if (XmlNodeType.Element == reader.NodeType && "thing" == reader.Name) { while(0 != reader.ReadChars(buffer, 0, 1) { // Do something. // Attribute values are not available at this point. } }`

  Reads the text contents of an element into a character buffer. This method is designed to read large streams of embedded text by calling it successively.

  The number of characters read. This can be 0 if the reader is not positioned on an element or if there is no more text content to return in the current context.

  The array of characters that serves as the buffer to which the text contents are written. The position within where the method can begin writing text contents. The number of characters to write into . 0
- Method
  2.0.0.0
  4.0.0.0
  System.Int32 `` `` ``

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  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 at http://www.rfc-editor.org.

  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, DocumentFragment.

  Reads the content and returns the Base64 decoded binary bytes.

  The number of bytes written to the buffer.

  The buffer into which to copy the resulting text. This value cannot be null. The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method.
- Method
  2.0.0.0
  4.0.0.0
  System.Int32 `` `` ``

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  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.

  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, DocumentFragment.

  Reads the content and returns the BinHex decoded binary bytes.

  The number of bytes written to the buffer.

  The buffer into which to copy the resulting text. This value cannot be null. The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method.
- Method
  2.0.0.0
  4.0.0.0
  System.Int32 `` `` ``

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  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 at http://www.rfc-editor.org.

  This method can only read 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 only be called on element node types.

  If the 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 reads all the text until the end element is encountered. It then reads the end tag node, reads the next node, and then positions itself on the next subsequent node.

  Reads the element and decodes the Base64 content.

  The number of bytes written to the buffer.

  The buffer into which to copy the resulting text. This value cannot be null. The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method.
- Method
  2.0.0.0
  4.0.0.0
  System.Int32 `` `` ``

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  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 only read 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 only be called on element node types.

  If the 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 reads all the text until the end element is encountered. It then reads the end tag node, reads the next node, and then positions itself on the next subsequent node.

  Reads the element and decodes the BinHex content.

  The number of bytes written to the buffer.

  The buffer into which to copy the resulting text. This value cannot be null. The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method.
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Xml.ReadState

  One of the members of the enumeration.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Gets the state of the reader.

  0
- Method
  2.0.0.0
  4.0.0.0
  System.String An invalid operation was attempted. An error occurred while parsing the XML.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  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. It 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.

  Reads the contents of an element or a 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 text node can be either an element or an attribute text node.

- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Void The current instance was constructed with a .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  This method enables you to parse multiple XML documents in a single stream. When you reach the end of an XML document, you can call ResetState to reset the state of the reader in preparation for the next XML document.

  The documents in the stream must share the same encoding. If this is not the case, when ResetState is called an is thrown. (This is a change in behavior from .NET Framework version 1.1 and earlier).

  The following properties are not affected by ResetState.

  Resets the state of the reader to ReadState.Initial.

  0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Void Any call to this method.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  If the reader is positioned on an EntityReference node (XmlNodeType.EntityReference), if is called after calling this method, the entity replacement text is parsed. When the entity replacement text is finished, an EndEntity node is returned to close the entity reference scope.

  After calling this method, if the entity is part of an attribute value, you must call to step into the entity.

  Resolves the entity reference for EntityReference nodes.

  0
- Property
  System.Xml.XmlReaderSettings To be added.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Gets the object used to create this instance.

  2.0.0.0
- Method
  2.0.0.0
  4.0.0.0
  System.Void

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  In the following XML input if the reader is positioned on the <a> node or any of its attributes, calling Skip positions the reader to the <b> node.

  If the reader is positioned on a leaf node already (such as the <x> node or the text node abc), calling Skip is the same as calling .

  `<a name="bob" age="123"> <x/>abc<y/> </a> <b> ... </b>`

  This method checks for well-formed XML.

  Skips the children of the current node.

- Method
  System.Boolean

  This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.

  For a description of this member, see .

  true if and can be provided; otherwise, false.

  1.0.5000.0
- Method
  2.0.0.0
  4.0.0.0
  System.Collections.Generic.IDictionary<System.String,System.String> ``

  This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.

  For a description of this member, see .

  An that contains the current in-scope namespaces.

  An value that specifies the type of namespace nodes to return.
- Method
  2.0.0.0
  4.0.0.0
  System.String `` To be added. To be added.

  For a description of this member, see .

  The prefix that is mapped to the namespace URI; null if the namespace URI is not mapped to a prefix.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String

  A containing the text value of the current node.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Gets the text value of the current node.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Xml.WhitespaceHandling

  One of the members of the enumeration. The default is (returns both significant and insignificant white space).

  The value to be set is not one of the members of the enumeration. When setting the property, the is .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  This property can be changed at any time and takes effect on the next read operation.

  Because the XmlTextReader does not have DTD information available to it, SignificantWhitepsace nodes are only returned within an xml:space='preserve' scope.

  Gets or sets a value that specifies how white space is handled.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String

  A containing the current xml:lang scope.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  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 US English in the root element:

  <root xml:lang="en-us">

  <name>Fred</name>

  </root>

  When the reader is positioned on the name element, you can use this property to find that it is in the scope of a US English xml:lang attribute.

  Gets the current xml:lang scope.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Xml.XmlResolver

  The to use for resolving DTD references.

  If this property is not set, the current instance uses a new instance of the class with default credentials. If this property is set to , any external DTD or entities encountered by the reader are not resolved.

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  The reader uses XmlResolver to resolve the location of the file loaded into the reader and also to resolve DTD references. For example, if your XML included the DOCTYPE declaration, <!DOCTYPE book SYSTEM book.dtd> the reader resolves this external file and ensures that the DTD is well-formed. The reader does not use the DTD for validation.

  This property can be changed at any time and takes effect on the next read operation. If this property is set to null, any external DTD references encountered by the reader are not resolved.

  In version 1.1 of the dnprdnshort, 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.

  Sets the used for resolving DTD references.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Xml.XmlSpace

  One of the members of the enumeration. If no xml:space scope exists, this property defaults to .

  In the dnprdnext release, the recommended practice is to create instances using the method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

  Gets the current xml:space scope.

  0
0