XmlWriter XmlWriter XmlWriter XmlWriter Class

Определение

Представляет средство записи, обеспечивающее быстрый прямой способ (без кэширования) создания потоков или файлов, содержащих XML-данные.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 abstract class XmlWriter : IDisposable
type XmlWriter = class
    interface IDisposable
Public MustInherit Class XmlWriter
Implements IDisposable
Наследование
XmlWriterXmlWriterXmlWriterXmlWriter
Производный
Реализации

Примеры

В следующем примере кода показано, как использовать асинхронный интерфейс 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) 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 метод вызывает исключение, если пытаться выполнить преобразование к типу, который не допускается. Если хранилище данных не содержит сведений о схеме, WriteValue метод обрабатывает все значения как xsd:anySimpleType типа.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.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() XmlWriter() XmlWriter() XmlWriter()

Инициализирует новый экземпляр класса XmlWriter.Initializes a new instance of the XmlWriter class.

Свойства

Settings Settings Settings Settings

Получает объект XmlWriterSettings, используемый для создания данного экземпляра XmlWriter.Gets the XmlWriterSettings object used to create this XmlWriter instance.

WriteState WriteState WriteState WriteState

Когда переопределено в производном классе, возвращает состояние средства записи.When overridden in a derived class, gets the state of the writer.

XmlLang XmlLang XmlLang XmlLang

При переопределении в производном классе получает текущую область действия xml:lang.When overridden in a derived class, gets the current xml:lang scope.

XmlSpace XmlSpace XmlSpace XmlSpace

При переопределении в производном классе возвращает класс XmlSpace, предоставляющий текущую область xml:space.When overridden in a derived class, gets an XmlSpace representing the current xml:space scope.

Методы

Close() Close() Close() Close()

Когда переопределено в производном классе, закрывает данный поток и базовый поток.When overridden in a derived class, closes this stream and the underlying stream.

Create(Stream) Create(Stream) Create(Stream) Create(Stream)

Создает новый экземпляр XmlWriter с использованием указанного потока.Creates a new XmlWriter instance using the specified stream.

Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings)

Создает новый экземпляр XmlWriter с помощью потока и объекта XmlWriterSettings.Creates a new XmlWriter instance using the stream and XmlWriterSettings object.

Create(String) Create(String) Create(String) Create(String)

Создает новый экземпляр XmlWriter с использованием указанного имени файла.Creates a new XmlWriter instance using the specified filename.

Create(String, XmlWriterSettings) Create(String, XmlWriterSettings) Create(String, XmlWriterSettings) Create(String, XmlWriterSettings)

Создает новый экземпляр XmlWriter с помощью имени файла и объекта XmlWriterSettings.Creates a new XmlWriter instance using the filename and XmlWriterSettings object.

Create(StringBuilder) Create(StringBuilder) Create(StringBuilder) Create(StringBuilder)

Создает новый экземпляр XmlWriter с использованием указанного StringBuilder.Creates a new XmlWriter instance using the specified StringBuilder.

Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings)

Создает новый экземпляр XmlWriter с использованием объектов StringBuilder и XmlWriterSettings.Creates a new XmlWriter instance using the StringBuilder and XmlWriterSettings objects.

Create(TextWriter) Create(TextWriter) Create(TextWriter) Create(TextWriter)

Создает новый экземпляр XmlWriter с использованием указанного TextWriter.Creates a new XmlWriter instance using the specified TextWriter.

Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings)

Создает новый экземпляр XmlWriter с использованием объектов TextWriter и XmlWriterSettings.Creates a new XmlWriter instance using the TextWriter and XmlWriterSettings objects.

Create(XmlWriter) Create(XmlWriter) Create(XmlWriter) Create(XmlWriter)

Создает новый экземпляр XmlWriter с использованием указанного объекта XmlWriter.Creates a new XmlWriter instance using the specified XmlWriter object.

Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings)

Создает новый экземпляр XmlWriter с использованием указанных объектов XmlWriter и XmlWriterSettings.Creates a new XmlWriter instance using the specified XmlWriter and XmlWriterSettings objects.

Dispose() Dispose() Dispose() Dispose()

