WindowsRuntimeSystemExtensions.AsTask 方法

  • 參考

定義

命名空間:
System
組件:
System.Runtime.WindowsRuntime.dll

多載

AsTask(IAsyncAction)

傳回代表 Windows 執行階段非同步動作的工作。
AsTask(IAsyncAction, CancellationToken)

傳回工作，代表可取消的 Windows 執行階段非同步動作。
AsTask<TProgress>(IAsyncActionWithProgress<TProgress>)

傳回代表 Windows 執行階段非同步動作的工作。
AsTask<TProgress>(IAsyncActionWithProgress<TProgress>, IProgress<TProgress>)

傳回工作，代表報告進度的 Windows執行階段非同步動作。
AsTask<TProgress>(IAsyncActionWithProgress<TProgress>, CancellationToken)

傳回工作，代表可取消的 Windows 執行階段非同步動作。
AsTask<TProgress>(IAsyncActionWithProgress<TProgress>, CancellationToken, IProgress<TProgress>)

傳回工作，代表報告進度且可取消的 Windows執行階段非同步動作。
AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, CancellationToken, IProgress<TProgress>)

傳回工作，代表傳回結果、報告進度且可取消的 Windows 執行階段非同步作業。
AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, CancellationToken)

傳回工作，代表傳回結果且可取消的 Windows執行階段非同步作業。
AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>)

傳回工作，代表傳回結果的 Windows 執行階段非同步作業。
AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, IProgress<TProgress>)

傳回工作，代表傳回結果並報告進度的 Windows 執行階段非同步作業。
AsTask<TResult>(IAsyncOperation<TResult>)

傳回工作，代表傳回結果的 Windows 執行階段非同步作業。
AsTask<TResult>(IAsyncOperation<TResult>, CancellationToken)

傳回工作，代表傳回結果且可取消的 Windows執行階段非同步作業。

AsTask(IAsyncAction)

傳回代表 Windows 執行階段非同步動作的工作。

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

參數

source
IAsyncAction

非同步動作。

傳回

Task

表示非同步動作的工作。

例外狀況

ArgumentNullException

source 為 null。

備註

注意

在 Visual Basic 和 c # 中，您可以在任何類型的物件上呼叫這個方法做為實例方法 IAsyncAction 。 使用執行個體方法語法呼叫這個方法時，請省略第一個參數。 如需詳細資訊，請參閱 (Visual Basic) 或擴充方法的擴充方法 (c # 程式設計手冊) 。

使用這個方法可取得 Task Windows 執行階段非同步作業的物件。 Task 物件會簡化非同步作業的協調。

適用於

AsTask(IAsyncAction, CancellationToken)

傳回工作，代表可取消的 Windows 執行階段非同步動作。

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

參數

source
IAsyncAction

非同步動作。

cancellationToken
CancellationToken

可用來要求取消非同步動作的權杖。

傳回

Task

表示非同步動作的工作。

例外狀況

ArgumentNullException

source 為 null。

備註

注意

在 Visual Basic 和 c # 中，您可以在任何類型的物件上呼叫這個方法做為實例方法 IAsyncAction 。 使用執行個體方法語法呼叫這個方法時，請省略第一個參數。 如需詳細資訊，請參閱 (Visual Basic) 或擴充方法的擴充方法 (c # 程式設計手冊) 。

使用這個方法可取得 Task Windows 執行階段非同步作業的物件。 Task 物件會簡化非同步作業的協調。

適用於

AsTask<TProgress>(IAsyncActionWithProgress<TProgress>)

傳回代表 Windows 執行階段非同步動作的工作。

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

類型參數

TProgress

物件型別，會提供表示進度的資料。

參數

source
IAsyncActionWithProgress<TProgress>

非同步動作。

傳回

Task

表示非同步動作的工作。

例外狀況

ArgumentNullException

source 為 null。

備註

注意

在 Visual Basic 和 c # 中，您可以在任何類型的物件上呼叫這個方法做為實例方法 IAsyncActionWithProgress<TProgress> 。 使用執行個體方法語法呼叫這個方法時，請省略第一個參數。 如需詳細資訊，請參閱 (Visual Basic) 或擴充方法的擴充方法 (c # 程式設計手冊) 。

使用這個方法可取得 Task Windows 執行階段非同步作業的物件。 Task 物件會簡化非同步作業的協調。

呼叫這個方法多載相當於呼叫 AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, IProgress<TProgress>) 擴充方法多載，並 null 為 progress 參數指定。 當您不想從報告進度的動作取得進度報表時，這會很有用。

適用於

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

傳回工作，代表報告進度的 Windows執行階段非同步動作。

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

類型參數

TProgress

物件型別，會提供表示進度的資料。

參數

