XDocument.LoadAsync Metoda

Definicja

Przestrzeń nazw:

System.Xml.Linq

Zestaw:

System.Xml.XDocument.dll

Przeciążenia

LoadAsync(TextReader, LoadOptions, CancellationToken)	Tworzy nowe XDocument i inicjuje bazowe drzewo XML przy użyciu określonego TextReader parametru, opcjonalnie zachowując biały odstęp.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Tworzy nowy XDocument element zawierający zawartość określonego XmlReaderelementu .
LoadAsync(Stream, LoadOptions, CancellationToken)	Asynchronicznie tworzy nowe XDocument i inicjuje bazowe drzewo XML z określonego strumienia, opcjonalnie zachowując biały odstęp.

LoadAsync(TextReader, LoadOptions, CancellationToken)

Źródło:

XDocument.cs

Tworzy nowe XDocument i inicjuje bazowe drzewo XML przy użyciu określonego TextReader parametru, opcjonalnie zachowując biały odstęp.

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

Czytelnik zawierający nieprzetworzone dane XML do odczytu do nowo utworzonego XDocumentelementu .

options

LoadOptions

Zestaw opcji ładowania.

cancellationToken

CancellationToken

Token anulowania.

Zwraca

Task<XDocument>

Nowy dokument XDocument zawierający zawartość określonego TextReaderelementu .

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Jeśli LoadOptions.PreserveWhitespace jest ustawiona, właściwość jest ustawiona XmlReaderSettings.IgnoreWhitespace na false.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. 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 Load(TextReader, LoadOptions)usługę .

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Źródło:

XDocument.cs

Tworzy nowy XDocument element zawierający zawartość określonego XmlReaderelementu .

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

Czytnik zawierający kod XML, który ma zostać odczytany do nowego XDocumentelementu .

options

LoadOptions

Zestaw opcji ładowania.

cancellationToken

CancellationToken

Token anulowania.

Zwraca

Task<XDocument>

Nowy dokument XDocument zawierający zawartość określonego XmlReaderelementu .

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. 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 Load(XmlReader, LoadOptions)usługę .

LoadAsync(Stream, LoadOptions, CancellationToken)

Źródło:

XDocument.cs

Asynchronicznie tworzy nowe XDocument i inicjuje bazowe drzewo XML z określonego strumienia, opcjonalnie zachowując biały odstęp.

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

Strumień zawierający nieprzetworzone dane XML do odczytu do nowo utworzonego XDocumentpliku .

options

LoadOptions

Zestaw opcji ładowania.

cancellationToken

CancellationToken

Token anulowania.

Zwraca

Task<XDocument>

Nowy dokument XDocument zawierający zawartość określonego Streamelementu .

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Jeśli LoadOptions.PreserveWhitespace jest ustawiona, właściwość bazowa XmlReaderSettings.IgnoreWhitespace jest ustawiona na false.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. 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 Load(Stream, LoadOptions)usługę .