XmlReader Klas

Definitie

Naamruimte:
System.Xml
Assembly's:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assembly's:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Bron:
XmlReader.cs
Bron:
XmlReader.cs
Bron:
XmlReader.cs
Bron:
XmlReader.cs
Bron:
XmlReader.cs

Vertegenwoordigt een lezer die snelle, niet-in de cache opgeslagen, alleen-doorstuurtoegang biedt tot XML-gegevens.

public ref class XmlReader abstract : IDisposable
public ref class XmlReader abstract
public abstract class XmlReader : IDisposable
public abstract class XmlReader
type XmlReader = class
    interface IDisposable
type XmlReader = class
Public MustInherit Class XmlReader
Implements IDisposable
Public MustInherit Class XmlReader
Overname
Object
XmlReader
Afgeleid
Implementeringen
IDisposable

Voorbeelden

In de volgende voorbeeldcode ziet u hoe u de asynchrone API gebruikt om XML te parseren.

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

Opmerkingen

Zie Aanvullende API-opmerkingen voor XmlReader voor meer informatie over deze API.

Constructors

Name Description
XmlReader()

Initialiseert een nieuw exemplaar van de XmlReader klasse.

Eigenschappen

Name Description
AttributeCount

Wanneer deze wordt overschreven in een afgeleide klasse, haalt u het aantal kenmerken op het huidige knooppunt op.
BaseURI

Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de basis-URI van het huidige knooppunt op.
CanReadBinaryContent

Hiermee wordt een waarde opgehaald die aangeeft of de XmlReader binaire inhoud leesmethoden worden geïmplementeerd.
CanReadValueChunk

Hiermee wordt een waarde opgehaald die aangeeft of de XmlReaderReadValueChunk(Char[], Int32, Int32) methode wordt geïmplementeerd.
CanResolveEntity

Hiermee wordt een waarde opgehaald die aangeeft of deze lezer entiteiten kan parseren en oplossen.
Depth

Wanneer deze wordt overschreven in een afgeleide klasse, wordt de diepte van het huidige knooppunt in het XML-document opgehaald.
EOF

Wanneer deze wordt overschreven in een afgeleide klasse, haalt u een waarde op die aangeeft of de lezer aan het einde van de stream wordt weergegeven.
HasAttributes

Hiermee wordt een waarde opgehaald die aangeeft of het huidige knooppunt kenmerken heeft.
HasValue

Wanneer deze wordt overschreven in een afgeleide klasse, wordt een waarde opgehaald die aangeeft of het huidige knooppunt een Value.
IsDefault

Wanneer deze wordt overschreven in een afgeleide klasse, wordt een waarde opgehaald die aangeeft of het huidige knooppunt een kenmerk is dat is gegenereerd op basis van de standaardwaarde die is gedefinieerd in de DTD of het schema.
IsEmptyElement

Wanneer dit wordt overschreven in een afgeleide klasse, wordt een waarde opgehaald die aangeeft of het huidige knooppunt een leeg element is (bijvoorbeeld <MyElement/>).
Item[Int32]

Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de waarde van het kenmerk op met de opgegeven index.
Item[String, String]

Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de waarde van het kenmerk op met de opgegeven LocalName en NamespaceURI.
Item[String]

Wanneer deze wordt overschreven in een afgeleide klasse, wordt de waarde van het kenmerk opgehaald met de opgegeven Name.
LocalName

Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de lokale naam van het huidige knooppunt op.
Name

Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de gekwalificeerde naam van het huidige knooppunt op.
NamespaceURI

Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de naamruimte-URI (zoals gedefinieerd in de W3C-naamruimtespecificatie) op van het knooppunt waarop de lezer is ingesteld.
NameTable

Wanneer deze wordt overschreven in een afgeleide klasse, wordt de XmlNameTable gekoppeld aan deze implementatie.
NodeType

Wanneer deze wordt overschreven in een afgeleide klasse, wordt het type van het huidige knooppunt opgehaald.
Prefix

Wanneer deze wordt overschreven in een afgeleide klasse, haalt u het voorvoegsel van de naamruimte op dat is gekoppeld aan het huidige knooppunt.
QuoteChar

Wanneer deze wordt overschreven in een afgeleide klasse, haalt u het aanhalingsteken op dat wordt gebruikt om de waarde van een kenmerkknooppunt in te sluiten.
ReadState

Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u de status van de lezer.
SchemaInfo

