XmlWriter.WriteElementStringAsync(String, String, String, String) 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 element z określonym prefiksem, nazwą lokalną, identyfikatorem URI przestrzeni nazw i wartością.
public:
System::Threading::Tasks::Task ^ WriteElementStringAsync(System::String ^ prefix, System::String ^ localName, System::String ^ ns, System::String ^ value);public System.Threading.Tasks.Task WriteElementStringAsync(string prefix, string localName, string ns, string value);public System.Threading.Tasks.Task WriteElementStringAsync(string? prefix, string localName, string? ns, string value);member this.WriteElementStringAsync : string * string * string * string -> System.Threading.Tasks.TaskPublic Function WriteElementStringAsync (prefix As String, localName As String, ns As String, value As String) As TaskParametry
- prefix
- String
Prefiks elementu.
- localName
- String
Lokalna nazwa elementu.
- ns
- String
Identyfikator URI przestrzeni nazw elementu.
- value
- String
Wartość elementu.
Zwraca
Zadanie reprezentujące operację asynchroniczną WriteElementString .
Wyjątki
Metoda XmlWriter 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 XmlWriter 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 WriteElementStringprogramu , 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 WriteElementString(String, String, String, String).
