XElement.LoadAsync Método

Definición

Espacio de nombres:

System.Xml.Linq

Ensamblado:

System.Xml.XDocument.dll

Sobrecargas

LoadAsync(Stream, LoadOptions, CancellationToken)	Crea de forma asincrónica un nuevo objeto XElement e inicializa su árbol XML subyacente mediante el flujo especificado y, de manera opcional, conserva el espacio en blanco.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Crea de forma asincrónica un nuevo objeto XElement e inicializa su árbol XML subyacente mediante el lector de texto especificado y, de manera opcional, conserva el espacio en blanco.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Crea de forma asincrónica un nuevo objeto XElement e inicializa su árbol XML subyacente mediante el lector XML especificado y, de manera opcional, conserva el espacio en blanco.

LoadAsync(Stream, LoadOptions, CancellationToken)

Source:

XElement.cs

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

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)

Parámetros

stream

Stream

Flujo que contiene el XML sin formato que se van a leer.

options

LoadOptions

Combinación bit a bit de los valores de enumeración que especifican las opciones de carga para analizar el XML.

cancellationToken

CancellationToken

Un token que se puede utilizar para solicitar la cancelación de la operación asincrónica.

Devoluciones

Task<XElement>

Nuevo objeto XElement que incluye el contenido del flujo especificado.

Excepciones

OperationCanceledException

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

Comentarios

Si options se establece PreserveWhitespaceen , la 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(Stream, LoadOptions).

LoadAsync(TextReader, LoadOptions, CancellationToken)

Source:

XElement.cs

Crea de forma asincrónica un nuevo objeto XElement e inicializa su árbol XML subyacente mediante el lector de texto especificado y, de manera opcional, conserva el espacio en blanco.

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)

Parámetros

textReader

TextReader

Un lector que contiene el XML sin formato que se va a leer.

options

LoadOptions

Combinación bit a bit de los valores de enumeración que especifican las opciones de carga para analizar el XML.

cancellationToken

CancellationToken

Un token que se puede utilizar para solicitar la cancelación de la operación asincrónica.

Devoluciones

Task<XElement>

Nuevo objeto XElement que incluye el contenido del lector especificado.

Excepciones

OperationCanceledException

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

Comentarios

Si options se establece PreserveWhitespaceen , la 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:

XElement.cs

Crea de forma asincrónica un nuevo objeto XElement e inicializa su árbol XML subyacente mediante el lector XML especificado y, de manera opcional, conserva el espacio en blanco.

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)

Parámetros

reader

XmlReader

Lector que contiene el XML que se va a leer.

options

LoadOptions

Combinación bit a bit de los valores de enumeración que especifican las opciones de carga para analizar el XML.

cancellationToken

CancellationToken

Un token que se puede utilizar para solicitar la cancelación de la operación asincrónica.

Devoluciones

Task<XElement>

Nuevo objeto XElement que incluye el contenido del lector especificado.

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