XmlWriter.Create XmlWriter.Create XmlWriter.Create XmlWriter.Create Method

Definition

Erstellt eine neue XmlWriter-Instanz.Creates a new XmlWriter instance.

Überlädt

Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings)

Erstellt mit dem angegebenen XmlWriter-Objekt und dem angegebenen XmlWriter-Objekt eine neue XmlWriterSettings-Instanz.Creates a new XmlWriter instance using the specified XmlWriter and XmlWriterSettings objects.

Create(String, XmlWriterSettings) Create(String, XmlWriterSettings) Create(String, XmlWriterSettings) Create(String, XmlWriterSettings)

Erstellt eine neue XmlWriter-Instanz mit dem Dateinamen und dem XmlWriterSettings-Objekt.Creates a new XmlWriter instance using the filename and XmlWriterSettings object.

Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings)

Erstellt mit dem XmlWriter-Objekt und dem TextWriter-Objekt eine neue XmlWriterSettings-Instanz.Creates a new XmlWriter instance using the TextWriter and XmlWriterSettings objects.

Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings)

Erstellt eine neue XmlWriter-Instanz mit dem Stream und dem XmlWriterSettings-Objekt.Creates a new XmlWriter instance using the stream and XmlWriterSettings object.

Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings)

Erstellt mit dem XmlWriter-Objekt und dem StringBuilder-Objekt eine neue XmlWriterSettings-Instanz.Creates a new XmlWriter instance using the StringBuilder and XmlWriterSettings objects.

Create(StringBuilder) Create(StringBuilder) Create(StringBuilder) Create(StringBuilder)

Erstellt mit dem angegebenen XmlWriter eine neue StringBuilder-Instanz.Creates a new XmlWriter instance using the specified StringBuilder.

Create(String) Create(String) Create(String) Create(String)

Erstellt eine neue XmlWriter-Instanz mit dem angegebenen Dateinamen.Creates a new XmlWriter instance using the specified filename.

Create(TextWriter) Create(TextWriter) Create(TextWriter) Create(TextWriter)

Erstellt mit dem angegebenen XmlWriter eine neue TextWriter-Instanz.Creates a new XmlWriter instance using the specified TextWriter.

Create(Stream) Create(Stream) Create(Stream) Create(Stream)

Erstellt eine neue XmlWriter-Instanz mit dem angegebenen Stream.Creates a new XmlWriter instance using the specified stream.

Create(XmlWriter) Create(XmlWriter) Create(XmlWriter) Create(XmlWriter)

Erstellt eine neue XmlWriter-Instanz mit dem angegebenen XmlWriter-Objekt.Creates a new XmlWriter instance using the specified XmlWriter object.

Hinweise

Einige der settings XmlWriterSettings über Ladungen enthalten einen Parameter, der ein Objekt akzeptiert. CreateSome of the Create overloads include a settings parameter that accepts an XmlWriterSettings object. Sie können dieses Objekt für Folgendes verwenden:You can use this object to:

  • Geben Sie an, welche Funktionen für das erstellte XmlWriter Objekt unterstützt werden sollen.Specify which features you want supported on the created XmlWriter object.

  • Verwenden Sie XmlWriterSettings das-Objekt, um mehrere Writer-Objekte zu erstellen.Reuse the XmlWriterSettings object to create multiple writer objects. Das XmlWriterSettings-Objekt wird kopiert und für jeden erstellten Writer als schreibgeschützt markiert.The XmlWriterSettings object is copied and marked read-only for each created writer. Änderungen von Einstellungen in einer XmlWriterSettings-Instanz wirken sich nicht auf Writer mit denselben Einstellungen aus.Changes to the settings on an XmlWriterSettings instance do not affect existing writers with the same settings. Deshalb können Sie dieselben Einstellungen verwenden, um mehrere Writer mit denselben Funktionen zu erstellen.Thus, you can use the same settings to create multiple writers with the same functionality. Sie können auch die Einstellungen in einer XmlWriterSettings-Instanz ändern und einen neuen Writer mit einer anderen Gruppe von Funktionen erstellen.Or, you can modify the settings on an XmlWriterSettings instance and create a new writer with a different set of features.

  • Hinzufügen von Funktionen zu einem vorhandenen XML-Writer.Add features to an existing XML writer. Die Create-Methode kann ein anderes XmlWriter-Objekt annehmen.The Create method can accept another XmlWriter object. Das zugrunde XmlWriter liegende-Objekt muss kein XML-Writer sein, der von der Create statischen-Methode erstellt wurde.The underlying XmlWriter object does not have to be an XML writer created by the static Create method. Beispielsweise können Sie einen benutzerdefinierten XML-Writer angeben, um zusätzliche Funktionen hinzuzufügen.For example, you can specify a user-defined XML writer to add additional features to.

  • Profitieren Sie von Features wie besserer Überprüfung der Konformität und Konformität mit der XML 1,0-Empfehlung , die nur für XmlWriter Objekte verfügbar ist, die Create von der statischen-Methode erstellt wurden.Take full advantage of features such as better conformance checking and compliance to the XML 1.0 recommendation that are available only on XmlWriter objects created by the static Create method.

