XDocument.LoadAsync Método

Definición

Espacio de nombres:

System.Xml.Linq

Ensamblado:

System.Xml.XDocument.dll

Sobrecargas

LoadAsync(TextReader, LoadOptions, CancellationToken)	Crea un nuevo objeto XDocument e inicializa su árbol XML subyacente mediante el parámetro TextReader especificado y, de manera opcional, conserva el espacio en blanco.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Crea un nuevo objeto XDocument que incluye el contenido del objeto XmlReader especificado.
LoadAsync(Stream, LoadOptions, CancellationToken)	Crea de forma asincrónica un nuevo objeto XDocument e inicializa su árbol XML subyacente a partir del flujo especificado y, de manera opcional, conserva el espacio en blanco.

LoadAsync(TextReader, LoadOptions, CancellationToken)

Source:

XDocument.cs

Crea un nuevo objeto XDocument e inicializa su árbol XML subyacente mediante el parámetro TextReader especificado y, de manera opcional, conserva el espacio en blanco.

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)

Parámetros

textReader

TextReader

Lector que contiene el XML sin formato que se va a leer en el objeto recién creado XDocument.

options

LoadOptions

Conjunto de opciones de carga.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task<XDocument>

Nueva clase XDocument que incluye el contenido del objeto especificado TextReader.

Excepciones

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Si LoadOptions.PreserveWhitespace se establece, la XmlReaderSettings.IgnoreWhitespace propiedad se establece falseen .

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Load(TextReader, LoadOptions).

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Source:

XDocument.cs

Crea un nuevo objeto XDocument que incluye el contenido del objeto XmlReader especificado.

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)

Parámetros

reader

XmlReader

Lector que contiene el XML que se va a leer en el nuevo objeto XDocument.

options

LoadOptions

Conjunto de opciones de carga.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task<XDocument>

Nueva clase XDocument que incluye el contenido del objeto especificado XmlReader.

Excepciones

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Load(XmlReader, LoadOptions).

LoadAsync(Stream, LoadOptions, CancellationToken)

Source:

XDocument.cs

Crea de forma asincrónica un nuevo objeto XDocument e inicializa su árbol XML subyacente a partir del flujo especificado y, de manera opcional, conserva el espacio en blanco.

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)

Parámetros

stream

Stream

Flujo que contiene el XML sin formato que se va a leer en el objeto recién creado XDocument.

options

LoadOptions

Conjunto de opciones de carga.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task<XDocument>

Nueva clase XDocument que incluye el contenido del objeto especificado Stream.

Excepciones

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Si LoadOptions.PreserveWhitespace se establece, la propiedad subyacente XmlReaderSettings.IgnoreWhitespace se establece falseen .

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Load(Stream, LoadOptions).