XmlWriter Klasse

Definition

Stellt einen Writer für die schnelle, vorwärts gerichtete Generierung von Streams oder Dateien mit XML-Daten ohne Zwischenspeicherung dar.

public ref class XmlWriter abstract : IDisposable
public ref class XmlWriter abstract : IAsyncDisposable, IDisposable
public ref class XmlWriter abstract
public abstract class XmlWriter : IDisposable
public abstract class XmlWriter : IAsyncDisposable, IDisposable
public abstract class XmlWriter
type XmlWriter = class
    interface IDisposable
type XmlWriter = class
    interface IAsyncDisposable
    interface IDisposable
type XmlWriter = class
Public MustInherit Class XmlWriter
Implements IDisposable
Public MustInherit Class XmlWriter
Implements IAsyncDisposable, IDisposable
Public MustInherit Class XmlWriter
Vererbung
XmlWriter
Abgeleitet
Implementiert

Beispiele

Der folgende Beispielcode zeigt, wie Sie die asynchrone API zum Generieren von XML verwenden.

async Task TestWriter(Stream stream)
{
    XmlWriterSettings settings = new XmlWriterSettings();
    settings.Async = true;

    using (XmlWriter writer = XmlWriter.Create(stream, settings)) {
        await writer.WriteStartElementAsync("pf", "root", "http://ns");
        await writer.WriteStartElementAsync(null, "sub", null);
        await writer.WriteAttributeStringAsync(null, "att", null, "val");
        await writer.WriteStringAsync("text");
        await writer.WriteEndElementAsync();
        await writer.WriteProcessingInstructionAsync("pName", "pValue");
        await writer.WriteCommentAsync("cValue");
        await writer.WriteCDataAsync("cdata value");
        await writer.WriteEndElementAsync();
        await writer.FlushAsync();
    }
}

Hinweise

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

Konstruktoren

XmlWriter()

Initialisiert eine neue Instanz der XmlWriter-Klasse.

Eigenschaften

Settings

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

WriteState

Ruft beim Überschreiben in einer abgeleiteten Klasse den Zustand des Writers ab.

XmlLang

Ruft beim Überschreiben in einer abgeleiteten Klasse den aktuellen xml:lang-Bereich ab.

XmlSpace

Ruft beim Überschreiben in einer abgeleiteten Klasse einen XmlSpace ab, der den aktuellen xml:space-Bereich darstellt.

Methoden

Close()

Schließt beim Überschreiben in einer abgeleiteten Klasse diesen Stream und den zugrunde liegenden Stream.

Create(Stream)

Erstellt eine neue XmlWriter-Instanz mit dem angegebenen Stream.

Create(Stream, XmlWriterSettings)

Erstellt eine neue XmlWriter-Instanz mit dem Stream und dem XmlWriterSettings-Objekt.

Create(String)

Erstellt eine neue XmlWriter-Instanz mit dem angegebenen Dateinamen.

Create(String, XmlWriterSettings)

Erstellt eine neue XmlWriter-Instanz mit dem Dateinamen und dem XmlWriterSettings-Objekt.

Create(StringBuilder)

Erstellt mit dem angegebenen XmlWriter eine neue StringBuilder-Instanz.

Create(StringBuilder, XmlWriterSettings)

Erstellt mit dem XmlWriter-Objekt und dem StringBuilder-Objekt eine neue XmlWriterSettings-Instanz.

Create(TextWriter)

Erstellt mit dem angegebenen XmlWriter eine neue TextWriter-Instanz.

Create(TextWriter, XmlWriterSettings)

Erstellt mit dem XmlWriter-Objekt und dem TextWriter-Objekt eine neue XmlWriterSettings-Instanz.

Create(XmlWriter)

Erstellt eine neue XmlWriter-Instanz mit dem angegebenen XmlWriter-Objekt.

Create(XmlWriter, XmlWriterSettings)

Erstellt mit dem angegebenen XmlWriter-Objekt und dem angegebenen XmlWriter-Objekt eine neue XmlWriterSettings-Instanz.

Dispose()

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

Dispose(Boolean)

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

DisposeAsync()

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

DisposeAsyncCore()

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

Equals(Object)

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

(Geerbt von Object)
Flush()

Entleert beim Überschreiben in einer abgeleiteten Klasse den Inhalt des Puffers in die zugrunde liegenden Streams und leert den zugrunde liegenden Stream ebenfalls.

FlushAsync()

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

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
LookupPrefix(String)

Gibt beim Überschreiben in einer abgeleiteten Klasse 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.

WriteAttributesAsync(XmlReader, Boolean)

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

WriteAttributeString(String, String)

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

WriteAttributeString(String, String, String)

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

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.

WriteAttributeStringAsync(String, String, String, String)

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

WriteBase64(Byte[], Int32, Int32)

Codiert beim Überschreiben in einer abgeleiteten Klasse 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.

WriteBinHex(Byte[], Int32, Int32)

Codiert beim Überschreiben in einer abgeleiteten Klasse 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.

