WindowsRuntimeSystemExtensions.AsTask Método

Referência

Definição

Namespace:: System

Assembly:: System.Runtime.WindowsRuntime.dll

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

AsTask(IAsyncAction)	Retorna uma tarefa que representa uma ação assíncrona do Windows Runtime.
AsTask(IAsyncAction, CancellationToken)	Retorna uma tarefa que representa uma ação assíncrona do Windows Runtime que pode ser cancelada.
AsTask<TProgress>(IAsyncActionWithProgress<TProgress>)	Retorna uma tarefa que representa uma ação assíncrona do Windows Runtime.
AsTask<TProgress>(IAsyncActionWithProgress<TProgress>, IProgress<TProgress>)	Retorna uma tarefa que representa uma ação assíncrona do Windows Runtime que relata o progresso.
AsTask<TProgress>(IAsyncActionWithProgress<TProgress>, CancellationToken)	Retorna uma tarefa que representa uma ação assíncrona do Windows Runtime que pode ser cancelada.
AsTask<TProgress>(IAsyncActionWithProgress<TProgress>, CancellationToken, IProgress<TProgress>)	Retorna uma tarefa que representa uma ação assíncrona do Windows Runtime que relata o progresso e pode ser cancelada.
AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, CancellationToken, IProgress<TProgress>)	Retorna uma tarefa que representa uma operação assíncrona do Windows Runtime que retorna um resultado, relata o andamento e pode ser cancelada.
AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, CancellationToken)	Retorna uma tarefa que representa uma operação assíncrona do Windows Runtime que retorna um resultado e pode ser cancelada.
AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>)	Retorna uma tarefa que representa uma operação assíncrona do Windows Runtime que retorna um resultado.
AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, IProgress<TProgress>)	Retorna uma tarefa que representa a operação assíncrona do Windows Runtime que retorna um resultado e relata o progresso.
AsTask<TResult>(IAsyncOperation<TResult>)	Retorna uma tarefa que representa uma operação assíncrona do Windows Runtime que retorna um resultado.
AsTask<TResult>(IAsyncOperation<TResult>, CancellationToken)	Retorna uma tarefa que representa uma operação assíncrona do Windows Runtime que retorna um resultado e pode ser cancelada.

AsTask(IAsyncAction)

Retorna uma tarefa que representa uma ação assíncrona do Windows Runtime.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task ^ AsTask(Windows::Foundation::IAsyncAction ^ source);

public static System.Threading.Tasks.Task AsTask (this Windows.Foundation.IAsyncAction source);

static member AsTask : Windows.Foundation.IAsyncAction -> System.Threading.Tasks.Task

<Extension()>
Public Function AsTask (source As IAsyncAction) As Task

Parâmetros

source: IAsyncAction

A ação assíncrona.

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Exceções

ArgumentNullException

source é null.

Comentários

Observação

Em Visual Basic e C#, você pode chamar esse método como um método de instância em qualquer objeto do tipo IAsyncAction . Quando você usar a sintaxe de método de instância para chamar esse método, omita o primeiro parâmetro. Para obter mais informações, consulte Métodos de extensão (Visual Basic) ou Métodos de Extensão (Guia de Programação em C#).

Use esse método para obter um Task objeto para uma operação Windows runtime assíncrona. Task os objetos simplificam a coordenação de operações assíncronas.

Aplica-se a

AsTask(IAsyncAction, CancellationToken)