Освобождает все ресурсы, используемые текущим экземпляром класса XmlWriter.Releases all resources used by the current instance of the XmlWriter class.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом XmlWriter, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the XmlWriter and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
Flush() Flush() Flush() Flush()

Когда переопределено в производном классе, сохраняет в базовый поток содержимое буфера, а также сохраняет основной поток.When overridden in a derived class, flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

FlushAsync() FlushAsync() FlushAsync() FlushAsync()

Асинхронно записывает в базовый поток содержимое буфера и сохраняет базовый поток.Asynchronously flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
LookupPrefix(String) LookupPrefix(String) LookupPrefix(String) LookupPrefix(String)

Когда переопределено в производном классе, возвращает ближайший префикс, определенный в области видимости текущего пространства имен для URI пространства имен.When overridden in a derived class, returns the closest prefix defined in the current namespace scope for the namespace URI.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)
WriteAttributes(XmlReader, Boolean) WriteAttributes(XmlReader, Boolean) WriteAttributes(XmlReader, Boolean) WriteAttributes(XmlReader, Boolean)

При переопределении в производном классе записывает все атрибуты, найденные в текущей позиции в объекте XmlReader.When overridden in a derived class, writes out all the attributes found at the current position in the XmlReader.

WriteAttributesAsync(XmlReader, Boolean) WriteAttributesAsync(XmlReader, Boolean) WriteAttributesAsync(XmlReader, Boolean) WriteAttributesAsync(XmlReader, Boolean)

Асинхронно записывает все атрибуты, найденные в текущей позиции в объекте XmlReader.Asynchronously writes out all the attributes found at the current position in the XmlReader.

WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String)

Когда переопределено в производном классе, записывает атрибут с указанным локальным именем и значением.When overridden in a derived class, writes out the attribute with the specified local name and value.

WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String)

Когда переопределено в производном классе, записывает атрибут с указанным локальным именем, URI пространства имен и значением.When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value.

WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String)

Когда переопределено в производном классе, записывает атрибут с указанным префиксом, локальным именем, URI пространства имен и значением.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) WriteAttributeStringAsync(String, String, String, String) WriteAttributeStringAsync(String, String, String, String) WriteAttributeStringAsync(String, String, String, String)

Асинхронно записывает атрибут с заданным префиксом, локальным именем, универсальным кодом ресурса (URI) пространства имен и значением.Asynchronously writes out the attribute with the specified prefix, local name, namespace URI, and value.

WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32)

Когда переопределено в производном классе, преобразует указанный набор двоичных байтов в кодировку Base64 и записывает получившийся текст.When overridden in a derived class, encodes the specified binary bytes as Base64 and writes out the resulting text.

WriteBase64Async(Byte[], Int32, Int32) WriteBase64Async(Byte[], Int32, Int32) WriteBase64Async(Byte[], Int32, Int32) WriteBase64Async(Byte[], Int32, Int32)

Асинхронно преобразует указанный набор двоичных байтов в кодировку Base64 и записывает получившийся текст.Asynchronously encodes the specified binary bytes as Base64 and writes out the resulting text.

WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32)

При переопределении в производном классе преобразует указанный набор двоичных байтов как BinHex и выводит получившийся текст.When overridden in a derived class, encodes the specified binary bytes as BinHex and writes out the resulting text.

WriteBinHexAsync(Byte[], Int32, Int32) WriteBinHexAsync(Byte[], Int32, Int32) WriteBinHexAsync(Byte[], Int32, Int32) WriteBinHexAsync(Byte[], Int32, Int32)

Асинхронно кодирует указанные двоичные байты как BinHex и выводит получившийся текст.Asynchronously encodes the specified binary bytes as BinHex and writes out the resulting text.

WriteCData(String) WriteCData(String) WriteCData(String) WriteCData(String)

Когда переопределено в производном классе, записывает блок <![CDATA[...]]>, содержащий заданный текст.When overridden in a derived class, writes out a <![CDATA[...]]> block containing the specified text.

WriteCDataAsync(String) WriteCDataAsync(String) WriteCDataAsync(String) WriteCDataAsync(String)