Haalt de schemagegevens op die zijn toegewezen aan het huidige knooppunt als gevolg van schemavalidatie.
Settings

Hiermee haalt u het XmlReaderSettings object op dat wordt gebruikt om dit XmlReader exemplaar te maken.
Value

Wanneer deze wordt overschreven in een afgeleide klasse, wordt de tekstwaarde van het huidige knooppunt opgehaald.
ValueType

Hiermee wordt het CLR-type (Common Language Runtime) opgehaald voor het huidige knooppunt.
XmlLang

Wanneer deze wordt overschreven in een afgeleide klasse, haalt u het huidige xml:lang bereik op.
XmlSpace

Wanneer deze wordt overschreven in een afgeleide klasse, haalt u het huidige xml:space bereik op.

Methoden

Name Description
Close()

Wanneer deze wordt overschreven in een afgeleide klasse, wijzigt u het ReadState in Closed.
Create(Stream, XmlReaderSettings, String)

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven stream, basis-URI en instellingen.
Create(Stream, XmlReaderSettings, XmlParserContext)

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven stroom, instellingen en contextinformatie voor parseren.
Create(Stream, XmlReaderSettings)

Hiermee maakt u een nieuw XmlReader exemplaar met de opgegeven stream en instellingen.
Create(Stream)

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven stream met standaardinstellingen.
Create(String, XmlReaderSettings, XmlParserContext)

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven URI, instellingen en contextinformatie voor parseren.
Create(String, XmlReaderSettings)

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven URI en instellingen.
Create(String)

Hiermee maakt u een nieuw XmlReader exemplaar met de opgegeven URI.
Create(TextReader, XmlReaderSettings, String)

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven tekstlezer, instellingen en basis-URI.
Create(TextReader, XmlReaderSettings, XmlParserContext)

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven tekstlezer, instellingen en contextinformatie voor parseren.
Create(TextReader, XmlReaderSettings)

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven tekstlezer en -instellingen.
Create(TextReader)

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven tekstlezer.
Create(XmlReader, XmlReaderSettings)

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven XML-lezer en -instellingen.
Dispose()

Alle resources die door het huidige exemplaar van de XmlReader klasse worden gebruikt, worden vrijgegeven.
Dispose(Boolean)

Publiceert de niet-beheerde resources die worden gebruikt door de XmlReader beheerde resources en brengt eventueel de beheerde resources vrij.
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetAttribute(Int32)

Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de waarde van het kenmerk op met de opgegeven index.
GetAttribute(String, String)

Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de waarde van het kenmerk op met de opgegeven LocalName en NamespaceURI.
GetAttribute(String)

Wanneer deze wordt overschreven in een afgeleide klasse, wordt de waarde van het kenmerk opgehaald met de opgegeven Name.
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
GetValueAsync()

Asynchroon haalt de waarde van het huidige knooppunt op.
IsName(String)

Retourneert een waarde die aangeeft of het tekenreeksargument een geldige XML-naam is.
IsNameToken(String)

Retourneert een waarde die aangeeft of het tekenreeksargument een geldig XML-naamtoken is.
IsStartElement()

Roept MoveToContent() aan en test of het huidige inhoudsknooppunt een starttag of lege elementtag is.
IsStartElement(String, String)

Roept MoveToContent() en test of het huidige inhoudsknooppunt een starttag of lege elementtag is en of de LocalName en NamespaceURI eigenschappen van het gevonden element overeenkomen met de opgegeven tekenreeksen.
IsStartElement(String)

Roept MoveToContent() aan en test of het huidige inhoudsknooppunt een starttag of lege elementtag is en of de Name eigenschap van het gevonden element overeenkomt met het opgegeven argument.
LookupNamespace(String)

Wanneer deze wordt overschreven in een afgeleide klasse, wordt een naamruimtevoorvoegsel in het bereik van het huidige element omgezet.
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
MoveToAttribute(Int32)

Wanneer deze wordt overschreven in een afgeleide klasse, gaat u naar het kenmerk met de opgegeven index.
MoveToAttribute(String, String)

Wanneer deze wordt overschreven in een afgeleide klasse, gaat u naar het kenmerk met de opgegeven LocalName en NamespaceURI.
MoveToAttribute(String)