source
IAsyncActionWithProgress<TProgress>

非同步動作。

progress
IProgress<TProgress>

接收進度更新的物件。

傳回

Task

表示非同步動作的工作。

例外狀況

ArgumentNullException

source 為 null。

備註

注意

在 Visual Basic 和 c # 中，您可以在任何類型的物件上呼叫這個方法做為實例方法 IAsyncActionWithProgress<TProgress> 。 使用執行個體方法語法呼叫這個方法時，請省略第一個參數。 如需詳細資訊，請參閱 (Visual Basic) 或擴充方法的擴充方法 (c # 程式設計手冊) 。

使用這個方法可取得 Task Windows 執行階段非同步作業的物件。 Task 物件會簡化非同步作業的協調。

適用於

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

傳回工作，代表可取消的 Windows 執行階段非同步動作。

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

類型參數

TProgress

物件型別，會提供表示進度的資料。

參數

source
IAsyncActionWithProgress<TProgress>

非同步動作。

cancellationToken
CancellationToken

可用來要求取消非同步動作的權杖。

傳回

Task

表示非同步動作的工作。

例外狀況

ArgumentNullException

source 為 null。

備註

注意

在 Visual Basic 和 c # 中，您可以在任何類型的物件上呼叫這個方法做為實例方法 IAsyncActionWithProgress<TProgress> 。 使用執行個體方法語法呼叫這個方法時，請省略第一個參數。 如需詳細資訊，請參閱 (Visual Basic) 或擴充方法的擴充方法 (c # 程式設計手冊) 。

使用這個方法可取得 Task Windows 執行階段非同步作業的物件。 Task 物件會簡化非同步作業的協調。

呼叫這個方法多載相當於呼叫 AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, CancellationToken, IProgress<TProgress>) 擴充方法多載，並 null 為 progress 參數指定。 當您不想從報告進度的動作取得進度報表時，這會很有用。

適用於

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

傳回工作，代表報告進度且可取消的 Windows執行階段非同步動作。

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

類型參數

TProgress

物件型別，會提供表示進度的資料。

參數

source
IAsyncActionWithProgress<TProgress>

非同步動作。

cancellationToken
CancellationToken

可用來要求取消非同步動作的權杖。

progress
IProgress<TProgress>

接收進度更新的物件。

傳回

Task

表示非同步動作的工作。

例外狀況

ArgumentNullException

source 為 null。

備註

注意

在 Visual Basic 和 c # 中，您可以在任何類型的物件上呼叫這個方法做為實例方法 IAsyncActionWithProgress<TProgress> 。 使用執行個體方法語法呼叫這個方法時，請省略第一個參數。 如需詳細資訊，請參閱 (Visual Basic) 或擴充方法的擴充方法 (c # 程式設計手冊) 。

使用這個方法可取得 Task Windows 執行階段非同步作業的物件。 Task 物件會簡化非同步作業的協調。

適用於

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

傳回工作，代表傳回結果、報告進度且可取消的 Windows 執行階段非同步作業。

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)

類型參數

TResult

物件型別，會傳回非同步作業的結果。

TProgress

物件型別，會提供表示進度的資料。

參數

source
IAsyncOperationWithProgress<TResult,TProgress>

非同步作業。

cancellationToken
CancellationToken

可用來要求取消非同步作業的權杖。

progress
IProgress<TProgress>

接收進度更新的物件。

傳回

Task<TResult>

代表非同步作業的工作。

備註

注意

在 Visual Basic 和 c # 中，您可以在任何類型的物件上呼叫這個方法做為實例方法 IAsyncOperationWithProgress<TResult,TProgress> 。 使用執行個體方法語法呼叫這個方法時，請省略第一個參數。 如需詳細資訊，請參閱 (Visual Basic) 或擴充方法的擴充方法 (c # 程式設計手冊) 。

使用這個方法可取得 Task<TResult> Windows 執行階段非同步作業的物件。 Task<TResult> 物件會簡化非同步作業的協調。

適用於

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

傳回工作，代表傳回結果且可取消的 Windows執行階段非同步作業。

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)

類型參數

TResult

物件型別，會傳回非同步作業的結果。

TProgress

物件型別，會提供表示進度的資料。

參數

source
IAsyncOperationWithProgress<TResult,TProgress>

非同步作業。

cancellationToken
CancellationToken

可用來要求取消非同步作業的權杖。

傳回

Task<TResult>

代表非同步作業的工作。

例外狀況

ArgumentNullException

source 為 null。

備註

注意

在 Visual Basic 和 c # 中，您可以在任何類型的物件上呼叫這個方法做為實例方法 IAsyncOperationWithProgress<TResult,TProgress> 。 使用執行個體方法語法呼叫這個方法時，請省略第一個參數。 如需詳細資訊，請參閱 (Visual Basic) 或擴充方法的擴充方法 (c # 程式設計手冊) 。