WriteCData(String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse einen <![CDATA[...]]>-Block mit dem angegebenen Text.

WriteCDataAsync(String)

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

WriteCharEntity(Char)

Erzwingt beim Überschreiben in einer abgeleiteten Klasse die Generierung einer Zeichenentität für den angegebenen Wert eines Unicode-Zeichens.

WriteCharEntityAsync(Char)

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

WriteChars(Char[], Int32, Int32)

Schreibt beim Überschreiben in einer abgeleiteten Klasse Text in jeweils einen Puffer.

WriteCharsAsync(Char[], Int32, Int32)

Schreibt Text asynchron in jeweils einen Puffer.

WriteComment(String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse den Kommentar <!--...--> mit dem angegebenen Text.

WriteCommentAsync(String)

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

WriteDocType(String, String, String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse 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.

WriteElementString(String, String)

Schreibt ein Element mit dem angegebenen lokalen Namen und Wert.

WriteElementString(String, String, String)

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

WriteElementString(String, String, String, String)

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

WriteElementStringAsync(String, String, String, String)

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

WriteEndAttribute()

Schließt beim Überschreiben in einer abgeleiteten Klasse den vorherigen WriteStartAttribute(String, String)-Aufruf.

WriteEndAttributeAsync()

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

WriteEndDocument()

Schließt beim Überschreiben in einer abgeleiteten Klasse alle geöffneten Elemente oder Attribute und setzt den Writer in den Anfangszustand zurück.

WriteEndDocumentAsync()

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

WriteEndElement()

Schließt beim Überschreiben in einer abgeleiteten Klasse ein Element und löst den entsprechenden Namespacebereich auf.

WriteEndElementAsync()

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

WriteEntityRef(String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse einen Entitätsverweis als &name;.

WriteEntityRefAsync(String)

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

WriteFullEndElement()

Schließt beim Überschreiben in einer abgeleiteten Klasse ein Element und löst den entsprechenden Namespacebereich auf.

WriteFullEndElementAsync()

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

WriteName(String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse den angegebenen Namen aus, und stellt sicher, 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.

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.

WriteNmToken(String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse den angegebenen Namen aus, und stellt sicher, dass es sich um einen gültigen NmToken gemäß der W3C XML 1.0-Empfehlung (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name) handelt.

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.

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.

WriteNode(XPathNavigator, Boolean)

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

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.

WriteNodeAsync(XPathNavigator, Boolean)

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

WriteProcessingInstruction(String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse 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?>.

WriteQualifiedName(String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse 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.

WriteRaw(Char[], Int32, Int32)

Schreibt beim Überschreiben in einer abgeleiteten Klasse Rohdatenmarkup manuell aus einem Zeichenpuffer.

WriteRaw(String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse Rohdatenmarkup manuell aus einer Zeichenfolge.

WriteRawAsync(Char[], Int32, Int32)

Schreibt asynchron unformatiertes Markup manuell aus einem Zeichenpuffer.

WriteRawAsync(String)

Schreibt asynchron unformatiertes Markup manuell aus einer Zeichenfolge.

WriteStartAttribute(String)

Schreibt den Anfang eines Attributs mit dem angegebenen lokalen Namen.

WriteStartAttribute(String, String)

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

WriteStartAttribute(String, String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse den Anfang eines Attributs mit dem angegebenen Präfix, dem angegebenen lokalen Namen und dem angegebenen Namespace-URI.

WriteStartAttributeAsync(String, String, String)

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

WriteStartDocument()

Schreibt beim Überschreiben in einer abgeleiteten Klasse die XML-Deklaration mit der Version "1.0".

WriteStartDocument(Boolean)

Schreibt beim Überschreiben in einer abgeleiteten Klasse die XML-Deklaration mit der Version "1.0" und dem eigenständigen Attribut.

WriteStartDocumentAsync()

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

WriteStartDocumentAsync(Boolean)

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

WriteStartElement(String)

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

WriteStartElement(String, String)

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

WriteStartElement(String, String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse 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.

WriteString(String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse den angegebenen Textinhalt.

WriteStringAsync(String)

Schreibt den angegebenen Textinhalt asynchron.

WriteSurrogateCharEntity(Char, Char)

Generiert und schreibt beim Überschreiben in einer abgeleiteten Klasse die Ersatzzeichenentität für das Ersatzzeichenpaar.

WriteSurrogateCharEntityAsync(Char, Char)

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

WriteValue(Boolean)

Schreibt einen Boolean-Wert.

WriteValue(DateTime)

Schreibt einen DateTime-Wert.

WriteValue(DateTimeOffset)

Schreibt einen DateTimeOffset-Wert.

WriteValue(Decimal)

Schreibt einen Decimal-Wert.

WriteValue(Double)

Schreibt einen Double-Wert.

WriteValue(Int32)

Schreibt einen Int32-Wert.

WriteValue(Int64)

Schreibt einen Int64-Wert.

WriteValue(Object)

Schreibt den Objektwert.

WriteValue(Single)

Schreibt eine Gleitkommazahl mit einfacher Genauigkeit.

WriteValue(String)

Schreibt einen String-Wert.

WriteWhitespace(String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse den angegebenen Leerraum.

WriteWhitespaceAsync(String)

Schreibt den angegebenen Leerraum asynchron.

Explizite Schnittstellenimplementierungen

IDisposable.Dispose()

Eine Beschreibung dieses Elements finden Sie unter Dispose().

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