XmlTextWriter 构造函数

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

程序集:

System.Xml.dll

程序集:

netstandard.dll

创建 XmlTextWriter 类的实例。

重载

XmlTextWriter(TextWriter)	使用指定的 TextWriter 创建 XmlTextWriter 类的实例。
XmlTextWriter(Stream, Encoding)	使用指定的流和编码方式创建 XmlTextWriter 类的实例。
XmlTextWriter(String, Encoding)	使用指定的文件创建 XmlTextWriter 类的实例。

注解

备注

从 .NET Framework 2.0 开始，我们建议使用XmlWriter.Create方法和XmlWriterSettings类来创建XmlWriter实例，以利用新功能。

XmlTextWriter(TextWriter)

使用指定的 TextWriter 创建 XmlTextWriter 类的实例。

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)

参数

w

TextWriter

要向其中进行写入的 TextWriter。 假定 TextWriter 已设置为正确的编码方式。

注解

备注

从 .NET Framework 2.0 开始，我们建议使用XmlWriter.Create方法和XmlWriterSettings类来创建XmlWriter实例，以利用新功能。

XmlTextWriter(Stream, Encoding)

使用指定的流和编码方式创建 XmlTextWriter 类的实例。

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)

参数

w

Stream

要对其写入的流。

encoding

Encoding

要生成的编码。 如果编码方式为 null，则它以 UTF-8 的形式写出流并忽略 ProcessingInstruction 中的编码特性。

例外

ArgumentException

该编码方式不受支持或无法写入流。

ArgumentNullException

w 为 null。

注解

备注

从 .NET Framework 2.0 开始，我们建议使用XmlWriter.Create方法和XmlWriterSettings类来创建XmlWriter实例，以利用新功能。

XmlTextWriter(String, Encoding)

使用指定的文件创建 XmlTextWriter 类的实例。

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)

参数

filename

String

要写入的文件名。 如果该文件存在，它将截断该文件并用新内容将其覆盖。

encoding

Encoding

要生成的编码。 如果编码方式为 null，它将以 UTF-8 的形式写出该文件，并忽略 ProcessingInstruction 中的编码特性。

例外

ArgumentException

编码方式不受支持；文件名为空；仅包含空格，或者包含一个或多个无效字符。

UnauthorizedAccessException

访问被拒绝。

ArgumentNullException

文件名为 null。

DirectoryNotFoundException

未找到要写入的目录。

IOException

文件名中包含不正确或无效的文件名、目录名或卷标语法。

SecurityException

调用方没有所要求的权限。

注解

备注

从 .NET Framework 2.0 开始，我们建议使用XmlWriter.Create方法和XmlWriterSettings类来创建XmlWriter实例，以利用新功能。