XmlReader Osztály

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlReader.cs

Olyan olvasót jelöl, amely gyors, nem gyorsítótárazott, csak továbbítható hozzáférést biztosít az XML-adatokhoz.

public ref class XmlReader abstract : IDisposable

public abstract class XmlReader : IDisposable

type XmlReader = class
    interface IDisposable

Public MustInherit Class XmlReader
Implements IDisposable

Öröklődés

Object

XmlReader

Származtatott

System.Xml.XmlDictionaryReader

System.Xml.XmlNodeReader

System.Xml.XmlTextReader

System.Xml.XmlValidatingReader

Megvalósítás

IDisposable

Példák

Az alábbi példakód bemutatja, hogyan használható az aszinkron API az XML elemzéséhez.

async Task TestReader(System.IO.Stream stream)
{
    XmlReaderSettings settings = new XmlReaderSettings();
    settings.Async = true;

    using (XmlReader reader = XmlReader.Create(stream, settings))
    {
        while (await reader.ReadAsync())
        {
            switch (reader.NodeType)
            {
                case XmlNodeType.Element:
                    Console.WriteLine("Start Element {0}", reader.Name);
                    break;
                case XmlNodeType.Text:
                    Console.WriteLine("Text Node: {0}",
                             await reader.GetValueAsync());
                    break;
                case XmlNodeType.EndElement:
                    Console.WriteLine("End Element {0}", reader.Name);
                    break;
                default:
                    Console.WriteLine("Other node {0} with value {1}",
                                    reader.NodeType, reader.Value);
                    break;
            }
        }
    }
}

Public Async Function TestReader(stream As System.IO.Stream) As Task
    Dim settings As New XmlReaderSettings()
    settings.Async = True

    Using reader As XmlReader = XmlReader.Create(stream, settings)
        While (Await reader.ReadAsync())
            Select Case (reader.NodeType)
                Case XmlNodeType.Element
                    Console.WriteLine("Start Element {0}", reader.Name)
                Case XmlNodeType.Text
                    Console.WriteLine("Text Node: {0}",
                             Await reader.GetValueAsync())
                Case XmlNodeType.EndElement
                    Console.WriteLine("End Element {0}", reader.Name)
                Case Else
                    Console.WriteLine("Other node {0} with value {1}",
                                    reader.NodeType, reader.Value)
            End Select
        End While
    End Using
End Function

Megjegyzések

Az API-val kapcsolatos további információkért lásd az XmlReader kiegészítő API-megjegyzéseit.

Konstruktorok

Name	Description
XmlReader()	Inicializálja a XmlReader osztály új példányát.

Tulajdonságok