Wanneer deze wordt overschreven in een afgeleide klasse, gaat u naar het kenmerk met de opgegeven Name.
MoveToContent()

Hiermee wordt gecontroleerd of het huidige knooppunt een inhoud (niet-witruimtetekst, CDATA, ElementEndElement, , EntityReferenceof EndEntity) knooppunt is. Als het knooppunt geen inhoudsknooppunt is, gaat de lezer verder naar het volgende inhoudsknooppunt of het einde van het bestand. Hiermee worden knooppunten van het volgende type overgeslagen: ProcessingInstruction, DocumentType, Comment, , Whitespaceof SignificantWhitespace.
MoveToContentAsync()

Asynchroon controleert of het huidige knooppunt een inhoudsknooppunt is. Als het knooppunt geen inhoudsknooppunt is, gaat de lezer verder naar het volgende inhoudsknooppunt of het einde van het bestand.
MoveToElement()

Wanneer deze wordt overschreven in een afgeleide klasse, gaat u naar het element dat het huidige kenmerkknooppunt bevat.
MoveToFirstAttribute()

Wanneer deze wordt overschreven in een afgeleide klasse, gaat u naar het eerste kenmerk.
MoveToNextAttribute()

Wanneer deze wordt overschreven in een afgeleide klasse, gaat u naar het volgende kenmerk.
Read()

Wanneer dit wordt overschreven in een afgeleide klasse, leest u het volgende knooppunt uit de stream.
ReadAsync()

Asynchroon leest het volgende knooppunt uit de stream.
ReadAttributeValue()

Wanneer deze wordt overschreven in een afgeleide klasse, parseert u de kenmerkwaarde in een of meer Text, EntityReferenceof EndEntity knooppunten.
ReadContentAs(Type, IXmlNamespaceResolver)

Leest de inhoud als een object van het opgegeven type.
ReadContentAsAsync(Type, IXmlNamespaceResolver)

De inhoud wordt asynchroon gelezen als een object van het opgegeven type.
ReadContentAsBase64(Byte[], Int32, Int32)

Leest de inhoud en retourneert de met Base64 gedecodeerde binaire bytes.
ReadContentAsBase64Async(Byte[], Int32, Int32)

Asynchroon leest de inhoud en retourneert de met Base64 gedecodeerde binaire bytes.
ReadContentAsBinHex(Byte[], Int32, Int32)

Leest de inhoud en retourneert de BinHex gedecodeerde binaire bytes.
ReadContentAsBinHexAsync(Byte[], Int32, Int32)

Asynchroon leest de inhoud en retourneert de BinHex gedecodeerde binaire bytes.
ReadContentAsBoolean()

Leest de tekstinhoud op de huidige positie als een Boolean.
ReadContentAsDateTime()

Leest de tekstinhoud op de huidige positie als een DateTime object.
ReadContentAsDateTimeOffset()

Leest de tekstinhoud op de huidige positie als een DateTimeOffset object.
ReadContentAsDecimal()

Leest de tekstinhoud op de huidige positie als een Decimal object.
ReadContentAsDouble()

Leest de tekstinhoud op de huidige positie als een drijvendekommagetal met dubbele precisie.
ReadContentAsFloat()

Leest de tekstinhoud op de huidige positie als een drijvendekommagetal met één precisie.
ReadContentAsInt()

Leest de tekstinhoud op de huidige positie als een 32-bits geheel getal dat is ondertekend.
ReadContentAsLong()

Leest de tekstinhoud op de huidige positie als een 64-bits geheel getal dat is ondertekend.
ReadContentAsObject()

Leest de tekstinhoud op de huidige positie als een Object.
ReadContentAsObjectAsync()

Asynchroon leest de tekstinhoud op de huidige positie als een Object.
ReadContentAsString()

Leest de tekstinhoud op de huidige positie als een String object.
ReadContentAsStringAsync()

Asynchroon leest de tekstinhoud op de huidige positie als een String object.
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

Controleert of de opgegeven lokale naam- en naamruimte-URI overeenkomt met die van het huidige element en leest vervolgens de inhoud van het element als het aangevraagde type.
ReadElementContentAs(Type, IXmlNamespaceResolver)

Leest de elementinhoud als het aangevraagde type.
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)

