XmlWriter Класс

Определение

Represents a writer that provides a fast, non-cached, forward-only way to generate streams or files that contain XML data.Represents a writer that provides a fast, non-cached, forward-only way to generate streams or files that contain XML data.

public ref class XmlWriter abstract : IDisposable
public ref class XmlWriter abstract
public abstract class XmlWriter : IDisposable
public abstract class XmlWriter
type XmlWriter = class
    interface IDisposable
type XmlWriter = class
Public MustInherit Class XmlWriter
Implements IDisposable
Public MustInherit Class XmlWriter
Наследование
XmlWriter
Производный
Реализации

Примеры

В следующем примере кода показано, как использовать асинхронный API для создания XML.The following example code shows how to use the asynchronous API to generate XML.

async Task TestWriter(Stream stream)   
{  
    XmlWriterSettings settings = new XmlWriterSettings();  
    settings.Async = true;  
  
    using (XmlWriter writer = XmlWriter.Create(stream, settings)) {  
        await writer.WriteStartElementAsync("pf", "root", "http://ns");  
        await writer.WriteStartElementAsync(null, "sub", null);  
        await writer.WriteAttributeStringAsync(null, "att", null, "val");  
        await writer.WriteStringAsync("text");  
        await writer.WriteEndElementAsync();  
        await writer.WriteProcessingInstructionAsync("pName", "pValue");  
        await writer.WriteCommentAsync("cValue");  
        await writer.WriteCDataAsync("cdata value");  
        await writer.WriteEndElementAsync();  
        await writer.FlushAsync();  
    }  
}  

Комментарии

Класс XmlWriter записывает XML-данные в поток, файл, модуль чтения текста или строку.The XmlWriter class writes XML data to a stream, file, text reader, or string. Он поддерживает рекомендации консорциума W3C язык XML (XML) 1,0 (Четвертый выпуск) и пространства имен в рекомендациях по XML 1,0 (третий выпуск) .It supports the W3C Extensible Markup Language (XML) 1.0 (fourth edition) and Namespaces in XML 1.0 (third edition) recommendations.

Члены класса XmlWriter позволяют:The members of the XmlWriter class enable you to:

  • проверять допустимость XML-символов и допустимость XML-имен элементов и атрибутов;Verify that the characters are legal XML characters and that element and attribute names are valid XML names.

  • проверять правильность формата XML-документа;Verify that the XML document is well-formed.

  • Кодирование двоичных байтов в Base64 или BinHex и запись полученного текста.Encode binary bytes as Base64 or BinHex, and write out the resulting text.

  • Передайте значения с помощью типов среды CLR вместо строк, чтобы не выполнять преобразования значений вручную.Pass values by using common language runtime types instead of strings, to avoid having to manually perform value conversions.

  • записывать несколько документов в выходной поток;Write multiple documents to one output stream.

  • записывать допустимые имена, полные имена и маркеры имен.Write valid names, qualified names, and name tokens.

В этом разделеIn this section:

Создание модуля записи XML Creating an XML writer
Указание формата выходных данных Specifying the output format
Соответствие данных Data conformance
Запись элементов Writing elements
Запись атрибутов Writing attributes
Обработка пространств имен Handling namespaces
Запись типизированных данныхWriting typed data
Закрытие модуля записи XML Closing the XML writer
Асинхронное программирование Asynchronous programming
Вопросы безопасностиSecurity considerations

Создание модуля записи XMLCreating an XML writer

Чтобы создать XmlWriter экземпляр, используйте метод XmlWriter.Create.To create an XmlWriter instance, use the XmlWriter.Create method. Чтобы указать набор компонентов, которые необходимо включить в модуле записи XML, передайте XmlWriterSettings методу Create.To specify the set of features you want to enable on the XML writer, pass an XmlWriterSettings to the Create method. В противном случае используются параметры по умолчанию.Otherwise, default settings are used. Дополнительные сведения см. на страницах справочника по Create.See the Create reference pages for details.

Указание формата выходных данныхSpecifying the output format

Класс XmlWriterSettings содержит несколько свойств, управляющих форматированием выходных данных XmlWriter.The XmlWriterSettings class includes several properties that control how XmlWriter output is formatted:

