XmlWriter.WriteRawAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронно записывает необработанную разметку вручную.
Перегрузки
| Имя | Описание |
|---|---|
| WriteRawAsync(String) |
Асинхронно записывает необработанную разметку вручную из строки. |
| WriteRawAsync(Char[], Int32, Int32) |
Асинхронно записывает необработанную разметку вручную из буфера символов. |
Комментарии
Это асинхронная версия WriteRawс той же функциональностью. Чтобы использовать этот метод, необходимо задать для флага Asynctrueзначение .
WriteRawAsync(String)
- Исходный код:
- XmlWriterAsync.cs
- Исходный код:
- XmlWriterAsync.cs
- Исходный код:
- XmlWriterAsync.cs
- Исходный код:
- XmlWriterAsync.cs
- Исходный код:
- XmlWriterAsync.cs
Асинхронно записывает необработанную разметку вручную из строки.
public:
virtual System::Threading::Tasks::Task ^ WriteRawAsync(System::String ^ data);
public virtual System.Threading.Tasks.Task WriteRawAsync(string data);
abstract member WriteRawAsync : string -> System.Threading.Tasks.Task
override this.WriteRawAsync : string -> System.Threading.Tasks.Task
Public Overridable Function WriteRawAsync (data As String) As Task
Параметры
- data
- String
Строка, содержащая текст для записи.
Возвращаемое значение
Задача, представляющая асинхронную WriteRaw операцию.
Исключения
Метод XmlWriter был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".
–или–
Асинхронный XmlWriter метод был вызван без задания флага Asynctrue. В этом случае InvalidOperationException создается сообщение "Set XmlWriterSettings.Async to true, если вы хотите использовать Асинхронные методы".
Комментарии
Это асинхронная версия WriteRawс той же функциональностью. Чтобы использовать этот метод, необходимо задать для флага Asynctrueзначение .
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых WriteRaw(String).
См. также раздел
- Асинхронное программирование (C#)
- Асинхронное программирование с помощью Async и Await (Visual Basic)
Применяется к
WriteRawAsync(Char[], Int32, Int32)
- Исходный код:
- XmlWriterAsync.cs
- Исходный код:
- XmlWriterAsync.cs
- Исходный код:
- XmlWriterAsync.cs
- Исходный код:
- XmlWriterAsync.cs
- Исходный код:
- XmlWriterAsync.cs
Асинхронно записывает необработанную разметку вручную из буфера символов.
public:
virtual System::Threading::Tasks::Task ^ WriteRawAsync(cli::array <char> ^ buffer, int index, int count);
public virtual System.Threading.Tasks.Task WriteRawAsync(char[] buffer, int index, int count);
abstract member WriteRawAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteRawAsync : char[] * int * int -> System.Threading.Tasks.Task
Public Overridable Function WriteRawAsync (buffer As Char(), index As Integer, count As Integer) As Task
Параметры
- buffer
- Char[]
Массив символов, содержащий текст для записи.
- index
- Int32
Позиция в буфере, указывающая начало текста для записи.
- count
- Int32
Число записываемых символов.
Возвращаемое значение
Задача, представляющая асинхронную WriteRaw операцию.
Исключения
Метод XmlWriter был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".
–или–
Асинхронный XmlWriter метод был вызван без задания флага Asynctrue. В этом случае InvalidOperationException создается сообщение "Set XmlWriterSettings.Async to true, если вы хотите использовать Асинхронные методы".
Комментарии
Это асинхронная версия WriteRawс той же функциональностью. Чтобы использовать этот метод, необходимо задать для флага Asynctrueзначение .
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых WriteRaw(Char[], Int32, Int32).
См. также раздел
- Асинхронное программирование (C#)
- Асинхронное программирование с помощью Async и Await (Visual Basic)