Wenn Sie eine Create Überladung verwenden, die kein XmlWriterSettings -Objekt akzeptiert, werden die folgenden Standard-Writer-Einstellungen verwendet:If you use a Create overload that doesn't accept an XmlWriterSettings object, the following default writer settings are used:

EinstellungSetting StandardDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Zwei LeerzeichenTwo spaces
NamespaceHandling Default(keine Entfernung)Default (no removal)
NewLineChars \r\n (Wagenrücklauf, Zeilenumbruch)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Hinweis

Obwohl die-.NET Framework die XmlTextWriter -Klasse enthält, bei der es sich um XmlWriter eine konkrete Implementierung der-Klasse handelt XmlWriter , empfiehlt es sich Create ,-Instanzen mit der-Methode zu erstellen.Although the .NET Framework includes the XmlTextWriter class, which is a concrete implementation of the XmlWriter class, we recommend that you create XmlWriter instances by using the Create method.

Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings)

Erstellt mit dem angegebenen XmlWriter-Objekt und dem angegebenen XmlWriter-Objekt eine neue XmlWriterSettings-Instanz.Creates a new XmlWriter instance using the specified XmlWriter and XmlWriterSettings objects.

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 XmlWriter XmlWriter XmlWriter

Das XmlWriter-Objekt, dass Sie als zugrunde liegenden Writer verwenden möchten.The XmlWriter object that you want to use as the underlying writer.

settings
XmlWriterSettings XmlWriterSettings XmlWriterSettings XmlWriterSettings

Das XmlWriterSettings-Objekt zum Konfigurieren der neuen XmlWriter-Instanz.The XmlWriterSettings object used to configure the new XmlWriter instance. Wenn dies null ist, wird XmlWriterSettings mit Standardeinstellungen verwendet.If this is null, a XmlWriterSettings with default settings is used.

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.If the XmlWriter is being used with the Transform(String, XmlWriter) method, you should use the OutputSettings property to obtain an XmlWriterSettings object with the correct settings. Dieses Verfahren gewährleistet, dass das erstellte XmlWriter-Objekt über die korrekten Ausgabeeinstellungen verfügt.This ensures that the created XmlWriter object has the correct output settings.

Gibt zurück

Ein XmlWriter-Objekt, das das angegebene XmlWriter-Objekt umschließt.An XmlWriter object that is wrapped around the specified XmlWriter object.

Ausnahmen

Der writer-Wert ist null.The writer value is null.

Hinweise

Mit dieser Methode können Sie einem zugrunde liegenden XmlWriter Objekt zusätzliche Funktionen hinzufügen.This method allows you add additional features to an underlying XmlWriter object. Das zugrunde XmlWriter liegende-Objekt kann ein Objekt sein, XmlWriter.Create das von der-Methode erstellt wurde, XmlTextWriter oder ein mit der-Implementierung erstelltes Objekt.The underlying XmlWriter object can be an object created by the XmlWriter.Create method, or an object created using the XmlTextWriter implementation.

Create(String, XmlWriterSettings) Create(String, XmlWriterSettings) Create(String, XmlWriterSettings) Create(String, XmlWriterSettings)

