XmlWriter.Create Methode

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

Gibt zurück

Ein XmlWriter-Objekt.

Ausnahmen

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

Gibt zurück

Ein XmlWriter-Objekt.

Ausnahmen

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

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

Gibt zurück

Ein XmlWriter-Objekt.

Ausnahmen

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

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

Gibt zurück

Ein XmlWriter-Objekt.

Ausnahmen

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.

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

Gibt zurück

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

Ausnahmen

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.

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

Gibt zurück

Ein XmlWriter-Objekt.

Ausnahmen

Hinweise

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

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.

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

Gibt zurück

Ein XmlWriter-Objekt.

Ausnahmen

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.

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.

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

Gibt zurück

Ein XmlWriter-Objekt.

Ausnahmen

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.

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.

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

Gibt zurück

Ein XmlWriter-Objekt.

Ausnahmen

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:

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.

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.

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 das angegebene XmlWriter-Objekt umschließt.

Ausnahmen

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.

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.