XDocument.LoadAsync Método

Definição

Namespace:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Sobrecargas

LoadAsync(TextReader, LoadOptions, CancellationToken)	Cria um novo XDocument e inicializa sua árvore XML subjacente usando o parâmetro TextReader especificado, preservando opcionalmente o espaço em branco.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Cria um novo XDocument que contém o conteúdo do XmlReader especificado.
LoadAsync(Stream, LoadOptions, CancellationToken)	Cria de forma assíncrona um novo XDocument e inicializa sua árvore XML subjacente a partir do fluxo especificado, preservando opcionalmente o espaço em branco.

LoadAsync(TextReader, LoadOptions, CancellationToken)

Origem:

XDocument.cs

Cria um novo XDocument e inicializa sua árvore XML subjacente usando o parâmetro TextReader especificado, 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 para ler no XDocument recém-criado.

options

LoadOptions

Um conjunto de opções de carregamento.

cancellationToken

CancellationToken

Um token de cancelamento.

Retornos

Task<XDocument>

Um novo XDocument que contém o conteúdo do TextReader especificado.

Exceções

OperationCanceledException

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

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Origem:

XDocument.cs

Cria um novo XDocument que contém o conteúdo do 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

Um leitor que contém o XML que será lido no novo XDocument.

options

LoadOptions

Um conjunto de opções de carregamento.

cancellationToken

CancellationToken

Um token de cancelamento.

Retornos

Task<XDocument>

Um novo XDocument que contém o conteúdo do XmlReader especificado.

Exceções

OperationCanceledException

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

LoadAsync(Stream, LoadOptions, CancellationToken)

Origem:

XDocument.cs

Cria de forma assíncrona um novo XDocument e inicializa sua árvore XML subjacente a partir 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

stream

Stream

Um fluxo que contém o XML bruto para ler no XDocument recém-criado.

options

LoadOptions

Um conjunto de opções de carregamento.

cancellationToken

CancellationToken

Um token de cancelamento.

Retornos

Task<XDocument>

Um novo XDocument que contém o conteúdo do Stream especificado.

Exceções

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Se LoadOptions.PreserveWhitespace for definido, a propriedade subjacente XmlReaderSettings.IgnoreWhitespace será definida falsecomo .

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