СвойствоProperty ОписаниеDescription
Encoding Указывает кодировку текста, которую следует использовать.Specifies the text encoding to use. Значение по умолчанию: Encoding.UTF8.The default is Encoding.UTF8.
Indent Показывает, нужны ли отступы элементов.Indicates whether to indent elements. Значение по умолчанию — false (без отступа).The default is false (no indentation).
IndentChars Указывает символьную строку для использования при отступе.Specifies the character string to use when indenting. По умолчанию - два пробела.The default is two spaces.
NewLineChars Указывает символьную строку, используемую для разрывов строки.Specifies the character string to use for line breaks. По умолчанию используется \r\n (возврат каретки, перевода строки).The default is \r\n (carriage return, line feed).
NewLineHandling Задает способ управления символами новой строки.Specifies how to handle newline characters.
NewLineOnAttributes Указывает, следует ли записывать атрибуты на новой строке.Indicates whether to write attributes on a new line. При использовании этого свойства для Indent должно быть задано значение true.Indent should be set to true when using this property. Значение по умолчанию: false.The default is false.
OmitXmlDeclaration Показывает, следует ли записывать XML-декларацию.Indicates whether to write an XML declaration. Значение по умолчанию: false.The default is false.

Свойства Indent и IndentChars управляют форматированием незначащих пробелов.The Indent and IndentChars properties control how insignificant white space is formatted. Например, для отступа узлов элементов:For example, to indent element nodes:

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.IndentChars = "\t";
XmlWriter writer = XmlWriter.Create("books.xml", settings);
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = vbTab
Dim writer As XmlWriter = XmlWriter.Create("books.xml", settings)

Используйте NewLineOnAttributes для записи каждого атрибута в новой строке с одним дополнительным уровнем отступа:Use the NewLineOnAttributes to write each attribute on a new line with one extra level of indentation:

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.NewLineOnAttributes = true;
XmlWriter writer = XmlWriter.Create("books.xml", settings);
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.NewLineOnAttributes = True
Dim writer As XmlWriter = XmlWriter.Create("books.xml", settings)

Соответствие данныхData conformance

Модуль записи XML использует два свойства класса XmlWriterSettings для проверки соответствия данных:An XML writer uses two properties from the XmlWriterSettings class to check for data conformance:

  • Свойство CheckCharacters предписывает модулю записи XML проверять символы и вызывать исключение XmlException, если какие-либо символы находятся за пределами допустимого диапазона, как определено консорциумом W3C.The CheckCharacters property instructs the XML writer to check characters and throw an XmlException exception if any characters are outside the legal range, as defined by the W3C.

  • Свойство ConformanceLevel настраивает модуль записи XML для проверки того, что записываемый поток соответствует правилам для XML-документа или фрагмента документа в правильном 1,0 формате, в соответствии с определением консорциума W3C.The ConformanceLevel property configures the XML writer to check that the stream being written complies with the rules for a well-formed XML 1.0 document or document fragment, as defined by the W3C. Три уровня соответствия описаны в следующей таблице.The three conformance levels are described in the following table. Значение по умолчанию: Document.The default is Document. Дополнительные сведения см. в описании свойства XmlWriterSettings.ConformanceLevel и перечисления System.Xml.ConformanceLevel.For details, see the XmlWriterSettings.ConformanceLevel property and the System.Xml.ConformanceLevel enumeration.

    УровеньLevel ОписаниеDescription
    Document Выходные данные XML соответствует правилам для XML 1,0-документа с правильным форматом и могут обрабатываться любым процессором.The XML output conforms to the rules for a well-formed XML 1.0 document and can be processed by any conforming processor.
    Fragment Выходные данные XML соответствует правилам для фрагмента документа XML 1,0 с правильным форматом.The XML output conforms to the rules for a well-formed XML 1.0 document fragment.
    Auto Модуль записи XML определяет, какой уровень проверки соответствия необходимо применить (документ или фрагмент) на основе входящих данных.The XML writer determines which level of conformation checking to apply (document or fragment) based on the incoming data.

Запись элементовWriting elements

Для записи узлов элементов можно использовать следующие методы XmlWriter.You can use the following XmlWriter methods to write element nodes. Примеры см. в списке методов.For examples, see the methods listed.