Name	Description
AttributeCount	Ha felül van bírálva egy származtatott osztályban, lekéri az aktuális csomópont attribútumainak számát.
BaseURI	Ha egy származtatott osztályban felül van bírálva, lekéri az aktuális csomópont alap URI-ját.
CanReadBinaryContent	Egy értéket kap, amely jelzi, hogy a XmlReader bináris tartalom olvasási módszereit implementálja-e.
CanReadValueChunk	Egy értéket kap, amely jelzi, hogy a XmlReader metódus implementálva ReadValueChunk(Char[], Int32, Int32) van-e.
CanResolveEntity	Beolvas egy értéket, amely jelzi, hogy az olvasó elemezheti és feloldhatja-e az entitásokat.
Depth	Ha egy származtatott osztályban felül van bírálva, az XML-dokumentumban lekéri az aktuális csomópont mélységét.
EOF	Ha egy származtatott osztályban felül van bírálva, egy értéket kap, amely jelzi, hogy az olvasó a stream végén van-e elhelyezve.
HasAttributes	Beolvas egy értéket, amely jelzi, hogy az aktuális csomópont rendelkezik-e attribútumokkal.
HasValue	Ha egy származtatott osztály felül van bírálva, egy értéket kap, amely jelzi, hogy az aktuális csomópont rendelkezhet-e Value.
IsDefault	Ha felülbírált egy származtatott osztályban, egy értéket kap, amely jelzi, hogy az aktuális csomópont olyan attribútum-e, amely a DTD-ben vagy sémában definiált alapértelmezett értékből lett létrehozva.
IsEmptyElement	Ha egy származtatott osztályban felül van bírálva, egy értéket kap, amely jelzi, hogy az aktuális csomópont üres elem-e (például <MyElement/>).
Item[Int32]	Ha felülbírált egy származtatott osztályban, lekéri az attribútum értékét a megadott indexszel.
Item[String, String]	Ha felül van bírálva egy származtatott osztályban, lekéri az attribútum értékét a megadott LocalName és NamespaceURIa .
Item[String]	Ha felül van bírálva egy származtatott osztályban, lekéri az attribútum értékét a megadott Nameértékkel.
LocalName	Ha felül van bírálva egy származtatott osztályban, lekéri az aktuális csomópont helyi nevét.
Name	Ha felül van bírálva egy származtatott osztályban, lekéri az aktuális csomópont minősített nevét.
NamespaceURI	Ha felül van bírálva egy származtatott osztályban, lekéri annak a csomópontnak a névtér URI-ját (a W3C-névtér specifikációjában meghatározottak szerint), amelyen az olvasó elhelyezve van.
NameTable	Ha felül van bírálva egy származtatott osztályban, a rendszer lekéri az XmlNameTable implementációhoz társítottat.
NodeType	Ha felül van bírálva egy származtatott osztályban, lekéri az aktuális csomópont típusát.
Prefix	Ha felül van bírálva egy származtatott osztályban, lekéri az aktuális csomóponthoz társított névtérelőtagot.
QuoteChar	Ha egy származtatott osztályban felül van bírálva, lekéri az attribútumcsomópont értékének beágyazásához használt idézőjel karaktert.
ReadState	Ha felül van bírálva egy származtatott osztályban, lekéri az olvasó állapotát.
SchemaInfo	Lekéri az aktuális csomóponthoz a sémaérvényesítés eredményeként hozzárendelt sémaadatokat.
Settings	Lekéri a XmlReaderSettings példány létrehozásához XmlReader használt objektumot.
Value	Ha egy származtatott osztályban felül van bírálva, lekéri az aktuális csomópont szöveges értékét.
ValueType	Lekéri az aktuális csomópont common language runtime (CLR) típusát.
XmlLang	Ha felül van bírálva egy származtatott osztályban, lekéri az aktuális xml:lang hatókört.
XmlSpace	Ha felül van bírálva egy származtatott osztályban, lekéri az aktuális xml:space hatókört.

Metódusok

