XmlTextWriter Klasse

Definition

Stellt einen Writer für die schnelle, nicht zwischengespeicherte Vorwärtsgenerierung von Streams oder Dateien dar, die XML-Daten gemäß den W3C-Empfehlungen zu XML (Extensible Markup Language), Version 1.0, und zu Namespaces in XML enthalten.

Ab .NET Framework 2.0 sollten Sie stattdessen die XmlWriter-Klasse verwenden.

public ref class XmlTextWriter : System::Xml::XmlWriter
public class XmlTextWriter : System.Xml.XmlWriter
type XmlTextWriter = class
    inherit XmlWriter
Public Class XmlTextWriter
Inherits XmlWriter
Vererbung
XmlTextWriter

Hinweise

Weitere Informationen zu dieser API finden Sie unter Zusätzliche API-Hinweise für XmlTextWriter.

Konstruktoren

XmlTextWriter(Stream, Encoding)

Erstellt mithilfe des angegebenen Streams und der angegebenen Codierung eine Instanz der XmlTextWriter-Klasse.

XmlTextWriter(String, Encoding)

Erstellt mithilfe der angegebenen Datei eine Instanz der XmlTextWriter-Klasse.

XmlTextWriter(TextWriter)

Erstellt mithilfe des angegebenen TextWriter eine Instanz der XmlTextWriter-Klasse.

Eigenschaften

BaseStream

Ruft das zugrunde liegende Streamobjekt ab.

Formatting

Gibt die Formatierung der Ausgabe an.

Indentation

Ruft ab oder legt fest, wie viele IndentChars für jede Ebene der Hierarchie geschrieben werden sollen, wenn Formatting auf Formatting.Indented festgelegt ist.

IndentChar

Ruft ab oder legt fest, welches Zeichen für den Einzug verwendet werden soll, wenn Formatting auf Formatting.Indented festgelegt ist.

Namespaces

Ruft einen Wert ab, der angibt, ob Namespaces unterstützt werden, oder legt diesen fest.

QuoteChar

Ruft ab oder legt fest, welches Zeichen als Anführungszeichen für Attributwerte verwendet werden soll.

Settings

Ruft das zum Erstellen dieser XmlWriterSettings-Instanz verwendete XmlWriter-Objekt ab.

(Geerbt von XmlWriter)
WriteState

Ruft den Zustand des Writers ab.

XmlLang

Ruft den aktuellen xml:lang-Bereich ab.

XmlSpace

Ruft einen XmlSpace ab, der den aktuellen xml:space-Bereich darstellt.

Methoden

Close()

Schließt diesen Stream und den zugrunde liegenden Stream.

Dispose()

Gibt alle von der aktuellen Instanz der XmlWriter-Klasse verwendeten Ressourcen frei.

(Geerbt von XmlWriter)
Dispose(Boolean)

Gibt die von XmlWriter verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

(Geerbt von XmlWriter)
DisposeAsync()

Führt anwendungsspezifische Aufgaben aus, die mit dem asynchronen Freigeben, Zurückgeben oder Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.

(Geerbt von XmlWriter)
DisposeAsyncCore()

Führt anwendungsspezifische Aufgaben aus, die mit dem asynchronen Freigeben, Zurückgeben oder Zurücksetzen von verwalteten Ressourcen zusammenhängen.

(Geerbt von XmlWriter)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Flush()

Entleert den Pufferinhalt in die zugrunde liegenden Streams und entleert den zugrunde liegenden Stream ebenfalls.

FlushAsync()

Entleert den Pufferinhalt asynchron in die zugrunde liegenden Streams und entleert den zugrunde liegenden Stream ebenfalls.

(Geerbt von XmlWriter)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
LookupPrefix(String)

Gibt das nächstliegende Präfix zurück, das im aktuellen Namespacebereich für den Namespace-URI definiert ist.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
WriteAttributes(XmlReader, Boolean)

Schreibt beim Überschreiben in einer abgeleiteten Klasse sämtliche an der aktuellen Position gefundenen Attribute in den XmlReader.

(Geerbt von XmlWriter)
WriteAttributesAsync(XmlReader, Boolean)