ПрименениеUse ЧтобыTo
WriteElementString Запись всего узла элемента, включая строковое значение.Write an entire element node, including a string value.
WriteStartElement Для записи значения элемента с помощью нескольких вызовов методов.To write an element value by using multiple method calls. Например, можно вызвать метод WriteValue для записи типизированного значения, метод WriteCharEntity для записи сущности-символа, метод WriteAttributeString для записи атрибута или можно записать дочерний элемент.For example, you can call WriteValue to write a typed value, WriteCharEntity to write a character entity, WriteAttributeString to write an attribute, or you can write a child element. Это более сложная версия метода WriteElementString.This is a more sophisticated version of the WriteElementString method.

Чтобы закрыть элемент, вызовите метод WriteEndElement или WriteFullEndElement.To close the element, you call the WriteEndElement or WriteFullEndElement method.
WriteNode Копирование узла элемента, найденного в текущей позиции XmlReader или XPathNavigator объекта.To copy an element node found at the current position of an XmlReader or XPathNavigator object. При вызове выполняется копирование всего, от исходного объекта до экземпляра XmlWriter.When called, it copies everything from the source object to the XmlWriter instance.

Запись атрибутовWriting attributes

Для записи атрибутов в узлах элементов можно использовать следующие методы XmlWriter.You can use the following XmlWriter methods to write attributes on element nodes. Эти методы также можно использовать для создания объявлений пространств имен в элементе, как описано в следующем разделе.These methods can also be used to create namespace declarations on an element, as discussed in the next section.

ПрименениеUse ЧтобыTo
WriteAttributeString Для записи всего узла атрибута, включая строковое значение.To write an entire attribute node, including a string value.
WriteStartAttribute Для записи значения атрибута с помощью нескольких вызовов методов.To write the attribute value using multiple method calls. Например, можно вызвать WriteValue для записи типизированного значения.For example, you can call WriteValue to write a typed value. Это более сложная версия метода WriteElementString.This is a more sophisticated version of the WriteElementString method.

Чтобы закрыть элемент, вызовите метод WriteEndAttribute.To close the element, you call the WriteEndAttribute method.
WriteAttributes Копирование всех атрибутов, найденных в текущей позиции объекта XmlReader.To copy all the attributes found at the current position of an XmlReader object. Записываемые атрибуты зависят от типа узла, на котором в данный момент расположен модуль чтения.The attributes that are written depend on the type of node the reader is currently positioned on:

— Для узла атрибута он записывает текущий атрибут, а остальные атрибуты — до закрывающего тега элемента.- For an attribute node, it writes the current attribute, and then the rest of the attributes until the element closing tag.
— Для узла элемента записываются все атрибуты, содержащиеся в элементе.- For an element node, it writes all attributes contained by the element.
— Для узла объявления XML записываются все атрибуты в объявлении.- For an XML declaration node, it writes all the attributes in the declaration.
— Для всех других типов узлов метод создает исключение.- For all other node types, the method throws an exception.

Обработка пространств именHandling namespaces

Пространства имен используются, чтобы указывать имена элементов и атрибутов в XML-документе.Namespaces are used to qualify element and attribute names in an XML document. Префиксы пространств имен связывают элементы и атрибуты с пространствами имен, которые, в свою очередь, связаны со ссылками URI.Namespace prefixes associate elements and attributes with namespaces, which are in turn associated with URI references. Пространства имен обеспечивают уникальность имен элементов и атрибутов в XML-документе.Namespaces create element and attribute name uniqueness in an XML document.

