XmlNodeReader Třída

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlNodeReader.cs

Představuje čtečku, která poskytuje rychlý, nepřeposlaný přístup pouze k datům XML v objektu XmlNode.

public ref class XmlNodeReader : System::Xml::XmlReader, System::Xml::IXmlNamespaceResolver

public class XmlNodeReader : System.Xml.XmlReader, System.Xml.IXmlNamespaceResolver

type XmlNodeReader = class
    inherit XmlReader
    interface IXmlNamespaceResolver

Public Class XmlNodeReader
Inherits XmlReader
Implements IXmlNamespaceResolver

Dědičnost

Object

XmlReader

XmlNodeReader

Implementuje

IXmlNamespaceResolver

Příklady

V následujícím příkladu se soubor XML načte do dokumentu XML a upraví se. Dokument XML se předá do objektu XmlNodeReader, který se pak předá metodě XmlReader.Create . Při ověřování čtenáře může soubor analyzovat, může ověřit všechny změny provedené v souboru XML.

using System;
using System.Xml;
using System.Xml.Schema;
using System.IO;

public class Sample {

  public static void Main() {

    // Create and load the XML document.
    XmlDocument doc = new XmlDocument();
    doc.Load("booksSchema.xml");

    // Make changes to the document.
    XmlElement book = (XmlElement) doc.DocumentElement.FirstChild;
    book.SetAttribute("publisher", "Worldwide Publishing");

    // Create an XmlNodeReader using the XML document.
    XmlNodeReader nodeReader = new XmlNodeReader(doc);

    // Set the validation settings on the XmlReaderSettings object.
    XmlReaderSettings settings = new XmlReaderSettings();
    settings.ValidationType = ValidationType.Schema;
    settings.Schemas.Add("urn:bookstore-schema", "books.xsd");
    settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);

   // Create a validating reader that wraps the XmlNodeReader object.
   XmlReader reader = XmlReader.Create(nodeReader, settings);

   // Parse the XML file.
   while (reader.Read());
  }

  // Display any validation errors.
  private static void ValidationCallBack(object sender, ValidationEventArgs e) {
    Console.WriteLine("Validation Error: {0}", e.Message);
  }
}

Imports System.Xml
Imports System.Xml.Schema
Imports System.IO

public class Sample 

  public shared sub Main() 

    ' Create and load the XML document.
    Dim doc as XmlDocument = new XmlDocument()
    doc.Load("booksSchema.xml")

    ' Make changes to the document.
    Dim book as XmlElement
    book = CType(doc.DocumentElement.FirstChild, XmlElement)
    book.SetAttribute("publisher", "Worldwide Publishing")

    ' Create an XmlNodeReader using the XML document.
    Dim nodeReader as XmlNodeReader = new XmlNodeReader(doc)

    ' Set the validation settings on the XmlReaderSettings object.
    Dim settings as XmlReaderSettings = new XmlReaderSettings()
    settings.ValidationType = ValidationType.Schema
    settings.Schemas.Add("urn:bookstore-schema", "books.xsd")
    AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack

    ' Create a validating reader that wraps the XmlNodeReader object.
    Dim reader as XmlReader = XmlReader.Create(nodeReader,settings)
    
    ' Parse the XML file.
    while (reader.Read())
    end while
  end sub

  ' Display any validation errors.
  private shared sub ValidationCallBack(sender as object, e as ValidationEventArgs)
    Console.WriteLine("Validation Error: {0}", e.Message)
  end sub

end class

Jako vstup se používají následující dva soubory XML.

<?xml version='1.0'?>
<bookstore xmlns="urn:bookstore-schema">
  <book genre="autobiography">
    <title>The Autobiography of Benjamin Franklin</title>
    <author>
      <first-name>Benjamin</first-name>
      <last-name>Franklin</last-name>
    </author>
    <price>8.99</price>
  </book>
  <book genre="novel">
    <title>The Confidence Man</title>
    <author>
      <first-name>Herman</first-name>
      <last-name>Melville</last-name>
    </author>
    <price>11.99</price>
  </book>
