XDocument.LoadAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Source:
- XDocument.cs
- 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
Nueva clase XDocument que incluye el contenido del objeto especificado TextReader.
Excepciones
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).
Se aplica a
LoadAsync(XmlReader, LoadOptions, CancellationToken)
- Source:
- XDocument.cs
- Source:
- XDocument.cs
- Source:
- XDocument.cs
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
- options
- LoadOptions
Conjunto de opciones de carga.
- cancellationToken
- CancellationToken
Token de cancelación.
Devoluciones
Nueva clase XDocument que incluye el contenido del objeto especificado XmlReader.
Excepciones
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).
Se aplica a
LoadAsync(Stream, LoadOptions, CancellationToken)
- Source:
- XDocument.cs
- Source:
- XDocument.cs
- 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
Nueva clase XDocument que incluye el contenido del objeto especificado Stream.
Excepciones
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).
