XmlNodeReader Třída

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Zdroj:

XmlNodeReader.cs

Představuje čtenáře, který poskytuje rychlý, dopředný přístup pouze k datům XML bez mezipaměti 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 je soubor XML načten do dokumentu XML a upraven. Dokument XML se předá do objektu XmlNodeReader, který se pak předá XmlReader.Create metodě . Když ověřující čtenář analyzuje soubor, 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 publisher není deklarován.

Poznámky

Poznámka

Místo použití XmlNodeReadernástroje doporučujeme vytvářet XmlReader instance pomocí XmlReaderSettings třídy a Create metody . To vám umožní využít výhod kontroly shody a dodržování předpisů s doporučením 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 však vytvořit XmlReader objekt, který obtéká kolem objektu XmlNodeReader a ověří data uložená v objektu XmlNodeReader , jak je znázorněno v části Příklady.

Konstruktory

XmlNodeReader(XmlNode)

Vytvoří instanci XmlNodeReader třídy pomocí zadané XmlNodetřídy .

Vlastnosti

AttributeCount	Získá počet atributů na aktuálním uzlu.
BaseURI	Získá základní identifikátor URI aktuálního uzlu.
CanReadBinaryContent	Získá hodnotu označující, zda XmlNodeReader implementuje metody čtení binárního obsahu.
CanReadValueChunk	Získá hodnotu označující, zda XmlReader implementuje metodu ReadValueChunk(Char[], Int32, Int32) . (Zděděno od XmlReader)
CanResolveEntity	Získá hodnotu označující, zda tento čtenář může analyzovat a řešit entity.
Depth	Získá hloubku aktuálního uzlu v dokumentu XML.
EOF	Získá hodnotu označující, zda je čtečka umístěna na konci datového proudu.
HasAttributes	Získá hodnotu označující, zda má aktuální uzel nějaké atributy.
HasValue	Získá hodnotu označující, zda aktuální uzel může mít .Value
IsDefault	Získá hodnotu označující, zda aktuální uzel je atribut, který byl vygenerován z výchozí hodnoty definované v definici typu dokumentu (DTD) nebo schématu.
IsEmptyElement	Získá hodnotu označující, <MyElement/>zda je aktuální uzel prázdný prvek (například ).
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ými 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 Nameparametrem . (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ů (jak je definováno ve specifikaci oboru názvů W3C) uzlu, na kterém je umístěn čtenář.
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 uvozovek, který se používá 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á Common Language Runtime (CLR) typ 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

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é nástrojem XmlReader a volitelně uvolní spravované prostředky. (Zděděno od XmlReader)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetAttribute(Int32)	Získá hodnotu atributu se zadaným indexem.
GetAttribute(String)	Získá hodnotu atributu se zadaným názvem.
GetAttribute(String, String)	Získá hodnotu atributu se zadaným místním názvem a identifikátorem URI oboru názvů.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
GetValueAsync()	Asynchronně získá hodnotu aktuálního uzlu. (Zděděno od XmlReader)
IsStartElement()	Zavolá MoveToContent() a otestuje, jestli je aktuální uzel obsahu značkou Start nebo prázdnou značkou elementu. (Zděděno od XmlReader)
IsStartElement(String)	Zavolá MoveToContent() a otestuje, jestli je aktuální uzel obsahu značkou start nebo prázdnou značkou elementu a jestli Name vlastnost nalezeného prvku odpovídá danému argumentu. (Zděděno od XmlReader)
IsStartElement(String, String)	Zavolá MoveToContent() a otestuje, jestli je aktuální uzel obsahu značkou start nebo prázdnou značkou elementu a jestli LocalNameNamespaceURI nalezené vlastnosti elementu odpovídají zadaným řetězcům. (Zděděno od XmlReader)
LookupNamespace(String)	Přeloží předponu oboru názvů v oboru aktuálního prvku.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MoveToAttribute(Int32)	Přesune se na atribut se zadaným indexem.
MoveToAttribute(String)	Přesune se na atribut se zadaným názvem.
MoveToAttribute(String, String)	Přesune se na atribut se zadaným místním názvem a identifikátorem URI oboru názvů.
MoveToContent()	Zkontroluje, jestli je aktuálním uzlem obsah (text bez prázdných znaků, CDATA, Element, EndElement, EntityReferencenebo EndEntity). 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, Whitespacenebo SignificantWhitespace. (Zděděno od XmlReader)
MoveToContentAsync()	Asynchronně zkontroluje, jestli je aktuální uzel obsahovým uzlem. 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 uzel aktuálního atributu.
MoveToFirstAttribute()	Přesune se na první atribut.
MoveToNextAttribute()	Přesune se na další atribut.
Read()	Načte další uzel ze streamu.
ReadAsync()	Asynchronně přečte další uzel z datového proudu. (Zděděno od XmlReader)
ReadAttributeValue()	Parsuje hodnotu atributu do jednoho nebo více Textuzlů , EntityReferencenebo EndEntity .
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í binární bajty dekódované base64.
ReadContentAsBase64Async(Byte[], Int32, Int32)	Asynchronně přečte obsah a vrátí binární bajty dekódované Base64. (Zděděno od XmlReader)
ReadContentAsBinHex(Byte[], Int32, Int32)	Přečte obsah a vrátí binární dekódované binární bajty BinHex.
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í desetinou čárkou s dvojitou přesností. (Zděděno od XmlReader)
ReadContentAsFloat()	Přečte textový obsah na aktuální pozici jako číslo s plovoucí desetinou čárkou s jednoduchou přesností. (Zděděno od XmlReader)
ReadContentAsInt()	Přečte textový obsah na aktuální pozici jako 32bitové celé číslo se signedýmm systémem. (Zděděno od XmlReader)
ReadContentAsLong()	Čte textový obsah na aktuální pozici jako 64bitové celé číslo se signedýmm systémem. (Zděděno od XmlReader)
ReadContentAsObject()	Přečte textový obsah na aktuální pozici jako Object. (Zděděno od XmlReader)
ReadContentAsObjectAsync()	Asynchronně přeč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ě čte textový obsah na aktuální pozici jako String objekt. (Zděděno od XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver)	Přečte obsah elementu jako požadovaný typ. (Zděděno od XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Zkontroluje, jestli zadaný místní název a identifikátor URI oboru názvů odpovídá identifikátoru URI aktuálního elementu, a pak přečte obsah elementu jako požadovaný typ. (Zděděno od XmlReader)
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)	Asynchronně přečte obsah elementu jako požadovaný typ. (Zděděno od XmlReader)
ReadElementContentAsBase64(Byte[], Int32, Int32)	Čte element 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)	Č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, jestli zadaný místní název a identifikátor URI oboru názvů odpovídá identifikátoru URI aktuálního elementu, a pak načte aktuální element 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, jestli zadaný místní název a identifikátor URI oboru názvů odpovídá identifikátoru URI aktuálního elementu, a pak načte aktuální element 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, jestli zadaný místní název a identifikátor URI oboru názvů odpovídá identifikátoru URI aktuálního elementu, a pak načte aktuální element a vrátí obsah jako Decimal objekt. (Zděděno od XmlReader)
ReadElementContentAsDouble()	Načte aktuální prvek a vrátí obsah jako číslo s plovoucí desetinou čárkou s dvojitou přesností. (Zděděno od XmlReader)
ReadElementContentAsDouble(String, String)	Zkontroluje, že zadaný místní název a identifikátor URI oboru názvů odpovídá identifikátoru URI aktuálního elementu, pak přečte aktuální prvek a vrátí obsah jako číslo s dvojitou přesností s plovoucí desetinnou čárkou. (Zděděno od XmlReader)
ReadElementContentAsFloat()	Načte aktuální prvek a vrátí obsah jako číslo s plovoucí desetinou čárkou s jednoduchou přesností. (Zděděno od XmlReader)
ReadElementContentAsFloat(String, String)	Zkontroluje, jestli zadaný místní název a identifikátor URI oboru názvů a oboru názvů odpovídá identifikátoru URI aktuálního elementu, pak načte aktuální prvek a vrátí obsah jako číslo s plovoucí desetinnou čárkou s jednou přesností. (Zděděno od XmlReader)
ReadElementContentAsInt()	Načte aktuální prvek a vrátí obsah jako 32bitové celé číslo se signoumi sadou. (Zděděno od XmlReader)
ReadElementContentAsInt(String, String)	Zkontroluje, jestli zadaný místní název a identifikátor URI oboru názvů odpovídá identifikátoru URI aktuálního elementu, a pak přečte aktuální prvek a vrátí obsah jako 32bitové celé číslo se signedoumchm. (Zděděno od XmlReader)
ReadElementContentAsLong()	Načte aktuální prvek a vrátí obsah jako 64bitové celé číslo se signoummi sadou. (Zděděno od XmlReader)
ReadElementContentAsLong(String, String)	Zkontroluje, že zadaný místní název a identifikátor URI oboru názvů odpovídá identifikátoru URI aktuálního elementu, pak načte aktuální prvek a vrátí obsah jako 64bitové celé číslo se signedýmm. (Zděděno od XmlReader)
ReadElementContentAsObject()	Načte aktuální prvek a vrátí obsah jako Object. (Zděděno od XmlReader)
ReadElementContentAsObject(String, String)	Zkontroluje, jestli zadaný místní název a identifikátor URI oboru názvů odpovídá identifikátoru URI aktuálního elementu, a pak načte aktuální element 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, jestli zadaný místní název a identifikátor URI oboru názvů odpovídá identifikátoru URI aktuálního elementu, a pak načte aktuální element 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()	Čte prvek pouze textu. Doporučujeme však místo toho použít metodu ReadElementContentAsString() , protože poskytuje jednodušší způsob zpracování této operace. (Zděděno od XmlReader)
ReadElementString(String)	Kontroluje, zda Name vlastnost nalezeného prvku odpovídá danému řetězci před čtením elementu pouze textu. Doporučujeme však místo toho použít metodu ReadElementContentAsString() , protože poskytuje jednodušší způsob zpracování této operace. (Zděděno od XmlReader)
ReadElementString(String, String)	Kontroluje, zda LocalName vlastnosti a NamespaceURI nalezeného elementu odpovídají zadaným řetězcům před čtením elementu pouze textu. Doporučujeme však místo toho použít metodu ReadElementContentAsString(String, String) , protože poskytuje jednodušší způsob zpracování této operace. (Zděděno od XmlReader)
ReadEndElement()	Zkontroluje, že aktuální uzel obsahu je koncová značka, a posune č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ě značek, jako řetězec. (Zděděno od XmlReader)
ReadInnerXmlAsync()	Asynchronně přečte veškerý obsah, včetně značek, jako řetězec. (Zděděno od XmlReader)
ReadOuterXml()	Při přepsání v odvozené třídě přečte obsah, včetně značek, 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ě kódu, představující tento uzel a všechny jeho podřízené položky. (Zděděno od XmlReader)
ReadStartElement()	Zkontroluje, že aktuální uzel je prvek, a posune čtenáře na další uzel. (Zděděno od XmlReader)
ReadStartElement(String)	Zkontroluje, že aktuální uzel obsahu je prvek s daným Name a posune čtenáře na další uzel. (Zděděno od XmlReader)
ReadStartElement(String, String)	Zkontroluje, že aktuální uzel obsahu je prvek s daným LocalName a a NamespaceURI posune č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)	Přejde na XmlReader další následný prvek se zadaným kvalifikovaným názvem. (Zděděno od XmlReader)
ReadToDescendant(String, String)	Přejde na XmlReader další následný prvek se zadaným místním názvem a identifikátorem URI oboru názvů. (Zděděno od XmlReader)
ReadToFollowing(String)	Čte, dokud se nenajde prvek se zadaným kvalifikovaným názvem. (Zděděno od XmlReader)
ReadToFollowing(String, String)	Čte, dokud se nenajde element se zadaným místním názvem a identifikátorem URI oboru názvů. (Zděděno od XmlReader)
ReadToNextSibling(String)	Přejde na XmlReader další prvek na stejné hodnotě se zadaným kvalifikovaným názvem. (Zděděno od XmlReader)
ReadToNextSibling(String, String)	Přejde na XmlReader 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)
ReadValueChunk(Char[], Int32, Int32)	Čte velké proudy textu vloženého do dokumentu XML. (Zděděno od XmlReader)
ReadValueChunkAsync(Char[], Int32, Int32)	Asynchronně čte velké proudy textu vložené do dokumentu XML. (Zděděno od XmlReader)
ResolveEntity()	Řeší referenční informace k entitám 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í

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