XmlWriter поддерживает стек пространства имен, соответствующий всем пространствам имен, определенным в текущей области пространства имен.The XmlWriter maintains a namespace stack that corresponds to all the namespaces defined in the current namespace scope. При написании элементов и атрибутов можно использовать следующие способы.When writing elements and attributes you can utilize namespaces in the following ways:

  • Объявите пространства имен вручную с помощью метода WriteAttributeString.Declare namespaces manually by using the WriteAttributeString method. Это бывает полезным, если известно, как наилучшим образом оптимизировать количество деклараций пространств имен.This can be useful when you know how to best optimize the number of namespace declarations. Пример см. в описании метода WriteAttributeString(String, String, String, String).For an example, see the WriteAttributeString(String, String, String, String) method.

  • Текущее объявление пространства имен обходится новым пространством имен.Override the current namespace declaration with a new namespace. В следующем коде метод WriteAttributeString изменяет URI пространства имен для префикса "x" из "123" в "abc".In the following code, the WriteAttributeString method changes the namespace URI for the "x" prefix from "123" to "abc".

    writer.WriteStartElement("x", "root", "123");
    writer.WriteStartElement("item");
    writer.WriteAttributeString("xmlns", "x", null, "abc");
    writer.WriteEndElement();
    writer.WriteEndElement();
    
    writer.WriteStartElement("x", "root", "123")
    writer.WriteStartElement("item")
    writer.WriteAttributeString("xmlns", "x", Nothing, "abc")
    writer.WriteEndElement()
    writer.WriteEndElement()
    

    Код формирует следующую XML-строку:The code generates the following XML string:

    <x:root xmlns:x="123">  
      <item xmlns:x="abc" />  
    </x:root>  
    
  • Префикс пространства имен указывается при написании атрибутов или элементов.Specify a namespace prefix when writing attributes or elements. Многие методы, используемые для записи элементов и атрибутов, позволяют сделать это.Many of the methods used to write element and attributes enable you to do this. Например, метод WriteStartElement(String, String, String) записывает открывающий тег и связывает его с указанным пространством имен и префиксом.For example, the WriteStartElement(String, String, String) method writes a start tag and associates it with a specified namespace and prefix.

Запись типизированных данныхWriting typed data

Метод WriteValue принимает объект среды CLR, преобразует входное значение в его строковое представление в соответствии с правилами преобразования типов данных языка определения схем XML (XSD) и записывает его с помощью метода WriteString.The WriteValue method accepts a common language runtime (CLR) object, converts the input value to its string representation according to XML schema definition language (XSD) data type conversion rules, and writes it out by using the WriteString method. Это проще, чем использовать методы в классе XmlConvert для преобразования типизированных данных в строковое значение перед их записью.This is easier than using the methods in the XmlConvert class to convert the typed data to a string value before writing it out.

При записи в текст типизированное значение сериализуется в текст с использованием правил XmlConvert для этого типа схемы.When writing to text, the typed value is serialized to text by using the XmlConvert rules for that schema type.

Сведения о типах данных XSD по умолчанию, соответствующих типам CLR, см. в описании метода WriteValue.For default XSD data types that correspond to CLR types, see the WriteValue method.

XmlWriter также можно использовать для записи в хранилище данных XML.The XmlWriter can also be used to write to an XML data store. Например, класс XPathNavigator может создать объект XmlWriter для создания узлов для объекта XmlDocument.For example, the XPathNavigator class can create an XmlWriter object to create nodes for an XmlDocument object. Если хранилище данных имеет доступ к сведениям о схеме, метод WriteValue вызывает исключение при попытке преобразовать его в недопустимый тип.If the data store has schema information available to it, the WriteValue method throws an exception if you try to convert to a type that is not allowed. Если хранилище данных не имеет доступной информации о схеме, метод WriteValue рассматривает все значения как тип xsd:anySimpleType.If the data store does not have schema information available to it, the WriteValue method treats all values as an xsd:anySimpleType type.

Закрытие модуля записи XMLClosing the XML writer

При использовании XmlWriter методов для вывода XML элементы и атрибуты не записываются, пока не будет вызван метод Close.When you use XmlWriter methods to output XML, the elements and attributes are not written until you call the Close method. Например, если вы используете XmlWriter для заполнения объекта XmlDocument, вы не сможете увидеть записанные элементы и атрибуты в целевом документе, пока не закроете экземпляр XmlWriter.For example, if you are using XmlWriter to populate an XmlDocument object, you won't be able to see the written elements and attributes in the target document until you close the XmlWriter instance.

Асинхронное программированиеAsynchronous programming

Большинство методов XmlWriter имеют асинхронные аналоги, имеющие "Async" в конце имен методов.Most of the XmlWriter methods have asynchronous counterparts that have "Async" at the end of their method names. Например, асинхронный эквивалент WriteAttributeString WriteAttributeStringAsync.For example, the asynchronous equivalent of WriteAttributeString is WriteAttributeStringAsync.

