XmlTextWriter Конструкторы

Определение

Пространство имен:

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Создает экземпляр класса XmlTextWriter.

Перегрузки

XmlTextWriter(TextWriter)	Инициализирует новый экземпляр класса XmlTextWriter с помощью указанного класса TextWriter.
XmlTextWriter(Stream, Encoding)	Создает экземпляр класса XmlTextWriter с помощью указанного потока и кодировки.
XmlTextWriter(String, Encoding)	Создает экземпляр класса XmlTextWriter с помощью указанного файла.

Комментарии

Примечание

Начиная с платформа .NET Framework 2.0, рекомендуется создавать XmlWriter экземпляры с помощью XmlWriter.Create метода и класса , XmlWriterSettings чтобы воспользоваться преимуществами новых функций.

XmlTextWriter(TextWriter)

Исходный код:

XmlTextWriter.cs

Инициализирует новый экземпляр класса XmlTextWriter с помощью указанного класса TextWriter.

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 экземпляры с помощью XmlWriter.Create метода и класса , XmlWriterSettings чтобы воспользоваться преимуществами новых функций.

XmlTextWriter(Stream, Encoding)

Исходный код:

XmlTextWriter.cs

Создает экземпляр класса XmlTextWriter с помощью указанного потока и кодировки.

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 экземпляры с помощью XmlWriter.Create метода и класса , XmlWriterSettings чтобы воспользоваться преимуществами новых функций.

XmlTextWriter(String, Encoding)

Исходный код:

XmlTextWriter.cs

Создает экземпляр класса XmlTextWriter с помощью указанного файла.

public:
 XmlTextWriter(System::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 экземпляры с помощью XmlWriter.Create метода и класса , XmlWriterSettings чтобы воспользоваться преимуществами новых функций.