</bookstore>

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns="urn:bookstore-schema"
    elementFormDefault="qualified"
    targetNamespace="urn:bookstore-schema">

 <xsd:element name="bookstore" type="bookstoreType"/>

 <xsd:complexType name="bookstoreType">
  <xsd:sequence maxOccurs="unbounded">
   <xsd:element name="book"  type="bookType"/>
  </xsd:sequence>
 </xsd:complexType>

 <xsd:complexType name="bookType">
  <xsd:sequence>
   <xsd:element name="title" type="xsd:string"/>
   <xsd:element name="author" type="authorName"/>
   <xsd:element name="price"  type="xsd:decimal"/>
  </xsd:sequence>
  <xsd:attribute name="genre" type="xsd:string"/>
 </xsd:complexType>

 <xsd:complexType name="authorName">
  <xsd:sequence>
   <xsd:element name="first-name"  type="xsd:string"/>
   <xsd:element name="last-name" type="xsd:string"/>
  </xsd:sequence>
 </xsd:complexType>

</xsd:schema>

Výstup:

Chyba ověření: Atribut vydavatele není deklarován.

Poznámky

Note

Místo použití XmlNodeReader, doporučujeme vytvořit XmlReader instance pomocí XmlReaderSettings třídy a Create metody. To vám umožní využít kontrolu shody a dodržování předpisů doporučení XML 1.0.

Má XmlNodeReader schopnost číst podstrom XML DOM. Tato třída nepodporuje definici typu dokumentu (DTD) ani ověřování schématu. Můžete ale vytvořit XmlReader objekt, který se kolem objektu XmlNodeReader zabalí a ověří data uložená v objektu XmlNodeReader , jak je znázorněno v části Příklady.

Konstruktory

Name	Description
XmlNodeReader(XmlNode)	Vytvoří instanci XmlNodeReader třídy pomocí zadaného XmlNode.

Vlastnosti

Name	Description
AttributeCount	Získá počet atributů v aktuálním uzlu.
BaseURI	Získá základní identifikátor URI aktuálního uzlu.
CanReadBinaryContent	Získá hodnotu určující, zda XmlNodeReader implementuje binární obsah read metody.
CanReadValueChunk	Získá hodnotu určující, zda XmlReader implementuje metodu ReadValueChunk(Char[], Int32, Int32) . (Zděděno od XmlReader)
CanResolveEntity	Získá hodnotu označující, zda může tato čtečka analyzovat a překládat entity.
Depth	Získá hloubku aktuálního uzlu v dokumentu XML.
EOF	Získá hodnotu určující, zda je čtenář umístěn na konci datového proudu.
HasAttributes	Získá hodnotu určující, zda aktuální uzel má nějaké atributy.
HasValue	Získá hodnotu určující, zda aktuální uzel může mít Valuehodnotu .
IsDefault	Získá hodnotu určující, zda aktuální uzel je atribut, který byl generován z výchozí hodnoty definované v definici typu dokumentu (DTD) nebo schématu.
IsEmptyElement	Získá hodnotu určující, zda aktuální uzel je prázdný prvek (například <MyElement/>).
Item[Int32]	Při přepsání v odvozené třídě získá hodnotu atributu se zadaným indexem. (Zděděno od XmlReader)
Item[String, String]	Při přepsání v odvozené třídě získá hodnotu atributu se zadaným LocalName a NamespaceURI. (Zděděno od XmlReader)
Item[String]	Při přepsání v odvozené třídě získá hodnotu atributu se zadaným Name. (Zděděno od XmlReader)
LocalName	Získá místní název aktuálního uzlu.
Name	Získá kvalifikovaný název aktuálního uzlu.
NamespaceURI	Získá identifikátor URI oboru názvů (definovaný ve specifikaci oboru názvů W3C) uzlu, na kterém je čtečka umístěna.
NameTable	Získá přidružené k XmlNameTable této implementaci.
NodeType	Získá typ aktuálního uzlu.
Prefix	Získá předponu oboru názvů přidruženou k aktuálnímu uzlu.
QuoteChar	Při přepsání v odvozené třídě získá znak uvozovky použitý k uzavření hodnoty uzlu atributu. (Zděděno od XmlReader)
ReadState	Získá stav čtenáře.
SchemaInfo	Získá informace o schématu, které byly přiřazeny k aktuálnímu uzlu.
Settings	XmlReaderSettings Získá objekt použitý k vytvoření této XmlReader instance. (Zděděno od XmlReader)
Value	Získá text hodnotu aktuálního uzlu.
ValueType	Získá typ CLR (Common Language Runtime) pro aktuální uzel. (Zděděno od XmlReader)
XmlLang	Získá aktuální xml:lang obor.
XmlSpace	Získá aktuální xml:space obor.