Erstellt eine neue XmlWriter-Instanz mit dem Dateinamen und dem XmlWriterSettings-Objekt.Creates a new XmlWriter instance using the filename and XmlWriterSettings object.

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);
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 String String String

Die Datei, in die geschrieben werden soll.The file to which you want to write. Der XmlWriter erstellt eine Datei am dem angegebenen Pfad und schreibt darin in XML 1.0-Textsyntax.The XmlWriter creates a file at the specified path and writes to it in XML 1.0 text syntax. Der outputFileName muss ein Dateisystempfad sein.The outputFileName must be a file system path.

settings
XmlWriterSettings XmlWriterSettings XmlWriterSettings XmlWriterSettings

Das XmlWriterSettings-Objekt zum Konfigurieren der neuen XmlWriter-Instanz.The XmlWriterSettings object used to configure the new XmlWriter instance. Wenn dies null ist, wird XmlWriterSettings mit Standardeinstellungen verwendet.If this is null, a XmlWriterSettings with default settings is used.

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.If the XmlWriter is being used with the Transform(String, XmlWriter) method, you should use the OutputSettings property to obtain an XmlWriterSettings object with the correct settings. Dieses Verfahren gewährleistet, dass das erstellte XmlWriter-Objekt über die korrekten Ausgabeeinstellungen verfügt.This ensures that the created XmlWriter object has the correct output settings.

Gibt zurück

Ausnahmen

Beispiele

Im folgenden Beispiel wird ein XmlWriter -Objekt mit den definierten Einstellungen erstellt.The following example creates an XmlWriter object with the defined settings.

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 

Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings)

Erstellt mit dem XmlWriter-Objekt und dem TextWriter-Objekt eine neue XmlWriterSettings-Instanz.Creates a new XmlWriter instance using the TextWriter and XmlWriterSettings objects.

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 TextWriter TextWriter TextWriter

Der TextWriter, in den geschrieben werden soll.The TextWriter to which you want to write. Der XmlWriter schreibt XML 1.0-Textsyntax und fügt diese an den angegebenen TextWriter an.The XmlWriter writes XML 1.0 text syntax and appends it to the specified TextWriter.

settings
XmlWriterSettings XmlWriterSettings XmlWriterSettings XmlWriterSettings

Das XmlWriterSettings-Objekt zum Konfigurieren der neuen XmlWriter-Instanz.The XmlWriterSettings object used to configure the new XmlWriter instance. Wenn dies null ist, wird XmlWriterSettings mit Standardeinstellungen verwendet.If this is null, a XmlWriterSettings with default settings is used.

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.If the XmlWriter is being used with the Transform(String, XmlWriter) method, you should use the OutputSettings property to obtain an XmlWriterSettings object with the correct settings. Dieses Verfahren gewährleistet, dass das erstellte XmlWriter-Objekt über die korrekten Ausgabeeinstellungen verfügt.This ensures that the created XmlWriter object has the correct output settings.

Gibt zurück

Ausnahmen

Beispiele

Im folgenden Beispiel wird eine XML-Zeichenfolge geschrieben.The following example writes out an XML string.

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

Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings)

Erstellt eine neue XmlWriter-Instanz mit dem Stream und dem XmlWriterSettings-Objekt.Creates a new XmlWriter instance using the stream and XmlWriterSettings object.

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 Stream Stream Stream

Der Stream, in den geschrieben werden soll.The stream to which you want to write. Der XmlWriter schreibt XML 1.0-Textsyntax und fügt diese an den angegebenen Stream an.The XmlWriter writes XML 1.0 text syntax and appends it to the specified stream.

settings
XmlWriterSettings XmlWriterSettings XmlWriterSettings XmlWriterSettings

Das XmlWriterSettings-Objekt zum Konfigurieren der neuen XmlWriter-Instanz.The XmlWriterSettings object used to configure the new XmlWriter instance. Wenn dies null ist, wird XmlWriterSettings mit Standardeinstellungen verwendet.If this is null, a XmlWriterSettings with default settings is used.

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.If the XmlWriter is being used with the Transform(String, XmlWriter) method, you should use the OutputSettings property to obtain an XmlWriterSettings object with the correct settings. Dieses Verfahren gewährleistet, dass das erstellte XmlWriter-Objekt über die korrekten Ausgabeeinstellungen verfügt.This ensures that the created XmlWriter object has the correct output settings.

