XmlWriter.Create Methode

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

Parameters

Retouren

Een XmlWriter object dat rond het opgegeven XmlWriter object is verpakt.

Uitzonderingen

Opmerkingen

Met deze methode kunt u extra functies toevoegen aan een onderliggend XmlWriter object. Het onderliggende XmlWriter object kan een object zijn dat is gemaakt door de XmlWriter.Create methode of een object dat is gemaakt met behulp van de XmlTextWriter implementatie.

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

Parameters

Retouren

Een XmlWriter object.

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt een XmlWriter object gemaakt met de gedefinieerde instellingen.

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

static member Create : System.IO.TextWriter * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (output As TextWriter, settings As XmlWriterSettings) As XmlWriter

Parameters

Retouren

Een XmlWriter object.

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt een XML-tekenreeks weggeschreven.

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

static member Create : System.IO.Stream * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (output As Stream, settings As XmlWriterSettings) As XmlWriter

Parameters

Retouren

Een XmlWriter object.

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt een XML-fragment naar een geheugenstroom geschreven.

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.

Opmerkingen

XmlWriter schrijft altijd een Byte Order Mark (BOM) naar de onderliggende gegevensstroom; sommige streams mogen echter geen bom hebben. Als u de bom wilt weglaten, maakt u een nieuw XmlWriterSettings object en stelt u de eigenschap Encoding in op een nieuw UTF8Encoding object met de Booleaanse waarde in de constructor ingesteld op false.

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

Parameters

Retouren

Een XmlWriter object.

Uitzonderingen

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

Parameters

Retouren

Een XmlWriter object.

Uitzonderingen

Opmerkingen

Wanneer u deze overbelasting gebruikt, wordt een XmlWriterSettings object met standaardinstellingen gebruikt om de XML-schrijver te maken.

Als u de functies wilt opgeven die moeten worden ondersteund voor de gemaakte XML-schrijver, gebruikt u een overbelasting die een XmlWriterSettings object als een van de argumenten gebruikt en geeft u een XmlWriterSettings object door met uw aangepaste instellingen.

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

Parameters

Retouren

Een XmlWriter object.

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt een XmlWriter object gemaakt en wordt een boekknooppunt geschreven.

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

Opmerkingen

Wanneer u deze overbelasting gebruikt, wordt een XmlWriterSettings object met standaardinstellingen gebruikt om de XML-schrijver te maken.

Als u de functies wilt opgeven die moeten worden ondersteund voor de gemaakte XML-schrijver, gebruikt u een overbelasting die een XmlWriterSettings object als een van de argumenten gebruikt en geeft u een XmlWriterSettings object door met uw aangepaste instellingen.

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

Parameters

Retouren

Een XmlWriter object.

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt een schrijver gemaakt die naar de console wordt uitgevoerd.

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

Opmerkingen

Wanneer u deze overbelasting gebruikt, wordt een XmlWriterSettings object met standaardinstellingen gebruikt om de XML-schrijver te maken.

Als u de functies wilt opgeven die moeten worden ondersteund voor de gemaakte schrijver, gebruikt u een overbelasting die een XmlWriterSettings object als een van de argumenten gebruikt en geeft u een XmlWriterSettings object door met uw aangepaste instellingen.

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

Parameters

Retouren

Een XmlWriter object.

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt een XML-fragment naar een geheugenstroom geschreven. (Hierbij wordt de Create(Stream, XmlWriterSettings) overbelasting gebruikt, waarmee ook de instellingen voor het nieuwe XML Writer-exemplaar worden geconfigureerd.)

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.

Opmerkingen

Wanneer u deze overbelasting gebruikt, wordt een XmlWriterSettings object met de volgende standaardinstellingen gebruikt om de XML-schrijver te maken:

Als u de functies wilt opgeven die moeten worden ondersteund voor de gemaakte schrijver, gebruikt u een overbelasting die een XmlWriterSettings object als een van de argumenten gebruikt en geeft u een XmlWriterSettings object door met uw aangepaste instellingen.

XmlWriter schrijft ook altijd een Byte Order Mark (BOM) naar de onderliggende gegevensstroom; sommige streams mogen echter geen bom hebben. Als u de bom wilt weglaten, maakt u een nieuw XmlWriterSettings object en stelt u de eigenschap Encoding in op een nieuw UTF8Encoding object met de Booleaanse waarde in de constructor ingesteld op false.

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

Parameters

Retouren

Een XmlWriter object dat rond het opgegeven XmlWriter object is verpakt.

Uitzonderingen

Opmerkingen

Met deze methode kunt u functies toevoegen aan een onderliggend XmlWriter object. Het onderliggende XmlWriter object kan een object zijn dat is gemaakt door de XmlWriter.Create methode of een object dat is gemaakt met behulp van de XmlTextWriter implementatie.

Wanneer u deze overbelasting gebruikt, wordt een XmlWriterSettings object met standaardinstellingen gebruikt om de XML-schrijver te maken.

Als u de functies wilt opgeven die moeten worden ondersteund voor de gemaakte XML-schrijver, gebruikt u een overbelasting die een XmlWriterSettings object als een van de argumenten gebruikt en geeft u een XmlWriterSettings object door met uw aangepaste instellingen.