XElement.LoadAsync Metoda

Definicja

Przestrzeń nazw:

System.Xml.Linq

Zestaw:

System.Xml.XDocument.dll

Przeciążenia

LoadAsync(Stream, LoadOptions, CancellationToken)	Asynchronicznie tworzy nowe XElement i inicjuje bazowe drzewo XML przy użyciu określonego strumienia, opcjonalnie zachowując biały odstęp.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Asynchronicznie tworzy nowe XElement i inicjuje bazowe drzewo XML przy użyciu określonego czytnika tekstu, opcjonalnie zachowując biały odstęp.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Asynchronicznie tworzy nowe XElement i inicjuje bazowe drzewo XML przy użyciu określonego czytnika XML, opcjonalnie zachowując biały odstęp.

LoadAsync(Stream, LoadOptions, CancellationToken)

Źródło:

XElement.cs

Asynchronicznie tworzy nowe XElement i inicjuje bazowe drzewo XML przy użyciu określonego strumienia, opcjonalnie zachowując biały odstęp.

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

Strumień zawierający nieprzetworzone dane XML do odczytania.

options

LoadOptions

Bitowa kombinacja wartości wyliczenia, które określają opcje ładowania, aby przeanalizować kod XML.

cancellationToken

CancellationToken

Token, który może służyć do żądania anulowania operacji asynchronicznej.

Zwraca

Task<XElement>

Nowa XElement zawartość określonego strumienia.

Wyjątki

OperationCanceledException

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

Uwagi

Jeśli options ustawiono PreserveWhitespacewartość , właściwość jest ustawiona 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(Stream, LoadOptions)usługę .

LoadAsync(TextReader, LoadOptions, CancellationToken)

Źródło:

XElement.cs

Asynchronicznie tworzy nowe XElement i inicjuje bazowe drzewo XML przy użyciu określonego czytnika tekstu, opcjonalnie zachowując biały odstęp.

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

Czytnik zawierający nieprzetworzone dane XML do odczytania.

options

LoadOptions

Bitowa kombinacja wartości wyliczenia, które określają opcje ładowania, aby przeanalizować kod XML.

cancellationToken

CancellationToken

Token, który może służyć do żądania anulowania operacji asynchronicznej.

Zwraca

Task<XElement>

Nowy XElement zawierający zawartość określonego czytnika.

Wyjątki

OperationCanceledException

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

Uwagi

Jeśli options ustawiono PreserveWhitespacewartość , właściwość jest ustawiona 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:

XElement.cs

Asynchronicznie tworzy nowe XElement i inicjuje bazowe drzewo XML przy użyciu określonego czytnika XML, opcjonalnie zachowując biały odstęp.

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

Czytnik zawierający kod XML do odczytania.

options

LoadOptions

Bitowa kombinacja wartości wyliczenia, które określają opcje ładowania, aby przeanalizować kod XML.

cancellationToken

CancellationToken

Token, który może służyć do żądania anulowania operacji asynchronicznej.

Zwraca

Task<XElement>

Nowy XElement zawierający zawartość określonego czytnika.

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