XmlWriter.Create Método

Definição

Namespace:: System.Xml

Assemblies:: System.Xml.dll, System.Xml.ReaderWriter.dll

Assemblies:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cria uma nova instância XmlWriter.

Sobrecargas

Nome	Description
Create(StringBuilder, XmlWriterSettings)	Cria uma nova XmlWriter instância usando os objetos eStringBuilder.XmlWriterSettings
Create(String, XmlWriterSettings)	Cria uma nova XmlWriter instância usando o nome do arquivo e XmlWriterSettings o objeto.
Create(TextWriter, XmlWriterSettings)	Cria uma nova XmlWriter instância usando os objetos eTextWriter.XmlWriterSettings
Create(Stream, XmlWriterSettings)	Cria uma nova XmlWriter instância usando o fluxo e XmlWriterSettings o objeto.
Create(XmlWriter, XmlWriterSettings)	Cria uma nova XmlWriter instância usando os objetos e XmlWriter especificadosXmlWriterSettings.
Create(StringBuilder)	Cria uma nova XmlWriter instância usando a especificada StringBuilder.
Create(String)	Cria uma nova XmlWriter instância usando o nome de arquivo especificado.
Create(TextWriter)	Cria uma nova XmlWriter instância usando a especificada TextWriter.
Create(Stream)	Cria uma nova XmlWriter instância usando o fluxo especificado.
Create(XmlWriter)	Cria uma nova XmlWriter instância usando o objeto especificado XmlWriter .

Comentários

Algumas das Create sobrecargas incluem um settings parâmetro que aceita um XmlWriterSettings objeto. Você pode usar este objeto para:

Especifique quais recursos você deseja ter suporte no objeto criado XmlWriter .
Reutilize o XmlWriterSettings objeto para criar vários objetos de gravador. O XmlWriterSettings objeto é copiado e marcado como somente leitura para cada gravador criado. As alterações nas configurações em uma XmlWriterSettings instância não afetam os gravadores existentes com as mesmas configurações. Portanto, você pode usar as mesmas configurações para criar vários gravadores com a mesma funcionalidade. Ou você pode modificar as configurações em uma XmlWriterSettings instância e criar um novo gravador com um conjunto diferente de recursos.
Adicione recursos a um gravador XML existente. O Create método pode aceitar outro XmlWriter objeto. O objeto subjacente XmlWriter não precisa ser um gravador XML criado pelo método estático Create . Por exemplo, você pode especificar um gravador XML definido pelo usuário para adicionar recursos adicionais.
Aproveite ao máximo os recursos, como melhor verificação de conformidade e conformidade com a recomendação XML 1.0 que estão disponíveis somente em XmlWriter objetos criados pelo método estático Create .

Se você usar uma Create sobrecarga que não aceita um XmlWriterSettings objeto, as seguintes configurações de gravador padrão serão usadas:

Setting	Default
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Dois espaços
NamespaceHandling	Default (sem remoção)
NewLineChars	`\r\n` (retorno de carro, feed de linha) para plataformas não Unix ou `\n` (feed de linha) para plataformas Unix
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Note

Embora o .NET Framework inclua a classe XmlTextWriter, que é uma implementação concreta da classe XmlWriter, recomendamos que você crie instâncias XmlWriter usando o método Create.

Create(StringBuilder, XmlWriterSettings)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Cria uma nova XmlWriter instância usando os objetos eStringBuilder.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

O StringBuilder para o qual gravar. O conteúdo escrito pelo XmlWriter é acrescentado ao StringBuilder.

settings: XmlWriterSettings

O XmlWriterSettings objeto usado para configurar a nova XmlWriter instância. Se isso for null, uma XmlWriterSettings configuração com padrão será usada.

Se estiver XmlWriter sendo usado com o Transform(String, XmlWriter) método, você deverá usar a OutputSettings propriedade para obter um XmlWriterSettings objeto com as configurações corretas. Isso garante que o objeto criado XmlWriter tenha as configurações de saída corretas.

Retornos

XmlWriter

Um XmlWriter objeto.

Exceções

ArgumentNullException

output é null.

Aplica-se a

Create(String, XmlWriterSettings)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Cria uma nova XmlWriter instância usando o nome do arquivo e XmlWriterSettings o 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

O arquivo no qual você deseja gravar. Ele XmlWriter cria um arquivo no caminho especificado e grava-o na sintaxe de texto XML 1.0. Deve outputFileName ser um caminho do sistema de arquivos.

settings: XmlWriterSettings

O XmlWriterSettings objeto usado para configurar a nova XmlWriter instância. Se isso for null, uma XmlWriterSettings configuração com padrão será usada.

Retornos

XmlWriter

Um XmlWriter objeto.

Exceções

ArgumentNullException

outputFileName é null.

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

Aplica-se a

Create(TextWriter, XmlWriterSettings)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Cria uma nova XmlWriter instância usando os objetos eTextWriter.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

O TextWriter para o qual você deseja escrever. A XmlWriter sintaxe de texto XML 1.0 grava e a acrescenta ao especificado TextWriter.

settings: XmlWriterSettings

O XmlWriterSettings objeto usado para configurar a nova XmlWriter instância. Se isso for null, uma XmlWriterSettings configuração com padrão será usada.

Retornos

XmlWriter

Um XmlWriter objeto.

Exceções

ArgumentNullException

output é null.

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

Aplica-se a

Create(Stream, XmlWriterSettings)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Cria uma nova XmlWriter instância usando o fluxo e XmlWriterSettings o 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

O fluxo no qual você deseja gravar. A XmlWriter sintaxe de texto do XML 1.0 grava e a acrescenta ao fluxo especificado.

settings: XmlWriterSettings

O XmlWriterSettings objeto usado para configurar a nova XmlWriter instância. Se isso for null, uma XmlWriterSettings configuração com padrão será usada.

Retornos

XmlWriter

Um XmlWriter objeto.

Exceções

ArgumentNullException

output é null.

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 um BOM (Marca de Ordem de Bytes) no fluxo de dados subjacente; no entanto, alguns fluxos não devem ter um BOM. Para omitir o BOM, crie um novo XmlWriterSettings objeto e defina a propriedade Decodificação como um novo UTF8Encoding objeto com o valor booliano no construtor definido como false.

Aplica-se a

Create(XmlWriter, XmlWriterSettings)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Cria uma nova XmlWriter instância usando os objetos e 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

O XmlWriter objeto que você deseja usar como o gravador subjacente.

settings: XmlWriterSettings

O XmlWriterSettings objeto usado para configurar a nova XmlWriter instância. Se isso for null, uma XmlWriterSettings configuração com padrão será usada.

Retornos

XmlWriter

Um XmlWriter objeto que é encapsulado ao redor do objeto especificado XmlWriter .

Exceções

ArgumentNullException

output é null.

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.

Aplica-se a

Create(StringBuilder)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Cria uma nova XmlWriter instância usando a especificada 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

O StringBuilder para o qual gravar. O conteúdo escrito pelo XmlWriter é acrescentado ao StringBuilder.

Retornos

XmlWriter

Um XmlWriter objeto.

Exceções

ArgumentNullException

output é null.

Comentários

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

Setting	Default
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Dois espaços
NamespaceHandling	Default (sem remoção)
NewLineChars	`\r\n` (retorno de carro, feed de linha) para plataformas não Unix ou `\n` (feed de linha) para plataformas Unix
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

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.

Aplica-se a

Create(String)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Cria uma nova XmlWriter instância usando o nome de arquivo 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

O arquivo no qual você deseja gravar. Ele XmlWriter cria um arquivo no caminho especificado e grava-o na sintaxe de texto XML 1.0. Deve outputFileName ser um caminho do sistema de arquivos.

Retornos

XmlWriter

Um XmlWriter objeto.

Exceções

ArgumentNullException

outputFileName é null.

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.

Setting	Default
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Dois espaços
NamespaceHandling	Default (sem remoção)
NewLineChars	`\r\n` (retorno de carro, feed de linha) para plataformas não Unix ou `\n` (feed de linha) para plataformas Unix
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Aplica-se a

Create(TextWriter)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Cria uma nova XmlWriter instância usando a especificada 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

O TextWriter para o qual você deseja escrever. A XmlWriter sintaxe de texto XML 1.0 grava e a acrescenta ao especificado TextWriter.

Retornos

XmlWriter

Um XmlWriter objeto.

Exceções

ArgumentNullException

output é null.

Exemplos

O exemplo a seguir cria um gravador que é enviado 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.

Setting	Default
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Dois espaços
NamespaceHandling	Default (sem remoção)
NewLineChars	`\r\n` (retorno de carro, feed de linha) para plataformas não Unix ou `\n` (feed de linha) para plataformas Unix
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

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.

Aplica-se a

Create(Stream)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Cria uma nova XmlWriter instância usando o fluxo especificado.

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

O fluxo no qual você deseja gravar. A XmlWriter sintaxe de texto do XML 1.0 grava e a acrescenta ao fluxo especificado.

Retornos

XmlWriter

Um XmlWriter objeto.

Exceções

ArgumentNullException

output é null.

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:

Setting	Default
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Dois espaços
NamespaceHandling	Default (sem remoção)
NewLineChars	`\r\n` (retorno de carro, feed de linha) para plataformas não Unix ou `\n` (feed de linha) para plataformas Unix
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Além disso, o XmlWriter sempre grava um BOM (Byte Order Mark) no fluxo de dados subjacente; no entanto, alguns fluxos não devem ter um BOM. Para omitir o BOM, crie um novo XmlWriterSettings objeto e defina a propriedade Decodificação como um novo UTF8Encoding objeto com o valor booliano no construtor definido como false.

Aplica-se a

Create(XmlWriter)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Cria uma nova XmlWriter instância usando o 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

O XmlWriter objeto que você deseja usar como o gravador subjacente.

Retornos

XmlWriter

Um XmlWriter objeto que é encapsulado ao redor do objeto especificado XmlWriter .

Exceções

ArgumentNullException

output é null.

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.

Setting	Default
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Dois espaços
NamespaceHandling	Default (sem remoção)
NewLineChars	`\r\n` (retorno de carro, feed de linha) para plataformas não Unix ou `\n` (feed de linha) para plataformas Unix
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Aplica-se a

Comentários

Esta página foi útil?