System::Xml::XmlReader class

XmlReader class

Stellt einen Reader dar, der schnellen, nicht zwischengespeicherten, nur vorwärts gerichteten Zugriff auf XML-Daten bietet.

class XmlReader : public System::IDisposable

Methoden

MethodeBeschreibung
virtual Close()Wenn in einer abgeleiteten Klasse überschrieben, ändert es den XmlReader::get_ReadState zu ReadState::Closed.
static Create(const String&)Erstellt eine neue XmlReader-Instanz mit der angegebenen URI.
static Create(const String&, const SharedPtr<XmlReaderSettings>&)Erstellt eine neue XmlReader-Instanz unter Verwendung der angegebenen URI und Einstellungen.
static Create(const String&, SharedPtr<XmlReaderSettings>, const SharedPtr<XmlParserContext>&)Erstellt eine neue XmlReader-Instanz unter Verwendung der angegebenen URI, Einstellungen und Kontextinformationen zum Parsen.
static Create(const SharedPtr<IO::Stream>&)Erstellt eine neue XmlReader-Instanz mit dem angegebenen Stream und den Standardeinstellungen.
static Create(const SharedPtr<IO::Stream>&, const SharedPtr<XmlReaderSettings>&)Erstellt eine neue XmlReader-Instanz mit dem angegebenen Stream und den Einstellungen.
static Create(const SharedPtr<IO::Stream>&, SharedPtr<XmlReaderSettings>, const String&)Erstellt eine neue XmlReader-Instanz mit dem angegebenen Stream, der Basis-URI und den Einstellungen.
static Create(const SharedPtr<IO::Stream>&, SharedPtr<XmlReaderSettings>, const SharedPtr<XmlParserContext>&)Erstellt eine neue XmlReader-Instanz mit dem angegebenen Stream, den Einstellungen und Kontextinformationen zum Parsen.
static Create(const SharedPtr<IO::TextReader>&)Erstellt eine neue XmlReader-Instanz unter Verwendung des angegebenen Textreaders.
static Create(const SharedPtr<IO::TextReader>&, const SharedPtr<XmlReaderSettings>&)Erstellt eine neue XmlReader-Instanz unter Verwendung des angegebenen Textreaders und der Einstellungen.
static Create(const SharedPtr<IO::TextReader>&, SharedPtr<XmlReaderSettings>, const String&)Erstellt eine neue XmlReader-Instanz unter Verwendung des angegebenen Textreaders, der Einstellungen und der Basis-URI.
static Create(const SharedPtr<IO::TextReader>&, SharedPtr<XmlReaderSettings>, const SharedPtr<XmlParserContext>&)Erstellt eine neue XmlReader-Instanz unter Verwendung des angegebenen Textreaders, der Einstellungen und Kontextinformationen zum Parsen.
static Create(const SharedPtr<XmlReader>&, SharedPtr<XmlReaderSettings>)Erstellt eine neue XmlReader-Instanz unter Verwendung des angegebenen XML-Readers und der Einstellungen.
Dispose() overrideGibt alle von der aktuellen Instanz der XmlReader-Klasse verwendeten Ressourcen frei.
virtual get_AttributeCount()Wird in einer abgeleiteten Klasse überschrieben, gibt die Anzahl der Attribute des aktuellen Knotens zurück.
virtual get_BaseURI()Wird in einer abgeleiteten Klasse überschrieben, gibt die Basis-URI des aktuellen Knotens zurück.
virtual get_CanReadBinaryContent()Gibt einen Wert zurück, der angibt, ob die XmlReader die Methoden zum Lesen binärer Inhalte implementiert.
virtual get_CanReadValueChunk()Gibt einen Wert zurück, der angibt, ob die XmlReader die Methode XmlReader::ReadValueChunk implementiert.
virtual get_CanResolveEntity()Gibt einen Wert zurück, der angibt, ob dieser Leser Entitäten analysieren und auflösen kann.
virtual get_Depth()Wird in einer abgeleiteten Klasse überschrieben, gibt die Tiefe des aktuellen Knotens im XML-Dokument zurück.
virtual get_EOF()Wird in einer abgeleiteten Klasse überschrieben, gibt einen Wert zurück, der angibt, ob der Reader am Ende des Streams positioniert ist.
virtual get_HasAttributes()Gibt einen Wert zurück, der angibt, ob der aktuelle Knoten Attribute hat.
virtual get_HasValue()Wird in einer abgeleiteten Klasse überschrieben, gibt einen Wert zurück, der angibt, ob der aktuelle Knoten einen XmlReader::get_Value-Wert haben kann.
virtual get_IsDefault()Wird in einer abgeleiteten Klasse überschrieben, gibt einen Wert zurück, der angibt, ob der aktuelle Knoten ein Attribut ist, das aus dem in der DTD oder dem Schema definierten Standardwert erzeugt wurde.
virtual get_IsEmptyElement()Wird in einer abgeleiteten Klasse überschrieben, gibt einen Wert zurück, der angibt, ob der aktuelle Knoten ein leeres Element ist (zum Beispiel ).
virtual get_LocalName()Wird in einer abgeleiteten Klasse überschrieben, gibt den lokalen Namen des aktuellen Knotens zurück.
virtual get_Name()Wird in einer abgeleiteten Klasse überschrieben, gibt den qualifizierten Namen des aktuellen Knotens zurück.
virtual get_NamespaceURI()Wird in einer abgeleiteten Klasse überschrieben, gibt die Namespace-URI (wie in der W3C-Namespace-Spezifikation definiert) des Knotens zurück, auf dem der Reader positioniert ist.
virtual get_NameTable()Wenn in einer abgeleiteten Klasse überschrieben, gibt die mit dieser Implementierung verbundene XmlNameTable zurück.
virtual get_NodeType()Wenn in einer abgeleiteten Klasse überschrieben, gibt den Typ des aktuellen Knotens zurück.
virtual get_Prefix()Wenn in einer abgeleiteten Klasse überschrieben, gibt das mit dem aktuellen Knoten verbundene Namespace-Präfix zurück.
virtual get_QuoteChar()Wenn in einer abgeleiteten Klasse überschrieben, gibt das Anführungszeichen‑Zeichen zurück, das zum Einschließen des Werts eines Attributknotens verwendet wird.
virtual get_ReadState()Wenn in einer abgeleiteten Klasse überschrieben, gibt den Zustand des Readers zurück.
virtual get_SchemaInfo()Gibt die Schemainformation zurück, die dem aktuellen Knoten als Ergebnis der Schema‑Validierung zugewiesen wurde.
virtual get_Settings()Gibt das XmlReaderSettings‑Objekt zurück, das verwendet wurde, um diese XmlReader-Instanz zu erstellen.
virtual get_Value()Wenn in einer abgeleiteten Klasse überschrieben, gibt den Textwert des aktuellen Knotens zurück.
virtual get_ValueType()Gibt den Typ des aktuellen Knotens zurück.
virtual get_XmlLang()Wenn in einer abgeleiteten Klasse überschrieben, gibt den aktuellen xml:lang‑Bereich zurück.
virtual get_XmlSpace()Wenn in einer abgeleiteten Klasse überschrieben, gibt den aktuellen xml:space‑Bereich zurück.
virtual GetAttribute(String)Wenn in einer abgeleiteten Klasse überschrieben, gibt den Wert des Attributs mit dem angegebenen XmlReader::get_Name-Wert zurück.
virtual GetAttribute(String, String)Wenn in einer abgeleiteten Klasse überschrieben, gibt den Wert des Attributs mit den angegebenen XmlReader::get_LocalName- und XmlReader::get_NamespaceURI-Werten zurück.
virtual GetAttribute(int32_t)Wenn in einer abgeleiteten Klasse überschrieben, gibt den Wert des Attributs mit dem angegebenen Index zurück.
virtual idx_get(int32_t)Wenn in einer abgeleiteten Klasse überschrieben, gibt den Wert des Attributs mit dem angegebenen Index zurück.
virtual idx_get(String)Wenn in einer abgeleiteten Klasse überschrieben, gibt den Wert des Attributs mit dem angegebenen XmlReader::get_Name-Wert zurück.
virtual idx_get(String, String)Wenn in einer abgeleiteten Klasse überschrieben, gibt den Wert des Attributs mit den angegebenen XmlReader::get_LocalName- und XmlReader::get_NamespaceURI-Werten zurück.
static IsName(const String&)Gibt einen Wert zurück, der angibt, ob das Zeichenkettenargument ein gültiger XML‑Name ist.
static IsNameToken(const String&)Gibt einen Wert zurück, der angibt, ob das Zeichenkettenargument ein gültiges XML‑Namens‑Token ist.
virtual IsStartElement()Ruft XmlReader::MoveToContent auf und prüft, ob der aktuelle Inhaltsknoten ein Start‑Tag oder ein leeres Element‑Tag ist.
virtual IsStartElement(String)Ruft XmlReader::MoveToContent auf und prüft, ob der aktuelle Inhaltsknoten ein Start‑Tag oder ein leeres Element‑Tag ist und ob der XmlReader::get_Name-Wert des gefundenen Elements dem angegebenen Argument entspricht.
virtual IsStartElement(String, String)Ruft XmlReader::MoveToContent auf und prüft, ob der aktuelle Inhaltsknoten ein Start‑Tag oder ein leeres Element‑Tag ist und ob die XmlReader::get_LocalName- und XmlReader::get_NamespaceURI-Werte des gefundenen Elements den angegebenen Zeichenketten entsprechen.
virtual LookupNamespace(const String&)Wenn in einer abgeleiteten Klasse überschrieben, löst ein Namespace‑Präfix im Geltungsbereich des aktuellen Elements auf.
virtual MoveToAttribute(String)Wenn in einer abgeleiteten Klasse überschrieben, wechselt zum Attribut mit dem angegebenen XmlReader::get_Name-Wert.
virtual MoveToAttribute(String, String)Wenn in einer abgeleiteten Klasse überschrieben, wechselt zum Attribut mit den angegebenen XmlReader::get_LocalName- und XmlReader::get_NamespaceURI-Werten.
virtual MoveToAttribute(int32_t)Wenn in einer abgeleiteten Klasse überschrieben, wechselt zum Attribut mit dem angegebenen Index.
virtual MoveToContent()Prüft, ob der aktuelle Knoten ein Inhaltsknoten (nicht‑Leerzeichen‑Text, CDATA, Element, EndElement, EntityReference oder EndEntity) ist. Ist der Knoten kein Inhaltsknoten, springt der Reader zum nächsten Inhaltsknoten oder zum Dateiende. Er überspringt Knoten der folgenden Typen: ProcessingInstruction, DocumentType, Comment, Whitespace oder SignificantWhitespace.
virtual MoveToElement()Wenn in einer abgeleiteten Klasse überschrieben, wechselt zum Element, das den aktuellen Attributknoten enthält.
virtual MoveToFirstAttribute()Wenn in einer abgeleiteten Klasse überschrieben, springt zum ersten Attribut.
virtual MoveToNextAttribute()Wenn in einer abgeleiteten Klasse überschrieben, springt zum nächsten Attribut.
virtual Read()Wenn in einer abgeleiteten Klasse überschrieben, liest den nächsten Knoten aus dem Stream.
virtual ReadAttributeValue()Wenn in einer abgeleiteten Klasse überschrieben, analysiert den Attributwert in einen oder mehrere Text, EntityReference oder EndEntity-Knoten.
virtual ReadContentAs(const TypeInfo&, SharedPtr<IXmlNamespaceResolver>)Liest den Inhalt als ein Objekt des angegebenen Typs.
virtual ReadContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t)Liest den Inhalt und gibt die Base64-dekodierten Binärbytes zurück.
virtual ReadContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t)Liest den Inhalt und gibt die BinHex-dekodierten Binärbytes zurück.
virtual ReadContentAsBoolean()Liest den Textinhalt an der aktuellen Position als ein Boolean.
virtual ReadContentAsDateTime()Liest den Textinhalt an der aktuellen Position als ein DateTime-Objekt.
virtual ReadContentAsDateTimeOffset()Liest den Textinhalt an der aktuellen Position als ein DateTimeOffset-Objekt.
virtual ReadContentAsDecimal()Liest den Textinhalt an der aktuellen Position als ein Decimal-Objekt.
virtual ReadContentAsDouble()Liest den Textinhalt an der aktuellen Position als eine Gleitkommazahl mit doppelter Genauigkeit.
virtual ReadContentAsFloat()Liest den Textinhalt an der aktuellen Position als eine Gleitkommazahl mit einfacher Genauigkeit.
virtual ReadContentAsInt()Liest den Textinhalt an der aktuellen Position als eine 32‑Bit vorzeichenbehaftete Ganzzahl.
virtual ReadContentAsLong()Liest den Textinhalt an der aktuellen Position als eine 64‑Bit vorzeichenbehaftete Ganzzahl.
virtual ReadContentAsObject()Liest den Textinhalt an der aktuellen Position als ein Object.
virtual ReadContentAsString()Liest den Textinhalt an der aktuellen Position als ein String-Objekt.
virtual ReadElementContentAs(const TypeInfo&, SharedPtr<IXmlNamespaceResolver>)Liest den Elementinhalt als den angeforderten Typ.
virtual ReadElementContentAs(const TypeInfo&, SharedPtr<IXmlNamespaceResolver>, String, String)Überprüft, ob der angegebene lokale Name und die Namespace‑URI mit denen des aktuellen Elements übereinstimmen, und liest dann den Elementinhalt als den angeforderten Typ.
virtual ReadElementContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t)Liest das Element und dekodiert den Base64‑Inhalt.
virtual ReadElementContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t)Liest das Element und dekodiert den BinHex-Inhalt.
virtual ReadElementContentAsBoolean()Liest das aktuelle Element und gibt den Inhalt als ein Boolean-Objekt zurück.
virtual ReadElementContentAsBoolean(String, String)Überprüft, ob der angegebene lokale Name und die Namespace‑URI mit denen des aktuellen Elements übereinstimmen, und liest dann das aktuelle Element und gibt den Inhalt als ein Boolean-Objekt zurück.
virtual ReadElementContentAsDateTime()Liest das aktuelle Element und gibt den Inhalt als ein DateTime-Objekt zurück.
virtual ReadElementContentAsDateTime(String, String)Überprüft, ob der angegebene lokale Name und die Namespace‑URI mit denen des aktuellen Elements übereinstimmen, und liest dann das aktuelle Element und gibt den Inhalt als ein DateTime-Objekt zurück.
virtual ReadElementContentAsDecimal()Liest das aktuelle Element und gibt den Inhalt als ein Decimal-Objekt zurück.
virtual ReadElementContentAsDecimal(String, String)Überprüft, ob der angegebene lokale Name und die Namespace‑URI mit denen des aktuellen Elements übereinstimmen, und liest dann das aktuelle Element und gibt den Inhalt als ein Decimal-Objekt zurück.
virtual ReadElementContentAsDouble()Liest das aktuelle Element und gibt den Inhalt als eine Gleitkommazahl mit doppelter Genauigkeit zurück.
virtual ReadElementContentAsDouble(String, String)Überprüft, ob der angegebene lokale Name und die Namespace-URI mit denen des aktuellen Elements übereinstimmen, liest dann das aktuelle Element und gibt den Inhalt als double‑Präzisions‑Gleitkommazahl zurück.
virtual ReadElementContentAsFloat()Liest das aktuelle Element und gibt den Inhalt als single‑Präzisions‑Gleitkommazahl zurück.
virtual ReadElementContentAsFloat(String, String)Überprüft, ob der angegebene lokale Name und die Namespace-URI mit denen des aktuellen Elements übereinstimmen, liest dann das aktuelle Element und gibt den Inhalt als single‑Präzisions‑Gleitkommazahl zurück.
virtual ReadElementContentAsInt()Liest das aktuelle Element und gibt den Inhalt als 32‑Bit‑vorzeichenbehaftete Ganzzahl zurück.
virtual ReadElementContentAsInt(String, String)Überprüft, ob der angegebene lokale Name und die Namespace-URI mit denen des aktuellen Elements übereinstimmen, liest dann das aktuelle Element und gibt den Inhalt als 32‑Bit‑vorzeichenbehaftete Ganzzahl zurück.
virtual ReadElementContentAsLong()Liest das aktuelle Element und gibt den Inhalt als 64‑Bit‑vorzeichenbehaftete Ganzzahl zurück.
virtual ReadElementContentAsLong(String, String)Überprüft, ob der angegebene lokale Name und die Namespace-URI mit denen des aktuellen Elements übereinstimmen, liest dann das aktuelle Element und gibt den Inhalt als 64‑Bit‑vorzeichenbehaftete Ganzzahl zurück.
virtual ReadElementContentAsObject()Liest das aktuelle Element und gibt den Inhalt als ein Object zurück.
virtual ReadElementContentAsObject(String, String)Überprüft, ob der angegebene lokale Name und die Namespace-URI mit denen des aktuellen Elements übereinstimmen, liest dann das aktuelle Element und gibt den Inhalt als ein Object zurück.
virtual ReadElementContentAsString()Liest das aktuelle Element und gibt den Inhalt als ein String-Objekt zurück.
virtual ReadElementContentAsString(String, String)Überprüft, ob der angegebene lokale Name und die Namespace-URI mit denen des aktuellen Elements übereinstimmen, liest dann das aktuelle Element und gibt den Inhalt als ein String-Objekt zurück.
virtual ReadElementString()Liest ein reines Textelement. Es wird jedoch empfohlen, stattdessen die Methode XmlReader::ReadElementContentAsString zu verwenden, da sie eine einfachere Möglichkeit bietet, diesen Vorgang zu handhaben.
virtual ReadElementString(String)Überprüft, ob der Wert XmlReader::get_Name des gefundenen Elements mit dem angegebenen String übereinstimmt, bevor ein reines Textelement gelesen wird. Es wird jedoch empfohlen, stattdessen die Methode XmlReader::ReadElementContentAsString zu verwenden, da sie eine einfachere Möglichkeit bietet, diesen Vorgang zu handhaben.
virtual ReadElementString(String, String)Überprüft, ob die Werte XmlReader::get_LocalName und XmlReader::get_NamespaceURI des gefundenen Elements mit den angegebenen Strings übereinstimmen, bevor ein reines Textelement gelesen wird. Es wird jedoch empfohlen, stattdessen die Methode XmlReader::ReadElementContentAsString zu verwenden, da sie eine einfachere Möglichkeit bietet, diesen Vorgang zu handhaben.
virtual ReadEndElement()Überprüft, ob der aktuelle Inhaltsknoten ein End-Tag ist, und bewegt den Reader zum nächsten Knoten weiter.
virtual ReadInnerXml()Wird in einer abgeleiteten Klasse überschrieben, liest es den gesamten Inhalt, einschließlich Markup, als Zeichenkette.
virtual ReadOuterXml()Wird in einer abgeleiteten Klasse überschrieben, liest es den Inhalt, einschließlich Markup, der diesen Knoten und alle seine Kinder darstellt.
virtual ReadStartElement()Überprüft, ob der aktuelle Knoten ein Element ist, und bewegt den Reader zum nächsten Knoten weiter.
virtual ReadStartElement(String)Überprüft, ob der aktuelle Inhaltsknoten ein Element mit dem angegebenen XmlReader::get_Name-Wert ist, und bewegt den Reader zum nächsten Knoten weiter.
virtual ReadStartElement(String, String)Überprüft, ob der aktuelle Inhaltsknoten ein Element mit den angegebenen XmlReader::get_LocalName- und XmlReader::get_NamespaceURI-Werten ist, und bewegt den Reader zum nächsten Knoten weiter.
virtual ReadString()Wird in einer abgeleiteten Klasse überschrieben, liest es den Inhalt eines Elements oder Textknotens als Zeichenkette. Es wird jedoch empfohlen, stattdessen die Methode XmlReader::ReadElementContentAsString zu verwenden, da sie eine einfachere Möglichkeit bietet, diesen Vorgang zu handhaben.
virtual ReadSubtree()Gibt eine neue XmlReader-Instanz zurück, die zum Lesen des aktuellen Knotens und aller seiner Nachkommen verwendet werden kann.
virtual ReadToDescendant(String)Bewegt den XmlReader zum nächsten Nachkommen-Element mit dem angegebenen qualifizierten Namen weiter.
virtual ReadToDescendant(String, String)Bewegt den XmlReader zum nächsten Nachkommen-Element mit dem angegebenen lokalen Namen und der Namespace-URI weiter.
virtual ReadToFollowing(String)Liest, bis ein Element mit dem angegebenen qualifizierten Namen gefunden wird.
virtual ReadToFollowing(String, String)Liest, bis ein Element mit dem angegebenen lokalen Namen und Namespace-URI gefunden wird.
virtual ReadToNextSibling(String)Verschiebt den XmlReader zum nächsten Geschwisterelement mit dem angegebenen qualifizierten Namen.
virtual ReadToNextSibling(String, String)Verschiebt den XmlReader zum nächsten Geschwisterelement mit dem angegebenen lokalen Namen und Namespace-URI.
virtual ReadValueChunk(ArrayPtr<char16_t>, int32_t, int32_t)Liest große Textströme, die in einem XML-Dokument eingebettet sind.
virtual ResolveEntity()Wird in einer abgeleiteten Klasse überschrieben, löst die Entity-Referenz für EntityReference-Knoten auf.
virtual Skip()Überspringt die Kindknoten des aktuellen Knotens.

Typedefs

TypedefBeschreibung
PtrEin Alias für einen Shared-Pointer auf eine Instanz dieser Klasse.

Siehe auch