XmlWriter.Create Methode

Referenz

Definition

Namespace:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

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

Create(StringBuilder, XmlWriterSettings)	Erstellt mit dem XmlWriter-Objekt und dem StringBuilder-Objekt eine neue XmlWriterSettings-Instanz.
Create(String, XmlWriterSettings)	Erstellt eine neue XmlWriter-Instanz mit dem Dateinamen und dem XmlWriterSettings-Objekt.
Create(TextWriter, XmlWriterSettings)	Erstellt mit dem XmlWriter-Objekt und dem TextWriter-Objekt eine neue XmlWriterSettings-Instanz.
Create(Stream, XmlWriterSettings)	Erstellt eine neue XmlWriter-Instanz mit dem Stream und dem XmlWriterSettings-Objekt.
Create(XmlWriter, XmlWriterSettings)	Erstellt mit dem angegebenen XmlWriter-Objekt und dem angegebenen XmlWriter-Objekt eine neue XmlWriterSettings-Instanz.
Create(StringBuilder)	Erstellt mit dem angegebenen XmlWriter eine neue StringBuilder-Instanz.
Create(String)	Erstellt eine neue XmlWriter-Instanz mit dem angegebenen Dateinamen.
Create(TextWriter)	Erstellt mit dem angegebenen XmlWriter eine neue TextWriter-Instanz.
Create(Stream)	Erstellt eine neue XmlWriter-Instanz mit dem angegebenen Stream.
Create(XmlWriter)	Erstellt eine neue XmlWriter-Instanz mit dem angegebenen XmlWriter-Objekt.

Hinweise

Einige der Create Überladungen enthalten einen settings Parameter, der ein XmlWriterSettings -Objekt akzeptiert. Sie können dieses Objekt für Folgendes verwenden:

Geben Sie an, welche Features für das erstellte XmlWriter Objekt unterstützt werden sollen.
Verwenden Sie das XmlWriterSettings Objekt wieder, um mehrere Writerobjekte zu erstellen. Das XmlWriterSettings-Objekt wird kopiert und für jeden erstellten Writer als schreibgeschützt markiert. Änderungen von Einstellungen in einer XmlWriterSettings-Instanz wirken sich nicht auf Writer mit denselben Einstellungen aus. Deshalb können Sie dieselben Einstellungen verwenden, um mehrere Writer mit denselben Funktionen zu erstellen. Sie können auch die Einstellungen in einer XmlWriterSettings-Instanz ändern und einen neuen Writer mit einer anderen Gruppe von Funktionen erstellen.
Fügen Sie einem vorhandenen XML-Writer Features hinzu. Die Create-Methode kann ein anderes XmlWriter-Objekt annehmen. Das zugrunde liegende XmlWriter Objekt muss kein XML-Writer sein, der von der statischen Create Methode erstellt wurde. Sie können beispielsweise einen benutzerdefinierten XML-Writer angeben, dem zusätzliche Features hinzugefügt werden sollen.
Nutzen Sie features wie eine bessere Konformitätsüberprüfung und Konformität mit der XML 1.0-Empfehlung , die nur für XmlWriter Objekte verfügbar sind, die mit 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:

Einstellung	Standard
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Zwei Leerzeichen
NamespaceHandling	Default (keine Entfernung)
NewLineChars	`\r\n` (Wagenrücklauf, Zeilenumbruch)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Hinweis

Obwohl der .NET Framework die XmlTextWriter -Klasse enthält, bei der es sich um eine konkrete Implementierung der XmlWriter -Klasse handelt, empfiehlt es sich, Instanzen mithilfe der Create -Methode zu erstellenXmlWriter.

Create(StringBuilder, XmlWriterSettings)

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

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, in den geschrieben werden soll. Vom XmlWriter geschriebener Inhalt wird an den StringBuilder angefügt.

settings: XmlWriterSettings

Das XmlWriterSettings-Objekt zum Konfigurieren der neuen XmlWriter-Instanz. Wenn dies null ist, wird XmlWriterSettings mit Standardeinstellungen verwendet.

