XmlWriter.Create Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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
- 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
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
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.