Share via


XmlTextWriter Construtores

Definição

Cria uma instância de XmlTextWriter classe.

Sobrecargas

XmlTextWriter(TextWriter)

Cria uma instância da classe XmlTextWriter usando o TextWriter especificado.

XmlTextWriter(Stream, Encoding)

Cria uma instância da classe XmlTextWriter usando o fluxo e a codificação especificados.

XmlTextWriter(String, Encoding)

Cria uma instância da classe XmlTextWriter usando o arquivo especificado.

Comentários

Observação

A partir do .NET Framework 2.0, recomendamos que você crie XmlWriter instâncias usando o XmlWriter.Create método e a XmlWriterSettings classe para aproveitar a nova funcionalidade.

XmlTextWriter(TextWriter)

Cria uma instância da classe XmlTextWriter usando o TextWriter especificado.

public:
 XmlTextWriter(System::IO::TextWriter ^ w);
public XmlTextWriter (System.IO.TextWriter w);
new System.Xml.XmlTextWriter : System.IO.TextWriter -> System.Xml.XmlTextWriter
Public Sub New (w As TextWriter)

Parâmetros

w
TextWriter

O TextWriter no qual ocorrerá a gravação. Supõe-se que TextWriter já esteja definido como a codificação correta.

Comentários

Observação

A partir do .NET Framework 2.0, recomendamos que você crie XmlWriter instâncias usando o XmlWriter.Create método e a XmlWriterSettings classe para aproveitar a nova funcionalidade.

Aplica-se a

XmlTextWriter(Stream, Encoding)

Cria uma instância da classe XmlTextWriter usando o fluxo e a codificação especificados.

public:
 XmlTextWriter(System::IO::Stream ^ w, System::Text::Encoding ^ encoding);
public XmlTextWriter (System.IO.Stream w, System.Text.Encoding? encoding);
public XmlTextWriter (System.IO.Stream w, System.Text.Encoding encoding);
new System.Xml.XmlTextWriter : System.IO.Stream * System.Text.Encoding -> System.Xml.XmlTextWriter
Public Sub New (w As Stream, encoding As Encoding)

Parâmetros

w
Stream

O fluxo no qual você deseja fazer a gravação.

encoding
Encoding

A codificação a ser gerada. Se a codificação for null, ele gravará o fluxo como UTF-8 e omitirá o atributo de codificação do ProcessingInstruction.

Exceções

Não há suporte para a codificação ou não é possível gravar no fluxo.

Comentários

Observação

A partir do .NET Framework 2.0, recomendamos que você crie XmlWriter instâncias usando o XmlWriter.Create método e a XmlWriterSettings classe para aproveitar a nova funcionalidade.

Aplica-se a

XmlTextWriter(String, Encoding)

Cria uma instância da classe XmlTextWriter usando o arquivo especificado.

public:
 XmlTextWriter(System::String ^ filename, System::Text::Encoding ^ encoding);
public XmlTextWriter (string filename, System.Text.Encoding? encoding);
public XmlTextWriter (string filename, System.Text.Encoding encoding);
new System.Xml.XmlTextWriter : string * System.Text.Encoding -> System.Xml.XmlTextWriter
Public Sub New (filename As String, encoding As Encoding)

Parâmetros

filename
String

O nome do arquivo para gravação. Se o arquivo existir, ele será truncado e substituído pelo novo conteúdo.

encoding
Encoding

A codificação a ser gerada. Se a codificação for null, ele gravará o arquivo como UTF-8 e omitirá o atributo de codificação do ProcessingInstruction.

Exceções

Não há suporte para a codificação; o nome do arquivo está vazio, contém somente espaços em branco ou contém um ou mais caracteres inválidos.

O nome do arquivo é null.

O diretório de gravação não foi encontrado.

O nome do arquivo inclui uma sintaxe incorreta ou inválida para o nome do arquivo, o nome do diretório ou a sintaxe do rótulo do volume.

O chamador não tem a permissão necessária.

Comentários

Observação

A partir do .NET Framework 2.0, recomendamos que você crie XmlWriter instâncias usando o XmlWriter.Create método e a XmlWriterSettings classe para aproveitar a nova funcionalidade.

Aplica-se a