Metody

Name	Description
Close()	Změní na ReadStateClosed.
Dispose()	Uvolní všechny prostředky používané aktuální instancí XmlReader třídy. (Zděděno od XmlReader)
Dispose(Boolean)	Uvolní nespravované prostředky používané XmlReader a volitelně uvolní spravované prostředky. (Zděděno od XmlReader)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetAttribute(Int32)	Získá hodnotu atributu se zadaným indexem.
GetAttribute(String, String)	Získá hodnotu atributu se zadaným místním názvem a identifikátorem URI oboru názvů.
GetAttribute(String)	Získá hodnotu atributu se zadaným názvem.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetValueAsync()	Asynchronně získá hodnotu aktuálního uzlu. (Zděděno od XmlReader)
IsStartElement()	Volá MoveToContent() a testuje, jestli je aktuální uzel obsahu počáteční značkou nebo prázdnou značkou elementu. (Zděděno od XmlReader)
IsStartElement(String, String)	Volá MoveToContent() a testuje, zda je aktuální uzel obsahu počáteční značkou nebo prázdnou značkou elementu a pokud nalezené LocalName vlastnosti NamespaceURI odpovídají zadaným řetězcům. (Zděděno od XmlReader)
IsStartElement(String)	Volá MoveToContent() a testuje, zda je aktuální uzel obsahu počáteční značkou nebo prázdnou značkou elementu a pokud Name vlastnost nalezeného prvku odpovídá danému argumentu. (Zděděno od XmlReader)
LookupNamespace(String)	Vyřeší předponu oboru názvů v oboru aktuálního prvku.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MoveToAttribute(Int32)	Přesune se na atribut se zadaným indexem.
MoveToAttribute(String, String)	Přesune se na atribut se zadaným místním názvem a identifikátorem URI oboru názvů.
MoveToAttribute(String)	Přesune se na atribut se zadaným názvem.
MoveToContent()	Zkontroluje, jestli je aktuální uzel obsahem (bez prázdného textu, CDATA, Element, EndElement, EntityReferencenebo EndEntity) uzlu. Pokud uzel není uzel obsahu, čtenář přeskočí dopředu na další uzel obsahu nebo konec souboru. Přeskočí uzly následujícího typu: ProcessingInstruction, DocumentType, Comment, Whitespace, nebo SignificantWhitespace. (Zděděno od XmlReader)
MoveToContentAsync()	Asynchronně zkontroluje, jestli je aktuální uzel uzlem obsahu. Pokud uzel není uzel obsahu, čtenář přeskočí dopředu na další uzel obsahu nebo konec souboru. (Zděděno od XmlReader)
MoveToElement()	Přesune se na prvek, který obsahuje aktuální uzel atributu.
MoveToFirstAttribute()	Přesune se na první atribut.
MoveToNextAttribute()	Přesune se na další atribut.
Read()	Načte další uzel ze streamu.
ReadAsync()	Asynchronně čte další uzel z datového proudu. (Zděděno od XmlReader)
ReadAttributeValue()	Parsuje hodnotu atributu do jednoho nebo více Text, EntityReferencenebo EndEntity uzlů.
ReadContentAs(Type, IXmlNamespaceResolver)	Přečte obsah jako objekt zadaného typu. (Zděděno od XmlReader)
ReadContentAsAsync(Type, IXmlNamespaceResolver)	Asynchronně čte obsah jako objekt zadaného typu. (Zděděno od XmlReader)
ReadContentAsBase64(Byte[], Int32, Int32)	Přečte obsah a vrátí dekódované binární bajty Base64.
ReadContentAsBase64Async(Byte[], Int32, Int32)	Asynchronně přečte obsah a vrátí dekódované binární bajty Base64. (Zděděno od XmlReader)
ReadContentAsBinHex(Byte[], Int32, Int32)	Přečte obsah a vrátí binární bajty dekódované binHexem.
ReadContentAsBinHexAsync(Byte[], Int32, Int32)	Asynchronně přečte obsah a vrátí BinHex dekódované binární bajty. (Zděděno od XmlReader)
ReadContentAsBoolean()	Přečte textový obsah na aktuální pozici jako Boolean. (Zděděno od XmlReader)
ReadContentAsDateTime()	Přečte textový obsah na aktuální pozici jako DateTime objekt. (Zděděno od XmlReader)
ReadContentAsDateTimeOffset()	Přečte textový obsah na aktuální pozici jako DateTimeOffset objekt. (Zděděno od XmlReader)
ReadContentAsDecimal()	Přečte textový obsah na aktuální pozici jako Decimal objekt. (Zděděno od XmlReader)
ReadContentAsDouble()	Přečte textový obsah na aktuální pozici jako číslo s plovoucí desetinnou čárkou s dvojitou přesností. (Zděděno od XmlReader)
ReadContentAsFloat()	Přečte textový obsah na aktuální pozici jako číslo s plovoucí desetinnou čárkou s jednou přesností. (Zděděno od XmlReader)
ReadContentAsInt()	Přečte textový obsah na aktuální pozici jako 32bitové celé číslo se signedm. (Zděděno od XmlReader)
ReadContentAsLong()	Přečte textový obsah na aktuální pozici jako 64bitové celé číslo se signedm. (Zděděno od XmlReader)
ReadContentAsObject()	Přečte textový obsah na aktuální pozici jako .Object (Zděděno od XmlReader)
ReadContentAsObjectAsync()	Asynchronně čte textový obsah na aktuální pozici jako .Object (Zděděno od XmlReader)
ReadContentAsString()	Přečte textový obsah na aktuální pozici jako String objekt. (Zděděno od XmlReader)
ReadContentAsStringAsync()	Asynchronně přečte textový obsah na aktuální pozici jako String objekt. (Zděděno od XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Zkontroluje, zda zadaný místní název a identifikátor URI oboru názvů odpovídá aktuálnímu prvku a pak přečte obsah elementu jako požadovaný typ. (Zděděno od XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver)	Přečte obsah elementu jako požadovaný typ. (Zděděno od XmlReader)
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)	Asynchronně čte obsah elementu jako požadovaný typ. (Zděděno od XmlReader)
ReadElementContentAsBase64(Byte[], Int32, Int32)	Přečte prvek a dekóduje obsah Base64.
ReadElementContentAsBase64Async(Byte[], Int32, Int32)	Asynchronně přečte prvek a dekóduje Base64 obsah. (Zděděno od XmlReader)
ReadElementContentAsBinHex(Byte[], Int32, Int32)	Přečte element a dekóduje obsah BinHex.
ReadElementContentAsBinHexAsync(Byte[], Int32, Int32)	Asynchronně přečte prvek a dekóduje BinHex obsah. (Zděděno od XmlReader)
ReadElementContentAsBoolean()	Přečte aktuální prvek a vrátí obsah jako Boolean objekt. (Zděděno od XmlReader)
ReadElementContentAsBoolean(String, String)	Zkontroluje, zda zadaný místní název a identifikátor URI oboru názvů odpovídá aktuálnímu prvku, pak přečte aktuální prvek a vrátí obsah jako Boolean objekt. (Zděděno od XmlReader)
ReadElementContentAsDateTime()	Přečte aktuální prvek a vrátí obsah jako DateTime objekt. (Zděděno od XmlReader)
ReadElementContentAsDateTime(String, String)	Zkontroluje, zda zadaný místní název a identifikátor URI oboru názvů odpovídá aktuálnímu prvku, pak přečte aktuální prvek a vrátí obsah jako DateTime objekt. (Zděděno od XmlReader)
ReadElementContentAsDecimal()	Přečte aktuální prvek a vrátí obsah jako Decimal objekt. (Zděděno od XmlReader)
ReadElementContentAsDecimal(String, String)	Zkontroluje, zda zadaný místní název a identifikátor URI oboru názvů odpovídá aktuálnímu prvku, pak přečte aktuální prvek a vrátí obsah jako Decimal objekt. (Zděděno od XmlReader)
ReadElementContentAsDouble()	Přečte aktuální prvek a vrátí obsah jako číslo s plovoucí desetinnou čárkou s dvojitou přesností. (Zděděno od XmlReader)
ReadElementContentAsDouble(String, String)	Zkontroluje, zda zadaný místní název a identifikátor URI oboru názvů odpovídá aktuálnímu prvku, pak přečte aktuální prvek a vrátí obsah jako číslo s plovoucí desetinnou čárkou s dvojitou přesností. (Zděděno od XmlReader)
ReadElementContentAsFloat()	Přečte aktuální prvek a vrátí obsah jako číslo s plovoucí desetinnou čárkou s jednoduchou přesností. (Zděděno od XmlReader)
ReadElementContentAsFloat(String, String)	Zkontroluje, zda zadaný místní název a identifikátor URI oboru názvů odpovídá aktuálnímu prvku, pak přečte aktuální prvek a vrátí obsah jako číslo s plovoucí desetinnou čárkou s jednoduchou přesností. (Zděděno od XmlReader)
ReadElementContentAsInt()	Přečte aktuální prvek a vrátí obsah jako 32bitové signed celé číslo. (Zděděno od XmlReader)
ReadElementContentAsInt(String, String)	Zkontroluje, zda zadaný místní název a identifikátor URI oboru názvů odpovídá aktuálnímu prvku, pak přečte aktuální prvek a vrátí obsah jako 32bitové signed integer. (Zděděno od XmlReader)
ReadElementContentAsLong()	Přečte aktuální prvek a vrátí obsah jako 64bitové signed integer. (Zděděno od XmlReader)
ReadElementContentAsLong(String, String)	Zkontroluje, zda zadaný místní název a identifikátor URI oboru názvů odpovídá aktuálnímu prvku, pak přečte aktuální prvek a vrátí obsah jako 64bitové celé číslo se signed. (Zděděno od XmlReader)
ReadElementContentAsObject()	Přečte aktuální prvek a vrátí obsah jako .Object (Zděděno od XmlReader)
ReadElementContentAsObject(String, String)	Zkontroluje, zda zadaný místní název a identifikátor URI oboru názvů odpovídá aktuálnímu prvku, pak přečte aktuální prvek a vrátí obsah jako Object. (Zděděno od XmlReader)
ReadElementContentAsObjectAsync()	Asynchronně přečte aktuální prvek a vrátí obsah jako .Object (Zděděno od XmlReader)
ReadElementContentAsString()	Přečte aktuální prvek a vrátí obsah jako String objekt. (Zděděno od XmlReader)
ReadElementContentAsString(String, String)	Zkontroluje, zda zadaný místní název a identifikátor URI oboru názvů odpovídá aktuálnímu prvku, pak přečte aktuální prvek a vrátí obsah jako String objekt. (Zděděno od XmlReader)
ReadElementContentAsStringAsync()	Asynchronně přečte aktuální prvek a vrátí obsah jako String objekt. (Zděděno od XmlReader)
ReadElementString()	Přečte textový prvek. Místo toho však doporučujeme použít metodu ReadElementContentAsString() , protože poskytuje jednodušší způsob, jak tuto operaci zpracovat. (Zděděno od XmlReader)
ReadElementString(String, String)	Zkontroluje, zda LocalName nalezené prvky a NamespaceURI vlastnosti odpovídají zadaným řetězcům před čtením textového prvku. Místo toho však doporučujeme použít metodu ReadElementContentAsString(String, String) , protože poskytuje jednodušší způsob, jak tuto operaci zpracovat. (Zděděno od XmlReader)
ReadElementString(String)	Zkontroluje, že Name vlastnost nalezeného prvku odpovídá danému řetězci před čtením textového prvku. Místo toho však doporučujeme použít metodu ReadElementContentAsString() , protože poskytuje jednodušší způsob, jak tuto operaci zpracovat. (Zděděno od XmlReader)
ReadEndElement()	Zkontroluje, jestli je aktuální uzel obsahu koncovou značkou a přejde čtenáře na další uzel. (Zděděno od XmlReader)
ReadInnerXml()	Při přepsání v odvozené třídě přečte veškerý obsah, včetně revizí, jako řetězec. (Zděděno od XmlReader)
ReadInnerXmlAsync()	Asynchronně přečte veškerý obsah, včetně revizí, jako řetězec. (Zděděno od XmlReader)
ReadOuterXml()	Při přepsání v odvozené třídě přečte obsah včetně revizí představující tento uzel a všechny jeho podřízené položky. (Zděděno od XmlReader)
ReadOuterXmlAsync()	Asynchronně přečte obsah, včetně revizí, představující tento uzel a všechny jeho podřízené položky. (Zděděno od XmlReader)
ReadStartElement()	Zkontroluje, jestli je aktuální uzel prvkem a přejde čtenáře na další uzel. (Zděděno od XmlReader)
ReadStartElement(String, String)	Zkontroluje, že aktuální uzel obsahu je prvek se zadaným LocalName uzlem a NamespaceURI přejde čtenáře na další uzel. (Zděděno od XmlReader)
ReadStartElement(String)	Zkontroluje, že aktuální uzel obsahu je prvek s daným Name prvkem a přejde čtenáře na další uzel. (Zděděno od XmlReader)
ReadString()	Přečte obsah prvku nebo textového uzlu jako řetězec.
ReadSubtree()	Vrátí novou XmlReader instanci, kterou lze použít ke čtení aktuálního uzlu a všech jeho potomků. (Zděděno od XmlReader)
ReadToDescendant(String, String)	Přejde na XmlReader další potomk element se zadaným místním názvem a identifikátorem URI oboru názvů. (Zděděno od XmlReader)
ReadToDescendant(String)	Přejde na XmlReader další následný prvek se zadaným kvalifikovaným názvem. (Zděděno od XmlReader)
ReadToFollowing(String, String)	Přečte, dokud se nenajde prvek se zadaným místním názvem a identifikátorem URI oboru názvů. (Zděděno od XmlReader)
ReadToFollowing(String)	Přečte, dokud se nenajde prvek se zadaným kvalifikovaným názvem. (Zděděno od XmlReader)
ReadToNextSibling(String, String)	Přejde XmlReader na další prvek na stejné úrovni se zadaným místním názvem a identifikátorem URI oboru názvů. (Zděděno od XmlReader)
ReadToNextSibling(String)	Přejde XmlReader na další prvek na stejné stejné straně se zadaným kvalifikovaným názvem. (Zděděno od XmlReader)
ReadValueChunk(Char[], Int32, Int32)	Čte velké datové proudy textu vložené do dokumentu XML. (Zděděno od XmlReader)
ReadValueChunkAsync(Char[], Int32, Int32)	Asynchronně čte velké datové proudy textu vložené do dokumentu XML. (Zděděno od XmlReader)
ResolveEntity()	Vyřeší odkaz na entitu pro EntityReference uzly.
Skip()	Přeskočí podřízené položky aktuálního uzlu.
SkipAsync()	Asynchronně přeskočí podřízené položky aktuálního uzlu. (Zděděno od XmlReader)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

Name	Description
IXmlNamespaceResolver.GetNamespacesInScope(XmlNamespaceScope)	Popis tohoto člena naleznete v tématu GetNamespacesInScope(XmlNamespaceScope).
IXmlNamespaceResolver.LookupNamespace(String)	Popis tohoto člena naleznete v tématu LookupNamespace(String).
IXmlNamespaceResolver.LookupPrefix(String)	Popis tohoto člena naleznete v tématu LookupPrefix(String).