XmlWriter.Create Methode
Definition
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.
Erstellt eine neue XmlWriter-Instanz.
Überlädt
| Name | Beschreibung |
|---|---|
| Create(StringBuilder, XmlWriterSettings) |
Erstellt eine neue XmlWriter Instanz mit den und StringBuilder den XmlWriterSettings Objekten. |
| Create(String, XmlWriterSettings) |
Erstellt eine neue XmlWriter Instanz mithilfe des Dateinamens und XmlWriterSettings Objekts. |
| Create(TextWriter, XmlWriterSettings) |
Erstellt eine neue XmlWriter Instanz mit den und TextWriter den XmlWriterSettings Objekten. |
| Create(Stream, XmlWriterSettings) |
Erstellt eine neue XmlWriter Instanz mithilfe des Datenstroms und XmlWriterSettings Objekts. |
| Create(XmlWriter, XmlWriterSettings) |
Erstellt eine neue XmlWriter Instanz mithilfe der angegebenen XmlWriter Und XmlWriterSettings Objekte. |
| Create(StringBuilder) |
Erstellt eine neue XmlWriter Instanz mithilfe der angegebenen StringBuilder. |
| Create(String) |
Erstellt eine neue XmlWriter Instanz mit dem angegebenen Dateinamen. |
| Create(TextWriter) |
Erstellt eine neue XmlWriter Instanz mithilfe der angegebenen TextWriter. |
| Create(Stream) |
Erstellt eine neue XmlWriter Instanz mithilfe des angegebenen Datenstroms. |
| Create(XmlWriter) |
Erstellt eine neue XmlWriter Instanz mithilfe des angegebenen XmlWriter Objekts. |
Hinweise
Einige der Überladungen enthalten einen Create Parameter, der settings ein XmlWriterSettings Objekt akzeptiert. Sie können dieses Objekt verwenden, um:
Geben Sie an, welche Features für das erstellte XmlWriter Objekt unterstützt werden sollen.
Verwenden Sie das XmlWriterSettings Objekt wieder, um mehrere Writer-Objekte zu erstellen. Das XmlWriterSettings Objekt wird für jeden erstellten Writer kopiert und schreibgeschützt markiert. Änderungen an den Einstellungen einer XmlWriterSettings Instanz wirken sich nicht auf vorhandene Autoren mit den gleichen Einstellungen aus. Daher können Sie dieselben Einstellungen verwenden, um mehrere Autoren mit derselben Funktionalität zu erstellen. Oder Sie können die Einstellungen für eine XmlWriterSettings Instanz ändern und einen neuen Writer mit einem anderen Satz von Features erstellen.
Hinzufügen von Features zu einem vorhandenen XML-Writer. Die Create Methode kann ein anderes XmlWriter Objekt akzeptieren. Das zugrunde liegende XmlWriter Objekt muss kein XML-Writer sein, der von der statischen Create Methode erstellt wurde. Sie können z. B. einen benutzerdefinierten XML-Writer angeben, dem zusätzliche Features hinzugefügt werden sollen.
Nutzen Sie die vorteile von Features wie einer besseren Konformitätsüberprüfung und -einhaltung der XML 1.0-Empfehlung , die nur für XmlWriter Objekte verfügbar sind, die von der statischen Create Methode erstellt wurden.
Wenn Sie eine Create Überladung verwenden, die kein XmlWriterSettings Objekt akzeptiert, werden die folgenden Standardeinstellungen für Writer verwendet:
| Setting | Vorgabe |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Zwei Leerzeichen |
| NamespaceHandling | Default (keine Entfernung) |
| NewLineChars |
\r\n (Wagenrücklauf, Zeilenvorschub) für Nicht-Unix-Plattformen oder \n (Zeilenvorschub) für Unix-Plattformen |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Note
Obwohl das .NET Framework die klasse XmlTextWriter enthält, bei der es sich um eine konkrete Implementierung der klasse XmlWriter handelt, wird empfohlen, XmlWriter Instanzen mithilfe der Create-Methode zu erstellen.
Create(StringBuilder, XmlWriterSettings)
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
Erstellt eine neue XmlWriter Instanz mit den und StringBuilder den XmlWriterSettings Objekten.
public:
static System::Xml::XmlWriter ^ Create(System::Text::StringBuilder ^ output, System::Xml::XmlWriterSettings ^ settings);
public static System.Xml.XmlWriter Create(System.Text.StringBuilder output, System.Xml.XmlWriterSettings settings);
public static System.Xml.XmlWriter Create(System.Text.StringBuilder output, System.Xml.XmlWriterSettings? settings);
static member Create : System.Text.StringBuilder * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter
Public Shared Function Create (output As StringBuilder, settings As XmlWriterSettings) As XmlWriter
Parameter
- output
- StringBuilder
Der StringBuilder zu schreibende Code. Inhalt, der von dem XmlWriter geschrieben wird, wird an die StringBuilderAngefügt.
- settings
- XmlWriterSettings
Das XmlWriterSettings Objekt, das zum Konfigurieren der neuen XmlWriter Instanz verwendet wird. Wenn dies der Fall ist null, wird eine XmlWriterSettings mit Standardeinstellungen verwendet.
Wenn die XmlWriter Methode verwendet Transform(String, XmlWriter) wird, sollten Sie die OutputSettings Eigenschaft verwenden, um ein XmlWriterSettings Objekt mit den richtigen Einstellungen abzurufen. Dadurch wird sichergestellt, dass das erstellte XmlWriter Objekt über die richtigen Ausgabeeinstellungen verfügt.
Gibt zurück
Ein XmlWriter-Objekt.
Ausnahmen
output ist null.
Gilt für:
Create(String, XmlWriterSettings)
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
Erstellt eine neue XmlWriter Instanz mithilfe des Dateinamens und XmlWriterSettings Objekts.
public:
static System::Xml::XmlWriter ^ Create(System::String ^ outputFileName, System::Xml::XmlWriterSettings ^ settings);
public static System.Xml.XmlWriter Create(string outputFileName, System.Xml.XmlWriterSettings? settings);
public static System.Xml.XmlWriter Create(string outputFileName, System.Xml.XmlWriterSettings settings);
static member Create : string * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter
Public Shared Function Create (outputFileName As String, settings As XmlWriterSettings) As XmlWriter
Parameter
- outputFileName
- String
Die Datei, in die Sie schreiben möchten. Die XmlWriter Datei wird im angegebenen Pfad erstellt und in die XML 1.0-Textsyntax geschrieben. Dies outputFileName muss ein Dateisystempfad sein.
- settings
- XmlWriterSettings
Das XmlWriterSettings Objekt, das zum Konfigurieren der neuen XmlWriter Instanz verwendet wird. Wenn dies der Fall ist null, wird eine XmlWriterSettings mit Standardeinstellungen verwendet.
Wenn die XmlWriter Methode verwendet Transform(String, XmlWriter) wird, sollten Sie die OutputSettings Eigenschaft verwenden, um ein XmlWriterSettings Objekt mit den richtigen Einstellungen abzurufen. Dadurch wird sichergestellt, dass das erstellte XmlWriter Objekt über die richtigen Ausgabeeinstellungen verfügt.
Gibt zurück
Ein XmlWriter-Objekt.
Ausnahmen
outputFileName ist null.
Beispiele
Im folgenden Beispiel wird ein XmlWriter Objekt mit den definierten Einstellungen erstellt.
using System;
using System.IO;
using System.Xml;
using System.Text;
public class Sample {
public static void Main() {
XmlWriter writer = null;
try {
// Create an XmlWriterSettings object with the correct options.
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.IndentChars = ("\t");
settings.OmitXmlDeclaration = true;
// Create the XmlWriter object and write some content.
writer = XmlWriter.Create("data.xml", settings);
writer.WriteStartElement("book");
writer.WriteElementString("item", "tesing");
writer.WriteEndElement();
writer.Flush();
}
finally {
if (writer != null)
writer.Close();
}
}
}
Imports System.IO
Imports System.Xml
Imports System.Text
Public Class Sample
Public Shared Sub Main()
Dim writer As XmlWriter = Nothing
Try
' Create an XmlWriterSettings object with the correct options.
Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.Indent = true
settings.IndentChars = (ControlChars.Tab)
settings.OmitXmlDeclaration = true
' Create the XmlWriter object and write some content.
writer = XmlWriter.Create("data.xml", settings)
writer.WriteStartElement("book")
writer.WriteElementString("item", "tesing")
writer.WriteEndElement()
writer.Flush()
Finally
If Not (writer Is Nothing) Then
writer.Close()
End If
End Try
End Sub
End Class
Gilt für:
Create(TextWriter, XmlWriterSettings)
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
Erstellt eine neue XmlWriter Instanz mit den und TextWriter den XmlWriterSettings Objekten.
public:
static System::Xml::XmlWriter ^ Create(System::IO::TextWriter ^ output, System::Xml::XmlWriterSettings ^ settings);
public static System.Xml.XmlWriter Create(System.IO.TextWriter output, System.Xml.XmlWriterSettings settings);
public static System.Xml.XmlWriter Create(System.IO.TextWriter output, System.Xml.XmlWriterSettings? settings);
static member Create : System.IO.TextWriter * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter
Public Shared Function Create (output As TextWriter, settings As XmlWriterSettings) As XmlWriter
Parameter
- output
- TextWriter
Der TextWriter , in den Sie schreiben möchten. Die XmlWriter XML 1.0-Textsyntax schreibt und fügt sie an die angegebene TextWriterAnfüge an.
- settings
- XmlWriterSettings
Das XmlWriterSettings Objekt, das zum Konfigurieren der neuen XmlWriter Instanz verwendet wird. Wenn dies der Fall ist null, wird eine XmlWriterSettings mit Standardeinstellungen verwendet.
Wenn die XmlWriter Methode verwendet Transform(String, XmlWriter) wird, sollten Sie die OutputSettings Eigenschaft verwenden, um ein XmlWriterSettings Objekt mit den richtigen Einstellungen abzurufen. Dadurch wird sichergestellt, dass das erstellte XmlWriter Objekt über die richtigen Ausgabeeinstellungen verfügt.
Gibt zurück
Ein XmlWriter-Objekt.
Ausnahmen
output ist null.
Beispiele
Im folgenden Beispiel wird eine XML-Zeichenfolge geschrieben.
XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
StringWriter sw = new StringWriter();
using (XmlWriter writer = XmlWriter.Create(sw, settings))
{
writer.WriteStartElement("book");
writer.WriteElementString("price", "19.95");
writer.WriteEndElement();
writer.Flush();
String output = sw.ToString();
}
Dim settings As New XmlWriterSettings()
settings.OmitXmlDeclaration = True
Dim sw As New StringWriter()
Using writer As XmlWriter = XmlWriter.Create(sw, settings)
writer.WriteStartElement("book")
writer.WriteElementString("price", "19.95")
writer.WriteEndElement()
writer.Flush()
Dim output As String = sw.ToString()
End Using
Gilt für:
Create(Stream, XmlWriterSettings)
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
Erstellt eine neue XmlWriter Instanz mithilfe des Datenstroms und XmlWriterSettings Objekts.
public:
static System::Xml::XmlWriter ^ Create(System::IO::Stream ^ output, System::Xml::XmlWriterSettings ^ settings);
public static System.Xml.XmlWriter Create(System.IO.Stream output, System.Xml.XmlWriterSettings settings);
public static System.Xml.XmlWriter Create(System.IO.Stream output, System.Xml.XmlWriterSettings? settings);
static member Create : System.IO.Stream * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter
Public Shared Function Create (output As Stream, settings As XmlWriterSettings) As XmlWriter
Parameter
- output
- Stream
Der Datenstrom, in den Sie schreiben möchten. Die XmlWriter XML 1.0-Textsyntax schreibt und fügt sie an den angegebenen Datenstrom an.
- settings
- XmlWriterSettings
Das XmlWriterSettings Objekt, das zum Konfigurieren der neuen XmlWriter Instanz verwendet wird. Wenn dies der Fall ist null, wird eine XmlWriterSettings mit Standardeinstellungen verwendet.
Wenn die XmlWriter Methode verwendet Transform(String, XmlWriter) wird, sollten Sie die OutputSettings Eigenschaft verwenden, um ein XmlWriterSettings Objekt mit den richtigen Einstellungen abzurufen. Dadurch wird sichergestellt, dass das erstellte XmlWriter Objekt über die richtigen Ausgabeeinstellungen verfügt.
Gibt zurück
Ein XmlWriter-Objekt.
Ausnahmen
output ist null.
Beispiele
Im folgenden Beispiel wird ein XML-Fragment in einen Speicherdatenstrom geschrieben.
XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.CloseOutput = false;
// Create the XmlWriter object and write some content.
MemoryStream strm = new MemoryStream();
XmlWriter writer = XmlWriter.Create(strm, settings);
writer.WriteElementString("orderID", "1-456-ab");
writer.WriteElementString("orderID", "2-36-00a");
writer.Flush();
writer.Close();
// Do additional processing on the stream.
Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.OmitXmlDeclaration = true
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.CloseOutput = false
' Create the XmlWriter object and write some content.
Dim strm as MemoryStream = new MemoryStream()
Dim writer As XmlWriter = XmlWriter.Create(strm, settings)
writer.WriteElementString("orderID", "1-456-ab")
writer.WriteElementString("orderID", "2-36-00a")
writer.Flush()
writer.Close()
' Do additional processing on the stream.
Hinweise
XmlWriter schreibt immer ein Byte Order Mark (BOM) in den zugrunde liegenden Datenstrom. Einige Datenströme dürfen jedoch keine BOM haben. Um die BOM auszulassen, erstellen Sie ein neues XmlWriterSettings Objekt, und legen Sie die Encoding-Eigenschaft auf ein neues UTF8Encoding Objekt fest, wobei der boolesche Wert im Konstruktor auf "false" festgelegt ist.
Gilt für:
Create(XmlWriter, XmlWriterSettings)
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
Erstellt eine neue XmlWriter Instanz mithilfe der angegebenen XmlWriter Und XmlWriterSettings Objekte.
public:
static System::Xml::XmlWriter ^ Create(System::Xml::XmlWriter ^ output, System::Xml::XmlWriterSettings ^ settings);
public static System.Xml.XmlWriter Create(System.Xml.XmlWriter output, System.Xml.XmlWriterSettings settings);
public static System.Xml.XmlWriter Create(System.Xml.XmlWriter output, System.Xml.XmlWriterSettings? settings);
static member Create : System.Xml.XmlWriter * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter
Public Shared Function Create (output As XmlWriter, settings As XmlWriterSettings) As XmlWriter
Parameter
- settings
- XmlWriterSettings
Das XmlWriterSettings Objekt, das zum Konfigurieren der neuen XmlWriter Instanz verwendet wird. Wenn dies der Fall ist null, wird eine XmlWriterSettings mit Standardeinstellungen verwendet.
Wenn die XmlWriter Methode verwendet Transform(String, XmlWriter) wird, sollten Sie die OutputSettings Eigenschaft verwenden, um ein XmlWriterSettings Objekt mit den richtigen Einstellungen abzurufen. Dadurch wird sichergestellt, dass das erstellte XmlWriter Objekt über die richtigen Ausgabeeinstellungen verfügt.
Gibt zurück
Ein XmlWriter Objekt, das um das angegebene XmlWriter Objekt herum umbrochen wird.
Ausnahmen
output ist null.
Hinweise
Mit dieser Methode können Sie einem zugrunde liegenden XmlWriter Objekt zusätzliche Features hinzufügen. Das zugrunde liegende XmlWriter Objekt kann ein Objekt sein, das von der XmlWriter.Create Methode erstellt wurde, oder ein Objekt, das mit der XmlTextWriter Implementierung erstellt wurde.
Gilt für:
Create(StringBuilder)
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
Erstellt eine neue XmlWriter Instanz mithilfe der angegebenen StringBuilder.
public:
static System::Xml::XmlWriter ^ Create(System::Text::StringBuilder ^ output);
public static System.Xml.XmlWriter Create(System.Text.StringBuilder output);
static member Create : System.Text.StringBuilder -> System.Xml.XmlWriter
Public Shared Function Create (output As StringBuilder) As XmlWriter
Parameter
- output
- StringBuilder
Der StringBuilder zu schreibende Code. Inhalt, der von dem XmlWriter geschrieben wird, wird an die StringBuilderAngefügt.
Gibt zurück
Ein XmlWriter-Objekt.
Ausnahmen
output ist null.
Hinweise
Wenn Sie diese Überladung verwenden, wird ein XmlWriterSettings Objekt mit Standardeinstellungen verwendet, um den XML-Writer zu erstellen.
| Setting | Vorgabe |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Zwei Leerzeichen |
| NamespaceHandling | Default (keine Entfernung) |
| NewLineChars |
\r\n (Wagenrücklauf, Zeilenvorschub) für Nicht-Unix-Plattformen oder \n (Zeilenvorschub) für Unix-Plattformen |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Wenn Sie die Features angeben möchten, die für den erstellten XML-Writer unterstützt werden sollen, verwenden Sie eine Überladung, die ein XmlWriterSettings Objekt als eines seiner Argumente verwendet, und übergeben Sie ein XmlWriterSettings Objekt mit ihren benutzerdefinierten Einstellungen.
Gilt für:
Create(String)
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
Erstellt eine neue XmlWriter Instanz mit dem angegebenen Dateinamen.
public:
static System::Xml::XmlWriter ^ Create(System::String ^ outputFileName);
public static System.Xml.XmlWriter Create(string outputFileName);
static member Create : string -> System.Xml.XmlWriter
Public Shared Function Create (outputFileName As String) As XmlWriter
Parameter
- outputFileName
- String
Die Datei, in die Sie schreiben möchten. Die XmlWriter Datei wird im angegebenen Pfad erstellt und in die XML 1.0-Textsyntax geschrieben. Dies outputFileName muss ein Dateisystempfad sein.
Gibt zurück
Ein XmlWriter-Objekt.
Ausnahmen
outputFileName ist null.
Beispiele
Im folgenden Beispiel wird ein XmlWriter Objekt erstellt und ein Buchknoten geschrieben.
using (XmlWriter writer = XmlWriter.Create("output.xml"))
{
writer.WriteStartElement("book");
writer.WriteElementString("price", "19.95");
writer.WriteEndElement();
writer.Flush();
}
Using writer As XmlWriter = XmlWriter.Create("output.xml")
writer.WriteStartElement("book")
writer.WriteElementString("price", "19.95")
writer.WriteEndElement()
writer.Flush()
End Using
Hinweise
Wenn Sie diese Überladung verwenden, wird ein XmlWriterSettings Objekt mit Standardeinstellungen verwendet, um den XML-Writer zu erstellen.
| Setting | Vorgabe |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Zwei Leerzeichen |
| NamespaceHandling | Default (keine Entfernung) |
| NewLineChars |
\r\n (Wagenrücklauf, Zeilenvorschub) für Nicht-Unix-Plattformen oder \n (Zeilenvorschub) für Unix-Plattformen |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Wenn Sie die Features angeben möchten, die für den erstellten XML-Writer unterstützt werden sollen, verwenden Sie eine Überladung, die ein XmlWriterSettings Objekt als eines seiner Argumente verwendet, und übergeben Sie ein XmlWriterSettings Objekt mit ihren benutzerdefinierten Einstellungen.
Gilt für:
Create(TextWriter)
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
Erstellt eine neue XmlWriter Instanz mithilfe der angegebenen TextWriter.
public:
static System::Xml::XmlWriter ^ Create(System::IO::TextWriter ^ output);
public static System.Xml.XmlWriter Create(System.IO.TextWriter output);
static member Create : System.IO.TextWriter -> System.Xml.XmlWriter
Public Shared Function Create (output As TextWriter) As XmlWriter
Parameter
- output
- TextWriter
Der TextWriter , in den Sie schreiben möchten. Die XmlWriter XML 1.0-Textsyntax schreibt und fügt sie an die angegebene TextWriterAnfüge an.
Gibt zurück
Ein XmlWriter-Objekt.
Ausnahmen
output ist null.
Beispiele
Im folgenden Beispiel wird ein Writer erstellt, der in die Konsole ausgegeben wird.
using (XmlWriter writer = XmlWriter.Create(Console.Out))
{
writer.WriteStartElement("book");
writer.WriteElementString("price", "19.95");
writer.WriteEndElement();
writer.Flush();
}
Using writer As XmlWriter = XmlWriter.Create(Console.Out)
writer.WriteStartElement("book")
writer.WriteElementString("price", "19.95")
writer.WriteEndElement()
writer.Flush()
End Using
Hinweise
Wenn Sie diese Überladung verwenden, wird ein XmlWriterSettings Objekt mit Standardeinstellungen verwendet, um den XML-Writer zu erstellen.
| Setting | Vorgabe |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Zwei Leerzeichen |
| NamespaceHandling | Default (keine Entfernung) |
| NewLineChars |
\r\n (Wagenrücklauf, Zeilenvorschub) für Nicht-Unix-Plattformen oder \n (Zeilenvorschub) für Unix-Plattformen |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Wenn Sie die Features angeben möchten, die für den erstellten Writer unterstützt werden sollen, verwenden Sie eine Überladung, die ein XmlWriterSettings Objekt als eines seiner Argumente verwendet, und übergeben Sie ein XmlWriterSettings Objekt mit ihren benutzerdefinierten Einstellungen.
Gilt für:
Create(Stream)
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
Erstellt eine neue XmlWriter Instanz mithilfe des angegebenen Datenstroms.
public:
static System::Xml::XmlWriter ^ Create(System::IO::Stream ^ output);
public static System.Xml.XmlWriter Create(System.IO.Stream output);
static member Create : System.IO.Stream -> System.Xml.XmlWriter
Public Shared Function Create (output As Stream) As XmlWriter
Parameter
- output
- Stream
Der Datenstrom, in den Sie schreiben möchten. Die XmlWriter XML 1.0-Textsyntax schreibt und fügt sie an den angegebenen Datenstrom an.
Gibt zurück
Ein XmlWriter-Objekt.
Ausnahmen
output ist null.
Beispiele
Im folgenden Beispiel wird ein XML-Fragment in einen Speicherdatenstrom geschrieben. (Es verwendet die Create(Stream, XmlWriterSettings) Überladung, die auch die Einstellungen für die neue XML Writer-Instanz konfiguriert.)
XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.CloseOutput = false;
// Create the XmlWriter object and write some content.
MemoryStream strm = new MemoryStream();
XmlWriter writer = XmlWriter.Create(strm, settings);
writer.WriteElementString("orderID", "1-456-ab");
writer.WriteElementString("orderID", "2-36-00a");
writer.Flush();
writer.Close();
// Do additional processing on the stream.
Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.OmitXmlDeclaration = true
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.CloseOutput = false
' Create the XmlWriter object and write some content.
Dim strm as MemoryStream = new MemoryStream()
Dim writer As XmlWriter = XmlWriter.Create(strm, settings)
writer.WriteElementString("orderID", "1-456-ab")
writer.WriteElementString("orderID", "2-36-00a")
writer.Flush()
writer.Close()
' Do additional processing on the stream.
Hinweise
Wenn Sie diese Überladung verwenden, wird ein XmlWriterSettings Objekt mit den folgenden Standardeinstellungen verwendet, um den XML-Writer zu erstellen:
| Setting | Vorgabe |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Zwei Leerzeichen |
| NamespaceHandling | Default (keine Entfernung) |
| NewLineChars |
\r\n (Wagenrücklauf, Zeilenvorschub) für Nicht-Unix-Plattformen oder \n (Zeilenvorschub) für Unix-Plattformen |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Wenn Sie die Features angeben möchten, die für den erstellten Writer unterstützt werden sollen, verwenden Sie eine Überladung, die ein XmlWriterSettings Objekt als eines seiner Argumente verwendet, und übergeben Sie ein XmlWriterSettings Objekt mit ihren benutzerdefinierten Einstellungen.
Außerdem schreibt XmlWriter immer ein Byte Order Mark (BOM) in den zugrunde liegenden Datenstrom. Einige Datenströme dürfen jedoch keine BOM haben. Um die BOM auszulassen, erstellen Sie ein neues XmlWriterSettings Objekt, und legen Sie die Encoding-Eigenschaft auf ein neues UTF8Encoding Objekt fest, wobei der boolesche Wert im Konstruktor auf "false" festgelegt ist.
Gilt für:
Create(XmlWriter)
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
public:
static System::Xml::XmlWriter ^ Create(System::Xml::XmlWriter ^ output);
public static System.Xml.XmlWriter Create(System.Xml.XmlWriter output);
static member Create : System.Xml.XmlWriter -> System.Xml.XmlWriter
Public Shared Function Create (output As XmlWriter) As XmlWriter
Parameter
Gibt zurück
Ein XmlWriter Objekt, das um das angegebene XmlWriter Objekt herum umbrochen wird.
Ausnahmen
output ist null.
Hinweise
Mit dieser Methode können Sie einem zugrunde liegenden XmlWriter Objekt Features hinzufügen. Das zugrunde liegende XmlWriter Objekt kann ein Objekt sein, das von der XmlWriter.Create Methode erstellt wurde, oder ein Objekt, das mit der XmlTextWriter Implementierung erstellt wurde.
Wenn Sie diese Überladung verwenden, wird ein XmlWriterSettings Objekt mit Standardeinstellungen verwendet, um den XML-Writer zu erstellen.
| Setting | Vorgabe |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Zwei Leerzeichen |
| NamespaceHandling | Default (keine Entfernung) |
| NewLineChars |
\r\n (Wagenrücklauf, Zeilenvorschub) für Nicht-Unix-Plattformen oder \n (Zeilenvorschub) für Unix-Plattformen |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Wenn Sie die Features angeben möchten, die für den erstellten XML-Writer unterstützt werden sollen, verwenden Sie eine Überladung, die ein XmlWriterSettings Objekt als eines seiner Argumente verwendet, und übergeben Sie ein XmlWriterSettings Objekt mit ihren benutzerdefinierten Einstellungen.