Retorna uma tarefa que representa uma ação assíncrona do Windows Runtime que pode ser cancelada.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task ^ AsTask(Windows::Foundation::IAsyncAction ^ source, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task AsTask (this Windows.Foundation.IAsyncAction source, System.Threading.CancellationToken cancellationToken);

static member AsTask : Windows.Foundation.IAsyncAction * System.Threading.CancellationToken -> System.Threading.Tasks.Task

<Extension()>
Public Function AsTask (source As IAsyncAction, cancellationToken As CancellationToken) As Task

Parâmetros

source: IAsyncAction

A ação assíncrona.

cancellationToken: CancellationToken

Um token que pode ser usado para solicitar o cancelamento da ação assíncrona.

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Exceções

ArgumentNullException

source é null.

Comentários

Observação

Use esse método para obter um Task objeto para uma operação Windows runtime assíncrona. Task os objetos simplificam a coordenação de operações assíncronas.

Aplica-se a

AsTask<TProgress>(IAsyncActionWithProgress<TProgress>)

Retorna uma tarefa que representa uma ação assíncrona do Windows Runtime.

public:
generic <typename TProgress>
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task ^ AsTask(Windows::Foundation::IAsyncActionWithProgress<TProgress> ^ source);

public static System.Threading.Tasks.Task AsTask<TProgress> (this Windows.Foundation.IAsyncActionWithProgress<TProgress> source);

static member AsTask : Windows.Foundation.IAsyncActionWithProgress<'Progress> -> System.Threading.Tasks.Task

<Extension()>
Public Function AsTask(Of TProgress) (source As IAsyncActionWithProgress(Of TProgress)) As Task

Parâmetros de tipo

TProgress

O tipo de objeto que fornece dados que indicam o progresso.

Parâmetros

source: IAsyncActionWithProgress<TProgress>

A ação assíncrona.

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Exceções

ArgumentNullException

source é null.

Comentários

Observação

Em Visual Basic e C#, você pode chamar esse método como um método de instância em qualquer objeto do tipo IAsyncActionWithProgress<TProgress> . Quando você usar a sintaxe de método de instância para chamar esse método, omita o primeiro parâmetro. Para obter mais informações, consulte Métodos de extensão (Visual Basic) ou Métodos de Extensão (Guia de Programação em C#).

Use esse método para obter um Task objeto para uma operação Windows runtime assíncrona. Task os objetos simplificam a coordenação de operações assíncronas.

Chamar essa sobrecarga de método é equivalente a chamar a sobrecarga AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, IProgress<TProgress>) do método de extensão e especificar para o parâmetro null progress . Isso é útil quando você não deseja obter relatórios de progresso de uma ação que relata o progresso.

Aplica-se a

AsTask<TProgress>(IAsyncActionWithProgress<TProgress>, IProgress<TProgress>)

Retorna uma tarefa que representa uma ação assíncrona do Windows Runtime que relata o progresso.

public:
generic <typename TProgress>
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task ^ AsTask(Windows::Foundation::IAsyncActionWithProgress<TProgress> ^ source, IProgress<TProgress> ^ progress);

public static System.Threading.Tasks.Task AsTask<TProgress> (this Windows.Foundation.IAsyncActionWithProgress<TProgress> source, IProgress<TProgress> progress);

static member AsTask : Windows.Foundation.IAsyncActionWithProgress<'Progress> * IProgress<'Progress> -> System.Threading.Tasks.Task

<Extension()>
Public Function AsTask(Of TProgress) (source As IAsyncActionWithProgress(Of TProgress), progress As IProgress(Of TProgress)) As Task

Parâmetros de tipo

TProgress

O tipo de objeto que fornece dados que indicam o progresso.

Parâmetros

source: IAsyncActionWithProgress<TProgress>

A ação assíncrona.

progress: IProgress<TProgress>

Um objeto que recebe atualizações de progresso.

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Exceções

ArgumentNullException

source é null.

Comentários

Observação

Use esse método para obter um Task objeto para uma operação Windows runtime assíncrona. Task os objetos simplificam a coordenação de operações assíncronas.

Aplica-se a

AsTask<TProgress>(IAsyncActionWithProgress<TProgress>, CancellationToken)

Retorna uma tarefa que representa uma ação assíncrona do Windows Runtime que pode ser cancelada.

public:
generic <typename TProgress>
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task ^ AsTask(Windows::Foundation::IAsyncActionWithProgress<TProgress> ^ source, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task AsTask<TProgress> (this Windows.Foundation.IAsyncActionWithProgress<TProgress> source, System.Threading.CancellationToken cancellationToken);

static member AsTask : Windows.Foundation.IAsyncActionWithProgress<'Progress> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

<Extension()>
Public Function AsTask(Of TProgress) (source As IAsyncActionWithProgress(Of TProgress), cancellationToken As CancellationToken) As Task

Parâmetros de tipo

TProgress

O tipo de objeto que fornece dados que indicam o progresso.

Parâmetros

source: IAsyncActionWithProgress<TProgress>

A ação assíncrona.

cancellationToken: CancellationToken

Um token que pode ser usado para solicitar o cancelamento da ação assíncrona.

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Exceções

ArgumentNullException

source é null.

Comentários

Observação

Use esse método para obter um Task objeto para uma operação Windows runtime assíncrona. Task os objetos simplificam a coordenação de operações assíncronas.

Chamar essa sobrecarga de método é equivalente a chamar a sobrecarga AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, CancellationToken, IProgress<TProgress>) do método de extensão e especificar para o parâmetro null progress . Isso é útil quando você não deseja obter relatórios de progresso de uma ação que relata o progresso.