使用這個方法可取得 Task<TResult> Windows 執行階段非同步作業的物件。 Task<TResult> 物件會簡化非同步作業的協調。

呼叫這個方法多載相當於呼叫 AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, CancellationToken, IProgress<TProgress>) 擴充方法多載，並 null 為 progress 參數指定。 當您不想從報告進度的動作取得進度報表時，這會很有用。

適用於

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

傳回工作，代表傳回結果的 Windows 執行階段非同步作業。

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)

類型參數

TResult

物件型別，會傳回非同步作業的結果。

TProgress

物件型別，會提供表示進度的資料。

參數

source
IAsyncOperationWithProgress<TResult,TProgress>

非同步作業。

傳回

Task<TResult>

代表非同步作業的工作。

例外狀況

ArgumentNullException

source 為 null。

備註

注意

在 Visual Basic 和 c # 中，您可以在任何類型的物件上呼叫這個方法做為實例方法 IAsyncOperationWithProgress<TResult,TProgress> 。 使用執行個體方法語法呼叫這個方法時，請省略第一個參數。 如需詳細資訊，請參閱 (Visual Basic) 或擴充方法的擴充方法 (c # 程式設計手冊) 。

使用這個方法可取得 Task<TResult> Windows 執行階段非同步作業的物件。 Task<TResult> 物件會簡化非同步作業的協調。

呼叫這個方法多載相當於呼叫 AsTask<TResult,TProgress>(IAsyncOperationWithProgress<TResult,TProgress>, IProgress<TProgress>) 擴充方法多載，並 null 為 progress 參數指定。 當您不想從報告進度的動作取得進度報表時，這會很有用。

適用於

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

傳回工作，代表傳回結果並報告進度的 Windows 執行階段非同步作業。

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)

類型參數

TResult

物件型別，會傳回非同步作業的結果。

TProgress

物件型別，會提供表示進度的資料。

參數

source
IAsyncOperationWithProgress<TResult,TProgress>

非同步作業。

progress
IProgress<TProgress>

接收進度更新的物件。

傳回

Task<TResult>

代表非同步作業的工作。

例外狀況

ArgumentNullException

source 為 null。

備註

注意

在 Visual Basic 和 c # 中，您可以在任何類型的物件上呼叫這個方法做為實例方法 IAsyncOperationWithProgress<TResult,TProgress> 。 使用執行個體方法語法呼叫這個方法時，請省略第一個參數。 如需詳細資訊，請參閱 (Visual Basic) 或擴充方法的擴充方法 (c # 程式設計手冊) 。

使用這個方法可取得 Task<TResult> Windows 執行階段非同步作業的物件。 Task<TResult> 物件會簡化非同步作業的協調。

適用於

AsTask<TResult>(IAsyncOperation<TResult>)

傳回工作，代表傳回結果的 Windows 執行階段非同步作業。

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)

類型參數

TResult

物件型別，會傳回非同步作業的結果。

參數

source
IAsyncOperation<TResult>

非同步作業。

傳回

Task<TResult>

代表非同步作業的工作。

例外狀況

ArgumentNullException

source 為 null。

備註

注意

在 Visual Basic 和 c # 中，您可以在任何類型的物件上呼叫這個方法做為實例方法 IAsyncActionWithProgress<TProgress> 。 使用執行個體方法語法呼叫這個方法時，請省略第一個參數。 如需詳細資訊，請參閱 (Visual Basic) 或擴充方法的擴充方法 (c # 程式設計手冊) 。

使用這個方法可取得 Task<TResult> Windows 執行階段非同步作業的物件。 Task<TResult> 物件會簡化非同步作業的協調。

適用於

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

傳回工作，代表傳回結果且可取消的 Windows執行階段非同步作業。

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)

類型參數

TResult

物件型別，會傳回非同步作業的結果。

參數

source
IAsyncOperation<TResult>

非同步作業。

cancellationToken
CancellationToken

可用來要求取消非同步作業的權杖。

傳回

Task<TResult>

代表非同步作業的工作。

例外狀況

ArgumentNullException

source 為 null。

備註

注意

在 Visual Basic 和 c # 中，您可以在任何類型的物件上呼叫這個方法做為實例方法 IAsyncActionWithProgress<TProgress> 。 使用執行個體方法語法呼叫這個方法時，請省略第一個參數。 如需詳細資訊，請參閱 (Visual Basic) 或擴充方法的擴充方法 (c # 程式設計手冊) 。

使用這個方法可取得 Task<TResult> Windows 執行階段非同步作業的物件。 Task<TResult> 物件會簡化非同步作業的協調。

適用於