Gibt zurück

Ausnahmen

Der stream-Wert ist null.The stream value is null.

Beispiele

Im folgenden Beispiel wird ein XML-Fragment in einen Speicherstream geschrieben.The following example writes an XML fragment to a memory stream.

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 additonal 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 additonal processing on the stream.

Hinweise

XmlWriter schreibt immer eine Byte Reihenfolge-Marke (BOM) in den zugrunde liegenden Datenstrom. Einige Datenströme dürfen jedoch nicht über eine BOM verfügen.XmlWriter always writes a Byte Order Mark (BOM) to the underlying data stream; however, some streams must not have a BOM. Um die BOM auszulassen, erstellen Sie ein XmlWriterSettings neues-Objekt, und legen Sie die Encoding- UTF8Encoding Eigenschaft auf ein neues-Objekt fest, wobei der boolesche Wert im Konstruktor auf false festgelegt ist.To omit the BOM, create a new XmlWriterSettings object and set the Encoding property to be a new UTF8Encoding object with the Boolean value in the constructor set to false.

Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings)

Erstellt mit dem XmlWriter-Objekt und dem StringBuilder-Objekt eine neue XmlWriterSettings-Instanz.Creates a new XmlWriter instance using the StringBuilder and XmlWriterSettings objects.

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 StringBuilder StringBuilder StringBuilder

Der StringBuilder, in den geschrieben werden soll.The StringBuilder to which to write to. Vom XmlWriter geschriebener Inhalt wird an den StringBuilder angefügt.Content written by the XmlWriter is appended to the StringBuilder.

settings
XmlWriterSettings XmlWriterSettings XmlWriterSettings XmlWriterSettings

Das XmlWriterSettings-Objekt zum Konfigurieren der neuen XmlWriter-Instanz.The XmlWriterSettings object used to configure the new XmlWriter instance. Wenn dies null ist, wird XmlWriterSettings mit Standardeinstellungen verwendet.If this is null, a XmlWriterSettings with default settings is used.

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.If the XmlWriter is being used with the Transform(String, XmlWriter) method, you should use the OutputSettings property to obtain an XmlWriterSettings object with the correct settings. Dieses Verfahren gewährleistet, dass das erstellte XmlWriter-Objekt über die korrekten Ausgabeeinstellungen verfügt.This ensures that the created XmlWriter object has the correct output settings.

Gibt zurück

Ausnahmen

Der builder-Wert ist null.The builder value is null.

Create(StringBuilder) Create(StringBuilder) Create(StringBuilder) Create(StringBuilder)

Erstellt mit dem angegebenen XmlWriter eine neue StringBuilder-Instanz.Creates a new XmlWriter instance using the specified 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 StringBuilder StringBuilder StringBuilder

Der StringBuilder, in den geschrieben werden soll.The StringBuilder to which to write to. Vom XmlWriter geschriebener Inhalt wird an den StringBuilder angefügt.Content written by the XmlWriter is appended to the StringBuilder.

Gibt zurück

Ausnahmen

Der builder-Wert ist null.The builder value is null.

Hinweise

Wenn Sie diese Überladung verwenden, XmlWriterSettings wird ein-Objekt mit Standardeinstellungen verwendet, um den XML-Writer zu erstellen.When you use this overload, an XmlWriterSettings object with default settings is used to create the XML writer.

EinstellungSetting StandardDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Zwei LeerzeichenTwo spaces
NamespaceHandling Default(keine Entfernung)Default (no removal)
NewLineChars \r\n (Wagenrücklauf, Zeilenumbruch)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Wenn Sie die Funktionen angeben möchten, die für den erstellten XML-Writer unterstützt werden sollen, verwenden Sie XmlWriterSettings eine Überladung, die ein-Objekt als eines der XmlWriterSettings Argumente annimmt, und übergeben Sie ein-Objekt mit den benutzerdefinierten Einstellungen.If you want to specify the features to support on the created XML writer, use an overload that takes an XmlWriterSettings object as one of its arguments, and pass in a XmlWriterSettings object with your custom settings.

Create(String) Create(String) Create(String) Create(String)