Asynchroon leest de elementinhoud als het aangevraagde type.
ReadElementContentAsBase64(Byte[], Int32, Int32)

Leest het element en ontsleutelt de Base64 inhoud.
ReadElementContentAsBase64Async(Byte[], Int32, Int32)

Asynchroon leest het element en ontsleutelt de Base64 inhoud.
ReadElementContentAsBinHex(Byte[], Int32, Int32)

Leest het element en ontsleutelt de BinHex inhoud.
ReadElementContentAsBinHexAsync(Byte[], Int32, Int32)

Asynchroon leest het element en ontsleutelt de BinHex inhoud.
ReadElementContentAsBoolean()

Leest het huidige element en retourneert de inhoud als een Boolean object.
ReadElementContentAsBoolean(String, String)

Controleert of de opgegeven lokale naam- en naamruimte-URI overeenkomt met die van het huidige element, waarna het huidige element wordt gelezen en de inhoud als een Boolean object wordt geretourneerd.
ReadElementContentAsDateTime()

Leest het huidige element en retourneert de inhoud als een DateTime object.
ReadElementContentAsDateTime(String, String)

Controleert of de opgegeven lokale naam- en naamruimte-URI overeenkomt met die van het huidige element, waarna het huidige element wordt gelezen en de inhoud als een DateTime object wordt geretourneerd.
ReadElementContentAsDecimal()

Leest het huidige element en retourneert de inhoud als een Decimal object.
ReadElementContentAsDecimal(String, String)

Controleert of de opgegeven lokale naam- en naamruimte-URI overeenkomt met die van het huidige element, waarna het huidige element wordt gelezen en de inhoud als een Decimal object wordt geretourneerd.
ReadElementContentAsDouble()

Leest het huidige element en retourneert de inhoud als een drijvendekommagetal met dubbele precisie.
ReadElementContentAsDouble(String, String)

Controleert of de opgegeven lokale naam- en naamruimte-URI overeenkomt met die van het huidige element, waarna het huidige element wordt gelezen en de inhoud wordt geretourneerd als een drijvendekommagetal met dubbele precisie.
ReadElementContentAsFloat()

Leest het huidige element en retourneert de inhoud als drijvendekommagetal met één precisie.
ReadElementContentAsFloat(String, String)

Controleert of de opgegeven lokale naam- en naamruimte-URI overeenkomt met die van het huidige element, waarna het huidige element wordt gelezen en de inhoud wordt geretourneerd als een drijvendekommagetal met één precisie.
ReadElementContentAsInt()

Leest het huidige element en retourneert de inhoud als een 32-bits geheel getal dat is ondertekend.
ReadElementContentAsInt(String, String)

Controleert of de opgegeven lokale naam- en naamruimte-URI overeenkomt met die van het huidige element, waarna het huidige element wordt gelezen en de inhoud wordt geretourneerd als een 32-bits geheel getal dat is ondertekend.
ReadElementContentAsLong()

Leest het huidige element en retourneert de inhoud als een 64-bits geheel getal dat is ondertekend.
ReadElementContentAsLong(String, String)

Controleert of de opgegeven lokale naam- en naamruimte-URI overeenkomt met die van het huidige element, waarna het huidige element wordt gelezen en de inhoud wordt geretourneerd als een 64-bits geheel getal dat is ondertekend.
ReadElementContentAsObject()

Leest het huidige element en retourneert de inhoud als een Object.
ReadElementContentAsObject(String, String)

Controleert of de opgegeven lokale naam- en naamruimte-URI overeenkomt met die van het huidige element, waarna het huidige element wordt gelezen en de inhoud wordt geretourneerd als een Object.
ReadElementContentAsObjectAsync()

Asynchroon leest het huidige element en retourneert de inhoud als een Object.
ReadElementContentAsString()

Leest het huidige element en retourneert de inhoud als een String object.
ReadElementContentAsString(String, String)

Controleert of de opgegeven lokale naam- en naamruimte-URI overeenkomt met die van het huidige element, waarna het huidige element wordt gelezen en de inhoud als een String object wordt geretourneerd.
ReadElementContentAsStringAsync()

Asynchroon leest het huidige element en retourneert de inhoud als een String object.
ReadElementString()

