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

Devoluciones

XmlWriter

Un objeto XmlWriter.

Excepciones

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

Devoluciones

XmlWriter

Un objeto XmlWriter.

Excepciones

Ejemplos

En el ejemplo siguiente se crea un XmlWriter objeto con la configuración definida.

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

Devoluciones

XmlWriter

Un objeto XmlWriter.

Excepciones

Ejemplos

En el ejemplo siguiente se escribe una cadena 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

Devoluciones

XmlWriter

Un objeto XmlWriter.

Excepciones

Ejemplos

En el ejemplo siguiente se escribe un fragmento XML en una secuencia de memoria.

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.

Comentarios

XmlWriter siempre escribe una marca de orden de bytes (BOM) en el flujo de datos subyacente; sin embargo, algunas secuencias no deben tener una lista de materiales. Para omitir la lista de materiales, cree un nuevo XmlWriterSettings objeto y establezca la propiedad Encoding como un nuevo UTF8Encoding objeto con el valor booleano en el constructor establecido en 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

Devoluciones

XmlWriter

Objeto XmlWriter que contiene el objeto XmlWriter especificado.

Excepciones

Comentarios

Este método permite agregar características adicionales a un objeto subyacente XmlWriter . El objeto subyacente XmlWriter puede ser un objeto creado por el XmlWriter.Create método o un objeto creado mediante la XmlTextWriter implementación.

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

Devoluciones

XmlWriter

Un objeto XmlWriter.

Excepciones

Comentarios

Cuando se usa esta sobrecarga, se usa un XmlWriterSettings objeto con la configuración predeterminada para crear el sistema de escritura XML.

Si desea especificar las características que se admitirán en el escritor XML creado, use una sobrecarga que tome un XmlWriterSettings objeto como uno de sus argumentos y pase un XmlWriterSettings objeto con la configuración personalizada.

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

Devoluciones

XmlWriter

Un objeto XmlWriter.

Excepciones

Ejemplos

En el ejemplo siguiente se crea un XmlWriter objeto y se escribe un nodo de libro.

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

Comentarios

Cuando se usa esta sobrecarga, se usa un XmlWriterSettings objeto con la configuración predeterminada para crear el sistema de escritura XML.

Si desea especificar las características que se admitirán en el escritor XML creado, use una sobrecarga que tome un XmlWriterSettings objeto como uno de sus argumentos y pase un XmlWriterSettings objeto con la configuración personalizada.

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

Devoluciones

XmlWriter

Un objeto XmlWriter.

Excepciones

Ejemplos

En el ejemplo siguiente se crea un escritor que se genera en la 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

Comentarios

Cuando se usa esta sobrecarga, se usa un XmlWriterSettings objeto con la configuración predeterminada para crear el sistema de escritura XML.

Si desea especificar las características que se admitirán en el escritor creado, use una sobrecarga que tome un XmlWriterSettings objeto como uno de sus argumentos y pase un XmlWriterSettings objeto con la configuración personalizada.

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

Devoluciones

XmlWriter

Un objeto XmlWriter.

Excepciones

Ejemplos

En el ejemplo siguiente se escribe un fragmento XML en una secuencia de memoria. (Usa la Create(Stream, XmlWriterSettings) sobrecarga, que también configura las opciones en la nueva instancia del 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.

Comentarios

Cuando se usa esta sobrecarga, se usa un XmlWriterSettings objeto con la siguiente configuración predeterminada para crear el sistema de escritura XML:

Si desea especificar las características que se admitirán en el escritor creado, use una sobrecarga que tome un XmlWriterSettings objeto como uno de sus argumentos y pase un XmlWriterSettings objeto con la configuración personalizada.

Además, XmlWriter siempre escribe una marca de orden de bytes (BOM) en el flujo de datos subyacente; sin embargo, algunas secuencias no deben tener una lista de materiales. Para omitir la lista de materiales, cree un nuevo XmlWriterSettings objeto y establezca la propiedad Encoding como un nuevo UTF8Encoding objeto con el valor booleano en el constructor establecido en 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

Devoluciones

XmlWriter

Objeto XmlWriter que contiene el objeto XmlWriter especificado.

Excepciones

Comentarios

Este método permite agregar características a un objeto subyacente XmlWriter . El objeto subyacente XmlWriter puede ser un objeto creado por el XmlWriter.Create método o un objeto creado mediante la XmlTextWriter implementación.

Cuando se usa esta sobrecarga, se usa un XmlWriterSettings objeto con la configuración predeterminada para crear el sistema de escritura XML.

Si desea especificar las características que se admitirán en el escritor XML creado, use una sobrecarga que tome un XmlWriterSettings objeto como uno de sus argumentos y pase un XmlWriterSettings objeto con la configuración personalizada.