XmlWriter.Create Methode

Definition

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

output
XmlWriter

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

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

Erstellt eine neue XmlWriter Instanz mithilfe des angegebenen XmlWriter Objekts.

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, das Sie als zugrunde liegenden Writer verwenden möchten.

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.

Gilt für: