XmlReader.ReadOuterXmlAsync 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 odczytuje zawartość, w tym znaczniki reprezentujące ten węzeł i wszystkie jego elementy podrzędne.
public:
virtual System::Threading::Tasks::Task<System::String ^> ^ ReadOuterXmlAsync();public virtual System.Threading.Tasks.Task<string> ReadOuterXmlAsync();abstract member ReadOuterXmlAsync : unit -> System.Threading.Tasks.Task<string>
override this.ReadOuterXmlAsync : unit -> System.Threading.Tasks.Task<string>Public Overridable Function ReadOuterXmlAsync () As Task(Of String)Zwraca
Jeśli czytnik jest umieszczony na elemencie lub w węźle atrybutu, ta metoda zwraca całą zawartość XML, w tym znaczniki, bieżącego węzła i wszystkich jego elementów podrzędnych; w przeciwnym razie zwraca pusty ciąg.
Wyjątki
Wywołano XmlReader metodę asynchroniczną bez ustawienia flagi Async na true. W takim przypadku zostanie zgłoszony komunikat "Ustaw wartość XmlReaderSettings.Async na wartość true, InvalidOperationException jeśli chcesz użyć metod asynchronicznych".
Uwagi
Jest to asynchroniczna wersja ReadOuterXmlprogramu , 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 ReadOuterXml().