Erstellt eine neue XmlWriter-Instanz mit dem angegebenen Dateinamen.Creates a new XmlWriter instance using the specified filename.

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 String String String

Die Datei, in die geschrieben werden soll.The file to which you want to write. Der XmlWriter erstellt eine Datei am dem angegebenen Pfad und schreibt darin in XML 1.0-Textsyntax.The XmlWriter creates a file at the specified path and writes to it in XML 1.0 text syntax. Der outputFileName muss ein Dateisystempfad sein.The outputFileName must be a file system path.

Gibt zurück

Ausnahmen

Beispiele

Im folgenden Beispiel wird ein XmlWriter -Objekt erstellt und ein book-Knoten geschrieben.The following example creates an XmlWriter object and writes a book node.

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, XmlWriterSettings wird ein-Objekt mit Standardeinstellungen verwendet, um den XML-Writer zu erstellen.When you use this overload, an XmlWriterSettings object with default settings is used to create the XML writer.

EinstellungSetting StandardDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Zwei LeerzeichenTwo spaces
NamespaceHandling Default(keine Entfernung)Default (no removal)
NewLineChars \r\n (Wagenrücklauf, Zeilenumbruch)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Wenn Sie die Funktionen angeben möchten, die für den erstellten XML-Writer unterstützt werden sollen, verwenden Sie XmlWriterSettings eine Überladung, die ein-Objekt als eines der XmlWriterSettings Argumente annimmt, und übergeben Sie ein-Objekt mit den benutzerdefinierten Einstellungen.If you want to specify the features to support on the created XML writer, use an overload that takes an XmlWriterSettings object as one of its arguments, and pass in a XmlWriterSettings object with your custom settings.

Create(TextWriter) Create(TextWriter) Create(TextWriter) Create(TextWriter)

Erstellt mit dem angegebenen XmlWriter eine neue TextWriter-Instanz.Creates a new XmlWriter instance using the specified 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 TextWriter TextWriter TextWriter

Der TextWriter, in den geschrieben werden soll.The TextWriter to which you want to write. Der XmlWriter schreibt XML 1.0-Textsyntax und fügt diese an den angegebenen TextWriter an.The XmlWriter writes XML 1.0 text syntax and appends it to the specified TextWriter.

Gibt zurück

Ausnahmen

Beispiele

Im folgenden Beispiel wird ein Writer erstellt, der an die Konsole ausgibt.The following example creates a writer that outputs to the console.

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, XmlWriterSettings wird ein-Objekt mit Standardeinstellungen verwendet, um den XML-Writer zu erstellen.When you use this overload, an XmlWriterSettings object with default settings is used to create the XML writer.

EinstellungSetting StandardDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Zwei LeerzeichenTwo spaces
NamespaceHandling Default(keine Entfernung)Default (no removal)
NewLineChars \r\n (Wagenrücklauf, Zeilenumbruch)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Wenn Sie die Funktionen angeben möchten, die für den erstellten Writer unterstützt werden sollen, verwenden Sie eine XmlWriterSettings Überladung, die ein-Objekt als eines der Argumente XmlWriterSettings annimmt, und übergeben Sie ein-Objekt mit den benutzerdefinierten Einstellungen.If you want to specify the features to support on the created writer, use an overload that takes an XmlWriterSettings object as one of its arguments, and pass in an XmlWriterSettings object with your custom settings.

Create(Stream) Create(Stream) Create(Stream) Create(Stream)

Erstellt eine neue XmlWriter-Instanz mit dem angegebenen Stream.Creates a new XmlWriter instance using the specified 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 Stream Stream Stream

Der Stream, in den geschrieben werden soll.The stream to which you want to write. Der XmlWriter schreibt XML 1.0-Textsyntax und fügt diese an den angegebenen Stream an.The XmlWriter writes XML 1.0 text syntax and appends it to the specified stream.

Gibt zurück

Ausnahmen

Der stream-Wert ist null.The stream value is null.

Beispiele

Im folgenden Beispiel wird ein XML-Fragment in einen Speicherstream geschrieben.The following example writes an XML fragment to a memory stream. (Sie verwendet die Create(Stream, XmlWriterSettings) -Überladung, die auch die Einstellungen für die neue XML Writer-Instanz konfiguriert.)(It uses the Create(Stream, XmlWriterSettings) overload, which also configures the settings on the new XML writer instance.)

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 additonal 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 additonal processing on the stream.

