XDocument.LoadAsync Metoda

Definice

Obor názvů:

System.Xml.Linq

Sestavení:

System.Xml.XDocument.dll

Přetížení

LoadAsync(TextReader, LoadOptions, CancellationToken)	Vytvoří nový XDocument a inicializuje jeho 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 XmlReaderobjektu .
LoadAsync(Stream, LoadOptions, CancellationToken)	Asynchronně vytvoří nový XDocument a inicializuje jeho 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 jeho 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

Čtečka, která obsahuje nezpracované 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 TextReaderobjektu .

Výjimky

OperationCanceledException

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

Poznámky

Pokud LoadOptions.PreserveWhitespace je nastavená, vlastnost je nastavená XmlReaderSettings.IgnoreWhitespace 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)

Zdroj:

XDocument.cs

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

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

Čtečka 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 XmlReaderobjektu .

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).

LoadAsync(Stream, LoadOptions, CancellationToken)

Zdroj:

XDocument.cs

Asynchronně vytvoří nový XDocument a inicializuje jeho 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 Streamobjektu .

Výjimky

OperationCanceledException

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

Poznámky

Pokud LoadOptions.PreserveWhitespace je nastavená, podkladová XmlReaderSettings.IgnoreWhitespace vlastnost je nastavená na falsehodnotu .

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).