XmlWriter.Create Método

Definición

Crea una nueva instancia de XmlWriter.

Sobrecargas

Nombre Description
Create(StringBuilder, XmlWriterSettings)

Crea una nueva XmlWriter instancia mediante los StringBuilder objetos y XmlWriterSettings .

Create(String, XmlWriterSettings)

Crea una nueva XmlWriter instancia mediante el nombre de archivo y XmlWriterSettings el objeto .

Create(TextWriter, XmlWriterSettings)

Crea una nueva XmlWriter instancia mediante los TextWriter objetos y XmlWriterSettings .

Create(Stream, XmlWriterSettings)

Crea una nueva XmlWriter instancia mediante la secuencia y XmlWriterSettings el objeto .

Create(XmlWriter, XmlWriterSettings)

Crea una nueva XmlWriter instancia con los objetos y XmlWriter especificadosXmlWriterSettings.

Create(StringBuilder)

Crea una nueva XmlWriter instancia mediante el especificado StringBuilder.

Create(String)

Crea una nueva XmlWriter instancia con el nombre de archivo especificado.

Create(TextWriter)

Crea una nueva XmlWriter instancia mediante el especificado TextWriter.

Create(Stream)

Crea una nueva XmlWriter instancia mediante la secuencia especificada.

Create(XmlWriter)

Crea una nueva XmlWriter instancia mediante el objeto especificado XmlWriter .

Comentarios

Algunas de las Create sobrecargas incluyen un settings parámetro que acepta un XmlWriterSettings objeto . Puede usar este objeto para:

  • Especifique qué características desea admitir en el objeto creado XmlWriter .

  • Vuelva a usar el XmlWriterSettings objeto para crear varios objetos de escritura. El XmlWriterSettings objeto se copia y se marca como de solo lectura para cada escritor creado. Los cambios en la configuración de una XmlWriterSettings instancia no afectan a los escritores existentes con la misma configuración. Por lo tanto, puede usar la misma configuración para crear varios escritores con la misma funcionalidad. O bien, puede modificar la configuración de una XmlWriterSettings instancia y crear un nuevo escritor con un conjunto diferente de características.

  • Agregue características a un escritor XML existente. El Create método puede aceptar otro XmlWriter objeto. El objeto subyacente XmlWriter no tiene que ser un escritor XML creado por el método estático Create . Por ejemplo, puede especificar un escritor XML definido por el usuario para agregar características adicionales.

  • Aproveche al máximo las características, como la comprobación de conformidad y el cumplimiento de la recomendación XML 1.0 que solo están disponibles en XmlWriter los objetos creados por el método estático Create .

Si usa una Create sobrecarga que no acepta un XmlWriterSettings objeto, se usan las siguientes opciones de escritura predeterminadas:

Configuración Predeterminado
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Dos espacios
NamespaceHandling Default (sin eliminación)
NewLineChars \r\n (retorno de carro, avance de línea) para plataformas que no son Unix o \n (fuente de líneas) para plataformas Unix
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Note

Aunque .NET Framework incluye la clase , que es una implementación concreta de la clase />c1 mediante el método .

Create(StringBuilder, XmlWriterSettings)

Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

Crea una nueva XmlWriter instancia mediante los StringBuilder objetos y XmlWriterSettings .

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

output
StringBuilder

al StringBuilder que se va a escribir. El contenido escrito por se XmlWriter anexa a .StringBuilder

settings
XmlWriterSettings

Objeto XmlWriterSettings utilizado para configurar la nueva XmlWriter instancia. Si es null, se usa un XmlWriterSettings con la configuración predeterminada.

XmlWriter Si se usa con el Transform(String, XmlWriter) método , debe usar la OutputSettings propiedad para obtener un XmlWriterSettings objeto con la configuración correcta. Esto garantiza que el objeto creado XmlWriter tenga la configuración de salida correcta.

Devoluciones

Un objeto XmlWriter.

Excepciones

output es null.

Se aplica a

Create(String, XmlWriterSettings)

Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

Crea una nueva XmlWriter instancia mediante el nombre de archivo y XmlWriterSettings el objeto .

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

outputFileName
String

Archivo en el que desea escribir. XmlWriter crea un archivo en la ruta de acceso especificada y lo escribe en la sintaxis de texto XML 1.0. outputFileName debe ser una ruta de acceso del sistema de archivos.

settings
XmlWriterSettings

Objeto XmlWriterSettings utilizado para configurar la nueva XmlWriter instancia. Si es null, se usa un XmlWriterSettings con la configuración predeterminada.

XmlWriter Si se usa con el Transform(String, XmlWriter) método , debe usar la OutputSettings propiedad para obtener un XmlWriterSettings objeto con la configuración correcta. Esto garantiza que el objeto creado XmlWriter tenga la configuración de salida correcta.

Devoluciones

Un objeto XmlWriter.

Excepciones

outputFileName es null.

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

Se aplica a

Create(TextWriter, XmlWriterSettings)

Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

Crea una nueva XmlWriter instancia mediante los TextWriter objetos y XmlWriterSettings .

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

output
TextWriter

al TextWriter que desea escribir. XmlWriter Escribe la sintaxis de texto XML 1.0 y la anexa al especificadoTextWriter.

settings
XmlWriterSettings

Objeto XmlWriterSettings utilizado para configurar la nueva XmlWriter instancia. Si es null, se usa un XmlWriterSettings con la configuración predeterminada.

XmlWriter Si se usa con el Transform(String, XmlWriter) método , debe usar la OutputSettings propiedad para obtener un XmlWriterSettings objeto con la configuración correcta. Esto garantiza que el objeto creado XmlWriter tenga la configuración de salida correcta.

Devoluciones

Un objeto XmlWriter.

Excepciones

output es null.

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

Se aplica a

Create(Stream, XmlWriterSettings)

Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

Crea una nueva XmlWriter instancia mediante la secuencia y XmlWriterSettings el objeto .

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

output
Stream

Secuencia a la que desea escribir. XmlWriter Escribe la sintaxis de texto XML 1.0 y la anexa a la secuencia especificada.

settings
XmlWriterSettings

Objeto XmlWriterSettings utilizado para configurar la nueva XmlWriter instancia. Si es null, se usa un XmlWriterSettings con la configuración predeterminada.

XmlWriter Si se usa con el Transform(String, XmlWriter) método , debe usar la OutputSettings propiedad para obtener un XmlWriterSettings objeto con la configuración correcta. Esto garantiza que el objeto creado XmlWriter tenga la configuración de salida correcta.

Devoluciones

Un objeto XmlWriter.

Excepciones

output es null.

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.

Se aplica a

Create(XmlWriter, XmlWriterSettings)

Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

Crea una nueva XmlWriter instancia con los objetos y XmlWriter especificadosXmlWriterSettings.

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

output
XmlWriter

Objeto XmlWriter que desea usar como escritor subyacente.

settings
XmlWriterSettings

Objeto XmlWriterSettings utilizado para configurar la nueva XmlWriter instancia. Si es null, se usa un XmlWriterSettings con la configuración predeterminada.

XmlWriter Si se usa con el Transform(String, XmlWriter) método , debe usar la OutputSettings propiedad para obtener un XmlWriterSettings objeto con la configuración correcta. Esto garantiza que el objeto creado XmlWriter tenga la configuración de salida correcta.

Devoluciones

Objeto XmlWriter que se ajusta alrededor del objeto especificado XmlWriter .

Excepciones

output es null.

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.

Se aplica a

Create(StringBuilder)

Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

Crea una nueva XmlWriter instancia mediante el especificado StringBuilder.

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

output
StringBuilder

al StringBuilder que se va a escribir. El contenido escrito por se XmlWriter anexa a .StringBuilder

Devoluciones

Un objeto XmlWriter.

Excepciones

output es null.

Comentarios

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

Configuración Predeterminado
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Dos espacios
NamespaceHandling Default (sin eliminación)
NewLineChars \r\n (retorno de carro, avance de línea) para plataformas que no son Unix o \n (fuente de líneas) para plataformas Unix
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

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.

Se aplica a

Create(String)

Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

Crea una nueva XmlWriter instancia con el nombre de archivo especificado.

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

outputFileName
String

Archivo en el que desea escribir. XmlWriter crea un archivo en la ruta de acceso especificada y lo escribe en la sintaxis de texto XML 1.0. outputFileName debe ser una ruta de acceso del sistema de archivos.

Devoluciones

Un objeto XmlWriter.

Excepciones

outputFileName es null.

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.

Configuración Predeterminado
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Dos espacios
NamespaceHandling Default (sin eliminación)
NewLineChars \r\n (retorno de carro, avance de línea) para plataformas que no son Unix o \n (fuente de líneas) para plataformas Unix
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

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.

Se aplica a

Create(TextWriter)

Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

Crea una nueva XmlWriter instancia mediante el especificado TextWriter.

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

output
TextWriter

al TextWriter que desea escribir. XmlWriter Escribe la sintaxis de texto XML 1.0 y la anexa al especificadoTextWriter.

Devoluciones

Un objeto XmlWriter.

Excepciones

output es null.

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.

Configuración Predeterminado
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Dos espacios
NamespaceHandling Default (sin eliminación)
NewLineChars \r\n (retorno de carro, avance de línea) para plataformas que no son Unix o \n (fuente de líneas) para plataformas Unix
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

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.

Se aplica a

Create(Stream)

Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

Crea una nueva XmlWriter instancia mediante la secuencia especificada.

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

output
Stream

Secuencia a la que desea escribir. XmlWriter Escribe la sintaxis de texto XML 1.0 y la anexa a la secuencia especificada.

Devoluciones

Un objeto XmlWriter.

Excepciones

output es null.

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:

Configuración Predeterminado
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Dos espacios
NamespaceHandling Default (sin eliminación)
NewLineChars \r\n (retorno de carro, avance de línea) para plataformas que no son Unix o \n (fuente de líneas) para plataformas Unix
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

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.

Se aplica a

Create(XmlWriter)

Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

Crea una nueva XmlWriter instancia mediante el objeto especificado XmlWriter .

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

output
XmlWriter

Objeto XmlWriter que desea usar como escritor subyacente.

Devoluciones

Objeto XmlWriter que se ajusta alrededor del objeto especificado XmlWriter .

Excepciones

output es null.

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.

Configuración Predeterminado
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Dos espacios
NamespaceHandling Default (sin eliminación)
NewLineChars \r\n (retorno de carro, avance de línea) para plataformas que no son Unix o \n (fuente de líneas) para plataformas Unix
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

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.

Se aplica a