XDocument.LoadAsync Metoda

Definice

Obor názvů:

System.Xml.Linq

Sestavení:

netstandard.dll, System.Xml.XDocument.dll

Přetížení

Name	Description
LoadAsync(TextReader, LoadOptions, CancellationToken)	Vytvoří nový XDocument a inicializuje základní strom XML pomocí zadaného TextReader parametru, volitelně zachová prázdné znaky.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Vytvoří nový XDocument obsahující obsah zadaného XmlReader.
LoadAsync(Stream, LoadOptions, CancellationToken)	Asynchronně vytvoří nový XDocument a inicializuje základní strom XML ze zadaného datového proudu, volitelně zachová prázdné znaky.

LoadAsync(TextReader, LoadOptions, CancellationToken)

Zdroj:

XDocument.cs

Vytvoří nový XDocument a inicializuje základní strom XML pomocí zadaného TextReader parametru, volitelně zachová prázdné znaky.

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

public static System.Threading.Tasks.Task<System.Xml.Linq.XDocument> 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.XDocument>

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

Parametry

textReader

TextReader

Čtenář, který obsahuje nezpracovaný KÓD XML pro čtení do nově vytvořeného XDocumentsouboru .

options

LoadOptions

Sada možností načtení.

cancellationToken

CancellationToken

Token zrušení.

Návraty

Task<XDocument>

Nový XDocument obsahující obsah zadaného TextReader.

Výjimky

OperationCanceledException

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

Poznámky

Pokud LoadOptions.PreserveWhitespace je nastavena, XmlReaderSettings.IgnoreWhitespace vlastnost je nastavena na false.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané Load(TextReader, LoadOptions).

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Zdroj:

XDocument.cs

Vytvoří nový XDocument obsahující obsah zadaného XmlReader.

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

public static System.Threading.Tasks.Task<System.Xml.Linq.XDocument> 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.XDocument>

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

Parametry

reader

XmlReader

Čtenář obsahující kód XML, který se má načíst do nového XDocumentsouboru .

options

LoadOptions

Sada možností načtení.

cancellationToken

CancellationToken

Token zrušení.

Návraty

Task<XDocument>

Nový XDocument obsahující obsah zadaného XmlReader.

Výjimky

OperationCanceledException

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

Poznámky

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané Load(XmlReader, LoadOptions).

LoadAsync(Stream, LoadOptions, CancellationToken)

Zdroj:

XDocument.cs

Asynchronně vytvoří nový XDocument a inicializuje základní strom XML ze zadaného datového proudu, volitelně zachová prázdné znaky.

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

public static System.Threading.Tasks.Task<System.Xml.Linq.XDocument> 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.XDocument>

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

Parametry

stream

Stream

Datový proud obsahující nezpracovaný XML, který se má načíst do nově vytvořeného XDocumentsouboru .

options

LoadOptions

Sada možností načtení.

cancellationToken

CancellationToken

Token zrušení.

Návraty

Task<XDocument>

Nový XDocument obsahující obsah zadaného Stream.

Výjimky

OperationCanceledException

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

Poznámky

Pokud LoadOptions.PreserveWhitespace je nastavena, podkladová XmlReaderSettings.IgnoreWhitespace vlastnost je nastavena na false.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané Load(Stream, LoadOptions).