Schreibt asynchron alle Attribute aus, die in der aktuellen Position in XmlReader gefunden werden.

(Geerbt von XmlWriter)
WriteAttributeString(String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse das Attribut mit dem angegebenen lokalen Namen und Wert.

(Geerbt von XmlWriter)
WriteAttributeString(String, String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse ein Attribut mit dem angegebenen lokalen Namen, Namespace-URI und Wert.

(Geerbt von XmlWriter)
WriteAttributeString(String, String, String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse das Attribut mit dem angegebenen Präfix, lokalen Namen, Namespace-URI und Wert.

(Geerbt von XmlWriter)
WriteAttributeStringAsync(String, String, String, String)

Schreibt ein Attribut asynchron mit dem angegebenen Präfix, lokalen Namen, Namespace-URI und Wert.

(Geerbt von XmlWriter)
WriteBase64(Byte[], Int32, Int32)

Codiert die angegebenen binären Bytes als base64 und schreibt den resultierenden Text.

WriteBase64Async(Byte[], Int32, Int32)

Codiert die angegebenen binären Bytes asynchron als Base64 und schreibt den resultierenden Text.

(Geerbt von XmlWriter)
WriteBinHex(Byte[], Int32, Int32)

Codiert die angegebenen binären Bytes als Binhex und schreibt den resultierenden Text.

WriteBinHexAsync(Byte[], Int32, Int32)

Codiert die angegebenen binären Bytes asynchron als BinHex und schreibt den resultierenden Text.

(Geerbt von XmlWriter)
WriteCData(String)

Schreibt einen <![CDATA[...]]>-Block mit dem angegebenen Text.

WriteCDataAsync(String)

Schreibt asynchron einen <![CDATA[...]]>-Block mit dem angegebenen Text.

(Geerbt von XmlWriter)
WriteCharEntity(Char)

Erzwingt das Generieren einer Zeichenentität für den angegebenen Unicode-Zeichenwert.

WriteCharEntityAsync(Char)

Erzwingt das Generieren einer Zeichenentität asynchron für den angegebenen Unicode-Zeichenwert.

(Geerbt von XmlWriter)
WriteChars(Char[], Int32, Int32)

Schreibt Text in jeweils einen Puffer.

WriteCharsAsync(Char[], Int32, Int32)

Schreibt Text asynchron in jeweils einen Puffer.

(Geerbt von XmlWriter)
WriteComment(String)

Schreibt den Kommentar <!--...--> mit dem angegebenen Text.

WriteCommentAsync(String)

Schreibt asynchron einen Kommentar <!--...-->, der den angegebenen Text enthält.

(Geerbt von XmlWriter)
WriteDocType(String, String, String, String)

Schreibt die DOCTYPE-Deklaration mit dem angegebenen Namen und optionalen Attributen.

WriteDocTypeAsync(String, String, String, String)

Schreibt die DOCTYPE-Deklaration asynchron mit dem angegebenen Namen und optionalen Attributen.

(Geerbt von XmlWriter)
WriteElementString(String, String)

Schreibt ein Element mit dem angegebenen lokalen Namen und Wert.

(Geerbt von XmlWriter)
WriteElementString(String, String, String)

Schreibt ein Element mit dem angegebenen lokalen Namen, Namespace-URI und Wert.

(Geerbt von XmlWriter)
WriteElementString(String, String, String, String)

Schreibt ein Element mit dem angegebenen Präfix, lokalen Namen, Namespace-URI und Wert.

(Geerbt von XmlWriter)
WriteElementStringAsync(String, String, String, String)

Schreibt ein Element asynchron mit dem angegebenen Präfix, lokalen Namen, Namespace-URI und Wert.

(Geerbt von XmlWriter)
WriteEndAttribute()

Schließt den vorherigen Aufruf von WriteStartAttribute(String, String, String).

WriteEndAttributeAsync()

Schließt den asynchronen vorherigen WriteStartAttribute(String, String)-Aufruf.

(Geerbt von XmlWriter)
WriteEndDocument()

Schließt alle geöffneten Elemente oder Attribute und setzt den Writer in den Startzustand zurück.

WriteEndDocumentAsync()

Schließt alle geöffneten Elemente oder Attribute asynchron und setzt den Writer in den Startzustand zurück.

(Geerbt von XmlWriter)
WriteEndElement()

Schließt ein Element und löst den entsprechenden Namespacebereich auf.

WriteEndElementAsync()

Schließt ein Element asynchron und löst den entsprechenden Namespacebereich auf.

(Geerbt von XmlWriter)
WriteEntityRef(String)

Schreibt einen Entitätsverweis als &name;.

WriteEntityRefAsync(String)

Schreibt einen Entitätsverweis asynchron als &name; aus.

(Geerbt von XmlWriter)
WriteFullEndElement()

Schließt ein Element und löst den entsprechenden Namespacebereich auf.

WriteFullEndElementAsync()

Schließt ein Element asynchron und löst den entsprechenden Namespacebereich auf.

(Geerbt von XmlWriter)
WriteName(String)

Schreibt den angegebenen Namen und prüft dessen Gültigkeit entsprechend der W3C-Empfehlung für XML, Version 1.0.

WriteNameAsync(String)

Schreibt den angegebenen Namen asynchron aus, wobei sichergestellt wird, dass es sich um einen gültigen Namen gemäß der W3C XML 1.0-Empfehlung (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name) handelt.

(Geerbt von XmlWriter)
WriteNmToken(String)

Schreibt den angegebenen Namen und prüft, ob es ein gültiger NmToken ist, entsprechend der W3C-Empfehlung für XML, Version 1.0.

WriteNmTokenAsync(String)

Schreibt den angegebenen Namen asynchron aus, wobei sichergestellt wird, dass es sich um einen gültigen NmToken gemäß der W3C XML 1.0-Empfehlung () handelthttps://www.w3.org/TR/1998/REC-xml-19980210#NT-Name.

(Geerbt von XmlWriter)
WriteNode(XmlReader, Boolean)

Kopiert beim Überschreiben in einer abgeleiteten Klasse den gesamten Inhalt des Readers in den Writer und verschiebt den Reader zum Anfang des nächsten nebengeordneten Elements.

(Geerbt von XmlWriter)
WriteNode(XPathNavigator, Boolean)

Kopiert den gesamten Inhalt des XPathNavigator-Objekts in den Writer. Die Position des XPathNavigator bleibt unverändert.

(Geerbt von XmlWriter)
WriteNodeAsync(XmlReader, Boolean)

Kopiert beim Überschreiben in einer abgeleiteten Klasse den gesamten Inhalt des Readers asynchron in den Writer und verschiebt den Reader zum Anfang des nächsten nebengeordneten Elements.

(Geerbt von XmlWriter)
WriteNodeAsync(XPathNavigator, Boolean)

Kopiert asynchron den gesamten Inhalt des XPathNavigator-Objekt in den Writer. Die Position des XPathNavigator bleibt unverändert.

(Geerbt von XmlWriter)
WriteProcessingInstruction(String, String)

Schreibt eine Verarbeitungsanweisung mit einem Leerzeichen zwischen dem Namen und dem Text wie folgt: <?name text?>.

WriteProcessingInstructionAsync(String, String)

Schreibt eine Verarbeitungsanweisung asynchron mit einem Leerzeichen zwischen dem Namen und dem Text wie folgt: <?name text?>.

(Geerbt von XmlWriter)
WriteQualifiedName(String, String)

Schreibt den durch den Namespace angegebenen Namen. Diese Methode sucht das Präfix im Gültigkeitsbereich des Namespaces.

WriteQualifiedNameAsync(String, String)

Schreibt den durch Namespace gekennzeichneten Namen asynchron. Diese Methode sucht das Präfix im Gültigkeitsbereich des Namespaces.

(Geerbt von XmlWriter)
WriteRaw(Char[], Int32, Int32)

Schreibt unformatiertes Markup manuell aus einem Zeichenpuffer.

WriteRaw(String)

Schreibt unformatiertes Markup manuell aus einer Zeichenfolge.

WriteRawAsync(Char[], Int32, Int32)

Schreibt asynchron unformatiertes Markup manuell aus einem Zeichenpuffer.

(Geerbt von XmlWriter)
WriteRawAsync(String)

Schreibt asynchron unformatiertes Markup manuell aus einer Zeichenfolge.

(Geerbt von XmlWriter)
WriteStartAttribute(String)

Schreibt den Anfang eines Attributs mit dem angegebenen lokalen Namen.

(Geerbt von XmlWriter)
WriteStartAttribute(String, String)

Schreibt den Anfang eines Attributs mit dem angegebenen lokalen Namen und dem angegebenen Namespace-URI.

(Geerbt von XmlWriter)
WriteStartAttribute(String, String, String)

Schreibt den Anfang eines Attributs.

WriteStartAttributeAsync(String, String, String)

Schreibt den Anfang eines Attributs asynchron mit dem angegebenen Präfix, lokalen Namen und Namespace-URI.

(Geerbt von XmlWriter)
WriteStartDocument()

Schreibt die XML-Deklaration mit der Version "1.0".

WriteStartDocument(Boolean)

Schreibt die XML-Deklaration mit der Version "1.0" und dem eigenständigen Attribut.

WriteStartDocumentAsync()

Schreibt die XML-Deklaration asynchron mit der Version "1.0".

(Geerbt von XmlWriter)
WriteStartDocumentAsync(Boolean)

Schreibt die XML-Deklaration asynchron mit der Version "1.0" und dem eigenständigen Attribut.

(Geerbt von XmlWriter)
WriteStartElement(String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse ein Starttag mit dem angegebenen lokalen Namen.

(Geerbt von XmlWriter)
WriteStartElement(String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse das angegebene Starttag und ordnet dieses dem angegebenen Namespace zu.

(Geerbt von XmlWriter)
WriteStartElement(String, String, String)

Schreibt das angegebene Starttag und ordnet dieses dem angegebenen Namespace und Präfix zu.

WriteStartElementAsync(String, String, String)

Schreibt das angegebene Starttag asynchron und ordnet dieses dem angegebenen Namespace und Präfix zu.

(Geerbt von XmlWriter)
WriteString(String)

Schreibt den angegebenen Textinhalt.

WriteStringAsync(String)

Schreibt den angegebenen Textinhalt asynchron.

(Geerbt von XmlWriter)
WriteSurrogateCharEntity(Char, Char)

Generiert und schreibt die Ersatzzeichenentität für das Ersatzzeichenpaar.

WriteSurrogateCharEntityAsync(Char, Char)

Generiert und schreibt die Ersatzzeichenentität asynchron für das Ersatzzeichenpaar.

(Geerbt von XmlWriter)
WriteValue(Boolean)

Schreibt einen Boolean-Wert.

(Geerbt von XmlWriter)
WriteValue(DateTime)

Schreibt einen DateTime-Wert.

(Geerbt von XmlWriter)
WriteValue(DateTimeOffset)

Schreibt einen DateTimeOffset-Wert.

(Geerbt von XmlWriter)
WriteValue(Decimal)

Schreibt einen Decimal-Wert.

(Geerbt von XmlWriter)
WriteValue(Double)

Schreibt einen Double-Wert.

(Geerbt von XmlWriter)
WriteValue(Int32)

Schreibt einen Int32-Wert.

(Geerbt von XmlWriter)
WriteValue(Int64)

Schreibt einen Int64-Wert.

(Geerbt von XmlWriter)
WriteValue(Object)

Schreibt den Objektwert.

(Geerbt von XmlWriter)
WriteValue(Single)

Schreibt eine Gleitkommazahl mit einfacher Genauigkeit.

(Geerbt von XmlWriter)
WriteValue(String)

Schreibt einen String-Wert.

(Geerbt von XmlWriter)
WriteWhitespace(String)

Schreibt den angegebenen Leerraum.

WriteWhitespaceAsync(String)

Schreibt den angegebenen Leerraum asynchron.

(Geerbt von XmlWriter)

Explizite Schnittstellenimplementierungen

IDisposable.Dispose()

Eine Beschreibung dieses Elements finden Sie unter Dispose().

(Geerbt von XmlWriter)

Erweiterungsmethoden

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguriert, wie Wartezeiten auf die Aufgaben angewandt werden, die von einem asynchronen verwerfbaren Element zurückgegeben werden.

Gilt für:

Weitere Informationen