Для метода WriteValue, который не имеет асинхронного аналога, преобразуйте возвращаемое значение в строку и используйте вместо этого метод WriteStringAsync.For the WriteValue method, which doesn't have an asynchronous counterpart, convert the return value to a string and use the WriteStringAsync method instead.

Замечания по безопасностиSecurity considerations

При работе с классом XmlWriter учитывайте следующее.Consider the following when working with the XmlWriter class:

  • Исключения, вызываемые XmlWriter, могут раскрывать сведения о пути, которые не должны быть собраны в приложение.Exceptions thrown by the XmlWriter can disclose path information that you do not want bubbled up to the app. Приложение должно перехватывать исключения и обрабатывать их соответствующим образом.Your app must catch exceptions and process them appropriately.

  • XmlWriter не проверяет данные, передаваемые в метод WriteDocType или WriteRaw.XmlWriter does not validate any data that is passed to the WriteDocType or WriteRaw method. В эти методы не следует передавать произвольные данные.You should not pass arbitrary data to these methods.

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

XmlWriter()

Initializes a new instance of the XmlWriter class.Initializes a new instance of the XmlWriter class.

Свойства

Settings

Gets the XmlWriterSettings object used to create this XmlWriter instance.Gets the XmlWriterSettings object used to create this XmlWriter instance.

WriteState

When overridden in a derived class, gets the state of the writer.When overridden in a derived class, gets the state of the writer.

XmlLang

When overridden in a derived class, gets the current xml:lang scope.When overridden in a derived class, gets the current xml:lang scope.

XmlSpace

When overridden in a derived class, gets an XmlSpace representing the current xml:space scope.When overridden in a derived class, gets an XmlSpace representing the current xml:space scope.

Методы

Close()

When overridden in a derived class, closes this stream and the underlying stream.When overridden in a derived class, closes this stream and the underlying stream.

Create(Stream)

Creates a new XmlWriter instance using the specified stream.Creates a new XmlWriter instance using the specified stream.

Create(Stream, XmlWriterSettings)

Creates a new XmlWriter instance using the stream and XmlWriterSettings object.Creates a new XmlWriter instance using the stream and XmlWriterSettings object.

Create(String)

Creates a new XmlWriter instance using the specified filename.Creates a new XmlWriter instance using the specified filename.

Create(String, XmlWriterSettings)

Creates a new XmlWriter instance using the filename and XmlWriterSettings object.Creates a new XmlWriter instance using the filename and XmlWriterSettings object.

Create(StringBuilder)

Creates a new XmlWriter instance using the specified StringBuilder.Creates a new XmlWriter instance using the specified StringBuilder.

Create(StringBuilder, XmlWriterSettings)

Creates a new XmlWriter instance using the StringBuilder and XmlWriterSettings objects.Creates a new XmlWriter instance using the StringBuilder and XmlWriterSettings objects.

Create(TextWriter)

Creates a new XmlWriter instance using the specified TextWriter.Creates a new XmlWriter instance using the specified TextWriter.

Create(TextWriter, XmlWriterSettings)

Creates a new XmlWriter instance using the TextWriter and XmlWriterSettings objects.Creates a new XmlWriter instance using the TextWriter and XmlWriterSettings objects.

Create(XmlWriter)

Creates a new XmlWriter instance using the specified XmlWriter object.Creates a new XmlWriter instance using the specified XmlWriter object.

Create(XmlWriter, XmlWriterSettings)

Creates a new XmlWriter instance using the specified XmlWriter and XmlWriterSettings objects.Creates a new XmlWriter instance using the specified XmlWriter and XmlWriterSettings objects.

Dispose()

Releases all resources used by the current instance of the XmlWriter class.Releases all resources used by the current instance of the XmlWriter class.

Dispose(Boolean)

Releases the unmanaged resources used by the XmlWriter and optionally releases the managed resources.Releases the unmanaged resources used by the XmlWriter and optionally releases the managed resources.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
Flush()

When overridden in a derived class, flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.When overridden in a derived class, flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

FlushAsync()

Asynchronously flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.Asynchronously flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
LookupPrefix(String)

When overridden in a derived class, returns the closest prefix defined in the current namespace scope for the namespace URI.When overridden in a derived class, returns the closest prefix defined in the current namespace scope for the namespace URI.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
WriteAttributes(XmlReader, Boolean)

When overridden in a derived class, writes out all the attributes found at the current position in the XmlReader.When overridden in a derived class, writes out all the attributes found at the current position in the XmlReader.

WriteAttributesAsync(XmlReader, Boolean)

Asynchronously writes out all the attributes found at the current position in the XmlReader.Asynchronously writes out all the attributes found at the current position in the XmlReader.

WriteAttributeString(String, String)

When overridden in a derived class, writes out the attribute with the specified local name and value.When overridden in a derived class, writes out the attribute with the specified local name and value.

WriteAttributeString(String, String, String)

When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value.When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value.

WriteAttributeString(String, String, String, String)

When overridden in a derived class, writes out the attribute with the specified prefix, local name, namespace URI, and value.When overridden in a derived class, writes out the attribute with the specified prefix, local name, namespace URI, and value.

WriteAttributeStringAsync(String, String, String, String)

Asynchronously writes out the attribute with the specified prefix, local name, namespace URI, and value.Asynchronously writes out the attribute with the specified prefix, local name, namespace URI, and value.

WriteBase64(Byte[], Int32, Int32)

When overridden in a derived class, encodes the specified binary bytes as Base64 and writes out the resulting text.When overridden in a derived class, encodes the specified binary bytes as Base64 and writes out the resulting text.

WriteBase64Async(Byte[], Int32, Int32)

Asynchronously encodes the specified binary bytes as Base64 and writes out the resulting text.Asynchronously encodes the specified binary bytes as Base64 and writes out the resulting text.

WriteBinHex(Byte[], Int32, Int32)

When overridden in a derived class, encodes the specified binary bytes as BinHex and writes out the resulting text.When overridden in a derived class, encodes the specified binary bytes as BinHex and writes out the resulting text.

WriteBinHexAsync(Byte[], Int32, Int32)

Asynchronously encodes the specified binary bytes as BinHex and writes out the resulting text.Asynchronously encodes the specified binary bytes as BinHex and writes out the resulting text.

WriteCData(String)

When overridden in a derived class, writes out a <![CDATA[...]]> block containing the specified text.When overridden in a derived class, writes out a <![CDATA[...]]> block containing the specified text.

WriteCDataAsync(String)

Asynchronously writes out a <![CDATA[...]]> block containing the specified text.Asynchronously writes out a <![CDATA[...]]> block containing the specified text.

WriteCharEntity(Char)

When overridden in a derived class, forces the generation of a character entity for the specified Unicode character value.When overridden in a derived class, forces the generation of a character entity for the specified Unicode character value.

WriteCharEntityAsync(Char)

Asynchronously forces the generation of a character entity for the specified Unicode character value.Asynchronously forces the generation of a character entity for the specified Unicode character value.

WriteChars(Char[], Int32, Int32)

When overridden in a derived class, writes text one buffer at a time.When overridden in a derived class, writes text one buffer at a time.

WriteCharsAsync(Char[], Int32, Int32)

Asynchronously writes text one buffer at a time.Asynchronously writes text one buffer at a time.

WriteComment(String)

When overridden in a derived class, writes out a comment <!--...--> containing the specified text.When overridden in a derived class, writes out a comment <!--...--> containing the specified text.

WriteCommentAsync(String)

Asynchronously writes out a comment <!--...--> containing the specified text.Asynchronously writes out a comment <!--...--> containing the specified text.

WriteDocType(String, String, String, String)

When overridden in a derived class, writes the DOCTYPE declaration with the specified name and optional attributes.When overridden in a derived class, writes the DOCTYPE declaration with the specified name and optional attributes.

WriteDocTypeAsync(String, String, String, String)

Asynchronously writes the DOCTYPE declaration with the specified name and optional attributes.Asynchronously writes the DOCTYPE declaration with the specified name and optional attributes.

WriteElementString(String, String)

Writes an element with the specified local name and value.Writes an element with the specified local name and value.

WriteElementString(String, String, String)

Writes an element with the specified local name, namespace URI, and value.Writes an element with the specified local name, namespace URI, and value.

WriteElementString(String, String, String, String)

Writes an element with the specified prefix, local name, namespace URI, and value.Writes an element with the specified prefix, local name, namespace URI, and value.

WriteElementStringAsync(String, String, String, String)