Асинхронно записывает блок <![CDATA[...]]>, содержащий заданный текст.Asynchronously writes out a <![CDATA[...]]> block containing the specified text.

WriteCharEntity(Char) WriteCharEntity(Char) WriteCharEntity(Char) WriteCharEntity(Char)

Когда переопределено в производном классе, вызывает создание сущности знака для указанного значения знака Юникода.When overridden in a derived class, forces the generation of a character entity for the specified Unicode character value.

WriteCharEntityAsync(Char) WriteCharEntityAsync(Char) WriteCharEntityAsync(Char) WriteCharEntityAsync(Char)

Асинхронно инициирует создание сущности знака для указанного значения знака Юникода.Asynchronously forces the generation of a character entity for the specified Unicode character value.

WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32)

Когда переопределено в производном классе, записывает содержимое текстового буфера.When overridden in a derived class, writes text one buffer at a time.

WriteCharsAsync(Char[], Int32, Int32) WriteCharsAsync(Char[], Int32, Int32) WriteCharsAsync(Char[], Int32, Int32) WriteCharsAsync(Char[], Int32, Int32)

Асинхронно записывает содержимое текстового буфера.Asynchronously writes text one buffer at a time.

WriteComment(String) WriteComment(String) WriteComment(String) WriteComment(String)

Когда переопределено в производном классе, записывает примечание <!--...-->, содержащее заданный текст.When overridden in a derived class, writes out a comment <!--...--> containing the specified text.

WriteCommentAsync(String) WriteCommentAsync(String) WriteCommentAsync(String) WriteCommentAsync(String)

Асинхронно записывает комментарий <!--...-->, содержащий заданный текст.Asynchronously writes out a comment <!--...--> containing the specified text.

WriteDocType(String, String, String, String) WriteDocType(String, String, String, String) WriteDocType(String, String, String, String) WriteDocType(String, String, String, String)

Когда переопределено в производном классе, записывает объявление DOCTYPE с указанным именем и дополнительными атрибутами.When overridden in a derived class, writes the DOCTYPE declaration with the specified name and optional attributes.

WriteDocTypeAsync(String, String, String, String) WriteDocTypeAsync(String, String, String, String) WriteDocTypeAsync(String, String, String, String) WriteDocTypeAsync(String, String, String, String)

Асинхронно записывает объявление DOCTYPE с указанным именем и дополнительными атрибутами.Asynchronously writes the DOCTYPE declaration with the specified name and optional attributes.

WriteElementString(String, String) WriteElementString(String, String) WriteElementString(String, String) WriteElementString(String, String)

Записывает элемент с заданным локальным именем и значением.Writes an element with the specified local name and value.

WriteElementString(String, String, String) WriteElementString(String, String, String) WriteElementString(String, String, String) WriteElementString(String, String, String)

Записывает элемент с заданным локальным именем, URI пространства имен и значением.Writes an element with the specified local name, namespace URI, and value.

WriteElementString(String, String, String, String) WriteElementString(String, String, String, String) WriteElementString(String, String, String, String) WriteElementString(String, String, String, String)

Записывает элемент с заданным префиксом, локальным именем, универсальный кодом ресурса (URI) пространства имен и значением.Writes an element with the specified prefix, local name, namespace URI, and value.

WriteElementStringAsync(String, String, String, String) WriteElementStringAsync(String, String, String, String) WriteElementStringAsync(String, String, String, String) WriteElementStringAsync(String, String, String, String)

Асинхронно записывает элемент с заданным префиксом, локальным именем, универсальным кодом ресурса (URI) пространства имен и значением.Asynchronously writes an element with the specified prefix, local name, namespace URI, and value.

WriteEndAttribute() WriteEndAttribute() WriteEndAttribute() WriteEndAttribute()

При переопределении в производном классе закрывает предыдущий вызов WriteStartAttribute(String, String).When overridden in a derived class, closes the previous WriteStartAttribute(String, String) call.

WriteEndAttributeAsync() WriteEndAttributeAsync() WriteEndAttributeAsync() WriteEndAttributeAsync()

Асинхронно закрывает предыдущий вызов WriteStartAttribute(String, String).Asynchronously closes the previous WriteStartAttribute(String, String) call.

