Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
XmlWriter-Klasse
Stellt einen Writer für die schnelle, vorwärts gerichtete Generierung von Streams oder Dateien mit XML-Daten ohne Zwischenspeicherung dar.
Assembly: System.Xml (in System.Xml.dll)
Der XmlWriter-Typ macht die folgenden Member verfügbar.
| Name | Beschreibung | |
|---|---|---|
|
Settings | Ruft das zum Erstellen dieser XmlWriter-Instanz verwendete XmlWriterSettings-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. |
| Name | Beschreibung | |
|---|---|---|
|
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(String) | Erstellt eine neue XmlWriter-Instanz mit dem angegebenen Dateinamen. |
|
Create(StringBuilder) | Erstellt mit dem angegebenen StringBuilder eine neue XmlWriter-Instanz. |
|
Create(TextWriter) | Erstellt mit dem angegebenen TextWriter eine neue XmlWriter-Instanz. |
|
Create(XmlWriter) | Erstellt eine neue XmlWriter-Instanz mit dem angegebenen XmlWriter-Objekt. |
|
Create(Stream, XmlWriterSettings) | Erstellt eine neue XmlWriter-Instanz mit dem Stream und dem XmlWriterSettings-Objekt. |
|
Create(String, XmlWriterSettings) | Erstellt eine neue XmlWriter-Instanz mit dem Dateinamen und dem XmlWriterSettings-Objekt. |
|
Create(StringBuilder, XmlWriterSettings) | Erstellt mit dem StringBuilder-Objekt und dem XmlWriterSettings-Objekt eine neue XmlWriter-Instanz. |
|
Create(TextWriter, XmlWriterSettings) | Erstellt mit dem TextWriter-Objekt und dem XmlWriterSettings-Objekt eine neue XmlWriter-Instanz. |
|
Create(XmlWriter, XmlWriterSettings) | Erstellt mit dem angegebenen XmlWriter-Objekt und dem angegebenen XmlWriterSettings-Objekt eine neue XmlWriter-Instanz. |
|
Dispose() | |
|
Dispose(Boolean) | Gibt die vom XmlWriter verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. |
|
Equals(Object) | Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.) |
|
Finalize | Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.) |
|
Flush | Entleert beim Überschreiben in einer abgeleiteten Klasse den Inhalt des Puffers in die zugrunde liegenden Streams und leert den zugrunde liegenden Stream ebenfalls. |
|
GetHashCode | Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.) |
|
GetType | Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.) |
|
LookupPrefix | 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. (Von Object geerbt.) |
|
ToString | Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.) |
|
WriteAttributes | Schreibt beim Überschreiben in einer abgeleiteten Klasse sämtliche an der aktuellen Position gefundenen Attribute in den XmlReader. |
|
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. |
|
WriteBase64 | Codiert beim Überschreiben in einer abgeleiteten Klasse die angegebenen binären Bytes als Base64 und schreibt den resultierenden Text. |
|
WriteBinHex | Codiert beim Überschreiben in einer abgeleiteten Klasse die angegebenen binären Bytes als BinHex und schreibt den resultierenden Text. |
|
WriteCData | Schreibt beim Überschreiben in einer abgeleiteten Klasse einen <![CDATA[...]]>-Block mit dem angegebenen Text. |
|
WriteCharEntity | Erzwingt beim Überschreiben in einer abgeleiteten Klasse die Generierung einer Zeichenentität für den angegebenen Wert eines Unicode-Zeichens. |
|
WriteChars | Schreibt beim Überschreiben in einer abgeleiteten Klasse Text in jeweils einen Puffer. |
|
WriteComment | Schreibt beim Überschreiben in einer abgeleiteten Klasse den Kommentar <!--...--> mit dem angegebenen Text. |
|
WriteDocType | Schreibt beim Überschreiben in einer abgeleiteten Klasse 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 lokalen Namen, Namespace-URI und Wert. |
|
WriteEndAttribute | Schließt beim Überschreiben in einer abgeleiteten Klasse den vorherigen WriteStartAttribute-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. |
|
WriteEndElement | Schließt beim Überschreiben in einer abgeleiteten Klasse ein Element und löst den entsprechenden Namespacebereich auf. |
|
WriteEntityRef | Schreibt beim Überschreiben in einer abgeleiteten Klasse einen Entitätsverweis als &name;. |
|
WriteFullEndElement | Schließt beim Überschreiben in einer abgeleiteten Klasse ein Element und löst den entsprechenden Namespacebereich auf. |
|
WriteName | Schreibt beim Überschreiben in einer abgeleiteten Klasse den angegebenen Namen und stellt sicher, dass dieser gemäß der W3C-Empfehlung zu XML, Version 1.0 (http://www.w3.org/TR/1998/REC-xml-19980210#NT-Name), ein gültiger Name ist. |
|
WriteNmToken | Schreibt beim Überschreiben in einer abgeleiteten Klasse den angegebenen Namen und stellt sicher, dass dieser gemäß der W3C-Empfehlung zu XML, Version 1.0 (http://www.w3.org/TR/1998/REC-xml-19980210#NT-Name), ein gültiges NmToken ist. |
|
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. |
|
WriteProcessingInstruction | Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Verarbeitungsanweisung mit einem Leerzeichen zwischen dem Namen und dem Text wie folgt: <? name text?>. |
|
WriteQualifiedName | Schreibt beim Überschreiben in einer abgeleiteten Klasse den durch Namespace gekennzeichneten Namen. Diese Methode sucht das Präfix im Gültigkeitsbereich des angegebenen Namespaces. |
|
WriteRaw(String) | Schreibt beim Überschreiben in einer abgeleiteten Klasse Rohdatenmarkup manuell aus einer Zeichenfolge. |
|
WriteRaw(Char[], Int32, Int32) | Schreibt beim Überschreiben in einer abgeleiteten Klasse Rohdatenmarkup manuell aus einem Zeichenpuffer. |
|
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. |
|
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. |
|
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. |
|
WriteString | Schreibt beim Überschreiben in einer abgeleiteten Klasse den angegebenen Textinhalt. |
|
WriteSurrogateCharEntity | Generiert und schreibt beim Überschreiben in einer abgeleiteten Klasse die Ersatzzeichenentität für das Ersatzzeichenpaar. |
|
WriteValue(Boolean) | Schreibt einen Boolean-Wert. |
|
WriteValue(DateTime) | Schreibt einen DateTime-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 | Schreibt beim Überschreiben in einer abgeleiteten Klasse den angegebenen Leerraum. |
| Name | Beschreibung | |
|---|---|---|
|
IDisposable.Dispose | Eine Beschreibung dieses Members finden Sie unter IDisposable.Dispose. |
Die XmlWriter-Klasse unterstützt die W3C-Empfehlungen für XML, Version 1.0, (Extensible Markup Language) und für die Namespaces in XML.
Hinweis
|
|---|
|
Microsoft .NET Framework enthält zwar die XmlTextWriter-Klasse, die eine Implementierung der XmlWriter-Klasse ist, jedoch wird für die Version 2.0 empfohlen, die Create-Methode zu verwenden, um neue XmlWriter-Objekte zu erstellen. Mit der Create-Methode können Sie die Features angeben, die vom erstellten XmlWriter-Objekt unterstützt werden sollen. Außerdem können Sie die in der Version 2.0 eingeführten neuen Features in vollem Umfang nutzen. |
Hinweis
|
|---|
|
Wenn Sie die XmlWriter-Methoden zum Ausgeben von XML verwenden, werden die Elemente und Attribute erst geschrieben, wenn Sie die Close-Methode aufrufen. Wenn Sie beispielsweise ein XmlDocument mithilfe des XmlWriters füllen, können Sie die geschriebenen Elemente und Attribute im Zieldokument erst anzeigen, wenn Sie den XmlWriter geschlossen haben. |
Weitere Informationen über die XmlWriter-Klasse finden Sie unter Schreiben von XML mit dem "XmlWriter".
Sicherheitsüberlegungen
Beachten Sie beim Arbeiten mit der XmlWriter-Klasse folgende Punkte:
-
Vom XmlWriter ausgelöste Ausnahmen können Pfadinformationen offen legen, die in der Anwendung nicht weitergegeben werden sollen. Die Anwendungen müssen Ausnahmen abfangen und entsprechend verarbeiten.
-
Der XmlWriter überprüft keine Daten, die an die WriteDocType-Methode oder WriteRaw-Methode übergeben werden. Sie sollten keine willkürlichen Daten an diese Methoden übergeben.
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Hinweis