Asynchronously writes an element with the specified prefix, local name, namespace URI, and value.Asynchronously writes an element with the specified prefix, local name, namespace URI, and value.

WriteEndAttribute()

When overridden in a derived class, closes the previous WriteStartAttribute(String, String) call.When overridden in a derived class, closes the previous WriteStartAttribute(String, String) call.

WriteEndAttributeAsync()

Asynchronously closes the previous WriteStartAttribute(String, String) call.Asynchronously closes the previous WriteStartAttribute(String, String) call.

WriteEndDocument()

When overridden in a derived class, closes any open elements or attributes and puts the writer back in the Start state.When overridden in a derived class, closes any open elements or attributes and puts the writer back in the Start state.

WriteEndDocumentAsync()

Asynchronously closes any open elements or attributes and puts the writer back in the Start state.Asynchronously closes any open elements or attributes and puts the writer back in the Start state.

WriteEndElement()

When overridden in a derived class, closes one element and pops the corresponding namespace scope.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

WriteEndElementAsync()

Asynchronously closes one element and pops the corresponding namespace scope.Asynchronously closes one element and pops the corresponding namespace scope.

WriteEntityRef(String)

When overridden in a derived class, writes out an entity reference as &name;.When overridden in a derived class, writes out an entity reference as &name;.

WriteEntityRefAsync(String)

Asynchronously writes out an entity reference as &name;.Asynchronously writes out an entity reference as &name;.

WriteFullEndElement()

When overridden in a derived class, closes one element and pops the corresponding namespace scope.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

WriteFullEndElementAsync()

Asynchronously closes one element and pops the corresponding namespace scope.Asynchronously closes one element and pops the corresponding namespace scope.

WriteName(String)

When overridden in a derived class, writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).When overridden in a derived class, writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNameAsync(String)

Asynchronously writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).Asynchronously writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNmToken(String)

When overridden in a derived class, writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).When overridden in a derived class, writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNmTokenAsync(String)

Asynchronously writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).Asynchronously writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNode(XmlReader, Boolean)

When overridden in a derived class, copies everything from the reader to the writer and moves the reader to the start of the next sibling.When overridden in a derived class, copies everything from the reader to the writer and moves the reader to the start of the next sibling.

WriteNode(XPathNavigator, Boolean)

Copies everything from the XPathNavigator object to the writer.Copies everything from the XPathNavigator object to the writer. The position of the XPathNavigator remains unchanged.The position of the XPathNavigator remains unchanged.

WriteNodeAsync(XmlReader, Boolean)

Asynchronously copies everything from the reader to the writer and moves the reader to the start of the next sibling.Asynchronously copies everything from the reader to the writer and moves the reader to the start of the next sibling.

WriteNodeAsync(XPathNavigator, Boolean)

Asynchronously copies everything from the XPathNavigator object to the writer.Asynchronously copies everything from the XPathNavigator object to the writer. The position of the XPathNavigator remains unchanged.The position of the XPathNavigator remains unchanged.

WriteProcessingInstruction(String, String)

When overridden in a derived class, writes out a processing instruction with a space between the name and text as follows: <?name text?>.When overridden in a derived class, writes out a processing instruction with a space between the name and text as follows: <?name text?>.

WriteProcessingInstructionAsync(String, String)

Asynchronously writes out a processing instruction with a space between the name and text as follows: <?name text?>.Asynchronously writes out a processing instruction with a space between the name and text as follows: <?name text?>.

WriteQualifiedName(String, String)

When overridden in a derived class, writes out the namespace-qualified name.When overridden in a derived class, writes out the namespace-qualified name. This method looks up the prefix that is in scope for the given namespace.This method looks up the prefix that is in scope for the given namespace.

WriteQualifiedNameAsync(String, String)

Asynchronously writes out the namespace-qualified name.Asynchronously writes out the namespace-qualified name. This method looks up the prefix that is in scope for the given namespace.This method looks up the prefix that is in scope for the given namespace.

WriteRaw(Char[], Int32, Int32)

When overridden in a derived class, writes raw markup manually from a character buffer.When overridden in a derived class, writes raw markup manually from a character buffer.

WriteRaw(String)

