XElement.LoadAsync Methode

Definition

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

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

Ein neues XElement mit dem Inhalt des angegebenen Datenstroms.

Ausnahmen

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.

Gilt für:

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.

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

Ein neues XElement mit dem Inhalt des angegebenen Lesers.

Ausnahmen

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.

Gilt für:

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.

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

Ein neues XElement mit dem Inhalt des angegebenen Lesers.

Ausnahmen

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.

Gilt für: