From e1aad17ce91ed090c91f1835a382ce7276db89ae Mon Sep 17 00:00:00 2001 From: Kent Sharkey Date: Wed, 6 Mar 2019 13:50:11 -0800 Subject: [PATCH 1/5] migrate content from MSDN --- xml/System/WindowsRuntimeSystemExtensions.xml | 389 +++++++++++++----- 1 file changed, 286 insertions(+), 103 deletions(-) diff --git a/xml/System/WindowsRuntimeSystemExtensions.xml b/xml/System/WindowsRuntimeSystemExtensions.xml index 672ad16b7bf..aa6c817338e 100644 --- a/xml/System/WindowsRuntimeSystemExtensions.xml +++ b/xml/System/WindowsRuntimeSystemExtensions.xml @@ -23,8 +23,18 @@ - To be added. - To be added. + Provides extension methods for converting between tasks and Windows Runtime asynchronous actions and operations. + + extension method overloads enable you to use a .NET Framework object to manage an asynchronous operation from the Windows Runtime. + +The method and the method enable you to pass started tasks to methods that take Windows Runtime asynchronous actions and operations. See also the methods of the class. + +The methods are used by compilers to implement the **await** operation (**Await** in Visual Basic). +]]> + @@ -47,10 +57,23 @@ - To be added. - To be added. - To be added. - To be added. + The started task. + Returns a Windows Runtime asynchronous action that represents a started task. + A **Windows.Foundation.IAsyncAction** instance that represents the started task. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method when you want to pass a task to a Windows Runtime method that takes an asynchronous action. + +The class provides static methods (**Shared** methods in Visual Basic) that create and start Windows Runtime asynchronous actions that represent tasks that can respond to cancellation requests and report progress. +]]> + + is . + is an unstarted task. @@ -76,11 +99,24 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The type that returns the result. + The started task. + Returns a Windows Runtime asynchronous operation that represents a started task that returns a result. + A **Windows.Foundation.IAsyncOperation** instance that represents the started task. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method when you want to pass a task that returns a result to a Windows Runtime method that takes an asynchronous operation. + +The class provides static methods (Shared methods in Visual Basic) that create and start Windows Runtime asynchronous operations that represent tasks that return results and can respond to cancellation requests and report progress. +]]> + + is . + is an unstarted task. @@ -103,10 +139,20 @@ - To be added. - To be added. - To be added. - To be added. + The asynchronous action. + Returns a task that represents a Windows Runtime asynchronous action. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . @@ -129,11 +175,21 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The asynchronous action. + A token that can be used to request cancellation of the asynchronous action. + Returns a task that represents a Windows Runtime asynchronous action that can be cancelled. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . @@ -159,11 +215,23 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The type of object that provides data that indicates progress. + The asynchronous action. + Returns a task that represents a Windows Runtime asynchronous action. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + +Calling this method overload is equivalent to calling the , IProgress)> extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. +]]> + + is . @@ -190,12 +258,22 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The type of object that provides data that indicates progress. + The asynchronous action. + An object that receives progress updates. + Returns a task that represents a Windows Runtime asynchronous action that reports progress. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . @@ -221,12 +299,24 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The type of object that provides data that indicates progress. + The asynchronous action. + A token that can be used to request cancellation of the asynchronous action. + Returns a task that represents a Windows Runtime asynchronous action that can be cancelled. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + +Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. +]]> + + is . @@ -253,13 +343,23 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The type of object that provides data that indicates progress. + The asynchronous action. + A token that can be used to request cancellation of the asynchronous action. + An object that receives progress updates. + Returns a task that represents a Windows Runtime asynchronous action that reports progress and can be cancelled. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . @@ -285,11 +385,21 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The type of object that returns the result of the asynchronous operation. + The asynchronous operation. + Returns a task that represents a Windows Runtime asynchronous operation returns a result. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . @@ -315,12 +425,22 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The type of object that returns the result of the asynchronous operation. + The asynchronous operation. + A token that can be used to request cancellation of the asynchronous operation. + Returns a task that represents a Windows Runtime asynchronous operation that returns a result and can be cancelled. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . @@ -347,12 +467,24 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The type of object that returns the result of the asynchronous operation. + The type of object that provides data that indicates progress. + The asynchronous operation. + Returns a task that represents a Windows Runtime asynchronous operation returns a result. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + +Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. +]]> + + is . @@ -380,13 +512,23 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The type of object that returns the result of the asynchronous operation. + The type of object that provides data that indicates progress. + The asynchronous operation. + An object that receives progress updates. + Returns a task that represents Windows Runtime asynchronous operation that returns a result and reports progress. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . @@ -413,13 +555,25 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The type of object that returns the result of the asynchronous operation. + The type of object that provides data that indicates progress. + The asynchronous operation. + A token that can be used to request cancellation of the asynchronous operation. + Returns a task that represents a Windows Runtime asynchronous operation that returns a result and can be cancelled. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + +Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. +]]> + + is . @@ -447,14 +601,23 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The type of object that returns the result of the asynchronous operation. + The type of object that provides data that indicates progress. + The asynchronous operation. + A token that can be used to request cancellation of the asynchronous operation. + An object that receives progress updates. + Returns a task that represents a Windows Runtime asynchronous operation that returns a result, reports progress, and can be cancelled. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + @@ -482,10 +645,15 @@ - To be added. - To be added. - To be added. - To be added. + The asynchronous action to await. + This API supports the .NET Framework infrastructure and is not intended to be used directly from your code. + An object that awaits the specified asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncAction. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). +]]> + @@ -516,11 +684,16 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The type of object that provides data that indicates progress. + The asynchronous action to await. + Returns an object that awaits an asynchronous action that reports progress. + An object that awaits the specified asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). +]]> + @@ -551,11 +724,16 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The type of object that returns the result of the asynchronous operation. + The asynchronous operation to await. + Returns an object that awaits an asynchronous operation that returns a result. + An object that awaits the specified asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncOperation. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). +]]> + @@ -587,12 +765,17 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The type of object that returns the result of the asynchronous operation. + The type of object that provides data that indicates progress. + The asynchronous operation to await. + Returns an object that awaits an asynchronous operation that reports progress and returns a result. + An object that awaits the specified asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncOperationWithProgress. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). +]]> + From 441a44337f3d1923f88b1d4e1701bc3cbbac6edf Mon Sep 17 00:00:00 2001 From: Maira Wenzel Date: Thu, 7 Mar 2019 09:32:32 -0800 Subject: [PATCH 2/5] Apply suggestions from code review Co-Authored-By: v-kents --- xml/System/WindowsRuntimeSystemExtensions.xml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/xml/System/WindowsRuntimeSystemExtensions.xml b/xml/System/WindowsRuntimeSystemExtensions.xml index aa6c817338e..4144b1ecdc5 100644 --- a/xml/System/WindowsRuntimeSystemExtensions.xml +++ b/xml/System/WindowsRuntimeSystemExtensions.xml @@ -102,11 +102,11 @@ The class provide The type that returns the result. The started task. Returns a Windows Runtime asynchronous operation that represents a started task that returns a result. - A **Windows.Foundation.IAsyncOperation** instance that represents the started task. + A instance that represents the started task. [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). ## Remarks @@ -779,4 +779,4 @@ Use this method to get a object for a Windo - \ No newline at end of file + From 1507d7d84e73186588a9664f6484585ecfc4e994 Mon Sep 17 00:00:00 2001 From: Kent Sharkey Date: Thu, 7 Mar 2019 09:39:24 -0800 Subject: [PATCH 3/5] update path to Extension methods page --- xml/System/WindowsRuntimeSystemExtensions.xml | 1564 ++++++++--------- 1 file changed, 782 insertions(+), 782 deletions(-) diff --git a/xml/System/WindowsRuntimeSystemExtensions.xml b/xml/System/WindowsRuntimeSystemExtensions.xml index 4144b1ecdc5..94fda5e5f1f 100644 --- a/xml/System/WindowsRuntimeSystemExtensions.xml +++ b/xml/System/WindowsRuntimeSystemExtensions.xml @@ -1,782 +1,782 @@ - - - - - - - - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Object - - - - - System.CLSCompliant(false) - - - System.Security.SecurityCritical - - - - Provides extension methods for converting between tasks and Windows Runtime asynchronous actions and operations. - - extension method overloads enable you to use a .NET Framework object to manage an asynchronous operation from the Windows Runtime. - -The method and the method enable you to pass started tasks to methods that take Windows Runtime asynchronous actions and operations. See also the methods of the class. - -The methods are used by compilers to implement the **await** operation (**Await** in Visual Basic). -]]> - - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - Windows.Foundation.IAsyncAction - - - - - - The started task. - Returns a Windows Runtime asynchronous action that represents a started task. - A **Windows.Foundation.IAsyncAction** instance that represents the started task. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method when you want to pass a task to a Windows Runtime method that takes an asynchronous action. - -The class provides static methods (**Shared** methods in Visual Basic) that create and start Windows Runtime asynchronous actions that represent tasks that can respond to cancellation requests and report progress. -]]> - - is . - is an unstarted task. - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - Windows.Foundation.IAsyncOperation<TResult> - - - - - - - - - The type that returns the result. - The started task. - Returns a Windows Runtime asynchronous operation that represents a started task that returns a result. - A instance that represents the started task. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method when you want to pass a task that returns a result to a Windows Runtime method that takes an asynchronous operation. - -The class provides static methods (Shared methods in Visual Basic) that create and start Windows Runtime asynchronous operations that represent tasks that return results and can respond to cancellation requests and report progress. -]]> - - is . - is an unstarted task. - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task - - - - - - The asynchronous action. - Returns a task that represents a Windows Runtime asynchronous action. - A task that represents the asynchronous action. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -]]> - - is . - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task - - - - - - - The asynchronous action. - A token that can be used to request cancellation of the asynchronous action. - Returns a task that represents a Windows Runtime asynchronous action that can be cancelled. - A task that represents the asynchronous action. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -]]> - - is . - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task - - - - - - - - - The type of object that provides data that indicates progress. - The asynchronous action. - Returns a task that represents a Windows Runtime asynchronous action. - A task that represents the asynchronous action. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. - -Calling this method overload is equivalent to calling the , IProgress)> extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. -]]> - - is . - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task - - - - - - - - - - The type of object that provides data that indicates progress. - The asynchronous action. - An object that receives progress updates. - Returns a task that represents a Windows Runtime asynchronous action that reports progress. - A task that represents the asynchronous action. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -]]> - - is . - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task - - - - - - - - - - The type of object that provides data that indicates progress. - The asynchronous action. - A token that can be used to request cancellation of the asynchronous action. - Returns a task that represents a Windows Runtime asynchronous action that can be cancelled. - A task that represents the asynchronous action. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. - -Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. -]]> - - is . - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task - - - - - - - - - - - The type of object that provides data that indicates progress. - The asynchronous action. - A token that can be used to request cancellation of the asynchronous action. - An object that receives progress updates. - Returns a task that represents a Windows Runtime asynchronous action that reports progress and can be cancelled. - A task that represents the asynchronous action. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -]]> - - is . - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task<TResult> - - - - - - - - - The type of object that returns the result of the asynchronous operation. - The asynchronous operation. - Returns a task that represents a Windows Runtime asynchronous operation returns a result. - A task that represents the asynchronous operation. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -]]> - - is . - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task<TResult> - - - - - - - - - - The type of object that returns the result of the asynchronous operation. - The asynchronous operation. - A token that can be used to request cancellation of the asynchronous operation. - Returns a task that represents a Windows Runtime asynchronous operation that returns a result and can be cancelled. - A task that represents the asynchronous operation. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -]]> - - is . - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task<TResult> - - - - - - - - - - The type of object that returns the result of the asynchronous operation. - The type of object that provides data that indicates progress. - The asynchronous operation. - Returns a task that represents a Windows Runtime asynchronous operation returns a result. - A task that represents the asynchronous operation. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. - -Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. -]]> - - is . - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task<TResult> - - - - - - - - - - - The type of object that returns the result of the asynchronous operation. - The type of object that provides data that indicates progress. - The asynchronous operation. - An object that receives progress updates. - Returns a task that represents Windows Runtime asynchronous operation that returns a result and reports progress. - A task that represents the asynchronous operation. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -]]> - - is . - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task<TResult> - - - - - - - - - - - The type of object that returns the result of the asynchronous operation. - The type of object that provides data that indicates progress. - The asynchronous operation. - A token that can be used to request cancellation of the asynchronous operation. - Returns a task that represents a Windows Runtime asynchronous operation that returns a result and can be cancelled. - A task that represents the asynchronous operation. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. - -Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. -]]> - - is . - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task<TResult> - - - - - - - - - - - - The type of object that returns the result of the asynchronous operation. - The type of object that provides data that indicates progress. - The asynchronous operation. - A token that can be used to request cancellation of the asynchronous operation. - An object that receives progress updates. - Returns a task that represents a Windows Runtime asynchronous operation that returns a result, reports progress, and can be cancelled. - A task that represents the asynchronous operation. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -]]> - - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Runtime.CompilerServices.TaskAwaiter - - - - - - The asynchronous action to await. - This API supports the .NET Framework infrastructure and is not intended to be used directly from your code. - An object that awaits the specified asynchronous action. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncAction. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). -]]> - - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Runtime.CompilerServices.TaskAwaiter - - - - - - - - - The type of object that provides data that indicates progress. - The asynchronous action to await. - Returns an object that awaits an asynchronous action that reports progress. - An object that awaits the specified asynchronous action. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). -]]> - - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Runtime.CompilerServices.TaskAwaiter<TResult> - - - - - - - - - The type of object that returns the result of the asynchronous operation. - The asynchronous operation to await. - Returns an object that awaits an asynchronous operation that returns a result. - An object that awaits the specified asynchronous operation. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncOperation. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). -]]> - - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Runtime.CompilerServices.TaskAwaiter<TResult> - - - - - - - - - - The type of object that returns the result of the asynchronous operation. - The type of object that provides data that indicates progress. - The asynchronous operation to await. - Returns an object that awaits an asynchronous operation that reports progress and returns a result. - An object that awaits the specified asynchronous operation. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncOperationWithProgress. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/csharp/programming-guide/classes-and-structs/extension-methods.md). -]]> - - - - - + + + + + + + + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Object + + + + + System.CLSCompliant(false) + + + System.Security.SecurityCritical + + + + Provides extension methods for converting between tasks and Windows Runtime asynchronous actions and operations. + + extension method overloads enable you to use a .NET Framework object to manage an asynchronous operation from the Windows Runtime. + +The method and the method enable you to pass started tasks to methods that take Windows Runtime asynchronous actions and operations. See also the methods of the class. + +The methods are used by compilers to implement the operation ( in Visual Basic). +]]> + + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + Windows.Foundation.IAsyncAction + + + + + + The started task. + Returns a Windows Runtime asynchronous action that represents a started task. + A instance that represents the started task. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method when you want to pass a task to a Windows Runtime method that takes an asynchronous action. + +The class provides static methods ( methods in Visual Basic) that create and start Windows Runtime asynchronous actions that represent tasks that can respond to cancellation requests and report progress. +]]> + + is . + is an unstarted task. + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + Windows.Foundation.IAsyncOperation<TResult> + + + + + + + + + The type that returns the result. + The started task. + Returns a Windows Runtime asynchronous operation that represents a started task that returns a result. + A instance that represents the started task. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method when you want to pass a task that returns a result to a Windows Runtime method that takes an asynchronous operation. + +The class provides static methods (Shared methods in Visual Basic) that create and start Windows Runtime asynchronous operations that represent tasks that return results and can respond to cancellation requests and report progress. +]]> + + is . + is an unstarted task. + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task + + + + + + The asynchronous action. + Returns a task that represents a Windows Runtime asynchronous action. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task + + + + + + + The asynchronous action. + A token that can be used to request cancellation of the asynchronous action. + Returns a task that represents a Windows Runtime asynchronous action that can be cancelled. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task + + + + + + + + + The type of object that provides data that indicates progress. + The asynchronous action. + Returns a task that represents a Windows Runtime asynchronous action. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + +Calling this method overload is equivalent to calling the , IProgress)> extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. +]]> + + is . + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task + + + + + + + + + + The type of object that provides data that indicates progress. + The asynchronous action. + An object that receives progress updates. + Returns a task that represents a Windows Runtime asynchronous action that reports progress. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task + + + + + + + + + + The type of object that provides data that indicates progress. + The asynchronous action. + A token that can be used to request cancellation of the asynchronous action. + Returns a task that represents a Windows Runtime asynchronous action that can be cancelled. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + +Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. +]]> + + is . + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task + + + + + + + + + + + The type of object that provides data that indicates progress. + The asynchronous action. + A token that can be used to request cancellation of the asynchronous action. + An object that receives progress updates. + Returns a task that represents a Windows Runtime asynchronous action that reports progress and can be cancelled. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task<TResult> + + + + + + + + + The type of object that returns the result of the asynchronous operation. + The asynchronous operation. + Returns a task that represents a Windows Runtime asynchronous operation returns a result. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task<TResult> + + + + + + + + + + The type of object that returns the result of the asynchronous operation. + The asynchronous operation. + A token that can be used to request cancellation of the asynchronous operation. + Returns a task that represents a Windows Runtime asynchronous operation that returns a result and can be cancelled. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task<TResult> + + + + + + + + + + The type of object that returns the result of the asynchronous operation. + The type of object that provides data that indicates progress. + The asynchronous operation. + Returns a task that represents a Windows Runtime asynchronous operation returns a result. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + +Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. +]]> + + is . + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task<TResult> + + + + + + + + + + + The type of object that returns the result of the asynchronous operation. + The type of object that provides data that indicates progress. + The asynchronous operation. + An object that receives progress updates. + Returns a task that represents Windows Runtime asynchronous operation that returns a result and reports progress. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task<TResult> + + + + + + + + + + + The type of object that returns the result of the asynchronous operation. + The type of object that provides data that indicates progress. + The asynchronous operation. + A token that can be used to request cancellation of the asynchronous operation. + Returns a task that represents a Windows Runtime asynchronous operation that returns a result and can be cancelled. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + +Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. +]]> + + is . + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task<TResult> + + + + + + + + + + + + The type of object that returns the result of the asynchronous operation. + The type of object that provides data that indicates progress. + The asynchronous operation. + A token that can be used to request cancellation of the asynchronous operation. + An object that receives progress updates. + Returns a task that represents a Windows Runtime asynchronous operation that returns a result, reports progress, and can be cancelled. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + + System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) + + + + System.Runtime.CompilerServices.TaskAwaiter + + + + + + The asynchronous action to await. + This API supports the .NET Framework infrastructure and is not intended to be used directly from your code. + An object that awaits the specified asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncAction. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). +]]> + + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + + System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) + + + + System.Runtime.CompilerServices.TaskAwaiter + + + + + + + + + The type of object that provides data that indicates progress. + The asynchronous action to await. + Returns an object that awaits an asynchronous action that reports progress. + An object that awaits the specified asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). +]]> + + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + + System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) + + + + System.Runtime.CompilerServices.TaskAwaiter<TResult> + + + + + + + + + The type of object that returns the result of the asynchronous operation. + The asynchronous operation to await. + Returns an object that awaits an asynchronous operation that returns a result. + An object that awaits the specified asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncOperation. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). +]]> + + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + + System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) + + + + System.Runtime.CompilerServices.TaskAwaiter<TResult> + + + + + + + + + + The type of object that returns the result of the asynchronous operation. + The type of object that provides data that indicates progress. + The asynchronous operation to await. + Returns an object that awaits an asynchronous operation that reports progress and returns a result. + An object that awaits the specified asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncOperationWithProgress. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). +]]> + + + + + From fa79c4297fe840f6c58be79787b80925befdd1f7 Mon Sep 17 00:00:00 2001 From: Kent Sharkey Date: Fri, 8 Mar 2019 09:59:25 -0800 Subject: [PATCH 4/5] switch to LF line endings --- xml/System/WindowsRuntimeSystemExtensions.xml | 1564 ++++++++--------- 1 file changed, 782 insertions(+), 782 deletions(-) diff --git a/xml/System/WindowsRuntimeSystemExtensions.xml b/xml/System/WindowsRuntimeSystemExtensions.xml index 94fda5e5f1f..45d203fcae9 100644 --- a/xml/System/WindowsRuntimeSystemExtensions.xml +++ b/xml/System/WindowsRuntimeSystemExtensions.xml @@ -1,782 +1,782 @@ - - - - - - - - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Object - - - - - System.CLSCompliant(false) - - - System.Security.SecurityCritical - - - - Provides extension methods for converting between tasks and Windows Runtime asynchronous actions and operations. - - extension method overloads enable you to use a .NET Framework object to manage an asynchronous operation from the Windows Runtime. - -The method and the method enable you to pass started tasks to methods that take Windows Runtime asynchronous actions and operations. See also the methods of the class. - -The methods are used by compilers to implement the operation ( in Visual Basic). -]]> - - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - Windows.Foundation.IAsyncAction - - - - - - The started task. - Returns a Windows Runtime asynchronous action that represents a started task. - A instance that represents the started task. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method when you want to pass a task to a Windows Runtime method that takes an asynchronous action. - -The class provides static methods ( methods in Visual Basic) that create and start Windows Runtime asynchronous actions that represent tasks that can respond to cancellation requests and report progress. -]]> - - is . - is an unstarted task. - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - Windows.Foundation.IAsyncOperation<TResult> - - - - - - - - - The type that returns the result. - The started task. - Returns a Windows Runtime asynchronous operation that represents a started task that returns a result. - A instance that represents the started task. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method when you want to pass a task that returns a result to a Windows Runtime method that takes an asynchronous operation. - -The class provides static methods (Shared methods in Visual Basic) that create and start Windows Runtime asynchronous operations that represent tasks that return results and can respond to cancellation requests and report progress. -]]> - - is . - is an unstarted task. - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task - - - - - - The asynchronous action. - Returns a task that represents a Windows Runtime asynchronous action. - A task that represents the asynchronous action. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -]]> - - is . - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task - - - - - - - The asynchronous action. - A token that can be used to request cancellation of the asynchronous action. - Returns a task that represents a Windows Runtime asynchronous action that can be cancelled. - A task that represents the asynchronous action. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -]]> - - is . - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task - - - - - - - - - The type of object that provides data that indicates progress. - The asynchronous action. - Returns a task that represents a Windows Runtime asynchronous action. - A task that represents the asynchronous action. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. - -Calling this method overload is equivalent to calling the , IProgress)> extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. -]]> - - is . - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task - - - - - - - - - - The type of object that provides data that indicates progress. - The asynchronous action. - An object that receives progress updates. - Returns a task that represents a Windows Runtime asynchronous action that reports progress. - A task that represents the asynchronous action. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -]]> - - is . - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task - - - - - - - - - - The type of object that provides data that indicates progress. - The asynchronous action. - A token that can be used to request cancellation of the asynchronous action. - Returns a task that represents a Windows Runtime asynchronous action that can be cancelled. - A task that represents the asynchronous action. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. - -Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. -]]> - - is . - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task - - - - - - - - - - - The type of object that provides data that indicates progress. - The asynchronous action. - A token that can be used to request cancellation of the asynchronous action. - An object that receives progress updates. - Returns a task that represents a Windows Runtime asynchronous action that reports progress and can be cancelled. - A task that represents the asynchronous action. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -]]> - - is . - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task<TResult> - - - - - - - - - The type of object that returns the result of the asynchronous operation. - The asynchronous operation. - Returns a task that represents a Windows Runtime asynchronous operation returns a result. - A task that represents the asynchronous operation. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -]]> - - is . - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task<TResult> - - - - - - - - - - The type of object that returns the result of the asynchronous operation. - The asynchronous operation. - A token that can be used to request cancellation of the asynchronous operation. - Returns a task that represents a Windows Runtime asynchronous operation that returns a result and can be cancelled. - A task that represents the asynchronous operation. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -]]> - - is . - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task<TResult> - - - - - - - - - - The type of object that returns the result of the asynchronous operation. - The type of object that provides data that indicates progress. - The asynchronous operation. - Returns a task that represents a Windows Runtime asynchronous operation returns a result. - A task that represents the asynchronous operation. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. - -Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. -]]> - - is . - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task<TResult> - - - - - - - - - - - The type of object that returns the result of the asynchronous operation. - The type of object that provides data that indicates progress. - The asynchronous operation. - An object that receives progress updates. - Returns a task that represents Windows Runtime asynchronous operation that returns a result and reports progress. - A task that represents the asynchronous operation. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -]]> - - is . - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task<TResult> - - - - - - - - - - - The type of object that returns the result of the asynchronous operation. - The type of object that provides data that indicates progress. - The asynchronous operation. - A token that can be used to request cancellation of the asynchronous operation. - Returns a task that represents a Windows Runtime asynchronous operation that returns a result and can be cancelled. - A task that represents the asynchronous operation. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. - -Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. -]]> - - is . - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - System.Threading.Tasks.Task<TResult> - - - - - - - - - - - - The type of object that returns the result of the asynchronous operation. - The type of object that provides data that indicates progress. - The asynchronous operation. - A token that can be used to request cancellation of the asynchronous operation. - An object that receives progress updates. - Returns a task that represents a Windows Runtime asynchronous operation that returns a result, reports progress, and can be cancelled. - A task that represents the asynchronous operation. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - -## Remarks - -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -]]> - - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Runtime.CompilerServices.TaskAwaiter - - - - - - The asynchronous action to await. - This API supports the .NET Framework infrastructure and is not intended to be used directly from your code. - An object that awaits the specified asynchronous action. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncAction. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). -]]> - - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Runtime.CompilerServices.TaskAwaiter - - - - - - - - - The type of object that provides data that indicates progress. - The asynchronous action to await. - Returns an object that awaits an asynchronous action that reports progress. - An object that awaits the specified asynchronous action. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). -]]> - - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Runtime.CompilerServices.TaskAwaiter<TResult> - - - - - - - - - The type of object that returns the result of the asynchronous operation. - The asynchronous operation to await. - Returns an object that awaits an asynchronous operation that returns a result. - An object that awaits the specified asynchronous operation. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncOperation. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). -]]> - - - - - - - - - - - Method - - System.Runtime.WindowsRuntime - 4.0.10.0 - 4.0.14.0 - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Runtime.CompilerServices.TaskAwaiter<TResult> - - - - - - - - - - The type of object that returns the result of the asynchronous operation. - The type of object that provides data that indicates progress. - The asynchronous operation to await. - Returns an object that awaits an asynchronous operation that reports progress and returns a result. - An object that awaits the specified asynchronous operation. - - [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncOperationWithProgress. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). -]]> - - - - - + + + + + + + + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Object + + + + + System.CLSCompliant(false) + + + System.Security.SecurityCritical + + + + Provides extension methods for converting between tasks and Windows Runtime asynchronous actions and operations. + + extension method overloads enable you to use a .NET Framework object to manage an asynchronous operation from the Windows Runtime. + +The method and the method enable you to pass started tasks to methods that take Windows Runtime asynchronous actions and operations. See also the methods of the class. + +The methods are used by compilers to implement the operation ( in Visual Basic). +]]> + + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + Windows.Foundation.IAsyncAction + + + + + + The started task. + Returns a Windows Runtime asynchronous action that represents a started task. + A instance that represents the started task. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method when you want to pass a task to a Windows Runtime method that takes an asynchronous action. + +The class provides static methods ( methods in Visual Basic) that create and start Windows Runtime asynchronous actions that represent tasks that can respond to cancellation requests and report progress. +]]> + + is . + is an unstarted task. + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + Windows.Foundation.IAsyncOperation<TResult> + + + + + + + + + The type that returns the result. + The started task. + Returns a Windows Runtime asynchronous operation that represents a started task that returns a result. + A instance that represents the started task. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method when you want to pass a task that returns a result to a Windows Runtime method that takes an asynchronous operation. + +The class provides static methods (Shared methods in Visual Basic) that create and start Windows Runtime asynchronous operations that represent tasks that return results and can respond to cancellation requests and report progress. +]]> + + is . + is an unstarted task. + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task + + + + + + The asynchronous action. + Returns a task that represents a Windows Runtime asynchronous action. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task + + + + + + + The asynchronous action. + A token that can be used to request cancellation of the asynchronous action. + Returns a task that represents a Windows Runtime asynchronous action that can be cancelled. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task + + + + + + + + + The type of object that provides data that indicates progress. + The asynchronous action. + Returns a task that represents a Windows Runtime asynchronous action. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + +Calling this method overload is equivalent to calling the , IProgress)> extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. +]]> + + is . + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task + + + + + + + + + + The type of object that provides data that indicates progress. + The asynchronous action. + An object that receives progress updates. + Returns a task that represents a Windows Runtime asynchronous action that reports progress. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task + + + + + + + + + + The type of object that provides data that indicates progress. + The asynchronous action. + A token that can be used to request cancellation of the asynchronous action. + Returns a task that represents a Windows Runtime asynchronous action that can be cancelled. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + +Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. +]]> + + is . + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task + + + + + + + + + + + The type of object that provides data that indicates progress. + The asynchronous action. + A token that can be used to request cancellation of the asynchronous action. + An object that receives progress updates. + Returns a task that represents a Windows Runtime asynchronous action that reports progress and can be cancelled. + A task that represents the asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task<TResult> + + + + + + + + + The type of object that returns the result of the asynchronous operation. + The asynchronous operation. + Returns a task that represents a Windows Runtime asynchronous operation returns a result. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task<TResult> + + + + + + + + + + The type of object that returns the result of the asynchronous operation. + The asynchronous operation. + A token that can be used to request cancellation of the asynchronous operation. + Returns a task that represents a Windows Runtime asynchronous operation that returns a result and can be cancelled. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task<TResult> + + + + + + + + + + The type of object that returns the result of the asynchronous operation. + The type of object that provides data that indicates progress. + The asynchronous operation. + Returns a task that represents a Windows Runtime asynchronous operation returns a result. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + +Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. +]]> + + is . + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task<TResult> + + + + + + + + + + + The type of object that returns the result of the asynchronous operation. + The type of object that provides data that indicates progress. + The asynchronous operation. + An object that receives progress updates. + Returns a task that represents Windows Runtime asynchronous operation that returns a result and reports progress. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + is . + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task<TResult> + + + + + + + + + + + The type of object that returns the result of the asynchronous operation. + The type of object that provides data that indicates progress. + The asynchronous operation. + A token that can be used to request cancellation of the asynchronous operation. + Returns a task that represents a Windows Runtime asynchronous operation that returns a result and can be cancelled. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + +Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. +]]> + + is . + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + System.Threading.Tasks.Task<TResult> + + + + + + + + + + + + The type of object that returns the result of the asynchronous operation. + The type of object that provides data that indicates progress. + The asynchronous operation. + A token that can be used to request cancellation of the asynchronous operation. + An object that receives progress updates. + Returns a task that represents a Windows Runtime asynchronous operation that returns a result, reports progress, and can be cancelled. + A task that represents the asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +## Remarks + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +]]> + + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + + System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) + + + + System.Runtime.CompilerServices.TaskAwaiter + + + + + + The asynchronous action to await. + This API supports the .NET Framework infrastructure and is not intended to be used directly from your code. + An object that awaits the specified asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncAction. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). +]]> + + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + + System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) + + + + System.Runtime.CompilerServices.TaskAwaiter + + + + + + + + + The type of object that provides data that indicates progress. + The asynchronous action to await. + Returns an object that awaits an asynchronous action that reports progress. + An object that awaits the specified asynchronous action. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). +]]> + + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + + System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) + + + + System.Runtime.CompilerServices.TaskAwaiter<TResult> + + + + + + + + + The type of object that returns the result of the asynchronous operation. + The asynchronous operation to await. + Returns an object that awaits an asynchronous operation that returns a result. + An object that awaits the specified asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncOperation. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). +]]> + + + + + + + + + + + Method + + System.Runtime.WindowsRuntime + 4.0.10.0 + 4.0.14.0 + + + + System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) + + + + System.Runtime.CompilerServices.TaskAwaiter<TResult> + + + + + + + + + + The type of object that returns the result of the asynchronous operation. + The type of object that provides data that indicates progress. + The asynchronous operation to await. + Returns an object that awaits an asynchronous operation that reports progress and returns a result. + An object that awaits the specified asynchronous operation. + + [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncOperationWithProgress. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). +]]> + + + + + From 4139a2e4f57c39901a8fd372e03abd37e682fb6e Mon Sep 17 00:00:00 2001 From: Maira Wenzel Date: Sat, 9 Mar 2019 00:04:02 -0800 Subject: [PATCH 5/5] fixes --- xml/System/WindowsRuntimeSystemExtensions.xml | 246 ++++++++++-------- 1 file changed, 143 insertions(+), 103 deletions(-) diff --git a/xml/System/WindowsRuntimeSystemExtensions.xml b/xml/System/WindowsRuntimeSystemExtensions.xml index 45d203fcae9..d5409216f98 100644 --- a/xml/System/WindowsRuntimeSystemExtensions.xml +++ b/xml/System/WindowsRuntimeSystemExtensions.xml @@ -23,16 +23,18 @@ - Provides extension methods for converting between tasks and Windows Runtime asynchronous actions and operations. + Provides extension methods for converting between tasks and Windows Runtime asynchronous actions and operations. extension method overloads enable you to use a .NET Framework object to manage an asynchronous operation from the Windows Runtime. +The extension method overloads enable you to use a .NET object to manage an asynchronous operation from the Windows Runtime. The method and the method enable you to pass started tasks to methods that take Windows Runtime asynchronous actions and operations. See also the methods of the class. The methods are used by compilers to implement the operation ( in Visual Basic). + ]]> @@ -57,23 +59,25 @@ The methods are used - The started task. - Returns a Windows Runtime asynchronous action that represents a started task. - A instance that represents the started task. + The started task. + Returns a Windows Runtime asynchronous action that represents a started task. + A instance that represents the started task. [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). ## Remarks +> [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + Use this method when you want to pass a task to a Windows Runtime method that takes an asynchronous action. -The class provides static methods ( methods in Visual Basic) that create and start Windows Runtime asynchronous actions that represent tasks that can respond to cancellation requests and report progress. +The class provides static methods (`Shared` methods in Visual Basic) that create and start Windows Runtime asynchronous actions that represent tasks that can respond to cancellation requests and report progress. + ]]> is . - is an unstarted task. + is an unstarted task. @@ -99,24 +103,26 @@ The class provide - The type that returns the result. - The started task. - Returns a Windows Runtime asynchronous operation that represents a started task that returns a result. - A instance that represents the started task. + The type that returns the result. + The started task. + Returns a Windows Runtime asynchronous operation that represents a started task that returns a result. + A instance that represents the started task. [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). ## Remarks +> [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + Use this method when you want to pass a task that returns a result to a Windows Runtime method that takes an asynchronous operation. -The class provides static methods (Shared methods in Visual Basic) that create and start Windows Runtime asynchronous operations that represent tasks that return results and can respond to cancellation requests and report progress. +The class provides static methods (`Shared` methods in Visual Basic) that create and start Windows Runtime asynchronous operations that represent tasks that return results and can respond to cancellation requests and report progress. + ]]> is . - is an unstarted task. + is an unstarted task. @@ -139,17 +145,19 @@ The class provide - The asynchronous action. - Returns a task that represents a Windows Runtime asynchronous action. - A task that represents the asynchronous action. + The asynchronous action. + Returns a task that represents a Windows Runtime asynchronous action. + A task that represents the asynchronous action. [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). ## Remarks +> [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + ]]> is . @@ -175,18 +183,19 @@ Use this method to get a object for a Windows - The asynchronous action. - A token that can be used to request cancellation of the asynchronous action. - Returns a task that represents a Windows Runtime asynchronous action that can be cancelled. + The asynchronous action. + A token that can be used to request cancellation of the asynchronous action. + Returns a task that represents a Windows Runtime asynchronous action that can be cancelled. A task that represents the asynchronous action. [!NOTE] > In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). -## Remarks - Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + ]]> is . @@ -215,20 +224,22 @@ Use this method to get a object for a Windows - The type of object that provides data that indicates progress. - The asynchronous action. - Returns a task that represents a Windows Runtime asynchronous action. - A task that represents the asynchronous action. + The type of object that provides data that indicates progress. + The asynchronous action. + Returns a task that represents a Windows Runtime asynchronous action. + A task that represents the asynchronous action. [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). ## Remarks +> [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -Calling this method overload is equivalent to calling the , IProgress)> extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. +Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. + ]]> is . @@ -258,19 +269,20 @@ Calling this method overload is equivalent to calling the - The type of object that provides data that indicates progress. - The asynchronous action. - An object that receives progress updates. - Returns a task that represents a Windows Runtime asynchronous action that reports progress. - A task that represents the asynchronous action. + The type of object that provides data that indicates progress. + The asynchronous action. + An object that receives progress updates. + Returns a task that represents a Windows Runtime asynchronous action that reports progress. + A task that represents the asynchronous action. [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - ## Remarks +> [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + ]]> is . @@ -299,21 +311,22 @@ Use this method to get a object for a Windows - The type of object that provides data that indicates progress. - The asynchronous action. + The type of object that provides data that indicates progress. + The asynchronous action. A token that can be used to request cancellation of the asynchronous action. - Returns a task that represents a Windows Runtime asynchronous action that can be cancelled. + Returns a task that represents a Windows Runtime asynchronous action that can be cancelled. A task that represents the asynchronous action. [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - ## Remarks +> [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. +Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. + ]]> is . @@ -344,19 +357,20 @@ Calling this method overload is equivalent to calling the The type of object that provides data that indicates progress. - The asynchronous action. + The asynchronous action. A token that can be used to request cancellation of the asynchronous action. - An object that receives progress updates. + An object that receives progress updates. Returns a task that represents a Windows Runtime asynchronous action that reports progress and can be cancelled. A task that represents the asynchronous action. [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). - ## Remarks +> [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + ]]> is . @@ -387,16 +401,17 @@ Use this method to get a object for a Windows The type of object that returns the result of the asynchronous operation. The asynchronous operation. - Returns a task that represents a Windows Runtime asynchronous operation returns a result. + Returns a task that represents a Windows Runtime asynchronous operation returns a result. A task that represents the asynchronous operation. [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). -## Remarks +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. ]]> is . @@ -425,19 +440,20 @@ Use this method to get a object for a Windo - The type of object that returns the result of the asynchronous operation. - The asynchronous operation. - A token that can be used to request cancellation of the asynchronous operation. - Returns a task that represents a Windows Runtime asynchronous operation that returns a result and can be cancelled. + The type of object that returns the result of the asynchronous operation. + The asynchronous operation. + A token that can be used to request cancellation of the asynchronous operation. + Returns a task that represents a Windows Runtime asynchronous operation that returns a result and can be cancelled. A task that represents the asynchronous operation. [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). -## Remarks +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. ]]> is . @@ -467,21 +483,23 @@ Use this method to get a object for a Windo - The type of object that returns the result of the asynchronous operation. - The type of object that provides data that indicates progress. + The type of object that returns the result of the asynchronous operation. + The type of object that provides data that indicates progress. The asynchronous operation. - Returns a task that represents a Windows Runtime asynchronous operation returns a result. + Returns a task that represents a Windows Runtime asynchronous operation returns a result. A task that represents the asynchronous operation. [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). ## Remarks -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +> [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + +Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. -Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. ]]> is . @@ -514,18 +532,20 @@ Calling this method overload is equivalent to calling the The type of object that returns the result of the asynchronous operation. The type of object that provides data that indicates progress. - The asynchronous operation. - An object that receives progress updates. - Returns a task that represents Windows Runtime asynchronous operation that returns a result and reports progress. - A task that represents the asynchronous operation. + The asynchronous operation. + An object that receives progress updates. + Returns a task that represents Windows Runtime asynchronous operation that returns a result and reports progress. + A task that represents the asynchronous operation. [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). ## Remarks -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +> [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + ]]> is . @@ -559,18 +579,20 @@ Use this method to get a object for a Windo The type of object that provides data that indicates progress. The asynchronous operation. A token that can be used to request cancellation of the asynchronous operation. - Returns a task that represents a Windows Runtime asynchronous operation that returns a result and can be cancelled. - A task that represents the asynchronous operation. + Returns a task that represents a Windows Runtime asynchronous operation that returns a result and can be cancelled. + A task that represents the asynchronous operation. [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). ## Remarks -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +> [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + +Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. -Calling this method overload is equivalent to calling the extension method overload and specifying for the parameter. This is useful when you don't want to get progress reports from an action that reports progress. ]]> is . @@ -605,17 +627,19 @@ Calling this method overload is equivalent to calling the The type of object that provides data that indicates progress. The asynchronous operation. A token that can be used to request cancellation of the asynchronous operation. - An object that receives progress updates. - Returns a task that represents a Windows Runtime asynchronous operation that returns a result, reports progress, and can be cancelled. - A task that represents the asynchronous operation. + An object that receives progress updates. + Returns a task that represents a Windows Runtime asynchronous operation that returns a result, reports progress, and can be cancelled. + A task that represents the asynchronous operation. [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TResult, TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). ## Remarks -Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. +> [!NOTE] +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + +Use this method to get a object for a Windows Runtime asynchronous operation. objects simplify the coordination of asynchronous operations. + ]]> @@ -650,8 +674,12 @@ Use this method to get a object for a Windo An object that awaits the specified asynchronous action. [!NOTE] > In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncAction. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + ]]> @@ -684,14 +712,18 @@ Use this method to get a object for a Windo - The type of object that provides data that indicates progress. - The asynchronous action to await. - Returns an object that awaits an asynchronous action that reports progress. - An object that awaits the specified asynchronous action. + The type of object that provides data that indicates progress. + The asynchronous action to await. + Returns an object that awaits an asynchronous action that reports progress. + An object that awaits the specified asynchronous action. [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncActionWithProgress<TProgress>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + ]]> @@ -724,14 +756,18 @@ Use this method to get a object for a Windo - The type of object that returns the result of the asynchronous operation. - The asynchronous operation to await. + The type of object that returns the result of the asynchronous operation. + The asynchronous operation to await. Returns an object that awaits an asynchronous operation that returns a result. - An object that awaits the specified asynchronous operation. + An object that awaits the specified asynchronous operation. [!NOTE] > In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncOperation. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + ]]> @@ -767,13 +803,17 @@ Use this method to get a object for a Windo The type of object that returns the result of the asynchronous operation. The type of object that provides data that indicates progress. - The asynchronous operation to await. - Returns an object that awaits an asynchronous operation that reports progress and returns a result. - An object that awaits the specified asynchronous operation. + The asynchronous operation to await. + Returns an object that awaits an asynchronous operation that reports progress and returns a result. + An object that awaits the specified asynchronous operation. [!NOTE] -> In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncOperationWithProgress. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). +> In Visual Basic and C#, you can call this method as an instance method on any object of type . When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md). + ]]>