When overridden in a derived class, writes raw markup manually from a string.When overridden in a derived class, writes raw markup manually from a string.

WriteRawAsync(Char[], Int32, Int32)

Asynchronously writes raw markup manually from a character buffer.Asynchronously writes raw markup manually from a character buffer.

WriteRawAsync(String)

Asynchronously writes raw markup manually from a string.Asynchronously writes raw markup manually from a string.

WriteStartAttribute(String)

Writes the start of an attribute with the specified local name.Writes the start of an attribute with the specified local name.

WriteStartAttribute(String, String)

Writes the start of an attribute with the specified local name and namespace URI.Writes the start of an attribute with the specified local name and namespace URI.

WriteStartAttribute(String, String, String)

When overridden in a derived class, writes the start of an attribute with the specified prefix, local name, and namespace URI.When overridden in a derived class, writes the start of an attribute with the specified prefix, local name, and namespace URI.

WriteStartAttributeAsync(String, String, String)

Asynchronously writes the start of an attribute with the specified prefix, local name, and namespace URI.Asynchronously writes the start of an attribute with the specified prefix, local name, and namespace URI.

WriteStartDocument()

When overridden in a derived class, writes the XML declaration with the version "1.0".When overridden in a derived class, writes the XML declaration with the version "1.0".

WriteStartDocument(Boolean)

When overridden in a derived class, writes the XML declaration with the version "1.0" and the standalone attribute.When overridden in a derived class, writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartDocumentAsync()

Asynchronously writes the XML declaration with the version "1.0".Asynchronously writes the XML declaration with the version "1.0".

WriteStartDocumentAsync(Boolean)

Asynchronously writes the XML declaration with the version "1.0" and the standalone attribute.Asynchronously writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartElement(String)

When overridden in a derived class, writes out a start tag with the specified local name.When overridden in a derived class, writes out a start tag with the specified local name.

WriteStartElement(String, String)

When overridden in a derived class, writes the specified start tag and associates it with the given namespace.When overridden in a derived class, writes the specified start tag and associates it with the given namespace.

WriteStartElement(String, String, String)

When overridden in a derived class, writes the specified start tag and associates it with the given namespace and prefix.When overridden in a derived class, writes the specified start tag and associates it with the given namespace and prefix.

WriteStartElementAsync(String, String, String)

Asynchronously writes the specified start tag and associates it with the given namespace and prefix.Asynchronously writes the specified start tag and associates it with the given namespace and prefix.

WriteString(String)

When overridden in a derived class, writes the given text content.When overridden in a derived class, writes the given text content.

WriteStringAsync(String)

Asynchronously writes the given text content.Asynchronously writes the given text content.

WriteSurrogateCharEntity(Char, Char)

When overridden in a derived class, generates and writes the surrogate character entity for the surrogate character pair.When overridden in a derived class, generates and writes the surrogate character entity for the surrogate character pair.

WriteSurrogateCharEntityAsync(Char, Char)

Asynchronously generates and writes the surrogate character entity for the surrogate character pair.Asynchronously generates and writes the surrogate character entity for the surrogate character pair.

WriteValue(Boolean)

Writes a Boolean value.Writes a Boolean value.

WriteValue(DateTime)

Writes a DateTime value.Writes a DateTime value.

WriteValue(DateTimeOffset)

Writes a DateTimeOffset value.Writes a DateTimeOffset value.

WriteValue(Decimal)

Writes a Decimal value.Writes a Decimal value.

WriteValue(Double)

Writes a Double value.Writes a Double value.

WriteValue(Int32)

Writes a Int32 value.Writes a Int32 value.

WriteValue(Int64)

Writes a Int64 value.Writes a Int64 value.

WriteValue(Object)

Writes the object value.Writes the object value.

WriteValue(Single)

Writes a single-precision floating-point number.Writes a single-precision floating-point number.

WriteValue(String)

Writes a String value.Writes a String value.

WriteWhitespace(String)

When overridden in a derived class, writes out the given white space.When overridden in a derived class, writes out the given white space.

WriteWhitespaceAsync(String)

Asynchronously writes out the given white space.Asynchronously writes out the given white space.

Явные реализации интерфейса

IDisposable.Dispose()

For a description of this member, see Dispose().For a description of this member, see Dispose().

Применяется к

Дополнительно