XmlWriter.Create Método

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

Devoluções

Um XmlWriter objeto que envolve o objeto especificado XmlWriter .

Exceções

Observações

Este método permite-lhe adicionar funcionalidades adicionais a um objeto subjacente XmlWriter . O objeto subjacente XmlWriter pode ser um objeto criado pelo XmlWriter.Create método, ou um objeto criado através da XmlTextWriter implementação.

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

Parâmetros

Devoluções

Um XmlWriter objeto.

Exceções

Exemplos

O exemplo seguinte cria um XmlWriter objeto com as definiçõ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);

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

Devoluções

Um XmlWriter objeto.

Exceções

Exemplos

O exemplo seguinte escreve uma cadeia 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);

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

Devoluções

Um XmlWriter objeto.

Exceções

Exemplos

O exemplo seguinte escreve um fragmento XML num 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.

Observações

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

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

Devoluções

Um XmlWriter objeto.

Exceções

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

Devoluções

Um XmlWriter objeto.

Exceções

Observações

Quando usas esta sobrecarga, um XmlWriterSettings objeto com definições predefinidas é usado para criar o escritor XML.

Se quiseres especificar as funcionalidades a suportar no escritor XML criado, usa um overload que aceita um XmlWriterSettings objeto como um dos seus argumentos e passa um XmlWriterSettings objeto com as tuas definiçõ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

Devoluções

Um XmlWriter objeto.

Exceções

Exemplos

O exemplo seguinte cria um XmlWriter objeto e escreve um nó 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

Observações

Quando usas esta sobrecarga, um XmlWriterSettings objeto com definições predefinidas é usado para criar o escritor XML.

Se quiseres especificar as funcionalidades a suportar no escritor XML criado, usa um overload que aceita um XmlWriterSettings objeto como um dos seus argumentos e passa um XmlWriterSettings objeto com as tuas definiçõ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

Devoluções

Um XmlWriter objeto.

Exceções

Exemplos

O exemplo seguinte cria um escritor que exporta para a consola.

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

Observações

Quando usas esta sobrecarga, um XmlWriterSettings objeto com definições predefinidas é usado para criar o escritor XML.

Se quiseres especificar as funcionalidades a suportar no escritor criado, usa uma sobrecarga que aceita um XmlWriterSettings objeto como um dos seus argumentos, e passa um XmlWriterSettings objeto com as tuas definiçõ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

Devoluções

Um XmlWriter objeto.

Exceções

Exemplos

O exemplo seguinte escreve um fragmento XML num fluxo de memória. (Utiliza a Create(Stream, XmlWriterSettings) sobrecarga, que também configura as definições da nova instância do escritor 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.

Observações

Quando usa esta sobrecarga, um XmlWriterSettings objeto com as seguintes definições predefinidas é usado para criar o escritor XML:

Se quiseres especificar as funcionalidades a suportar no escritor criado, usa uma sobrecarga que aceita um XmlWriterSettings objeto como um dos seus argumentos, e passa um XmlWriterSettings objeto com as tuas definições personalizadas.

Além disso, o XmlWriter escreve sempre uma Marca de Ordem de Bytes (BOM) no fluxo de dados subjacente; no entanto, alguns fluxos não devem ter uma lista de materiais (BOM). Para omitir a BOM, crie um novo XmlWriterSettings objeto e defina a propriedade Encoding como um novo UTF8Encoding objeto com o valor Booleano no construtor definido como falso.

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

Devoluções

Um XmlWriter objeto que envolve o objeto especificado XmlWriter .

Exceções

Observações

Este método permite adicionar funcionalidades a um objeto subjacente XmlWriter . O objeto subjacente XmlWriter pode ser um objeto criado pelo XmlWriter.Create método, ou um objeto criado através da XmlTextWriter implementação.

Quando usas esta sobrecarga, um XmlWriterSettings objeto com definições predefinidas é usado para criar o escritor XML.

Se quiseres especificar as funcionalidades a suportar no escritor XML criado, usa um overload que aceita um XmlWriterSettings objeto como um dos seus argumentos e passa um XmlWriterSettings objeto com as tuas definições personalizadas.