XElement.LoadAsync Metoda

Definice

Obor názvů:

System.Xml.Linq

Sestavení:

System.Xml.XDocument.dll

Přetížení

LoadAsync(Stream, LoadOptions, CancellationToken)	Asynchronně vytvoří nový XElement a inicializuje jeho základní strom XML pomocí zadaného streamu, volitelně zachová prázdné znaky.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Asynchronně vytvoří nový XElement a inicializuje jeho základní strom XML pomocí zadané čtečky textu, volitelně zachová prázdné znaky.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Asynchronně vytvoří nový XElement a inicializuje jeho základní strom XML pomocí zadané čtečky XML, volitelně zachová prázdné znaky.

LoadAsync(Stream, LoadOptions, CancellationToken)

Source:

XElement.cs

Asynchronně vytvoří nový XElement a inicializuje jeho základní strom XML pomocí zadaného streamu, volitelně zachová prázdné znaky.

public:
 static System::Threading::Tasks::Task<System::Xml::Linq::XElement ^> ^ LoadAsync(System::IO::Stream ^ stream, System::Xml::Linq::LoadOptions options, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task<System.Xml.Linq.XElement> LoadAsync (System.IO.Stream stream, System.Xml.Linq.LoadOptions options, System.Threading.CancellationToken cancellationToken);

static member LoadAsync : System.IO.Stream * System.Xml.Linq.LoadOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Xml.Linq.XElement>

Public Shared Function LoadAsync (stream As Stream, options As LoadOptions, cancellationToken As CancellationToken) As Task(Of XElement)

Parametry

stream

Stream

Datový proud obsahující nezpracovaný XML, který se má číst.

options

LoadOptions

Bitové kombinace hodnot výčtu, které určují možnosti načtení pro parsování XML.

cancellationToken

CancellationToken

Token, který lze použít k vyžádání zrušení asynchronní operace.

Návraty

Task<XElement>

Nový XElement obsahující obsah zadaného datového proudu.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Pokud options je nastavená hodnota PreserveWhitespace, pak IgnoreWhitespace je vlastnost nastavená na false.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Load(Stream, LoadOptions).

LoadAsync(TextReader, LoadOptions, CancellationToken)

Source:

XElement.cs

Asynchronně vytvoří nový XElement a inicializuje jeho základní strom XML pomocí zadané čtečky textu, volitelně zachová prázdné znaky.

public:
 static System::Threading::Tasks::Task<System::Xml::Linq::XElement ^> ^ LoadAsync(System::IO::TextReader ^ textReader, System::Xml::Linq::LoadOptions options, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task<System.Xml.Linq.XElement> LoadAsync (System.IO.TextReader textReader, System.Xml.Linq.LoadOptions options, System.Threading.CancellationToken cancellationToken);

static member LoadAsync : System.IO.TextReader * System.Xml.Linq.LoadOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Xml.Linq.XElement>

Public Shared Function LoadAsync (textReader As TextReader, options As LoadOptions, cancellationToken As CancellationToken) As Task(Of XElement)

Parametry

textReader

TextReader

Čtečka obsahující nezpracovaný kód XML, který se má číst.

options

LoadOptions

Bitové kombinace hodnot výčtu, které určují možnosti načtení pro parsování XML.

cancellationToken

CancellationToken

Token, který lze použít k vyžádání zrušení asynchronní operace.

Návraty

Task<XElement>

Nový XElement obsahující obsah zadaného čtenáře.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Pokud options je nastavená hodnota PreserveWhitespace, pak IgnoreWhitespace je vlastnost nastavená na false.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Load(TextReader, LoadOptions).

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Source:

XElement.cs

Asynchronně vytvoří nový XElement a inicializuje jeho základní strom XML pomocí zadané čtečky XML, volitelně zachová prázdné znaky.

public:
 static System::Threading::Tasks::Task<System::Xml::Linq::XElement ^> ^ LoadAsync(System::Xml::XmlReader ^ reader, System::Xml::Linq::LoadOptions options, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task<System.Xml.Linq.XElement> LoadAsync (System.Xml.XmlReader reader, System.Xml.Linq.LoadOptions options, System.Threading.CancellationToken cancellationToken);

static member LoadAsync : System.Xml.XmlReader * System.Xml.Linq.LoadOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Xml.Linq.XElement>

Public Shared Function LoadAsync (reader As XmlReader, options As LoadOptions, cancellationToken As CancellationToken) As Task(Of XElement)

Parametry

reader

XmlReader

Čtečka obsahující kód XML, který se má číst.

options

LoadOptions

Bitové kombinace hodnot výčtu, které určují možnosti načtení pro parsování XML.

cancellationToken

CancellationToken

Token, který lze použít k vyžádání zrušení asynchronní operace.

Návraty

Task<XElement>

Nový XElement obsahující obsah zadaného čtenáře.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Load(XmlReader, LoadOptions).