XElement.LoadAsync Methode

Definition

Namespace:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Überlädt

LoadAsync(Stream, LoadOptions, CancellationToken)	Erstellt asynchron ein neues XElement und initialisiert die zugrunde liegende XML-Struktur unter Verwendung des angegebenen Datenstroms, wobei optional Leerraum beibehalten wird.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Erstellt asynchron ein neues XElement und initialisiert die zugrunde liegende XML-Struktur unter Verwendung des angegebenen Textlesers, wobei optional Leerraum beibehalten wird.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Erstellt asynchron ein neues XElement und initialisiert die zugrunde liegende XML-Struktur unter Verwendung des angegebenen XML-Lesers, wobei optional Leerraum beibehalten wird.

LoadAsync(Stream, LoadOptions, CancellationToken)

Quelle:

XElement.cs

Erstellt asynchron ein neues XElement und initialisiert die zugrunde liegende XML-Struktur unter Verwendung des angegebenen Datenstroms, wobei optional Leerraum beibehalten wird.

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)

Parameter

stream

Stream

Der Datenstrom mit den zu lesenden XML-Rohdaten.

options

LoadOptions

Eine bitweise Kombination der Enumerationswerte, die Lastoptionen zum Analysieren der XML-Inhalte angeben.

cancellationToken

CancellationToken

Ein Token, das verwendet werden kann, um den Abbruch des asynchronen Vorgangs anzufordern.

Gibt zurück

Task<XElement>

Ein neues XElement mit dem Inhalt des angegebenen Datenstroms.

Ausnahmen

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Wenn options auf PreserveWhitespacefestgelegt ist, wird die IgnoreWhitespace -Eigenschaft auf falsefestgelegt.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Load(Stream, LoadOptions)Ausnahmen.

LoadAsync(TextReader, LoadOptions, CancellationToken)

Quelle:

XElement.cs

Erstellt asynchron ein neues XElement und initialisiert die zugrunde liegende XML-Struktur unter Verwendung des angegebenen Textlesers, wobei optional Leerraum beibehalten wird.

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)

Parameter

textReader

TextReader

Ein Leser mit dem zu lesenden XML-Rohdaten.

options

LoadOptions

Eine bitweise Kombination der Enumerationswerte, die Lastoptionen zum Analysieren der XML-Inhalte angeben.

cancellationToken

CancellationToken

Ein Token, das verwendet werden kann, um den Abbruch des asynchronen Vorgangs anzufordern.

Gibt zurück

Task<XElement>

Ein neues XElement mit dem Inhalt des angegebenen Lesers.

Ausnahmen

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Wenn options auf PreserveWhitespacefestgelegt ist, wird die IgnoreWhitespace -Eigenschaft auf falsefestgelegt.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Load(TextReader, LoadOptions)Ausnahmen.

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Quelle:

XElement.cs

Erstellt asynchron ein neues XElement und initialisiert die zugrunde liegende XML-Struktur unter Verwendung des angegebenen XML-Lesers, wobei optional Leerraum beibehalten wird.

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)

Parameter

reader

XmlReader

Ein Leser mit dem zu lesenden XML-Inhalt.

options

LoadOptions

Eine bitweise Kombination der Enumerationswerte, die Lastoptionen zum Analysieren der XML-Inhalte angeben.

cancellationToken

CancellationToken

Ein Token, das verwendet werden kann, um den Abbruch des asynchronen Vorgangs anzufordern.

Gibt zurück

Task<XElement>

Ein neues XElement mit dem Inhalt des angegebenen Lesers.

Ausnahmen

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Load(XmlReader, LoadOptions)Ausnahmen.