Aplica-se a

AsTask<TProgress>(IAsyncActionWithProgress<TProgress>, CancellationToken, IProgress<TProgress>)

Retorna uma tarefa que representa uma ação assíncrona do Windows Runtime que relata o progresso e pode ser cancelada.

public:
generic <typename TProgress>
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task ^ AsTask(Windows::Foundation::IAsyncActionWithProgress<TProgress> ^ source, System::Threading::CancellationToken cancellationToken, IProgress<TProgress> ^ progress);

public static System.Threading.Tasks.Task AsTask<TProgress> (this Windows.Foundation.IAsyncActionWithProgress<TProgress> source, System.Threading.CancellationToken cancellationToken, IProgress<TProgress> progress);

static member AsTask : Windows.Foundation.IAsyncActionWithProgress<'Progress> * System.Threading.CancellationToken * IProgress<'Progress> -> System.Threading.Tasks.Task

<Extension()>
Public Function AsTask(Of TProgress) (source As IAsyncActionWithProgress(Of TProgress), cancellationToken As CancellationToken, progress As IProgress(Of TProgress)) As Task

Parâmetros de tipo

TProgress

O tipo de objeto que fornece dados que indicam o progresso.

Parâmetros

source: IAsyncActionWithProgress<TProgress>

A ação assíncrona.

cancellationToken: CancellationToken

Um token que pode ser usado para solicitar o cancelamento da ação assíncrona.

progress: IProgress<TProgress>

Um objeto que recebe atualizações de progresso.

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Exceções

ArgumentNullException

source é null.

Comentários

Observação

Use esse método para obter um Task objeto para uma operação Windows runtime assíncrona. Task os objetos simplificam a coordenação de operações assíncronas.

Aplica-se a

AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, CancellationToken, IProgress<TProgress>)

Retorna uma tarefa que representa uma operação assíncrona do Windows Runtime que retorna um resultado, relata o andamento e pode ser cancelada.

public:
generic <typename TResult, typename TProgress>
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task<TResult> ^ AsTask(Windows::Foundation::IAsyncOperationWithProgress<TResult, TProgress> ^ source, System::Threading::CancellationToken cancellationToken, IProgress<TProgress> ^ progress);

public static System.Threading.Tasks.Task<TResult> AsTask<TResult,TProgress> (this Windows.Foundation.IAsyncOperationWithProgress<TResult,TProgress> source, System.Threading.CancellationToken cancellationToken, IProgress<TProgress> progress);

static member AsTask : Windows.Foundation.IAsyncOperationWithProgress<'Result, 'Progress> * System.Threading.CancellationToken * IProgress<'Progress> -> System.Threading.Tasks.Task<'Result>

<Extension()>
Public Function AsTask(Of TResult, TProgress) (source As IAsyncOperationWithProgress(Of TResult, TProgress), cancellationToken As CancellationToken, progress As IProgress(Of TProgress)) As Task(Of TResult)

Parâmetros de tipo

TResult

O tipo de objeto que retorna o resultado da operação assíncrona.

TProgress

O tipo de objeto que fornece dados que indicam o progresso.

Parâmetros

source: IAsyncOperationWithProgress<TResult,TProgress>

A operação assíncrona.

cancellationToken: CancellationToken

Um token que pode ser usado para solicitar o cancelamento da operação assíncrona.

progress: IProgress<TProgress>

Um objeto que recebe atualizações de progresso.

Retornos

Task<TResult>

Uma tarefa que representa a operação assíncrona.

Comentários

Observação

em Visual Basic e C#, você pode chamar esse método como um método de instância em qualquer objeto do tipo IAsyncOperationWithProgress<TResult,TProgress> . Quando você usar a sintaxe de método de instância para chamar esse método, omita o primeiro parâmetro. para obter mais informações, consulte métodos de extensão (Visual Basic) ou métodos de extensão (guia de programação C#).

Use este método para obter um Task<TResult> objeto para uma Windows Runtime operação assíncrona. Task<TResult> os objetos simplificam a coordenação de operações assíncronas.

Aplica-se a

AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, CancellationToken)

Retorna uma tarefa que representa uma operação assíncrona do Windows Runtime que retorna um resultado e pode ser cancelada.

public:
generic <typename TResult, typename TProgress>
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task<TResult> ^ AsTask(Windows::Foundation::IAsyncOperationWithProgress<TResult, TProgress> ^ source, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task<TResult> AsTask<TResult,TProgress> (this Windows.Foundation.IAsyncOperationWithProgress<TResult,TProgress> source, System.Threading.CancellationToken cancellationToken);

static member AsTask : Windows.Foundation.IAsyncOperationWithProgress<'Result, 'Progress> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

<Extension()>
Public Function AsTask(Of TResult, TProgress) (source As IAsyncOperationWithProgress(Of TResult, TProgress), cancellationToken As CancellationToken) As Task(Of TResult)

Parâmetros de tipo

TResult

O tipo de objeto que retorna o resultado da operação assíncrona.

TProgress

O tipo de objeto que fornece dados que indicam o progresso.

Parâmetros

source: IAsyncOperationWithProgress<TResult,TProgress>

A operação assíncrona.

cancellationToken: CancellationToken

Um token que pode ser usado para solicitar o cancelamento da operação assíncrona.

Retornos

Task<TResult>

Uma tarefa que representa a operação assíncrona.

Exceções

ArgumentNullException

source é null.

Comentários

Observação

Use este método para obter um Task<TResult> objeto para uma Windows Runtime operação assíncrona. Task<TResult> os objetos simplificam a coordenação de operações assíncronas.

Chamar essa sobrecarga de método é equivalente a chamar a AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, CancellationToken, IProgress<TProgress>) sobrecarga do método de extensão e especificar null para o progress parâmetro. Isso é útil quando você não deseja obter relatórios de andamento de uma ação que relata o progresso.

Aplica-se a

AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>)

Retorna uma tarefa que representa uma operação assíncrona do Windows Runtime que retorna um resultado.

public:
generic <typename TResult, typename TProgress>
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task<TResult> ^ AsTask(Windows::Foundation::IAsyncOperationWithProgress<TResult, TProgress> ^ source);

public static System.Threading.Tasks.Task<TResult> AsTask<TResult,TProgress> (this Windows.Foundation.IAsyncOperationWithProgress<TResult,TProgress> source);

static member AsTask : Windows.Foundation.IAsyncOperationWithProgress<'Result, 'Progress> -> System.Threading.Tasks.Task<'Result>

<Extension()>
Public Function AsTask(Of TResult, TProgress) (source As IAsyncOperationWithProgress(Of TResult, TProgress)) As Task(Of TResult)

Parâmetros de tipo

TResult

O tipo de objeto que retorna o resultado da operação assíncrona.

TProgress

O tipo de objeto que fornece dados que indicam o progresso.

Parâmetros

source: IAsyncOperationWithProgress<TResult,TProgress>

A operação assíncrona.

Retornos

Task<TResult>

Uma tarefa que representa a operação assíncrona.

Exceções

ArgumentNullException

source é null.

Comentários

Observação

Use este método para obter um Task<TResult> objeto para uma Windows Runtime operação assíncrona. Task<TResult> os objetos simplificam a coordenação de operações assíncronas.

Chamar essa sobrecarga de método é equivalente a chamar a AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, IProgress<TProgress>) sobrecarga do método de extensão e especificar null para o progress parâmetro. Isso é útil quando você não deseja obter relatórios de andamento de uma ação que relata o progresso.

Aplica-se a

AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, IProgress<TProgress>)

Retorna uma tarefa que representa a operação assíncrona do Windows Runtime que retorna um resultado e relata o progresso.

public:
generic <typename TResult, typename TProgress>
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task<TResult> ^ AsTask(Windows::Foundation::IAsyncOperationWithProgress<TResult, TProgress> ^ source, IProgress<TProgress> ^ progress);

public static System.Threading.Tasks.Task<TResult> AsTask<TResult,TProgress> (this Windows.Foundation.IAsyncOperationWithProgress<TResult,TProgress> source, IProgress<TProgress> progress);

static member AsTask : Windows.Foundation.IAsyncOperationWithProgress<'Result, 'Progress> * IProgress<'Progress> -> System.Threading.Tasks.Task<'Result>

<Extension()>
Public Function AsTask(Of TResult, TProgress) (source As IAsyncOperationWithProgress(Of TResult, TProgress), progress As IProgress(Of TProgress)) As Task(Of TResult)

Parâmetros de tipo

TResult

O tipo de objeto que retorna o resultado da operação assíncrona.

TProgress

O tipo de objeto que fornece dados que indicam o progresso.

Parâmetros

source: IAsyncOperationWithProgress<TResult,TProgress>

A operação assíncrona.

progress: IProgress<TProgress>

Um objeto que recebe atualizações de progresso.

Retornos

Task<TResult>

Uma tarefa que representa a operação assíncrona.

Exceções

ArgumentNullException

source é null.

Comentários

Observação

Use este método para obter um Task<TResult> objeto para uma Windows Runtime operação assíncrona. Task<TResult> os objetos simplificam a coordenação de operações assíncronas.

Aplica-se a

AsTask<TResult>(IAsyncOperation<TResult>)

Retorna uma tarefa que representa uma operação assíncrona do Windows Runtime que retorna um resultado.

public:
generic <typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task<TResult> ^ AsTask(Windows::Foundation::IAsyncOperation<TResult> ^ source);

public static System.Threading.Tasks.Task<TResult> AsTask<TResult> (this Windows.Foundation.IAsyncOperation<TResult> source);

static member AsTask : Windows.Foundation.IAsyncOperation<'Result> -> System.Threading.Tasks.Task<'Result>

<Extension()>
Public Function AsTask(Of TResult) (source As IAsyncOperation(Of TResult)) As Task(Of TResult)

Parâmetros de tipo

TResult

O tipo de objeto que retorna o resultado da operação assíncrona.

Parâmetros

source: IAsyncOperation<TResult>

A operação assíncrona.

Retornos

Task<TResult>

Uma tarefa que representa a operação assíncrona.

Exceções

ArgumentNullException

source é null.

Comentários

Observação

Use este método para obter um Task<TResult> objeto para uma Windows Runtime operação assíncrona. Task<TResult> os objetos simplificam a coordenação de operações assíncronas.

Aplica-se a

AsTask<TResult>(IAsyncOperation<TResult>, CancellationToken)

Retorna uma tarefa que representa uma operação assíncrona do Windows Runtime que retorna um resultado e pode ser cancelada.

public:
generic <typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task<TResult> ^ AsTask(Windows::Foundation::IAsyncOperation<TResult> ^ source, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task<TResult> AsTask<TResult> (this Windows.Foundation.IAsyncOperation<TResult> source, System.Threading.CancellationToken cancellationToken);

static member AsTask : Windows.Foundation.IAsyncOperation<'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

<Extension()>
Public Function AsTask(Of TResult) (source As IAsyncOperation(Of TResult), cancellationToken As CancellationToken) As Task(Of TResult)

Parâmetros de tipo

TResult

O tipo de objeto que retorna o resultado da operação assíncrona.

Parâmetros

source: IAsyncOperation<TResult>

A operação assíncrona.

cancellationToken: CancellationToken

Um token que pode ser usado para solicitar o cancelamento da operação assíncrona.

Retornos

Task<TResult>

Uma tarefa que representa a operação assíncrona.

Exceções

ArgumentNullException

source é null.

Comentários

Observação

em Visual Basic e C#, você pode chamar esse método como um método de instância em qualquer objeto do tipo IAsyncActionWithProgress<TProgress> . Quando você usar a sintaxe de método de instância para chamar esse método, omita o primeiro parâmetro. para obter mais informações, consulte métodos de extensão (Visual Basic) ou métodos de extensão (guia de programação C#).

Use este método para obter um Task<TResult> objeto para uma Windows Runtime operação assíncrona. Task<TResult> os objetos simplificam a coordenação de operações assíncronas.

Aplica-se a