XmlWriter Klasse

Referenz

Definition

Namespace:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Quelle:: XmlWriter.cs

Quelle:: XmlWriter.cs

Quelle:: XmlWriter.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt einen Writer dar, der eine schnelle, nicht zwischengespeicherte, vorwärtsbasierte Möglichkeit zum Generieren von Datenströmen oder Dateien mit XML-Daten bereitstellt.

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: Object
XmlWriter

Abgeleitet: System.Xml.XmlDictionaryWriter

System.Xml.XmlTextWriter

System.Xml.Xsl.Runtime.XmlQueryOutput

Implementiert: IDisposable IAsyncDisposable

Beispiele

Der folgende Beispielcode zeigt, wie die asynchrone API zum Generieren von XML verwendet wird.

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 Ergänzende API-Hinweise für XmlWriter.

Konstruktoren

XmlWriter()

Initialisiert eine neue Instanz der XmlWriter Klasse.

Eigenschaften

Settings	Ruft das XmlWriterSettings-Objekt ab, das zum Erstellen dieser XmlWriter Instanz verwendet wird.
WriteState	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Status des Writers ermittelt.
XmlLang	Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, ruft den aktuellen `xml:lang` Bereich ab.
XmlSpace	Wenn eine abgeleitete Klasse außer Kraft gesetzt wird, ruft eine XmlSpace ab, die den aktuellen `xml:space` Bereich darstellt.

Methoden

Close()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird dieser Datenstrom und der zugrunde liegende Datenstrom geschlossen.
Create(Stream)	Erstellt mithilfe des angegebenen Datenstroms eine neue XmlWriter Instanz.
Create(Stream, XmlWriterSettings)	Erstellt eine neue XmlWriter Instanz mithilfe des Datenstroms und XmlWriterSettings Objekts.
Create(String)	Erstellt eine neue XmlWriter Instanz unter Verwendung des angegebenen Dateinamens.
Create(String, XmlWriterSettings)	Erstellt mithilfe des Dateinamens und XmlWriterSettings Objekts eine neue XmlWriter Instanz.
Create(StringBuilder)	Erstellt eine neue XmlWriter Instanz mithilfe der angegebenen StringBuilder.
Create(StringBuilder, XmlWriterSettings)	Erstellt eine neue XmlWriter Instanz mithilfe der objekte StringBuilder und XmlWriterSettings.
Create(TextWriter)	Erstellt eine neue XmlWriter Instanz mithilfe der angegebenen TextWriter.
Create(TextWriter, XmlWriterSettings)	Erstellt eine neue XmlWriter Instanz mithilfe der objekte TextWriter und XmlWriterSettings.
Create(XmlWriter)	Erstellt eine neue XmlWriter Instanz mithilfe des angegebenen XmlWriter-Objekts.
Create(XmlWriter, XmlWriterSettings)	Erstellt eine neue XmlWriter Instanz mithilfe der angegebenen XmlWriter und XmlWriterSettings Objekte.
Dispose()	Gibt alle Ressourcen frei, die von der aktuellen Instanz der XmlWriter Klasse verwendet werden.
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die vom XmlWriter verwendet werden, und gibt optional die verwalteten Ressourcen frei.
DisposeAsync()	Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen asynchron verknüpft sind.
DisposeAsyncCore()	Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen verwalteter Ressourcen asynchron verknüpft sind.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
Flush()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, werden alle Inhalte im Puffer in die zugrunde liegenden Datenströme gelebt und auch der zugrunde liegende Datenstrom gelebt.
FlushAsync()	Löscht asynchron alles, was sich im Puffer befindet, in die zugrunde liegenden Datenströme und löscht auch den zugrunde liegenden Datenstrom.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
LookupPrefix(String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird das im aktuellen Namespacebereich für den Namespace-URI definierte präfix zurückgegeben.
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
WriteAttributes(XmlReader, Boolean)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, werden alle Attribute ausgeschrieben, die an der aktuellen Position im XmlReadergefunden wurden.
WriteAttributesAsync(XmlReader, Boolean)	Schreibt asynchron alle Attribute aus, die an der aktuellen Position im XmlReadergefunden wurden.
WriteAttributeString(String, String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird das Attribut mit dem angegebenen lokalen Namen und Wert geschrieben.
WriteAttributeString(String, String, String)	Wenn sie in einer abgeleiteten Klasse überschrieben werden, wird ein Attribut mit dem angegebenen lokalen Namen, Namespace-URI und Wert geschrieben.
WriteAttributeString(String, String, String, String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird das Attribut mit dem angegebenen Präfix, dem lokalen Namen, dem Namespace-URI und dem Wert geschrieben.
WriteAttributeStringAsync(String, String, String, String)	Schreibt asynchron das Attribut mit dem angegebenen Präfix, dem lokalen Namen, dem Namespace-URI und dem Wert aus.
WriteBase64(Byte[], Int32, Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben werden, codiert die angegebenen Binärbytes als Base64 und schreibt den resultierenden Text aus.
WriteBase64Async(Byte[], Int32, Int32)	Codiert die angegebenen Binärbytes asynchron als Base64 und schreibt den resultierenden Text aus.
WriteBinHex(Byte[], Int32, Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben werden, codiert die angegebenen binärbytes als `BinHex` und schreibt den resultierenden Text aus.
WriteBinHexAsync(Byte[], Int32, Int32)	Codiert die angegebenen Binärbytes asynchron als `BinHex` und schreibt den resultierenden Text aus.
WriteCData(String)	Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, schreibt sie eine <! [CDATA[...]]> Block, der den angegebenen Text enthält.
WriteCDataAsync(String)	Schreibt asynchron eine <! [CDATA[...]]> Block, der den angegebenen Text enthält.
WriteCharEntity(Char)	Wenn eine abgeleitete Klasse überschrieben wird, wird die Generierung einer Zeichenentität für den angegebenen Unicode-Zeichenwert erzwungen.
WriteCharEntityAsync(Char)	Erzwingt asynchron die Generierung einer Zeichenentität für den angegebenen Unicode-Zeichenwert.
WriteChars(Char[], Int32, Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird jeweils ein Puffer geschrieben.
WriteCharsAsync(Char[], Int32, Int32)	Schreibt text asynchron jeweils einen Puffer.
WriteComment(String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Kommentar <!--...--> mit dem angegebenen Text geschrieben.
WriteCommentAsync(String)	Schreibt asynchron einen Kommentar <!--...-->, der den angegebenen Text enthält.
WriteDocType(String, String, String, String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die DOCTYPE-Deklaration mit dem angegebenen Namen und optionalen Attributen geschrieben.
WriteDocTypeAsync(String, String, String, String)	Schreibt asynchron die DOCTYPE-Deklaration 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, dem lokalen Namen, dem Namespace-URI und dem Wert.
WriteElementStringAsync(String, String, String, String)	Schreibt asynchron ein Element mit dem angegebenen Präfix, dem lokalen Namen, dem Namespace-URI und dem Wert.
WriteEndAttribute()	Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, wird der vorherige WriteStartAttribute(String, String) Aufruf geschlossen.
WriteEndAttributeAsync()	Schließt asynchron den vorherigen WriteStartAttribute(String, String) Aufruf.
WriteEndDocument()	Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden alle geöffneten Elemente oder Attribute geschlossen und der Writer wieder in den Startzustand versetzt.
WriteEndDocumentAsync()	Schließt asynchron alle geöffneten Elemente oder Attribute und versetzt den Writer wieder in den Startzustand.
WriteEndElement()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Element geschlossen und der entsprechende Namespacebereich eingeblendet.
WriteEndElementAsync()	Schließt asynchron ein Element und füllt den entsprechenden Namespacebereich auf.
WriteEntityRef(String)	Wenn eine abgeleitete Klasse überschrieben wird, wird ein Entitätsverweis als `&name;`geschrieben.
WriteEntityRefAsync(String)	Schreibt asynchron einen Entitätsverweis als `&name;`aus.
WriteFullEndElement()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Element geschlossen und der entsprechende Namespacebereich eingeblendet.
WriteFullEndElementAsync()	Schließt asynchron ein Element und füllt den entsprechenden Namespacebereich auf.
WriteName(String)	Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, schreibt Sie den angegebenen Namen aus, und stellen Sie 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 asynchron den angegebenen Namen aus, um sicherzustellen, 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)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, schreibt sie den angegebenen Namen aus, um sicherzustellen, dass es sich um ein gültiges NmToken gemäß der W3C XML 1.0-Empfehlung (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name) handelt.
WriteNmTokenAsync(String)	Schreibt asynchron den angegebenen Namen aus, um sicherzustellen, dass es sich um ein gültiges NmToken gemäß der W3C XML 1.0-Empfehlung (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name) handelt.
WriteNode(XmlReader, Boolean)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, kopiert alles vom Leser in den Autor und verschiebt den Leser an den Anfang des nächsten gleichgeordneten Typs.
WriteNode(XPathNavigator, Boolean)	Kopiert alles vom XPathNavigator-Objekt in den Autor. Die Position der XPathNavigator bleibt unverändert.
WriteNodeAsync(XmlReader, Boolean)	Kopiert asynchron alles vom Leser in den Autor und verschiebt den Leser an den Anfang des nächsten gleichgeordneten Gleichgeordneten.
WriteNodeAsync(XPathNavigator, Boolean)	Kopiert asynchron alles vom XPathNavigator-Objekt in den Writer. Die Position der XPathNavigator bleibt unverändert.
WriteProcessingInstruction(String, String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine Verarbeitungsanweisung mit einem Leerzeichen zwischen dem Namen und dem Text wie folgt geschrieben: <?name-Text?>.
WriteProcessingInstructionAsync(String, String)	Schreibt asynchron eine Verarbeitungsanweisung mit einem Leerzeichen zwischen dem Namen und dem Text wie folgt aus: <?name text?>.
WriteQualifiedName(String, String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der namespacequalifizierte Name ausgeschrieben. Diese Methode sucht nach dem Präfix, das sich im Bereich für den angegebenen Namespace befindet.
WriteQualifiedNameAsync(String, String)	Schreibt asynchron den namespacequalifizierten Namen aus. Diese Methode sucht nach dem Präfix, das sich im Bereich für den angegebenen Namespace befindet.
WriteRaw(Char[], Int32, Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben werden, schreibt unformatiertes Markup manuell aus einem Zeichenpuffer.
WriteRaw(String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, schreibt unformatiertes Markup manuell aus einer Zeichenfolge.
WriteRawAsync(Char[], Int32, Int32)	Schreibt asynchron unformatiertes Markup manuell aus einem Zeichenpuffer.
WriteRawAsync(String)	Schreibt asynchron rohes 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 namespace-URI.
WriteStartAttribute(String, String, String)	Wenn eine abgeleitete Klasse überschrieben wird, wird der Anfang eines Attributs mit dem angegebenen Präfix, dem lokalen Namen und dem Namespace-URI geschrieben.
WriteStartAttributeAsync(String, String, String)	Schreibt asynchron den Start eines Attributs mit dem angegebenen Präfix, dem lokalen Namen und dem Namespace-URI.
WriteStartDocument()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die XML-Deklaration mit der Version "1.0" geschrieben.
WriteStartDocument(Boolean)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die XML-Deklaration mit der Version "1.0" und dem eigenständigen Attribut geschrieben.
WriteStartDocumentAsync()	Schreibt asynchron die XML-Deklaration mit der Version "1.0".
WriteStartDocumentAsync(Boolean)	Schreibt asynchron die XML-Deklaration mit der Version "1.0" und dem eigenständigen Attribut.
WriteStartElement(String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Starttag mit dem angegebenen lokalen Namen geschrieben.
WriteStartElement(String, String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird das angegebene Starttag geschrieben und dem angegebenen Namespace zugeordnet.
WriteStartElement(String, String, String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird das angegebene Starttag geschrieben und dem angegebenen Namespace und Präfix zugeordnet.
WriteStartElementAsync(String, String, String)	Schreibt asynchron das angegebene Starttag und ordnet es dem angegebenen Namespace und Präfix zu.
WriteString(String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der angegebene Textinhalt geschrieben.
WriteStringAsync(String)	Schreibt asynchron den angegebenen Textinhalt.
WriteSurrogateCharEntity(Char, Char)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Ersatzzeichenentität für das Ersatzzeichenpaar generiert und geschrieben.
WriteSurrogateCharEntityAsync(Char, Char)	Generiert und schreibt asynchron die Ersatzzeichenentität 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)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird das angegebene Leerzeichen geschrieben.
WriteWhitespaceAsync(String)	Schreibt asynchron das angegebene Leerzeichen aus.

Explizite Schnittstellenimplementierungen

IDisposable.Dispose()

Eine Beschreibung dieses Mitglieds finden Sie unter Dispose().

Erweiterungsmethoden

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguriert, wie auf die von einem asynchronen Einweg zurückgegebenen Aufgaben gewartet wird.

Gilt für:

Weitere Informationen

XML-Dokumente und -Daten-

Freigeben über