WriteEndDocument() WriteEndDocument() WriteEndDocument() WriteEndDocument()

Когда переопределено в производном классе, закрывает все открытые элементы и атрибуты, возвращая средство записи в начальное состояние.When overridden in a derived class, closes any open elements or attributes and puts the writer back in the Start state.

WriteEndDocumentAsync() WriteEndDocumentAsync() WriteEndDocumentAsync() WriteEndDocumentAsync()

Асинхронно закрывает все открытые элементы и атрибуты, возвращая средство записи в начальное состояние.Asynchronously closes any open elements or attributes and puts the writer back in the Start state.

WriteEndElement() WriteEndElement() WriteEndElement() WriteEndElement()

Когда переопределено в производном классе, закрывает один элемент и извлекает из стека область видимости соответствующего пространства имен.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

WriteEndElementAsync() WriteEndElementAsync() WriteEndElementAsync() WriteEndElementAsync()

Асинхронно закрывает один элемент и извлекает из стека область видимости соответствующего пространства имен.Asynchronously closes one element and pops the corresponding namespace scope.

WriteEntityRef(String) WriteEntityRef(String) WriteEntityRef(String) WriteEntityRef(String)

При переопределении в производном классе записывает ссылку на сущность в виде &name;.When overridden in a derived class, writes out an entity reference as &name;.

WriteEntityRefAsync(String) WriteEntityRefAsync(String) WriteEntityRefAsync(String) WriteEntityRefAsync(String)

Асинхронно записывает ссылку на сущность в виде &name;.Asynchronously writes out an entity reference as &name;.

WriteFullEndElement() WriteFullEndElement() WriteFullEndElement() WriteFullEndElement()

Когда переопределено в производном классе, закрывает один элемент и извлекает из стека область видимости соответствующего пространства имен.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

WriteFullEndElementAsync() WriteFullEndElementAsync() WriteFullEndElementAsync() WriteFullEndElementAsync()

Асинхронно закрывает один элемент и извлекает из стека область видимости соответствующего пространства имен.Asynchronously closes one element and pops the corresponding namespace scope.

WriteName(String) WriteName(String) WriteName(String) WriteName(String)

Когда переопределено в производном классе, записывает указанное имя, гарантируя его допустимость согласно рекомендации W3C по языку XML версии 1.0 (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) WriteNameAsync(String) WriteNameAsync(String) WriteNameAsync(String)

Асинхронно записывает указанное имя, гарантируя его допустимость согласно рекомендации W3C по языку XML версии 1.0 (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) WriteNmToken(String) WriteNmToken(String) WriteNmToken(String)

Когда переопределено в производном классе, записывает указанное имя, гарантируя, что оно является допустимым NmToken согласно рекомендации W3C по языку XML версии 1.0 (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) WriteNmTokenAsync(String) WriteNmTokenAsync(String) WriteNmTokenAsync(String)

Асинхронно записывает указанное имя, гарантируя, что оно является допустимым NmToken согласно рекомендации W3C по языку XML версии 1.0 (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) WriteNode(XmlReader, Boolean) WriteNode(XmlReader, Boolean) 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.

WriteNode(XPathNavigator, Boolean) WriteNode(XPathNavigator, Boolean) WriteNode(XPathNavigator, Boolean) WriteNode(XPathNavigator, Boolean)

Копирует все из объекта XPathNavigator в средство записи.Copies everything from the XPathNavigator object to the writer. Позиция XPathNavigator остается неизменной.The position of the XPathNavigator remains unchanged.

WriteNodeAsync(XmlReader, Boolean) WriteNodeAsync(XmlReader, Boolean) WriteNodeAsync(XmlReader, Boolean) WriteNodeAsync(XmlReader, Boolean)

Асинхронно копирует все данные из средства чтения в средство записи и перемещает средство чтения к началу следующего элемента того же уровня.Asynchronously copies everything from the reader to the writer and moves the reader to the start of the next sibling.

WriteNodeAsync(XPathNavigator, Boolean) WriteNodeAsync(XPathNavigator, Boolean) WriteNodeAsync(XPathNavigator, Boolean) WriteNodeAsync(XPathNavigator, Boolean)