Leest een alleen-tekstelement. U wordt echter aangeraden in plaats daarvan de ReadElementContentAsString() methode te gebruiken, omdat het een eenvoudigere manier biedt om deze bewerking te verwerken.
ReadElementString(String, String)

Controleert of de LocalName en NamespaceURI eigenschappen van het gevonden element overeenkomen met de opgegeven tekenreeksen voordat u een alleen-tekstelement leest. U wordt echter aangeraden in plaats daarvan de ReadElementContentAsString(String, String) methode te gebruiken, omdat het een eenvoudigere manier biedt om deze bewerking te verwerken.
ReadElementString(String)

Controleert of de Name eigenschap van het gevonden element overeenkomt met de opgegeven tekenreeks voordat u een alleen-tekstelement leest. U wordt echter aangeraden in plaats daarvan de ReadElementContentAsString() methode te gebruiken, omdat het een eenvoudigere manier biedt om deze bewerking te verwerken.
ReadEndElement()

Controleert of het huidige inhoudsknooppunt een eindtag is en de lezer naar het volgende knooppunt gaat.
ReadInnerXml()

Wanneer deze wordt overschreven in een afgeleide klasse, leest u alle inhoud, inclusief markeringen, als een tekenreeks.
ReadInnerXmlAsync()

Asynchroon leest alle inhoud, inclusief markeringen, als een tekenreeks.
ReadOuterXml()

Wanneer deze wordt overschreven in een afgeleide klasse, leest u de inhoud, inclusief markeringen, die dit knooppunt en alle onderliggende items vertegenwoordigen.
ReadOuterXmlAsync()

Asynchroon leest de inhoud, inclusief markeringen, die dit knooppunt en alle onderliggende elementen vertegenwoordigen.
ReadStartElement()

Controleert of het huidige knooppunt een element is en de lezer naar het volgende knooppunt gaat.
ReadStartElement(String, String)

Controleert of het huidige inhoudsknooppunt een element is met de opgegeven LocalName en NamespaceURI gaat de lezer naar het volgende knooppunt.
ReadStartElement(String)

Controleert of het huidige inhoudsknooppunt een element is met de opgegeven Name en gaat de lezer naar het volgende knooppunt.
ReadString()

Wanneer deze wordt overschreven in een afgeleide klasse, leest u de inhoud van een element of tekstknooppunt als tekenreeks. U wordt echter aangeraden in plaats daarvan de ReadElementContentAsString methode te gebruiken, omdat het een eenvoudigere manier biedt om deze bewerking te verwerken.
ReadSubtree()

Retourneert een nieuw XmlReader exemplaar dat kan worden gebruikt om het huidige knooppunt en alle onderliggende items ervan te lezen.
ReadToDescendant(String, String)

Hiermee gaat u naar XmlReader het volgende onderliggende element met de opgegeven lokale naam en naamruimte-URI.
ReadToDescendant(String)

Hiermee gaat u naar XmlReader het volgende onderliggende element met de opgegeven gekwalificeerde naam.
ReadToFollowing(String, String)

Wordt gelezen totdat een element met de opgegeven lokale naam en naamruimte-URI wordt gevonden.
ReadToFollowing(String)

Leest totdat een element met de opgegeven gekwalificeerde naam wordt gevonden.
ReadToNextSibling(String, String)

Hiermee gaat u naar XmlReader het volgende element op hetzelfde niveau met de opgegeven lokale naam en naamruimte-URI.
ReadToNextSibling(String)

Hiermee gaat u naar XmlReader het volgende element op hetzelfde niveau met de opgegeven gekwalificeerde naam.
ReadValueChunk(Char[], Int32, Int32)

Hiermee worden grote stromen tekst gelezen die zijn ingesloten in een XML-document.
ReadValueChunkAsync(Char[], Int32, Int32)

Asynchroon leest grote stromen tekst die zijn ingesloten in een XML-document.
ResolveEntity()

Als deze wordt overschreven in een afgeleide klasse, wordt de entiteitsreferentie voor EntityReference knooppunten omgezet.
Skip()

Slaat de onderliggende elementen van het huidige knooppunt over.
SkipAsync()

Slaat asynchroon de onderliggende elementen van het huidige knooppunt over.
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Expliciete interface-implementaties

Name Description
IDisposable.Dispose()

Zie voor een beschrijving van dit lid Dispose().

Van toepassing op

Zie ook