XElement.LoadAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| LoadAsync(Stream, LoadOptions, CancellationToken) |
De forma assíncrona, cria uma nova XElement árvore XML e inicializa a sua árvore XML subjacente usando o fluxo especificado, preservando opcionalmente o espaço em branco. |
| LoadAsync(TextReader, LoadOptions, CancellationToken) |
De forma assíncrona, cria uma nova XElement árvore XML e inicializa a sua árvore XML subjacente usando o leitor de texto especificado, preservando opcionalmente o espaço em branco. |
| LoadAsync(XmlReader, LoadOptions, CancellationToken) |
Cria assíncronamente uma nova XElement árvore XML e inicializa a sua árvore XML subjacente usando o leitor XML especificado, preservando opcionalmente o espaço em branco. |
LoadAsync(Stream, LoadOptions, CancellationToken)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
De forma assíncrona, cria uma nova XElement árvore XML e inicializa a sua árvore XML subjacente usando o fluxo especificado, preservando opcionalmente o espaço em branco.
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
O fluxo que contém o XML bruto para ler.
- options
- LoadOptions
Uma combinação bit a bit dos valores de enumeração que especificam as opções de carregamento para analisar o XML.
- cancellationToken
- CancellationToken
Um token que pode ser usado para solicitar o cancelamento da operação assíncrona.
Devoluções
Um novo XElement contendo o conteúdo do fluxo especificado.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Se options for definido como PreserveWhitespace, então a IgnoreWhitespace propriedade é definida como false.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Load(Stream, LoadOptions).
Aplica-se a
LoadAsync(TextReader, LoadOptions, CancellationToken)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
De forma assíncrona, cria uma nova XElement árvore XML e inicializa a sua árvore XML subjacente usando o leitor de texto especificado, preservando opcionalmente o espaço em branco.
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
Um leitor contendo o XML bruto para ler.
- options
- LoadOptions
Uma combinação bit a bit dos valores de enumeração que especificam as opções de carregamento para analisar o XML.
- cancellationToken
- CancellationToken
Um token que pode ser usado para solicitar o cancelamento da operação assíncrona.
Devoluções
Um novo XElement contendo o conteúdo do leitor especificado.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Se options for definido como PreserveWhitespace, então a IgnoreWhitespace propriedade é definida como false.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Load(TextReader, LoadOptions).
Aplica-se a
LoadAsync(XmlReader, LoadOptions, CancellationToken)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Cria assíncronamente uma nova XElement árvore XML e inicializa a sua árvore XML subjacente usando o leitor XML especificado, preservando opcionalmente o espaço em branco.
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
Um leitor contendo o XML a ser lido.
- options
- LoadOptions
Uma combinação bit a bit dos valores de enumeração que especificam as opções de carregamento para analisar o XML.
- cancellationToken
- CancellationToken
Um token que pode ser usado para solicitar o cancelamento da operação assíncrona.
Devoluções
Um novo XElement contendo o conteúdo do leitor especificado.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Load(XmlReader, LoadOptions).