Асинхронно копирует все из объекта XPathNavigator в средство записи.Asynchronously copies everything from the XPathNavigator object to the writer. Позиция XPathNavigator остается неизменной.The position of the XPathNavigator remains unchanged.

WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String) 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?>.

WriteProcessingInstructionAsync(String, String) WriteProcessingInstructionAsync(String, String) WriteProcessingInstructionAsync(String, String) WriteProcessingInstructionAsync(String, String)

Асинхронно записывает инструкцию обработки с пробелом между именем и текстом в следующем виде: <?имя текст?>.Asynchronously writes out a processing instruction with a space between the name and text as follows: <?name text?>.

WriteQualifiedName(String, String) WriteQualifiedName(String, String) WriteQualifiedName(String, String) WriteQualifiedName(String, String)

При переопределении в производном классе считывает полное имя пространства имен.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.

WriteQualifiedNameAsync(String, String) WriteQualifiedNameAsync(String, String) WriteQualifiedNameAsync(String, String) WriteQualifiedNameAsync(String, String)

Асинхронно записывает полное имя пространства имен.Asynchronously writes out the namespace-qualified name. Этот метод выполняет поиск префикса для пространства имен в его области.This method looks up the prefix that is in scope for the given namespace.

WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32)

Когда переопределено в производном классе, вручную записывает из буфера символов необработанные данные для разметки .When overridden in a derived class, writes raw markup manually from a character buffer.

WriteRaw(String) WriteRaw(String) WriteRaw(String) WriteRaw(String)

Когда переопределено в производном классе, вручную записывает из строки необработанные данные для разметки.When overridden in a derived class, writes raw markup manually from a string.

WriteRawAsync(Char[], Int32, Int32) WriteRawAsync(Char[], Int32, Int32) WriteRawAsync(Char[], Int32, Int32) WriteRawAsync(Char[], Int32, Int32)

Асинхронно, вручную записывает для разметки необработанные данные из буфера символов.Asynchronously writes raw markup manually from a character buffer.

WriteRawAsync(String) WriteRawAsync(String) WriteRawAsync(String) WriteRawAsync(String)

Асинхронно, вручную записывает необработанные данные для разметки.Asynchronously writes raw markup manually from a string.

WriteStartAttribute(String) WriteStartAttribute(String) WriteStartAttribute(String) WriteStartAttribute(String)

Записывает начало атрибута с заданным локальным именем.Writes the start of an attribute with the specified local name.

WriteStartAttribute(String, String) WriteStartAttribute(String, String) WriteStartAttribute(String, String) WriteStartAttribute(String, String)

Записывает начало атрибута с заданным локальным именем и URI пространства имен.Writes the start of an attribute with the specified local name and namespace URI.

WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String)

Когда переопределено в производном классе, записывает начало атрибута с указанным префиксом, локальным именем и 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) WriteStartAttributeAsync(String, String, String) WriteStartAttributeAsync(String, String, String) WriteStartAttributeAsync(String, String, String)

Асинхронно записывает начало атрибута с заданным префиксом, локальным именем и универсальным кодом ресурса (URI) пространства имен.Asynchronously writes the start of an attribute with the specified prefix, local name, and namespace URI.

WriteStartDocument() WriteStartDocument() WriteStartDocument() WriteStartDocument()

Когда переопределено в производном классе, записывает объявление XML с номером версии "1.0".When overridden in a derived class, writes the XML declaration with the version "1.0".

WriteStartDocument(Boolean) WriteStartDocument(Boolean) WriteStartDocument(Boolean) WriteStartDocument(Boolean)

Когда переопределено в производном классе, записывает объявление XML с номером версии "1.0" и отдельным атрибутом.When overridden in a derived class, writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartDocumentAsync() WriteStartDocumentAsync() WriteStartDocumentAsync() WriteStartDocumentAsync()

Асинхронно записывает объявление XML с номером версии "1.0".Asynchronously writes the XML declaration with the version "1.0".

WriteStartDocumentAsync(Boolean) WriteStartDocumentAsync(Boolean) WriteStartDocumentAsync(Boolean) WriteStartDocumentAsync(Boolean)