Hinweise

Wenn Sie diese Überladung verwenden, XmlWriterSettings wird ein Objekt mit den folgenden Standardeinstellungen verwendet, um den XML-Writer zu erstellen:When you use this overload, an XmlWriterSettings object with the following default settings is used to create the XML writer:

EinstellungSetting StandardDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Zwei LeerzeichenTwo spaces
NamespaceHandling Default(keine Entfernung)Default (no removal)
NewLineChars \r\n (Wagenrücklauf, Zeilenumbruch)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Wenn Sie die Funktionen angeben möchten, die für den erstellten Writer unterstützt werden sollen, verwenden Sie eine XmlWriterSettings Überladung, die ein-Objekt als eines der Argumente XmlWriterSettings annimmt, und übergeben Sie ein-Objekt mit den benutzerdefinierten Einstellungen.If you want to specify the features to support on the created writer, use an overload that takes an XmlWriterSettings object as one of its arguments, and pass in an XmlWriterSettings object with your custom settings.

Außerdem schreibt XmlWriter immer eine Byte Reihenfolge-Marke (BOM) in den zugrunde liegenden Datenstrom. Einige Datenströme dürfen jedoch nicht über eine BOM verfügen.Also, XmlWriter always writes a Byte Order Mark (BOM) to the underlying data stream; however, some streams must not have a BOM. Um die BOM auszulassen, erstellen Sie ein XmlWriterSettings neues-Objekt, und legen Sie die Encoding- UTF8Encoding Eigenschaft auf ein neues-Objekt fest, wobei der boolesche Wert im Konstruktor auf false festgelegt ist.To omit the BOM, create a new XmlWriterSettings object and set the Encoding property to be a new UTF8Encoding object with the Boolean value in the constructor set to false.

Create(XmlWriter) Create(XmlWriter) Create(XmlWriter) Create(XmlWriter)

Erstellt eine neue XmlWriter-Instanz mit dem angegebenen XmlWriter-Objekt.Creates a new XmlWriter instance using the specified XmlWriter object.

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 XmlWriter XmlWriter XmlWriter

Das XmlWriter-Objekt, dass Sie als zugrunde liegenden Writer verwenden möchten.The XmlWriter object that you want to use as the underlying writer.

Gibt zurück

Ein XmlWriter-Objekt, das das angegebene XmlWriter-Objekt umschließt.An XmlWriter object that is wrapped around the specified XmlWriter object.

Ausnahmen

Der writer-Wert ist null.The writer value is null.

Hinweise

Diese Methode ermöglicht das Hinzufügen von Funktionen zu XmlWriter einem zugrunde liegenden Objekt.This method allows you add features to an underlying XmlWriter object. Das zugrunde XmlWriter liegende-Objekt kann ein Objekt sein, XmlWriter.Create das von der-Methode erstellt wurde, XmlTextWriter oder ein mit der-Implementierung erstelltes Objekt.The underlying XmlWriter object can be an object created by the XmlWriter.Create method, or an object created using the XmlTextWriter implementation.

Wenn Sie diese Überladung verwenden, XmlWriterSettings wird ein-Objekt mit Standardeinstellungen verwendet, um den XML-Writer zu erstellen.When you use this overload, an XmlWriterSettings object with default settings is used to create the XML writer.

EinstellungSetting StandardDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Zwei LeerzeichenTwo spaces
NamespaceHandling Default(keine Entfernung)Default (no removal)
NewLineChars \r\n (Wagenrücklauf, Zeilenumbruch)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Wenn Sie die Funktionen angeben möchten, die für den erstellten XML-Writer unterstützt werden sollen, verwenden Sie XmlWriterSettings eine Überladung, die ein-Objekt als eines der XmlWriterSettings Argumente annimmt, und übergeben Sie ein-Objekt mit den benutzerdefinierten Einstellungen.If you want to specify the features to support on the created XML writer, use an overload that takes an XmlWriterSettings object as one of its arguments, and pass in a XmlWriterSettings object with your custom settings.

Gilt für: