XmlTextWriter XmlTextWriter XmlTextWriter XmlTextWriter Class

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.Represents a writer that provides a fast, non-cached, forward-only way of generating streams or files containing XML data that conforms to the W3C Extensible Markup Language (XML) 1.0 and the Namespaces in XML recommendations.

Ab .NET Framework 2.0 sollten Sie stattdessen die XmlWriter-Klasse verwenden.Starting with the .NET Framework 2.0, we recommend that you use the XmlWriter class instead.

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

Hinweise

Diese Klasse implementiert die XmlWriter Klasse.This class implements the XmlWriter class.

Hinweis

Ab .NET Framework 2.0, es wird empfohlen, Sie erstellen XmlWriter Instanzen mithilfe der XmlWriter.Create Methode und die XmlWriterSettings Klasse, um die neuen Funktionen nutzen.Starting with the .NET Framework 2.0, we recommend that you create XmlWriter instances by using the XmlWriter.Create method and the XmlWriterSettings class to take advantage of new functionality.

XmlTextWriter verwaltet einen Namespacestapel, der alle Namespaces in der aktuellen Elementstapel definiert entspricht.XmlTextWriter maintains a namespace stack corresponding to all the namespaces defined in the current element stack. Mithilfe von XmlTextWriter können Sie manuell Namespaces deklarieren.Using XmlTextWriter you can declare namespaces manually.

w.WriteStartElement("root");  
w.WriteAttributeString("xmlns", "x", null, "urn:1");  
 w.WriteStartElement("item","urn:1");  
 w.WriteEndElement();  
 w.WriteStartElement("item","urn:1");  
 w.WriteEndElement();  
w.WriteEndElement();  

Der oben aufgeführten C#-Code erzeugt die folgende Ausgabe.The above C# code produces the following output. XmlTextWriter definiert die Namespacedeklaration auf das Stammelement, um zu vermeiden, dass auf die beiden untergeordneten Elementen dupliziert.XmlTextWriter promotes the namespace declaration to the root element to avoid having it duplicated on the two child elements. Die untergeordneten Elemente übernehmen das Präfix aus der Namespacedeklaration.The child elements pick up the prefix from the namespace declaration.

<root xmlns:x="urn:1">  
 <x:item/>  
 <x:item/>  
</x:root>  

XmlTextWriter Außerdem können Sie die aktuellen Namespacedeklaration außer Kraft zu setzen.XmlTextWriter also allows you to override the current namespace declaration. Im folgenden Beispiel wird der Namespace-URI "123" von "Abc", um die XML-Element überschrieben <x:node xmlns:x="abc"/>.In the following example, the namespace URI "123" is overridden by "abc" to produce the XML element <x:node xmlns:x="abc"/>.

w.WriteStartElement("x","node","123");  
w.WriteAttributeString("xmlns","x",null,"abc");  

Mithilfe von Write-Methoden, die ein Präfix als Argument akzeptieren können Sie auch angeben, das Präfix verwenden.By using the write methods that take a prefix as an argument you can also specify which prefix to use. Im folgenden Beispiel werden zwei unterschiedliche Präfixe an denselben Namespace-URI, um die XML-Text zugeordnet <x:root xmlns:x="urn:1"><y:item xmlns:y="urn:1"/></x:root>.In the following example, two different prefixes are mapped to the same namespace URI to produce the XML text <x:root xmlns:x="urn:1"><y:item xmlns:y="urn:1"/></x:root>.

XmlTextWriter w = new XmlTextWriter(Console.Out);  
w.WriteStartElement("x","root","urn:1");  
 w.WriteStartElement("y","item","urn:1");  
 w.WriteEndElement();  
w.WriteEndElement();  
w.Close();  

Wenn mehrere Namespacedeklarationen denselben Namespace-URI, unterschiedliche Präfixe zuordnen XmlTextWriter führt Sie den Stapel der Namespacedeklarationen rückwärts und wählt die nächste aus.If there are multiple namespace declarations mapping different prefixes to the same namespace URI, XmlTextWriter walks the stack of namespace declarations backwards and picks the closest one.

XmlTextWriter w = new XmlTextWriter(Console.Out);  
w.Formatting = Formatting.Indented;  
w.WriteStartElement("x","root","urn:1");  
w.WriteStartElement("y","item","urn:1");  
w.WriteAttributeString("attr","urn:1","123");  
w.WriteEndElement();  
w.WriteEndElement();  
w.Close();  

Im obigen C#-Beispiel da die WriteAttributeString Aufruf wird kein Präfix angegeben, die der Writer verwendet das letzte Präfix, das auf den Namespacestapel verschoben und wird die folgende XML erstellt:In the above C# example, because the WriteAttributeString call does not specify a prefix, the writer uses the last prefix pushed onto the namespace stack, and produces the following XML:

<x:root xmlns:x="urn:1">  
 <y:item y:attr="123" xmlns:y="urn:1" />  
</x:root>  

Wenn der Namespacekonflikte auftreten, XmlTextWriter diese durch alternative Präfixe generieren aufgelöst.If namespace conflicts occur, XmlTextWriter resolves them by generating alternate prefixes. Wenn ein Attribut- und Elementnamen haben dasselbe Präfix, z. B. aber unterschiedliche Namespaces XmlWriter für das Attribut ein anderes Präfix generiert.For example, if an attribute and element have the same prefix but different namespaces, XmlWriter generates an alternate prefix for the attribute. Die generierten Präfixe werden mit dem Namen n{i} , in denen i ist eine bei 1 beginnende Zahl.The generated prefixes are named n{i} where i is a number beginning at 1. Die Anzahl wird für jedes Element auf 1 zurückgesetzt.The number is reset to 1 for each element.

Attribute, die einen Namespace-URI zugeordnet sind, müssen ein Präfix (Standard, die Namespaces für Attribute nicht gelten) haben.Attributes which are associated with a namespace URI must have a prefix (default namespaces do not apply to attributes). Dies entspricht Abschnitt 5.2 der W3C-Namespaces in XML-Empfehlung.This conforms to section 5.2 of the W3C Namespaces in XML recommendation. Wenn ein Attribut verweist auf einen Namespace-URI, aber kein Präfix angegeben ist, generiert der Writer ein Präfix für das Attribut an.If an attribute references a namespace URI, but does not specify a prefix, the writer generates a prefix for the attribute.

Wenn Sie ein leeres Element schreiben, ein zusätzliches Leerzeichen wurde zwischen Tagnamen und dem schließenden Tag, z. B. <item />.When writing an empty element, an additional space is added between tag name and the closing tag, for example <item />. Dadurch wird die Kompatibilität mit älteren Browsern.This provides compatibility with older browsers.

Wenn eine String dient als Methodenparameter null und String.Empty entsprechen.When a String is used as method parameter, null and String.Empty are equivalent. String.Empty folgt den W3C-Regeln.String.Empty follows the W3C rules.

Um stark typisierte Daten zu schreiben, verwenden die XmlConvert -Klasse zum Konvertieren von Datentypen in eine Zeichenfolge.To write strongly typed data, use the XmlConvert class to convert data types to string. Der folgende C#-Code konvertiert z. B. die Daten aus Double zu String und schreibt das Element <price>19.95</price>.For example, the following C# code converts the data from Double to String and writes the element <price>19.95</price>.

Double price = 19.95;  
writer.WriteElementString("price", XmlConvert.ToString(price));  

XmlTextWriter Folgendes wird nicht überprüft werden:XmlTextWriter does not check for the following:

  • Attribut-und Elementnamen enthält ungültige Zeichen.Invalid characters in attribute and element names.

  • Unicode-Zeichen, die die angegebene Codierung nicht passen.Unicode characters that do not fit the specified encoding. Wenn die angegebene Codierung nicht Unicode-Zeichen passen die XmlTextWriter nicht mit Escapezeichen versehen die Unicode-Zeichen in Zeichenentitäten.If the Unicode characters do not fit the specified encoding, the XmlTextWriter does not escape the Unicode characters into character entities.

  • Doppelte Attribute.Duplicate attributes.

  • Zeichen in der DOCTYPE-public-Bezeichner oder ein Systembezeichner.Characters in the DOCTYPE public identifier or system identifier.

SicherheitsüberlegungenSecurity Considerations

Die folgenden Elemente sind zu berücksichtigende Aspekte bei der Arbeit mit der XmlTextWriter Klasse.The following items are things to consider when working with the XmlTextWriter class.

  • Ausnahmen, die von der XmlTextWriter können offen legen, die Informationen über Pfade, die Sie nicht möchten, die der Anwendung weitergegeben.Exceptions thrown by the XmlTextWriter can disclose path information that you do not want bubbled up to the application. Die Anwendungen müssen diese Ausnahmen abfangen und entsprechend verarbeiten.Your applications must catch exceptions and process them appropriately.

  • Wenn ein XmlTextWriter an eine andere Anwendung übergeben wird, wird der zu Grunde liegenden Stream für diese Anwendung offengelegt.When you pass the XmlTextWriter to another application the underlying stream is exposed to that application. Übergeben Sie an eine teilweise vertrauenswürdige Anwendung ein von der XmlTextWriter-Methode erstelltes XmlWriter-Objekt anstelle eines Create-Objekts.If you need to pass the XmlTextWriter to a semi-trusted application, you should use an XmlWriter object created by the Create method instead.

  • Die XmlTextWriter überprüft nicht, dass alle Daten, die an die WriteDocType oder WriteRaw Methoden.The XmlTextWriter does not validate any data that is passed to the WriteDocType or WriteRaw methods. Sie sollten keine willkürlichen Daten an diese Methoden übergeben.You should not pass arbitrary data to these methods.

  • Wenn die Standardeinstellungen geändert werden, besteht keine Garantie, dass die generierte Ausgabe wohlgeformten XML-Daten ist.If the default settings are changed, there is no guarantee that the generated output is well-formed XML data.

  • Akzeptieren Sie keine unterstützende Komponenten, wie z. B. eine Encoding Objekt, aus einer nicht vertrauenswürdigen Quelle.Do not accept supporting components, such as an Encoding object, from an untrusted source.

Konstruktoren

XmlTextWriter(Stream, Encoding) XmlTextWriter(Stream, Encoding) XmlTextWriter(Stream, Encoding) XmlTextWriter(Stream, Encoding)

Erstellt mithilfe des angegebenen Streams und der angegebenen Codierung eine Instanz der XmlTextWriter-Klasse.Creates an instance of the XmlTextWriter class using the specified stream and encoding.

XmlTextWriter(String, Encoding) XmlTextWriter(String, Encoding) XmlTextWriter(String, Encoding) XmlTextWriter(String, Encoding)

Erstellt mithilfe der angegebenen Datei eine Instanz der XmlTextWriter-Klasse.Creates an instance of the XmlTextWriter class using the specified file.

XmlTextWriter(TextWriter) XmlTextWriter(TextWriter) XmlTextWriter(TextWriter) XmlTextWriter(TextWriter)

Erstellt mithilfe des angegebenen TextWriter eine Instanz der XmlTextWriter-Klasse.Creates an instance of the XmlTextWriter class using the specified TextWriter.

Eigenschaften

BaseStream BaseStream BaseStream BaseStream

Ruft das zugrunde liegende Streamobjekt ab.Gets the underlying stream object.

Formatting Formatting Formatting Formatting

Gibt die Formatierung der Ausgabe an.Indicates how the output is formatted.

Indentation Indentation Indentation 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.Gets or sets how many IndentChars to write for each level in the hierarchy when Formatting is set to Formatting.Indented.

IndentChar IndentChar IndentChar IndentChar

Ruft ab oder legt fest, welches Zeichen für den Einzug verwendet werden soll, wenn Formatting auf Formatting.Indented festgelegt ist.Gets or sets which character to use for indenting when Formatting is set to Formatting.Indented.

Namespaces Namespaces Namespaces Namespaces

Ruft einen Wert ab, der angibt, ob Namespaces unterstützt werden, oder legt diesen fest.Gets or sets a value indicating whether to do namespace support.

QuoteChar QuoteChar QuoteChar QuoteChar

Ruft ab oder legt fest, welches Zeichen als Anführungszeichen für Attributwerte verwendet werden soll.Gets or sets which character to use to quote attribute values.

Settings Settings Settings Settings

Ruft das zum Erstellen dieser XmlWriterSettings-Instanz verwendete XmlWriter-Objekt ab.Gets the XmlWriterSettings object used to create this XmlWriter instance.

(Inherited from XmlWriter)
WriteState WriteState WriteState WriteState

Ruft den Zustand des Writers ab.Gets the state of the writer.

XmlLang XmlLang XmlLang XmlLang

Ruft den aktuellen xml:lang-Bereich ab.Gets the current xml:lang scope.

XmlSpace XmlSpace XmlSpace XmlSpace

Ruft einen XmlSpace ab, der den aktuellen xml:space-Bereich darstellt.Gets an XmlSpace representing the current xml:space scope.

Methoden

Close() Close() Close() Close()

Schließt diesen Stream und den zugrunde liegenden Stream.Closes this stream and the underlying stream.

Dispose() Dispose() Dispose() Dispose()

Gibt alle von der aktuellen Instanz der XmlWriter-Klasse verwendeten Ressourcen frei.Releases all resources used by the current instance of the XmlWriter class.

(Inherited from XmlWriter)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von XmlWriter verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the XmlWriter and optionally releases the managed resources.

(Inherited from XmlWriter)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Flush() Flush() Flush() Flush()