Асинхронно записывает объявление XML с номером версии "1.0". и отдельным атрибутом.Asynchronously writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartElement(String) WriteStartElement(String) WriteStartElement(String) WriteStartElement(String)

Когда переопределено в производном классе, записывает открывающий тег с указанным локальным именем.When overridden in a derived class, writes out a start tag with the specified local name.

WriteStartElement(String, String) WriteStartElement(String, String) WriteStartElement(String, String) WriteStartElement(String, String)

Когда переопределено в производном классе, записывает указанный открывающий тег и связывает его с заданным пространством имен.When overridden in a derived class, writes the specified start tag and associates it with the given namespace.

WriteStartElement(String, String, String) WriteStartElement(String, String, String) WriteStartElement(String, String, String) WriteStartElement(String, String, String)

Когда переопределено в производном классе, записывает указанный открывающий тег и связывает его с заданным пространством имен и префиксом.When overridden in a derived class, writes the specified start tag and associates it with the given namespace and prefix.

WriteStartElementAsync(String, String, String) WriteStartElementAsync(String, String, String) WriteStartElementAsync(String, String, String) WriteStartElementAsync(String, String, String)

Асинхронно записывает указанный открывающий тег и связывает его с заданным пространством имен и префиксом.Asynchronously writes the specified start tag and associates it with the given namespace and prefix.

WriteString(String) WriteString(String) WriteString(String) WriteString(String)

Записывает заданное текстовое содержимое при переопределении в производном классе.When overridden in a derived class, writes the given text content.

WriteStringAsync(String) WriteStringAsync(String) WriteStringAsync(String) WriteStringAsync(String)

Асинхронно записывает заданное текстовое содержимое.Asynchronously writes the given text content.

WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char)

Когда переопределено в производном классе, создает и записывает сущность символа-заместителя для пары символов-заместителей.When overridden in a derived class, generates and writes the surrogate character entity for the surrogate character pair.

WriteSurrogateCharEntityAsync(Char, Char) WriteSurrogateCharEntityAsync(Char, Char) WriteSurrogateCharEntityAsync(Char, Char) WriteSurrogateCharEntityAsync(Char, Char)

Асинхронно создает и записывает сущность символа-заместителя для пары символов-заместителей.Asynchronously generates and writes the surrogate character entity for the surrogate character pair.

WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean)

Записывает значение Boolean.Writes a Boolean value.

WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime)

Записывает значение DateTime.Writes a DateTime value.

WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset)

Записывает значение DateTimeOffset.Writes a DateTimeOffset value.

WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal)

Записывает значение Decimal.Writes a Decimal value.

WriteValue(Double) WriteValue(Double) WriteValue(Double) WriteValue(Double)

Записывает значение Double.Writes a Double value.

WriteValue(Int32) WriteValue(Int32) WriteValue(Int32) WriteValue(Int32)

Записывает значение Int32.Writes a Int32 value.

WriteValue(Int64) WriteValue(Int64) WriteValue(Int64) WriteValue(Int64)

Записывает значение Int64.Writes a Int64 value.

WriteValue(Object) WriteValue(Object) WriteValue(Object) WriteValue(Object)

Записывает значение объекта.Writes the object value.

WriteValue(Single) WriteValue(Single) WriteValue(Single) WriteValue(Single)

Записывает число с плавающей запятой одиночной точности.Writes a single-precision floating-point number.

WriteValue(String) WriteValue(String) WriteValue(String) WriteValue(String)

Записывает значение String.Writes a String value.

WriteWhitespace(String) WriteWhitespace(String) WriteWhitespace(String) WriteWhitespace(String)

Когда переопределено в производном классе, записывает указанный символ-разделитель.When overridden in a derived class, writes out the given white space.

WriteWhitespaceAsync(String) WriteWhitespaceAsync(String) WriteWhitespaceAsync(String) WriteWhitespaceAsync(String)

Асинхронно записывает указанный символ-разделитель.Asynchronously writes out the given white space.

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

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

Описание этого члена см. в разделе Dispose().For a description of this member, see Dispose().

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

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