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 Zustand von XmlReader::get_ReadState zu 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 Reader 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 generiert 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-Namespacespezifikation definiert) des Knotens zurück, auf dem der Reader positioniert ist.
get_NameTable() override	Gibt die mit dieser Implementierung verknüpfte XmlNameTable zurück.
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‑Zeichen 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 verarbeitet 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 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 befindlichen 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 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 einen 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 Readers auf ReadState::Initial zurück.
ResolveEntity() override	Löst die Entity-Referenz für EntityReference-Knoten auf.
set_DtdProcessing(System::Xml::DtdProcessing)	Setzt die Aufzählung DtdProcessing.
set_EntityHandling(System::Xml::EntityHandling)	Setzt einen Wert, der festlegt, wie der Reader Entitäten verarbeitet.
set_Namespaces(bool)	Legt einen Wert fest, 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 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 Klasse XmlTextReader mit dem angegebenen Stream.
XmlTextReader(const String&, const SharedPtr<IO::Stream>&)	Initialisiert eine neue Instanz der Klasse XmlTextReader mit der angegebenen URL und dem Stream.
XmlTextReader(const SharedPtr<IO::Stream>&, const SharedPtr<XmlNameTable>&)	Initialisiert eine neue Instanz der Klasse XmlTextReader mit dem angegebenen Stream und dem XmlNameTable.
XmlTextReader(const String&, const SharedPtr<IO::Stream>&, const SharedPtr<XmlNameTable>&)	Initialisiert eine neue Instanz der Klasse XmlTextReader mit der angegebenen URL, dem Stream und dem XmlNameTable.
XmlTextReader(const SharedPtr<IO::TextReader>&)	Initialisiert eine neue Instanz der Klasse XmlTextReader mit dem angegebenen TextReader.
XmlTextReader(const String&, const SharedPtr<IO::TextReader>&)	Initialisiert eine neue Instanz der Klasse XmlTextReader mit der angegebenen URL und dem TextReader.
XmlTextReader(const SharedPtr<IO::TextReader>&, const SharedPtr<XmlNameTable>&)	Initialisiert eine neue Instanz der Klasse XmlTextReader mit dem angegebenen TextReader und dem XmlNameTable.
XmlTextReader(const String&, const SharedPtr<IO::TextReader>&, const SharedPtr<XmlNameTable>&)	Initialisiert eine neue Instanz der Klasse XmlTextReader 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, XmlNodeType und XmlParserContext.
XmlTextReader(const String&, XmlNodeType, const SharedPtr<XmlParserContext>&)	Initialisiert eine neue Instanz der XmlTextReader-Klasse mit dem angegebenen String, XmlNodeType und 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 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 class System::Xml::XmlTextWriter Klasse