Entleert den Pufferinhalt in die zugrunde liegenden Streams und entleert den zugrunde liegenden Stream ebenfalls.Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

FlushAsync() FlushAsync() FlushAsync() FlushAsync()

Entleert den Pufferinhalt asynchron in die zugrunde liegenden Streams und entleert den zugrunde liegenden Stream ebenfalls.Asynchronously flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

(Inherited from XmlWriter)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
LookupPrefix(String) LookupPrefix(String) LookupPrefix(String) LookupPrefix(String)

Gibt das nächstliegende Präfix zurück, das im aktuellen Namespacebereich für den Namespace-URI definiert ist.Returns the closest prefix defined in the current namespace scope for the namespace URI.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)
WriteAttributes(XmlReader, Boolean) WriteAttributes(XmlReader, Boolean) WriteAttributes(XmlReader, Boolean) WriteAttributes(XmlReader, Boolean)

Schreibt beim Überschreiben in einer abgeleiteten Klasse sämtliche an der aktuellen Position gefundenen Attribute in den XmlReader.When overridden in a derived class, writes out all the attributes found at the current position in the XmlReader.

(Inherited from XmlWriter)
WriteAttributesAsync(XmlReader, Boolean) WriteAttributesAsync(XmlReader, Boolean) WriteAttributesAsync(XmlReader, Boolean) WriteAttributesAsync(XmlReader, Boolean)

Schreibt asynchron alle Attribute aus, die in der aktuellen Position in XmlReader gefunden werden.Asynchronously writes out all the attributes found at the current position in the XmlReader.

(Inherited from XmlWriter)
WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse das Attribut mit dem angegebenen lokalen Namen und Wert.When overridden in a derived class, writes out the attribute with the specified local name and value.

(Inherited from XmlWriter)
WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse ein Attribut mit dem angegebenen lokalen Namen, Namespace-URI und Wert.When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value.

(Inherited from XmlWriter)
WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) 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.When overridden in a derived class, writes out the attribute with the specified prefix, local name, namespace URI, and value.

(Inherited from XmlWriter)
WriteAttributeStringAsync(String, String, String, String) WriteAttributeStringAsync(String, String, String, String) WriteAttributeStringAsync(String, String, String, String) WriteAttributeStringAsync(String, String, String, String)

Schreibt ein Attribut asynchron mit dem angegebenen Präfix, lokalen Namen, Namespace-URI und Wert.Asynchronously writes out the attribute with the specified prefix, local name, namespace URI, and value.

(Inherited from XmlWriter)
WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32)

Codiert die angegebenen binären Bytes als base64 und schreibt den resultierenden Text.Encodes the specified binary bytes as base64 and writes out the resulting text.

WriteBase64Async(Byte[], Int32, Int32) WriteBase64Async(Byte[], Int32, Int32) WriteBase64Async(Byte[], Int32, Int32) WriteBase64Async(Byte[], Int32, Int32)

Codiert die angegebenen binären Bytes asynchron als Base64 und schreibt den resultierenden Text.Asynchronously encodes the specified binary bytes as Base64 and writes out the resulting text.

(Inherited from XmlWriter)
WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32)

Codiert die angegebenen binären Bytes als Binhex und schreibt den resultierenden Text.Encodes the specified binary bytes as binhex and writes out the resulting text.

WriteBinHexAsync(Byte[], Int32, Int32) WriteBinHexAsync(Byte[], Int32, Int32) WriteBinHexAsync(Byte[], Int32, Int32) WriteBinHexAsync(Byte[], Int32, Int32)

Codiert die angegebenen binären Bytes asynchron als BinHex und schreibt den resultierenden Text.Asynchronously encodes the specified binary bytes as BinHex and writes out the resulting text.

(Inherited from XmlWriter)
WriteCData(String) WriteCData(String) WriteCData(String) WriteCData(String)

Schreibt einen <![CDATA[...]]>-Block mit dem angegebenen Text.Writes out a <![CDATA[...]]> block containing the specified text.

WriteCDataAsync(String) WriteCDataAsync(String) WriteCDataAsync(String) WriteCDataAsync(String)

Schreibt asynchron einen <![CDATA[...]]>-Block mit dem angegebenen Text.Asynchronously writes out a <![CDATA[...]]> block containing the specified text.

(Inherited from XmlWriter)
WriteCharEntity(Char) WriteCharEntity(Char) WriteCharEntity(Char) WriteCharEntity(Char)

Erzwingt das Generieren einer Zeichenentität für den angegebenen Unicode-Zeichenwert.Forces the generation of a character entity for the specified Unicode character value.

