XmlDictionaryWriter.WriteValueAsync(IStreamProvider) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Asynchronicznie zapisuje wartość z elementu IStreamProvider.
public:
virtual System::Threading::Tasks::Task ^ WriteValueAsync(System::Xml::IStreamProvider ^ value);public virtual System.Threading.Tasks.Task WriteValueAsync(System.Xml.IStreamProvider value);abstract member WriteValueAsync : System.Xml.IStreamProvider -> System.Threading.Tasks.Task
override this.WriteValueAsync : System.Xml.IStreamProvider -> System.Threading.Tasks.TaskPublic Overridable Function WriteValueAsync (value As IStreamProvider) As TaskParametry
- value
- IStreamProvider
IStreamProvider Wartość do zapisania.
Zwraca
Zadanie reprezentujące operację asynchroniczną WriteValue .
Wyjątki
Metoda XmlDictionaryWriter została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".
— lub —
Wywołano XmlDictionaryWriter metodę asynchroniczną bez ustawienia flagi Async na true. W takim przypadku zostanie zgłoszony komunikat "Ustaw wartość XmlWriterSettings.Async na wartość true, InvalidOperationException jeśli chcesz użyć metod asynchronicznych".
Uwagi
Jest to asynchroniczna wersja WriteValueprogramu , z tą samą funkcjonalnością. Aby użyć tej metody, należy ustawić flagę Async na true.
Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program WriteValue(IStreamProvider).
