XDocument.LoadAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| LoadAsync(TextReader, LoadOptions, CancellationToken) |
Cria uma nova XDocument e inicializa sua árvore XML subjacente usando o parâmetro especificado TextReader , preservando opcionalmente o espaço em branco. |
| LoadAsync(XmlReader, LoadOptions, CancellationToken) |
Cria um novo XDocument contendo o conteúdo do especificado XmlReader. |
| LoadAsync(Stream, LoadOptions, CancellationToken) |
Cria de forma assíncrona uma nova XDocument e inicializa sua árvore XML subjacente do fluxo especificado, preservando opcionalmente o espaço em branco. |
LoadAsync(TextReader, LoadOptions, CancellationToken)
Cria uma nova XDocument e inicializa sua árvore XML subjacente usando o parâmetro especificado TextReader , preservando opcionalmente o espaço em branco.
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
Um leitor que contém o XML bruto a ser lido no recém-criado XDocument.
- options
- LoadOptions
Um conjunto de opções de carga.
- cancellationToken
- CancellationToken
Um token de cancelamento.
Retornos
Um novo XDocument que contém o conteúdo do especificado TextReader.
Exceções
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Se LoadOptions.PreserveWhitespace estiver definido, a XmlReaderSettings.IgnoreWhitespace propriedade será definida como false.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Load(TextReader, LoadOptions).
Aplica-se a
LoadAsync(XmlReader, LoadOptions, 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);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
Um conjunto de opções de carga.
- cancellationToken
- CancellationToken
Um token de cancelamento.
Retornos
Um novo XDocument que contém o conteúdo do especificado XmlReader.
Exceções
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Load(XmlReader, LoadOptions).
Aplica-se a
LoadAsync(Stream, LoadOptions, CancellationToken)
Cria de forma assíncrona uma nova XDocument e inicializa sua árvore XML subjacente do fluxo especificado, preservando opcionalmente o espaço em branco.
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
- options
- LoadOptions
Um conjunto de opções de carga.
- cancellationToken
- CancellationToken
Um token de cancelamento.
Retornos
Um novo XDocument que contém o conteúdo do especificado Stream.
Exceções
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Se LoadOptions.PreserveWhitespace estiver definido, a propriedade subjacente XmlReaderSettings.IgnoreWhitespace será definida como false.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Load(Stream, LoadOptions).