XDocument.LoadAsync Méthode

Définition

Espace de noms:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Surcharges

LoadAsync(TextReader, LoadOptions, CancellationToken)	Crée un nouveau XDocument et initialise son arborescence XML sous-jacente à l'aide du paramètre TextReader spécifié, en conservant éventuellement l’espace blanc.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Crée un nouveau XDocument contenant le contenu du XmlReader spécifié.
LoadAsync(Stream, LoadOptions, CancellationToken)	Crée de façon asynchrone un nouveau XDocument et initialise son arborescence XML sous-jacente à partir du flux spécifié, en conservant éventuellement l’espace blanc.

LoadAsync(TextReader, LoadOptions, CancellationToken)

Source:

XDocument.cs

Crée un nouveau XDocument et initialise son arborescence XML sous-jacente à l'aide du paramètre TextReader spécifié, en conservant éventuellement l’espace blanc.

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)

Paramètres

textReader

TextReader

Un lecteur qui contient le code XML brut à lire dans le XDocument nouvellement créé.

options

LoadOptions

Un ensemble d’options de chargement.

cancellationToken

CancellationToken

Jeton d'annulation.

Retours

Task<XDocument>

Nouveau XDocument contenant le contenu du TextReader spécifié.

Exceptions

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Si LoadOptions.PreserveWhitespace est défini, la XmlReaderSettings.IgnoreWhitespace propriété a la valeur false.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Load(TextReader, LoadOptions).

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Source:

XDocument.cs

Crée un nouveau XDocument contenant le contenu du XmlReader spécifié.

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)

Paramètres

reader

XmlReader

Lecteur contenant le XML à lire dans le nouveau XDocument.

options

LoadOptions

Un ensemble d’options de chargement.

cancellationToken

CancellationToken

Jeton d'annulation.

Retours

Task<XDocument>

Nouveau XDocument contenant le contenu du XmlReader spécifié.

Exceptions

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Load(XmlReader, LoadOptions).

LoadAsync(Stream, LoadOptions, CancellationToken)

Source:

XDocument.cs

Crée de façon asynchrone un nouveau XDocument et initialise son arborescence XML sous-jacente à partir du flux spécifié, en conservant éventuellement l’espace blanc.

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)

Paramètres

stream

Stream

Flux contenant le XML brut à lire dans le XDocument nouvellement créé.

options

LoadOptions

Un ensemble d’options de chargement.

cancellationToken

CancellationToken

Jeton d'annulation.

Retours

Task<XDocument>

Nouveau XDocument contenant le contenu du Stream spécifié.

Exceptions

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Si LoadOptions.PreserveWhitespace est défini, la propriété sous-jacente XmlReaderSettings.IgnoreWhitespace a la valeur false.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Load(Stream, LoadOptions).