System::Xml::XmlTextReader Klasse

XmlTextReader class

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

class XmlTextReader : public System::Xml::XmlReader,
                      public System::Xml::IXmlLineInfo,
                      public System::Xml::IXmlNamespaceResolver

Methoden

Methode	Beschreibung
Close() override	Ändert den XmlReader::get_ReadState auf Closed.
get_AttributeCount() override	Gibt die Anzahl der Attribute des aktuellen Knotens zurück.
get_BaseURI() override	Gibt die Basis‑URI des aktuellen Knotens zurück.
get_CanReadBinaryContent() override	Gibt einen Wert zurück, der angibt, ob der XmlTextReader die Methoden zum Lesen binärer Inhalte implementiert.
get_CanReadValueChunk() override	Gibt einen Wert zurück, der angibt, ob der XmlTextReader die Methode XmlReader::ReadValueChunk implementiert.
get_CanResolveEntity() override	Gibt einen Wert zurück, der angibt, ob dieser Leser Entitäten analysieren und auflösen kann.
get_Depth() override	Gibt die Tiefe des aktuellen Knotens im XML-Dokument zurück.
get_DtdProcessing()	Gibt die Aufzählung DtdProcessing zurück.
get_Encoding()	Gibt die Kodierung des Dokuments zurück.
get_EntityHandling()	Gibt einen Wert zurück, der angibt, wie der Leser Entitäten verarbeitet.
get_EOF() override	Gibt einen Wert zurück, der angibt, ob der Reader am Ende des Streams positioniert ist.
get_HasValue() override	Gibt einen Wert zurück, der angibt, ob der aktuelle Knoten einen XmlTextReader::get_Value haben kann, der nicht String::Empty ist.
get_IsDefault() override	Gibt einen Wert zurück, der angibt, ob der aktuelle Knoten ein Attribut ist, das aus dem im DTD oder Schema definierten Standardwert erzeugt wurde.
get_IsEmptyElement() override	Gibt einen Wert zurück, der angibt, ob der aktuelle Knoten ein leeres Element ist (zum Beispiel, ).
get_LineNumber() override	Gibt die aktuelle Zeilennummer zurück.
get_LinePosition() override	Gibt die aktuelle Zeilenposition zurück.
get_LocalName() override	Gibt den lokalen Namen des aktuellen Knotens zurück.
get_Name() override	Gibt den qualifizierten Namen des aktuellen Knotens zurück.
get_Namespaces()	Gibt einen Wert zurück, der angibt, ob Namespace‑Unterstützung verwendet werden soll.
get_NamespaceURI() override	Gibt die Namespace-URI (wie in der W3C Namespace-Spezifikation definiert) des Knotens zurück, auf dem der Reader positioniert ist.
get_NameTable() override	Gibt die XmlNameTable zurück, die mit dieser Implementierung verknüpft ist.
get_NodeType() override	Gibt den Typ des aktuellen Knotens zurück.
get_Normalization()	Gibt einen Wert zurück, der angibt, ob Leerzeichen und Attributwerte normalisiert werden sollen.
get_Prefix() override	Gibt das Namespace-Präfix zurück, das dem aktuellen Knoten zugeordnet ist.
get_ProhibitDtd()	Gibt einen Wert zurück, der angibt, ob die DTD-Verarbeitung erlaubt werden soll.
get_QuoteChar() override	Gibt das Anführungszeichen zurück, das zum Einschließen des Werts eines Attributknotens verwendet wird.
get_ReadState() override	Gibt den Zustand des Readers zurück.
get_Value() override	Gibt den Textwert des aktuellen Knotens zurück.
get_WhitespaceHandling()	Gibt einen Wert zurück, der angibt, wie Leerzeichen behandelt werden.
get_XmlLang() override	Gibt den aktuellen xml:lang‑Bereich zurück.
get_XmlSpace() override	Gibt den aktuellen xml:space‑Geltungsbereich zurück.
GetAttribute(String) override	Gibt den Wert des Attributs mit dem angegebenen Namen zurück.
GetAttribute(String, String) override	Gibt den Wert des Attributs mit dem angegebenen lokalen Namen und der Namespace-URI zurück.
GetAttribute(int32_t) override	Gibt den Wert des Attributs mit dem angegebenen Index zurück.
GetNamespacesInScope(XmlNamespaceScope) override	Gibt eine Sammlung zurück, die alle derzeit im Gültigkeitsbereich liegenden Namespaces enthält.
GetRemainder()	Gibt den Rest des gepufferten XML zurück.
HasLineInfo() override	Gibt einen Wert zurück, der angibt, ob die Klasse Zeileninformationen zurückgeben kann.
LookupNamespace(const String&) override	Löst ein Namespace-Präfix im Geltungsbereich des aktuellen Elements auf.
MoveToAttribute(String) override	Wechselt zum Attribut mit dem angegebenen Namen.
MoveToAttribute(String, String) override	Wechselt zum Attribut mit dem angegebenen lokalen Namen und der Namespace-URI.
MoveToAttribute(int32_t) override	Wechselt zum Attribut mit dem angegebenen Index.
MoveToElement() override	Wechselt zum Element, das den aktuellen Attributknoten enthält.
MoveToFirstAttribute() override	Wechselt zum ersten Attribut.
MoveToNextAttribute() override	Wechselt zum nächsten Attribut.
Read() override	Liest den nächsten Knoten aus dem Stream.
ReadAttributeValue() override	Parst den Attributwert in ein oder mehrere Text, EntityReference oder EndEntity-Knoten.
ReadBase64(const ArrayPtr<uint8_t>&, int32_t, int32_t)	Dekodiert Base64 und gibt die dekodierten Binärbytes zurück.
ReadBinHex(const ArrayPtr<uint8_t>&, int32_t, int32_t)	Dekodiert BinHex und gibt die dekodierten Binärbytes zurück.
ReadChars(const ArrayPtr<char16_t>&, int32_t, int32_t)	Liest den Textinhalt eines Elements in einen Zeichenpuffer. Diese Methode ist dafür ausgelegt, große Streams eingebetteten Textes durch wiederholtes Aufrufen zu lesen.
ReadContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t) override	Liest den Inhalt und gibt die Base64-dekodierten Binärbytes zurück.
ReadContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) override	Liest den Inhalt und gibt die BinHex-dekodierten Binärbytes zurück.
ReadElementContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t) override	Liest das Element und dekodiert den Base64-Inhalt.
ReadElementContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) override	Liest das Element und dekodiert den BinHex-Inhalt.
ReadString() override	Liest den Inhalt eines Elements oder eines Textknotens als Zeichenkette.
ResetState()	Setzt den Zustand des Lesers auf ReadState::Initial zurück.
ResolveEntity() override	Löst die Entity-Referenz für EntityReference-Knoten auf.
set_DtdProcessing(System::Xml::DtdProcessing)	Setzt die DtdProcessing-Aufzählung.
set_EntityHandling(System::Xml::EntityHandling)	Setzt einen Wert, der festlegt, wie der Reader Entitäten verarbeitet.
set_Namespaces(bool)	Setzt einen Wert, der angibt, ob Namespace-Unterstützung verwendet werden soll.
set_Normalization(bool)	Setzt einen Wert, der angibt, ob Leerzeichen und Attributwerte normalisiert werden sollen.
set_ProhibitDtd(bool)	Setzt einen Wert, der angibt, ob die DTD-Verarbeitung erlaubt ist.
set_WhitespaceHandling(System::Xml::WhitespaceHandling)	Setzt einen Wert, der festlegt, wie Leerzeichen behandelt werden.
set_XmlResolver(const SharedPtr<System::Xml::XmlResolver>&)	Setzt den XmlResolver, der zum Auflösen von DTD-Referenzen verwendet wird.
Skip() override	Überspringt die Kindknoten des aktuellen Knotens.
XmlTextReader(const SharedPtr<IO::Stream>&)	Initialisiert eine neue Instanz der XmlTextReader-Klasse mit dem angegebenen Stream.
XmlTextReader(const String&, const SharedPtr<IO::Stream>&)	Initialisiert eine neue Instanz der XmlTextReader-Klasse mit der angegebenen URL und dem Stream.
XmlTextReader(const SharedPtr<IO::Stream>&, const SharedPtr<XmlNameTable>&)	Initialisiert eine neue Instanz der XmlTextReader-Klasse mit dem angegebenen Stream und dem XmlNameTable.
XmlTextReader(const String&, const SharedPtr<IO::Stream>&, const SharedPtr<XmlNameTable>&)	Initialisiert eine neue Instanz der XmlTextReader-Klasse mit der angegebenen URL, dem Stream und dem XmlNameTable.
XmlTextReader(const SharedPtr<IO::TextReader>&)	Initialisiert eine neue Instanz der XmlTextReader-Klasse mit dem angegebenen TextReader.
XmlTextReader(const String&, const SharedPtr<IO::TextReader>&)	Initialisiert eine neue Instanz der XmlTextReader-Klasse mit der angegebenen URL und dem TextReader.
XmlTextReader(const SharedPtr<IO::TextReader>&, const SharedPtr<XmlNameTable>&)	Initialisiert eine neue Instanz der XmlTextReader-Klasse mit dem angegebenen TextReader und dem XmlNameTable.
XmlTextReader(const String&, const SharedPtr<IO::TextReader>&, const SharedPtr<XmlNameTable>&)	Initialisiert eine neue Instanz der XmlTextReader-Klasse mit der angegebenen URL, dem TextReader und dem XmlNameTable.
XmlTextReader(const SharedPtr<IO::Stream>&, XmlNodeType, const SharedPtr<XmlParserContext>&)	Initialisiert eine neue Instanz der XmlTextReader-Klasse mit dem angegebenen Stream, dem XmlNodeType und dem XmlParserContext.
XmlTextReader(const String&, XmlNodeType, const SharedPtr<XmlParserContext>&)	Initialisiert eine neue Instanz der XmlTextReader-Klasse mit der angegebenen Zeichenkette, dem XmlNodeType und dem XmlParserContext.
XmlTextReader(const String&)	Initialisiert eine neue Instanz der XmlTextReader-Klasse mit der angegebenen Datei.
XmlTextReader(const String&, const SharedPtr<XmlNameTable>&)	Initialisiert eine neue Instanz der XmlTextReader-Klasse mit der angegebenen Datei und dem XmlNameTable.

Typedefs

Typedef	Beschreibung
Ptr	Ein Alias für einen Shared-Pointer auf eine Instanz dieser Klasse.

Hinweise

Es wird empfohlen, stattdessen die XmlReader-Klasse zu verwenden.

Objekte dieser Klasse sollten nur mit der Funktion System::MakeObject() alloziert werden. Erstellen Sie niemals Instanzen dieses Typs auf dem Stack oder mit dem Operator new, da dies zu Laufzeitfehlern und/oder Assertion-Fehlern führt. Wickeln Sie diese Klasse immer in einen System::SmartPtr Pointer und verwenden Sie diesen Pointer, um ihn als Argument an Funktionen zu übergeben.

Siehe auch

System::Xml::XmlText Klasse System::Xml::XmlTextWriter Klasse