WriteCharEntityAsync(Char) WriteCharEntityAsync(Char) WriteCharEntityAsync(Char) WriteCharEntityAsync(Char)

Erzwingt das Generieren einer Zeichenentität asynchron für den angegebenen Unicode-Zeichenwert.Asynchronously forces the generation of a character entity for the specified Unicode character value.

(Inherited from XmlWriter)
WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32)

Schreibt Text in jeweils einen Puffer.Writes text one buffer at a time.

WriteCharsAsync(Char[], Int32, Int32) WriteCharsAsync(Char[], Int32, Int32) WriteCharsAsync(Char[], Int32, Int32) WriteCharsAsync(Char[], Int32, Int32)

Schreibt Text asynchron in jeweils einen Puffer.Asynchronously writes text one buffer at a time.

(Inherited from XmlWriter)
WriteComment(String) WriteComment(String) WriteComment(String) WriteComment(String)

Schreibt den Kommentar <!--...--> mit dem angegebenen Text.Writes out a comment <!--...--> containing the specified text.

WriteCommentAsync(String) WriteCommentAsync(String) WriteCommentAsync(String) WriteCommentAsync(String)

Schreibt asynchron einen Kommentar <!--...-->, der den angegebenen Text enthält.Asynchronously writes out a comment <!--...--> containing the specified text.

(Inherited from XmlWriter)
WriteDocType(String, String, String, String) WriteDocType(String, String, String, String) WriteDocType(String, String, String, String) WriteDocType(String, String, String, String)

Schreibt die DOCTYPE-Deklaration mit dem angegebenen Namen und optionalen Attributen.Writes the DOCTYPE declaration with the specified name and optional attributes.

WriteDocTypeAsync(String, String, String, String) WriteDocTypeAsync(String, String, String, String) WriteDocTypeAsync(String, String, String, String) WriteDocTypeAsync(String, String, String, String)

Schreibt die DOCTYPE-Deklaration asynchron mit dem angegebenen Namen und optionalen Attributen.Asynchronously writes the DOCTYPE declaration with the specified name and optional attributes.

(Inherited from XmlWriter)
WriteElementString(String, String) WriteElementString(String, String) WriteElementString(String, String) WriteElementString(String, String)

Schreibt ein Element mit dem angegebenen lokalen Namen und Wert.Writes an element with the specified local name and value.

(Inherited from XmlWriter)
WriteElementString(String, String, String) WriteElementString(String, String, String) WriteElementString(String, String, String) WriteElementString(String, String, String)

Schreibt ein Element mit dem angegebenen lokalen Namen, Namespace-URI und Wert.Writes an element with the specified local name, namespace URI, and value.

(Inherited from XmlWriter)
WriteElementString(String, String, String, String) WriteElementString(String, String, String, String) WriteElementString(String, String, String, String) WriteElementString(String, String, String, String)

Schreibt ein Element mit dem angegebenen Präfix, lokalen Namen, Namespace-URI und Wert.Writes an element with the specified prefix, local name, namespace URI, and value.

(Inherited from XmlWriter)
WriteElementStringAsync(String, String, String, String) WriteElementStringAsync(String, String, String, String) WriteElementStringAsync(String, String, String, String) WriteElementStringAsync(String, String, String, String)

Schreibt ein Element asynchron mit dem angegebenen Präfix, lokalen Namen, Namespace-URI und Wert.Asynchronously writes an element with the specified prefix, local name, namespace URI, and value.

(Inherited from XmlWriter)
WriteEndAttribute() WriteEndAttribute() WriteEndAttribute() WriteEndAttribute()

Schließt den vorherigen Aufruf von WriteStartAttribute(String, String, String).Closes the previous WriteStartAttribute(String, String, String) call.

WriteEndAttributeAsync() WriteEndAttributeAsync() WriteEndAttributeAsync() WriteEndAttributeAsync()

Schließt den asynchronen vorherigen WriteStartAttribute(String, String)-Aufruf.Asynchronously closes the previous WriteStartAttribute(String, String) call.

(Inherited from XmlWriter)
WriteEndDocument() WriteEndDocument() WriteEndDocument() WriteEndDocument()

Schließt alle geöffneten Elemente oder Attribute und setzt den Writer in den Startzustand zurück.Closes any open elements or attributes and puts the writer back in the Start state.

WriteEndDocumentAsync() WriteEndDocumentAsync() WriteEndDocumentAsync() WriteEndDocumentAsync()

Schließt alle geöffneten Elemente oder Attribute asynchron und setzt den Writer in den Startzustand zurück.Asynchronously closes any open elements or attributes and puts the writer back in the Start state.

(Inherited from XmlWriter)
WriteEndElement() WriteEndElement() WriteEndElement() WriteEndElement()

Schließt ein Element und löst den entsprechenden Namespacebereich auf.Closes one element and pops the corresponding namespace scope.

WriteEndElementAsync() WriteEndElementAsync() WriteEndElementAsync() WriteEndElementAsync()

Schließt ein Element asynchron und löst den entsprechenden Namespacebereich auf.Asynchronously closes one element and pops the corresponding namespace scope.

(Inherited from XmlWriter)
WriteEntityRef(String) WriteEntityRef(String) WriteEntityRef(String) WriteEntityRef(String)

Schreibt einen Entitätsverweis als &name;.Writes out an entity reference as &name;.

WriteEntityRefAsync(String) WriteEntityRefAsync(String) WriteEntityRefAsync(String) WriteEntityRefAsync(String)

Schreibt einen Entitätsverweis asynchron als &name; aus.Asynchronously writes out an entity reference as &name;.

(Inherited from XmlWriter)
WriteFullEndElement() WriteFullEndElement() WriteFullEndElement() WriteFullEndElement()

Schließt ein Element und löst den entsprechenden Namespacebereich auf.Closes one element and pops the corresponding namespace scope.

WriteFullEndElementAsync() WriteFullEndElementAsync() WriteFullEndElementAsync() WriteFullEndElementAsync()

Schließt ein Element asynchron und löst den entsprechenden Namespacebereich auf.Asynchronously closes one element and pops the corresponding namespace scope.

(Inherited from XmlWriter)
WriteName(String) WriteName(String) WriteName(String) WriteName(String)

Schreibt den angegebenen Namen und prüft dessen Gültigkeit entsprechend der W3C-Empfehlung für XML, Version 1.0.Writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation.

WriteNameAsync(String) WriteNameAsync(String) WriteNameAsync(String) WriteNameAsync(String)

Schreibt den angegebenen Namen asynchron aus und prüft dessen Gültigkeit entsprechend der W3C-Empfehlung für XML, Version 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).Asynchronously writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

(Inherited from XmlWriter)
WriteNmToken(String) WriteNmToken(String) WriteNmToken(String) 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.Writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation.

WriteNmTokenAsync(String) WriteNmTokenAsync(String) WriteNmTokenAsync(String) WriteNmTokenAsync(String)

Schreibt den angegebenen Namen asynchron aus und stellt sicher, dass dieser gemäß der W3C-Empfehlung für XML, Version 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name), ein gültiges NmToken ist.Asynchronously writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

(Inherited from XmlWriter)
WriteNode(XmlReader, Boolean) WriteNode(XmlReader, Boolean) WriteNode(XmlReader, Boolean) 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.When overridden in a derived class, copies everything from the reader to the writer and moves the reader to the start of the next sibling.

(Inherited from XmlWriter)
WriteNode(XPathNavigator, Boolean) WriteNode(XPathNavigator, Boolean) WriteNode(XPathNavigator, Boolean) WriteNode(XPathNavigator, Boolean)

Kopiert den gesamten Inhalt des XPathNavigator-Objekts in den Writer.Copies everything from the XPathNavigator object to the writer. Die Position des XPathNavigator bleibt unverändert.The position of the XPathNavigator remains unchanged.

(Inherited from XmlWriter)
WriteNodeAsync(XmlReader, Boolean) WriteNodeAsync(XmlReader, Boolean) WriteNodeAsync(XmlReader, Boolean) 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.Asynchronously copies everything from the reader to the writer and moves the reader to the start of the next sibling.

(Inherited from XmlWriter)
WriteNodeAsync(XPathNavigator, Boolean) WriteNodeAsync(XPathNavigator, Boolean) WriteNodeAsync(XPathNavigator, Boolean) WriteNodeAsync(XPathNavigator, Boolean)

Kopiert asynchron den gesamten Inhalt des XPathNavigator-Objekt in den Writer.Asynchronously copies everything from the XPathNavigator object to the writer. Die Position des XPathNavigator bleibt unverändert.The position of the XPathNavigator remains unchanged.

(Inherited from XmlWriter)
WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String)

Schreibt eine Verarbeitungsanweisung mit einem Leerzeichen zwischen dem Namen und dem Text wie folgt: <?name text?>.Writes out a processing instruction with a space between the name and text as follows: <?name text?>.

WriteProcessingInstructionAsync(String, String) WriteProcessingInstructionAsync(String, String) WriteProcessingInstructionAsync(String, String) WriteProcessingInstructionAsync(String, String)

Schreibt eine Verarbeitungsanweisung asynchron mit einem Leerzeichen zwischen dem Namen und dem Text wie folgt: <?name text?>.Asynchronously writes out a processing instruction with a space between the name and text as follows: <?name text?>.

(Inherited from XmlWriter)
WriteQualifiedName(String, String) WriteQualifiedName(String, String) WriteQualifiedName(String, String) WriteQualifiedName(String, String)

Schreibt den durch den Namespace angegebenen Namen.Writes out the namespace-qualified name. Diese Methode sucht das Präfix im Gültigkeitsbereich des Namespaces.This method looks up the prefix that is in scope for the given namespace.

WriteQualifiedNameAsync(String, String) WriteQualifiedNameAsync(String, String) WriteQualifiedNameAsync(String, String) WriteQualifiedNameAsync(String, String)

Schreibt den durch Namespace gekennzeichneten Namen asynchron.Asynchronously writes out the namespace-qualified name. Diese Methode sucht das Präfix im Gültigkeitsbereich des Namespaces.This method looks up the prefix that is in scope for the given namespace.

(Inherited from XmlWriter)
WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32)

Schreibt unformatiertes Markup manuell aus einem Zeichenpuffer.Writes raw markup manually from a character buffer.

WriteRaw(String) WriteRaw(String) WriteRaw(String) WriteRaw(String)

Schreibt unformatiertes Markup manuell aus einer Zeichenfolge.Writes raw markup manually from a string.

WriteRawAsync(Char[], Int32, Int32) WriteRawAsync(Char[], Int32, Int32) WriteRawAsync(Char[], Int32, Int32) WriteRawAsync(Char[], Int32, Int32)

Schreibt asynchron unformatiertes Markup manuell aus einem Zeichenpuffer.Asynchronously writes raw markup manually from a character buffer.

(Inherited from XmlWriter)
WriteRawAsync(String) WriteRawAsync(String) WriteRawAsync(String) WriteRawAsync(String)

Schreibt asynchron unformatiertes Markup manuell aus einer Zeichenfolge.Asynchronously writes raw markup manually from a string.

(Inherited from XmlWriter)
WriteStartAttribute(String) WriteStartAttribute(String) WriteStartAttribute(String) WriteStartAttribute(String)

Schreibt den Anfang eines Attributs mit dem angegebenen lokalen Namen.Writes the start of an attribute with the specified local name.

(Inherited from XmlWriter)
WriteStartAttribute(String, String) WriteStartAttribute(String, String) WriteStartAttribute(String, String) WriteStartAttribute(String, String)

Schreibt den Anfang eines Attributs mit dem angegebenen lokalen Namen und dem angegebenen Namespace-URI.Writes the start of an attribute with the specified local name and namespace URI.

(Inherited from XmlWriter)
WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String)

Schreibt den Anfang eines Attributs.Writes the start of an attribute.

WriteStartAttributeAsync(String, String, String) WriteStartAttributeAsync(String, String, String) WriteStartAttributeAsync(String, String, String) WriteStartAttributeAsync(String, String, String)

Schreibt den Anfang eines Attributs asynchron mit dem angegebenen Präfix, lokalen Namen und Namespace-URI.Asynchronously writes the start of an attribute with the specified prefix, local name, and namespace URI.

(Inherited from XmlWriter)
WriteStartDocument() WriteStartDocument() WriteStartDocument() WriteStartDocument()

Schreibt die XML-Deklaration mit der Version "1.0".Writes the XML declaration with the version "1.0".

WriteStartDocument(Boolean) WriteStartDocument(Boolean) WriteStartDocument(Boolean) WriteStartDocument(Boolean)

Schreibt die XML-Deklaration mit der Version "1.0" und dem eigenständigen Attribut.Writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartDocumentAsync() WriteStartDocumentAsync() WriteStartDocumentAsync() WriteStartDocumentAsync()

Schreibt die XML-Deklaration asynchron mit der Version "1.0".Asynchronously writes the XML declaration with the version "1.0".

(Inherited from XmlWriter)
WriteStartDocumentAsync(Boolean) WriteStartDocumentAsync(Boolean) WriteStartDocumentAsync(Boolean) WriteStartDocumentAsync(Boolean)

Schreibt die XML-Deklaration asynchron mit der Version "1.0" und dem eigenständigen Attribut.Asynchronously writes the XML declaration with the version "1.0" and the standalone attribute.

(Inherited from XmlWriter)
WriteStartElement(String) WriteStartElement(String) WriteStartElement(String) WriteStartElement(String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse ein Starttag mit dem angegebenen lokalen Namen.When overridden in a derived class, writes out a start tag with the specified local name.

(Inherited from XmlWriter)
WriteStartElement(String, String) WriteStartElement(String, String) WriteStartElement(String, String) WriteStartElement(String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse das angegebene Starttag und ordnet dieses dem angegebenen Namespace zu.When overridden in a derived class, writes the specified start tag and associates it with the given namespace.

(Inherited from XmlWriter)
WriteStartElement(String, String, String) WriteStartElement(String, String, String) WriteStartElement(String, String, String) WriteStartElement(String, String, String)

Schreibt das angegebene Starttag und ordnet dieses dem angegebenen Namespace und Präfix zu.Writes the specified start tag and associates it with the given namespace and prefix.

WriteStartElementAsync(String, String, String) WriteStartElementAsync(String, String, String) WriteStartElementAsync(String, String, String) WriteStartElementAsync(String, String, String)

Schreibt das angegebene Starttag asynchron und ordnet dieses dem angegebenen Namespace und Präfix zu.Asynchronously writes the specified start tag and associates it with the given namespace and prefix.

(Inherited from XmlWriter)
WriteString(String) WriteString(String) WriteString(String) WriteString(String)

Schreibt den angegebenen Textinhalt.Writes the given text content.

WriteStringAsync(String) WriteStringAsync(String) WriteStringAsync(String) WriteStringAsync(String)

Schreibt den angegebenen Textinhalt asynchron.Asynchronously writes the given text content.

(Inherited from XmlWriter)
WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char)

Generiert und schreibt die Ersatzzeichenentität für das Ersatzzeichenpaar.Generates and writes the surrogate character entity for the surrogate character pair.

WriteSurrogateCharEntityAsync(Char, Char) WriteSurrogateCharEntityAsync(Char, Char) WriteSurrogateCharEntityAsync(Char, Char) WriteSurrogateCharEntityAsync(Char, Char)

Generiert und schreibt die Ersatzzeichenentität asynchron für das Ersatzzeichenpaar.Asynchronously generates and writes the surrogate character entity for the surrogate character pair.

(Inherited from XmlWriter)
WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean)

Schreibt einen Boolean-Wert.Writes a Boolean value.

(Inherited from XmlWriter)
WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime)

Schreibt einen DateTime-Wert.Writes a DateTime value.

(Inherited from XmlWriter)
WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset)

Schreibt einen DateTimeOffset-Wert.Writes a DateTimeOffset value.

(Inherited from XmlWriter)
WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal)

Schreibt einen Decimal-Wert.Writes a Decimal value.

(Inherited from XmlWriter)
WriteValue(Double) WriteValue(Double) WriteValue(Double) WriteValue(Double)

Schreibt einen Double-Wert.Writes a Double value.

(Inherited from XmlWriter)
WriteValue(Int32) WriteValue(Int32) WriteValue(Int32) WriteValue(Int32)

Schreibt einen Int32-Wert.Writes a Int32 value.

(Inherited from XmlWriter)
WriteValue(Int64) WriteValue(Int64) WriteValue(Int64) WriteValue(Int64)

Schreibt einen Int64-Wert.Writes a Int64 value.

(Inherited from XmlWriter)
WriteValue(Object) WriteValue(Object) WriteValue(Object) WriteValue(Object)

Schreibt den Objektwert.Writes the object value.

(Inherited from XmlWriter)
WriteValue(Single) WriteValue(Single) WriteValue(Single) WriteValue(Single)

Schreibt eine Gleitkommazahl mit einfacher Genauigkeit.Writes a single-precision floating-point number.

(Inherited from XmlWriter)
WriteValue(String) WriteValue(String) WriteValue(String) WriteValue(String)

Schreibt einen String-Wert.Writes a String value.

(Inherited from XmlWriter)
WriteWhitespace(String) WriteWhitespace(String) WriteWhitespace(String) WriteWhitespace(String)

Schreibt den angegebenen Leerraum.Writes out the given white space.

WriteWhitespaceAsync(String) WriteWhitespaceAsync(String) WriteWhitespaceAsync(String) WriteWhitespaceAsync(String)

Schreibt den angegebenen Leerraum asynchron.Asynchronously writes out the given white space.

(Inherited from XmlWriter)

Explizite Schnittstellenimplementierungen

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

Eine Beschreibung dieses Members finden Sie unter Dispose().For a description of this member, see Dispose().

(Inherited from XmlWriter)

Gilt für:

Siehe auch