Wenn der XmlWriter mit der Transform(String, XmlWriter)-Methode verwendet wird, sollten Sie die OutputSettings-Eigenschaft verwenden, um ein XmlWriterSettings-Objekt mit den korrekten Einstellungen abzurufen. Dieses Verfahren gewährleistet, dass das erstellte XmlWriter-Objekt über die korrekten Ausgabeeinstellungen verfügt.

Gibt zurück

XmlWriter

Ein XmlWriter-Objekt.

Ausnahmen

ArgumentNullException

Der builder-Wert ist null.

Gilt für:

.NET 7 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Create(String, XmlWriterSettings)

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

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 geschrieben werden soll. Der XmlWriter erstellt eine Datei am dem angegebenen Pfad und schreibt darin in XML 1.0-Textsyntax. Der outputFileName muss ein Dateisystempfad sein.

settings: XmlWriterSettings

Das XmlWriterSettings-Objekt zum Konfigurieren der neuen XmlWriter-Instanz. Wenn dies null ist, wird XmlWriterSettings mit Standardeinstellungen verwendet.

Gibt zurück

XmlWriter

Ein XmlWriter-Objekt.

Ausnahmen

ArgumentNullException

Der url-Wert 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:

.NET 7 und andere Versionen

Produkt	Versionen
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	2.0, 2.1

Create(TextWriter, XmlWriterSettings)

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

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 geschrieben werden soll. Der XmlWriter schreibt XML 1.0-Textsyntax und fügt diese an den angegebenen TextWriter an.

settings: XmlWriterSettings

Das XmlWriterSettings-Objekt zum Konfigurieren der neuen XmlWriter-Instanz. Wenn dies null ist, wird XmlWriterSettings mit Standardeinstellungen verwendet.

Gibt zurück

XmlWriter

Ein XmlWriter-Objekt.

Ausnahmen

ArgumentNullException

Der text-Wert 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:

.NET 7 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Create(Stream, XmlWriterSettings)

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

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 Stream, in den geschrieben werden soll. Der XmlWriter schreibt XML 1.0-Textsyntax und fügt diese an den angegebenen Stream an.

settings: XmlWriterSettings

Das XmlWriterSettings-Objekt zum Konfigurieren der neuen XmlWriter-Instanz. Wenn dies null ist, wird XmlWriterSettings mit Standardeinstellungen verwendet.

Gibt zurück

XmlWriter

Ein XmlWriter-Objekt.

Ausnahmen

ArgumentNullException

Der stream-Wert 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 eine Byte Order Mark (BOM) in den zugrunde liegenden Datenstrom. Einige Streams dürfen jedoch keine BoM haben. Um die Stückliste 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:

.NET 7 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Create(XmlWriter, XmlWriterSettings)

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

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

output: XmlWriter

Das XmlWriter-Objekt, dass Sie als zugrunde liegenden Writer verwenden möchten.

settings: XmlWriterSettings

Das XmlWriterSettings-Objekt zum Konfigurieren der neuen XmlWriter-Instanz. Wenn dies null ist, wird XmlWriterSettings mit Standardeinstellungen verwendet.

Gibt zurück

XmlWriter

Ein XmlWriter-Objekt, das das angegebene XmlWriter-Objekt umschließt.

Ausnahmen

ArgumentNullException

Der writer-Wert 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 von der XmlWriter.Create -Methode erstelltes Objekt oder ein Objekt sein, das mithilfe der XmlTextWriter Implementierung erstellt wurde.

Gilt für:

.NET 7 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Create(StringBuilder)

Erstellt mit dem angegebenen XmlWriter eine neue StringBuilder-Instanz.

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, in den geschrieben werden soll. Vom XmlWriter geschriebener Inhalt wird an den StringBuilder angefügt.

Gibt zurück

XmlWriter

Ein XmlWriter-Objekt.

Ausnahmen

ArgumentNullException

Der builder-Wert ist null.

Hinweise

Wenn Sie diese Überladung verwenden, wird ein XmlWriterSettings Objekt mit Standardeinstellungen verwendet, um den XML-Writer zu erstellen.

Einstellung	Standard
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Zwei Leerzeichen
NamespaceHandling	Default (keine Entfernung)
NewLineChars	`\r\n` (Wagenrücklauf, Zeilenumbruch)
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 akzeptiert und ein XmlWriterSettings Objekt mit Ihren benutzerdefinierten Einstellungen übergeben.

