XmlWriter.Create Método

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

Parâmetros

Retornos

Um objeto XmlWriter.

Exceções

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

Parâmetros

Retornos

Um objeto XmlWriter.

Exceções

Exemplos

O exemplo a seguir cria um XmlWriter objeto com as configurações definidas.

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

Parâmetros

Retornos

Um objeto XmlWriter.

Exceções

Exemplos

O exemplo a seguir grava uma cadeia de caracteres XML.

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

Parâmetros

Retornos

Um objeto XmlWriter.

Exceções

Exemplos

O exemplo a seguir grava um fragmento XML em um fluxo de memória.

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.

Comentários

O XmlWriter sempre grava uma BOM (Marca de Ordem de Byte) no fluxo de dados subjacente; no entanto, alguns fluxos não devem ter uma BOM. Para omitir a BOM, crie um novo XmlWriterSettings objeto e defina a propriedade Encoding como um novo UTF8Encoding objeto com o valor booliano no construtor definido como false.

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

Parâmetros

Retornos

Um objeto XmlWriter encapsulado em torno do objeto XmlWriter especificado.

Exceções

Comentários

Esse método permite adicionar recursos adicionais a um objeto subjacente XmlWriter . O objeto subjacente XmlWriter pode ser um objeto criado pelo XmlWriter.Create método ou um objeto criado usando a XmlTextWriter implementação .

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

Parâmetros

Retornos

Um objeto XmlWriter.

Exceções

Comentários

Quando você usa essa sobrecarga, um XmlWriterSettings objeto com configurações padrão é usado para criar o gravador XML.

Se você quiser especificar os recursos a serem compatíveis com o gravador XML criado, use uma sobrecarga que usa um XmlWriterSettings objeto como um de seus argumentos e passe um XmlWriterSettings objeto com suas configurações personalizadas.

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

Parâmetros

Retornos

Um objeto XmlWriter.

Exceções

Exemplos

O exemplo a seguir cria um XmlWriter objeto e grava um nó de livro.

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

Comentários

Quando você usa essa sobrecarga, um XmlWriterSettings objeto com configurações padrão é usado para criar o gravador XML.

Se você quiser especificar os recursos a serem compatíveis com o gravador XML criado, use uma sobrecarga que usa um XmlWriterSettings objeto como um de seus argumentos e passe um XmlWriterSettings objeto com suas configurações personalizadas.

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

Parâmetros

Retornos

Um objeto XmlWriter.

Exceções

Exemplos

O exemplo a seguir cria um gravador que é gerado para o 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

Comentários

Quando você usa essa sobrecarga, um XmlWriterSettings objeto com configurações padrão é usado para criar o gravador XML.

Se você quiser especificar os recursos para dar suporte ao gravador criado, use uma sobrecarga que usa um XmlWriterSettings objeto como um de seus argumentos e passe um XmlWriterSettings objeto com suas configurações personalizadas.

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

Parâmetros

Retornos

Um objeto XmlWriter.

Exceções

Exemplos

O exemplo a seguir grava um fragmento XML em um fluxo de memória. (Ele usa a Create(Stream, XmlWriterSettings) sobrecarga, que também define as configurações na nova instância do gravador XML.)

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.

Comentários

Quando você usa essa sobrecarga, um XmlWriterSettings objeto com as seguintes configurações padrão é usado para criar o gravador XML:

Se você quiser especificar os recursos para dar suporte ao gravador criado, use uma sobrecarga que usa um XmlWriterSettings objeto como um de seus argumentos e passe um XmlWriterSettings objeto com suas configurações personalizadas.

Além disso, o XmlWriter sempre grava uma Marca de Ordem de Byte (BOM) no fluxo de dados subjacente; no entanto, alguns fluxos não devem ter uma BOM. Para omitir o BOM, crie um novo XmlWriterSettings objeto e defina a propriedade Encoding como um novo UTF8Encoding objeto com o valor booliano no construtor definido como 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

Parâmetros

Retornos

Um objeto XmlWriter encapsulado em torno do objeto XmlWriter especificado.

Exceções

Comentários

Esse método permite adicionar recursos a um objeto subjacente XmlWriter . O objeto subjacente XmlWriter pode ser um objeto criado pelo XmlWriter.Create método ou um objeto criado usando a XmlTextWriter implementação.

Quando você usa essa sobrecarga, um XmlWriterSettings objeto com configurações padrão é usado para criar o gravador XML.

Se você quiser especificar os recursos para dar suporte ao gravador XML criado, use uma sobrecarga que usa um XmlWriterSettings objeto como um de seus argumentos e passe um XmlWriterSettings objeto com suas configurações personalizadas.