Name	Description
Close()	Ha felül van bírálva egy származtatott osztályban, a következőre ReadStateváltozik: Closed .
Create(Stream, XmlReaderSettings, String)	Létrehoz egy új XmlReader példányt a megadott stream, alap URI és beállítások használatával.
Create(Stream, XmlReaderSettings, XmlParserContext)	Létrehoz egy új XmlReader példányt a megadott stream, beállítások és környezeti információk használatával az elemzéshez.
Create(Stream, XmlReaderSettings)	Létrehoz egy új XmlReader példányt a megadott adatfolyammal és beállításokkal.
Create(Stream)	Létrehoz egy új XmlReader példányt a megadott stream használatával, alapértelmezett beállításokkal.
Create(String, XmlReaderSettings, XmlParserContext)	Létrehoz egy új XmlReader példányt a megadott URI, beállítások és környezeti információk használatával az elemzéshez.
Create(String, XmlReaderSettings)	Új példányt XmlReader hoz létre a megadott URI és beállítások használatával.
Create(String)	Létrehoz egy új XmlReader példányt a megadott URI-val.
Create(TextReader, XmlReaderSettings, String)	Új példányt XmlReader hoz létre a megadott szövegolvasó, beállítások és alapszintű URI használatával.
Create(TextReader, XmlReaderSettings, XmlParserContext)	Új példányt XmlReader hoz létre a megadott szövegolvasó, beállítások és környezetinformációk használatával az elemzéshez.
Create(TextReader, XmlReaderSettings)	Új példányt XmlReader hoz létre a megadott szövegolvasó és -beállítások használatával.
Create(TextReader)	Új példányt XmlReader hoz létre a megadott szövegolvasó használatával.
Create(XmlReader, XmlReaderSettings)	Létrehoz egy új XmlReader példányt a megadott XML-olvasó és -beállítások használatával.
Dispose()	Az osztály aktuális példánya által használt összes erőforrást felszabadítja XmlReader .
Dispose(Boolean)	Felszabadítja a felügyelt erőforrások által XmlReader használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetAttribute(Int32)	Ha felülbírált egy származtatott osztályban, lekéri az attribútum értékét a megadott indexszel.
GetAttribute(String, String)	Ha felül van bírálva egy származtatott osztályban, lekéri az attribútum értékét a megadott LocalName és NamespaceURIa .
GetAttribute(String)	Ha felül van bírálva egy származtatott osztályban, lekéri az attribútum értékét a megadott Nameértékkel.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
GetValueAsync()	Aszinkron módon lekéri az aktuális csomópont értékét.
IsName(String)	Egy értéket ad vissza, amely jelzi, hogy a sztring argumentum érvényes XML-név-e.
IsNameToken(String)	Egy értéket ad vissza, amely jelzi, hogy a sztringargumentum érvényes XML-név jogkivonat-e.
IsStartElement()	Meghívja MoveToContent() és ellenőrzi, hogy az aktuális tartalomcsomópont kezdőcímke vagy üres elemcímke-e.
IsStartElement(String, String)	Meghívja MoveToContent() és ellenőrzi, hogy az aktuális tartalomcsomópont kezdőcímke vagy üres elemcímke-e, és hogy a LocalName talált elem tulajdonságai megegyeznek-e NamespaceURI a megadott sztringekkel.
IsStartElement(String)	Meghívja MoveToContent() és ellenőrzi, hogy az aktuális tartalomcsomópont kezdőcímke vagy üres elemcímke-e, és hogy az Name elem tulajdonsága megegyezik-e a megadott argumentummal.
LookupNamespace(String)	Ha egy származtatott osztályban felül van bírálva, felold egy névtérelőtagot az aktuális elem hatókörében.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MoveToAttribute(Int32)	Ha felülbírált egy származtatott osztályban, a megadott indexet tartalmazó attribútumra lép.
MoveToAttribute(String, String)	Ha felül van bírálva egy származtatott osztályban, a megadott LocalName és NamespaceURIa .
MoveToAttribute(String)	Ha felül van bírálva egy származtatott osztályban, a megadott Nameattribútumra lép.
MoveToContent()	Ellenőrzi, hogy az aktuális csomópont tartalom-e (nem üres szóközCDATA, , , Element, EndElementEntityReferencevagy EndEntity) csomópont. Ha a csomópont nem tartalomcsomópont, az olvasó a következő tartalomcsomópontra vagy a fájl végére ugrik. A következő típusú csomópontokat hagyja ki: ProcessingInstruction, DocumentType, Comment, Whitespacevagy SignificantWhitespace.
MoveToContentAsync()	Aszinkron módon ellenőrzi, hogy az aktuális csomópont tartalomcsomópont-e. Ha a csomópont nem tartalomcsomópont, az olvasó a következő tartalomcsomópontra vagy a fájl végére ugrik.
MoveToElement()	Ha felül van bírálva egy származtatott osztályban, az aktuális attribútumcsomópontot tartalmazó elemre kerül.
MoveToFirstAttribute()	Ha felül van bírálva egy származtatott osztályban, az első attribútumra kerül.
MoveToNextAttribute()	Ha felül van bírálva egy származtatott osztályban, lépjen a következő attribútumra.
Read()	Ha felül van bírálva egy származtatott osztályban, beolvassa a következő csomópontot a streamből.
ReadAsync()	Aszinkron módon beolvassa a következő csomópontot a streamből.
ReadAttributeValue()	Ha egy származtatott osztályban felül van bírálva, az attribútum értékét egy vagy több Text, EntityReferencevagy EndEntity csomópontba elemzi.
ReadContentAs(Type, IXmlNamespaceResolver)	Beolvassa a tartalmat a megadott típusú objektumként.
ReadContentAsAsync(Type, IXmlNamespaceResolver)	Aszinkron módon beolvassa a tartalmat a megadott típusú objektumként.
ReadContentAsBase64(Byte[], Int32, Int32)	Beolvassa a tartalmat, és visszaadja a Base64 dekódolt bináris bájtjait.
ReadContentAsBase64Async(Byte[], Int32, Int32)	Aszinkron módon beolvassa a tartalmat, és visszaadja a Base64 dekódolt bináris bájtjait.
ReadContentAsBinHex(Byte[], Int32, Int32)	Beolvassa a tartalmat, és visszaadja a BinHex dekódolt bináris bájtokat.
ReadContentAsBinHexAsync(Byte[], Int32, Int32)	Aszinkron módon beolvassa a tartalmat, és visszaadja a BinHex dekódolt bináris bájtokat.
ReadContentAsBoolean()	Beolvassa a szöveges tartalmat az aktuális pozícióban Boolean.
ReadContentAsDateTime()	Beolvassa a szöveges tartalmat az aktuális pozícióban objektumként DateTime .
ReadContentAsDateTimeOffset()	Beolvassa a szöveges tartalmat az aktuális pozícióban objektumként DateTimeOffset .
ReadContentAsDecimal()	Beolvassa a szöveges tartalmat az aktuális pozícióban objektumként Decimal .
ReadContentAsDouble()	Az aktuális pozícióban lévő szöveges tartalmat két pontosságú lebegőpontos számként olvassa be.
ReadContentAsFloat()	Az aktuális pozícióban lévő szöveges tartalmat egy pontosságú lebegőpontos számként olvassa be.
ReadContentAsInt()	Az aktuális pozícióban lévő szöveges tartalmat 32 bites aláírt egész számként olvassa be.
ReadContentAsLong()	Az aktuális pozícióban lévő szöveges tartalmat 64 bites aláírt egész számként olvassa be.
ReadContentAsObject()	Beolvassa a szöveges tartalmat az aktuális pozícióban Object.
ReadContentAsObjectAsync()	Aszinkron módon beolvassa a szöveges tartalmat az aktuális pozícióban Object.
ReadContentAsString()	Beolvassa a szöveges tartalmat az aktuális pozícióban objektumként String .
ReadContentAsStringAsync()	Aszinkron módon beolvassa a szöveges tartalmat az aktuális pozícióban objektumként String .
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Ellenőrzi, hogy a megadott helyi név és névtér URI megegyezik-e az aktuális elemével, majd a kért típusként beolvassa az elem tartalmát.
ReadElementContentAs(Type, IXmlNamespaceResolver)	Beolvassa az elem tartalmát a kért típusként.
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)	Aszinkron módon beolvassa az elem tartalmát a kért típusként.
ReadElementContentAsBase64(Byte[], Int32, Int32)	Beolvassa az elemet, és dekódolja a Base64 tartalmat.
ReadElementContentAsBase64Async(Byte[], Int32, Int32)	Aszinkron módon beolvassa az elemet, és dekódolja a Base64 tartalmat.
ReadElementContentAsBinHex(Byte[], Int32, Int32)	Beolvassa az elemet, és dekódolja a BinHex tartalmat.
ReadElementContentAsBinHexAsync(Byte[], Int32, Int32)	Aszinkron módon beolvassa az elemet, és dekódolja a BinHex tartalmat.
ReadElementContentAsBoolean()	Beolvassa az aktuális elemet, és objektumként Boolean adja vissza a tartalmat.
ReadElementContentAsBoolean(String, String)	Ellenőrzi, hogy a megadott helyi név és névtér URI megegyezik-e az aktuális elem nevével, majd beolvassa az aktuális elemet, és objektumként Boolean adja vissza a tartalmat.
ReadElementContentAsDateTime()	Beolvassa az aktuális elemet, és objektumként DateTime adja vissza a tartalmat.
ReadElementContentAsDateTime(String, String)	Ellenőrzi, hogy a megadott helyi név és névtér URI megegyezik-e az aktuális elem nevével, majd beolvassa az aktuális elemet, és objektumként DateTime adja vissza a tartalmat.
ReadElementContentAsDecimal()	Beolvassa az aktuális elemet, és objektumként Decimal adja vissza a tartalmat.
ReadElementContentAsDecimal(String, String)	Ellenőrzi, hogy a megadott helyi név és névtér URI megegyezik-e az aktuális elem nevével, majd beolvassa az aktuális elemet, és objektumként Decimal adja vissza a tartalmat.
ReadElementContentAsDouble()	Beolvassa az aktuális elemet, és dupla pontosságú lebegőpontos számként adja vissza a tartalmat.
ReadElementContentAsDouble(String, String)	Ellenőrzi, hogy a megadott helyi név és névtér URI megegyezik-e az aktuális elemével, majd beolvassa az aktuális elemet, és dupla pontosságú lebegőpontos számként adja vissza a tartalmat.
ReadElementContentAsFloat()	Beolvassa az aktuális elemet, és egy pontosságú lebegőpontos számként adja vissza a tartalmat.
ReadElementContentAsFloat(String, String)	Ellenőrzi, hogy a megadott helyi név és névtér URI megegyezik-e az aktuális elemével, majd beolvassa az aktuális elemet, és egy pontosságú lebegőpontos számként adja vissza a tartalmat.
ReadElementContentAsInt()	Beolvassa az aktuális elemet, és 32 bites aláírt egész számként adja vissza a tartalmat.
ReadElementContentAsInt(String, String)	Ellenőrzi, hogy a megadott helyi név és névtér URI megegyezik-e az aktuális elemével, majd beolvassa az aktuális elemet, és 32 bites aláírt egész számként adja vissza a tartalmat.
ReadElementContentAsLong()	Beolvassa az aktuális elemet, és 64 bites aláírt egész számként adja vissza a tartalmat.
ReadElementContentAsLong(String, String)	Ellenőrzi, hogy a megadott helyi név és névtér URI megegyezik-e az aktuális elemével, majd beolvassa az aktuális elemet, és 64 bites aláírt egész számként adja vissza a tartalmat.
ReadElementContentAsObject()	Beolvassa az aktuális elemet, és visszaadja a tartalmat Object.
ReadElementContentAsObject(String, String)	Ellenőrzi, hogy a megadott helyi név és névtér URI megegyezik-e az aktuális elemével, majd beolvassa az aktuális elemet, és visszaadja a tartalmat Object.
ReadElementContentAsObjectAsync()	Aszinkron módon beolvassa az aktuális elemet, és visszaadja a tartalmat Object.
ReadElementContentAsString()	Beolvassa az aktuális elemet, és objektumként String adja vissza a tartalmat.
ReadElementContentAsString(String, String)	Ellenőrzi, hogy a megadott helyi név és névtér URI megegyezik-e az aktuális elem nevével, majd beolvassa az aktuális elemet, és objektumként String adja vissza a tartalmat.
ReadElementContentAsStringAsync()	Aszinkron módon beolvassa az aktuális elemet, és objektumként String adja vissza a tartalmat.
ReadElementString()	Csak szöveges elemet olvas be. Javasoljuk azonban, hogy inkább a ReadElementContentAsString() metódust használja, mert egyszerűbb módot kínál a művelet kezelésére.
ReadElementString(String, String)	Ellenőrzi, hogy a LocalName talált elem és NamespaceURI tulajdonságok megegyeznek-e a megadott sztringekkel, mielőtt csak szöveges elemet olvas. Javasoljuk azonban, hogy inkább a ReadElementContentAsString(String, String) metódust használja, mert egyszerűbb módot kínál a művelet kezelésére.
ReadElementString(String)	Ellenőrzi, hogy a Name talált elem tulajdonsága megegyezik-e a megadott sztringgel, mielőtt csak szöveges elemet olvas. Javasoljuk azonban, hogy inkább a ReadElementContentAsString() metódust használja, mert egyszerűbb módot kínál a művelet kezelésére.
ReadEndElement()	Ellenőrzi, hogy az aktuális tartalomcsomópont egy végcímke-e, és az olvasót a következő csomópontra lépteti.
ReadInnerXml()	Ha felül van bírálva egy származtatott osztályban, az összes tartalmat, beleértve a korrektúrát is, sztringként olvassa be.
ReadInnerXmlAsync()	Aszinkron módon sztringként olvassa be az összes tartalmat, beleértve a korrektúrát is.
ReadOuterXml()	Ha egy származtatott osztályban felül van bírálva, beolvassa a tartalmat, beleértve a korrektúrát is, amely a csomópontot és annak összes gyermekét jelöli.
ReadOuterXmlAsync()	Aszinkron módon beolvassa a tartalmat, beleértve a korrektúrát is, amely a csomópontot és annak összes gyermekét jelöli.
ReadStartElement()	Ellenőrzi, hogy az aktuális csomópont elem-e, és a következő csomópontra lépteti az olvasót.
ReadStartElement(String, String)	Ellenőrzi, hogy az aktuális tartalomcsomópont egy adott elem, LocalName és NamespaceURI az olvasót a következő csomópontra lépteti.
ReadStartElement(String)	Ellenőrzi, hogy az aktuális tartalomcsomópont egy adott elem, Name és az olvasót a következő csomópontra lépteti.
ReadString()	Ha egy származtatott osztályban felül van bírálva, egy elem vagy szövegcsomópont tartalmát sztringként olvassa be. Javasoljuk azonban, hogy inkább a ReadElementContentAsString metódust használja, mert egyszerűbb módot kínál a művelet kezelésére.
ReadSubtree()	Egy új XmlReader példányt ad vissza, amely az aktuális csomópont és annak összes leszármazottja olvasására használható.
ReadToDescendant(String, String)	A megadott helyi névvel és névtér URI-val továbbviszi a XmlReader következő leszármazott elemet.
ReadToDescendant(String)	A megadott minősített névvel tovább lép a XmlReader következő leszármazottelemre.
ReadToFollowing(String, String)	Addig olvasható, amíg a megadott helyi névvel és névtér URI-val rendelkező elem nem található.
ReadToFollowing(String)	Addig olvasható, amíg a megadott minősített névvel rendelkező elem nem található.
ReadToNextSibling(String, String)	A következő testvérelemre lép a XmlReader megadott helyi névvel és névtér URI-val.
ReadToNextSibling(String)	A megadott minősített névvel tovább lép a XmlReader következő testvérelemre.
ReadValueChunk(Char[], Int32, Int32)	Egy XML-dokumentumba beágyazott nagy szövegfolyamokat olvas be.
ReadValueChunkAsync(Char[], Int32, Int32)	Aszinkron módon beolvassa az XML-dokumentumokba beágyazott nagy szövegfolyamokat.
ResolveEntity()	Ha egy származtatott osztályban felül van bírálva, feloldja a csomópontok entitáshivatkozását EntityReference .
Skip()	Kihagyja az aktuális csomópont gyermekeit.
SkipAsync()	Aszinkron módon kihagyja az aktuális csomópont gyermekeit.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Lásd még

• XML-dokumentumok és -adatok