Gilt für:

.NET 7 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Create(String)

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 geschrieben werden soll. Der XmlWriter erstellt eine Datei am dem angegebenen Pfad und schreibt darin in XML 1.0-Textsyntax. Der outputFileName muss ein Dateisystempfad sein.

Gibt zurück

XmlWriter

Ein XmlWriter-Objekt.

Ausnahmen

ArgumentNullException

Der url-Wert 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.

Einstellung	Standard
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Zwei Leerzeichen
NamespaceHandling	Default (keine Entfernung)
NewLineChars	`\r\n` (Wagenrücklauf, Zeilenumbruch)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Gilt für:

.NET 7 und andere Versionen

Produkt	Versionen
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	2.0, 2.1

Create(TextWriter)

Erstellt mit dem angegebenen XmlWriter eine neue TextWriter-Instanz.

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 geschrieben werden soll. Der XmlWriter schreibt XML 1.0-Textsyntax und fügt diese an den angegebenen TextWriter an.

Gibt zurück

XmlWriter

Ein XmlWriter-Objekt.

Ausnahmen

ArgumentNullException

Der text-Wert ist null.

Beispiele

Im folgenden Beispiel wird ein Writer erstellt, der an die Konsole ausgibt.

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.

Einstellung	Standard
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Zwei Leerzeichen
NamespaceHandling	Default (keine Entfernung)
NewLineChars	`\r\n` (Wagenrücklauf, Zeilenumbruch)
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 ihrer Argumente akzeptiert, und übergeben Sie ein XmlWriterSettings Objekt mit Ihren benutzerdefinierten Einstellungen.

Gilt für:

.NET 7 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Create(Stream)

Erstellt eine neue XmlWriter-Instanz mit dem angegebenen Stream.

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 Stream, in den geschrieben werden soll. Der XmlWriter schreibt XML 1.0-Textsyntax und fügt diese an den angegebenen Stream an.

Gibt zurück

XmlWriter

Ein XmlWriter-Objekt.

Ausnahmen

ArgumentNullException

Der stream-Wert 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:

Einstellung	Standard
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Zwei Leerzeichen
NamespaceHandling	Default (keine Entfernung)
NewLineChars	`\r\n` (Wagenrücklauf, Zeilenumbruch)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Außerdem schreibt XmlWriter immer eine Byte order Mark (BOM) in den zugrunde liegenden Datenstrom. Einige Streams dürfen jedoch keine BOM aufweisen. 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:

.NET 7 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Create(XmlWriter)

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

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

output: XmlWriter

Das XmlWriter-Objekt, dass Sie als zugrunde liegenden Writer verwenden möchten.

Gibt zurück

XmlWriter

Ein XmlWriter-Objekt, das das angegebene XmlWriter-Objekt umschließt.

Ausnahmen

ArgumentNullException

Der writer-Wert 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 mithilfe der XmlTextWriter -Implementierung erstellt wurde.

Wenn Sie diese Überladung verwenden, wird ein XmlWriterSettings -Objekt mit Standardeinstellungen verwendet, um den XML-Writer zu erstellen.

Einstellung	Standard
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Zwei Leerzeichen
NamespaceHandling	Default (keine Entfernung)
NewLineChars	`\r\n` (Wagenrücklauf, Zeilenumbruch)
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 ihrer Argumente akzeptiert, und übergeben Sie ein XmlWriterSettings Objekt mit Ihren benutzerdefinierten Einstellungen.

Gilt für:

.NET 7 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Freigeben über

XmlWriter.Create Methode

Definition

Überlädt

Hinweise

Create(StringBuilder, XmlWriterSettings)

Parameter

Gibt zurück

Ausnahmen

Gilt für:

Create(String, XmlWriterSettings)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Gilt für:

Create(TextWriter, XmlWriterSettings)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Gilt für:

Create(Stream, XmlWriterSettings)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

Create(XmlWriter, XmlWriterSettings)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

Create(StringBuilder)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

Create(String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

Create(TextWriter)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

Create(Stream)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

Create(XmlWriter)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

Feedback

Zusätzliche Ressourcen