Note
Access to this page requires authorization. You can trysigning in orchanging directories.
Access to this page requires authorization. You can trychanging directories.
Task.ConfigureAwait Method
Definition
- Namespace:
- System.Threading.Tasks
- Assemblies:
- mscorlib.dll, System.Threading.Tasks.dll
- Assemblies:
- netstandard.dll, System.Runtime.dll
- Assembly:
- System.Threading.Tasks.dll
- Assembly:
- System.Runtime.dll
- Assembly:
- mscorlib.dll
- Assembly:
- netstandard.dll
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| ConfigureAwait(Boolean) | Configures an awaiter used to await thisTask. |
| ConfigureAwait(ConfigureAwaitOptions) | Configures an awaiter used to await thisTask. |
ConfigureAwait(Boolean)
- Source:
- Task.cs
- Source:
- Task.cs
- Source:
- Task.cs
- Source:
- Task.cs
Configures an awaiter used to await thisTask.
public: System::Runtime::CompilerServices::ConfiguredTaskAwaitable ConfigureAwait(bool continueOnCapturedContext);public System.Runtime.CompilerServices.ConfiguredTaskAwaitable ConfigureAwait(bool continueOnCapturedContext);member this.ConfigureAwait : bool -> System.Runtime.CompilerServices.ConfiguredTaskAwaitablePublic Function ConfigureAwait (continueOnCapturedContext As Boolean) As ConfiguredTaskAwaitableParameters
- continueOnCapturedContext
- Boolean
true to attempt to marshal the continuation back to the original context captured; otherwise,false.
Returns
An object used to await this task.
Remarks
When an asynchronous method awaits aTask directly, continuation usually occurs in the same thread that created the task, depending on the async context. This behavior can be costly in terms of performance and can result in a deadlock on the UI thread. To avoid these problems, callTask.ConfigureAwait(false). For more information, seeConfigureAwait FAQ.
See also
Applies to
ConfigureAwait(ConfigureAwaitOptions)
- Source:
- Task.cs
- Source:
- Task.cs
- Source:
- Task.cs
Configures an awaiter used to await thisTask.
public: System::Runtime::CompilerServices::ConfiguredTaskAwaitable ConfigureAwait(System::Threading::Tasks::ConfigureAwaitOptions options);public System.Runtime.CompilerServices.ConfiguredTaskAwaitable ConfigureAwait(System.Threading.Tasks.ConfigureAwaitOptions options);member this.ConfigureAwait : System.Threading.Tasks.ConfigureAwaitOptions -> System.Runtime.CompilerServices.ConfiguredTaskAwaitablePublic Function ConfigureAwait (options As ConfigureAwaitOptions) As ConfiguredTaskAwaitableParameters
- options
- ConfigureAwaitOptions
Options used to configure how awaits on this task are performed.
Returns
An object used to await this task.
Exceptions
Theoptions argument specifies an invalid value.
Applies to
Feedback
Was this page helpful?
In this article
Was this page helpful?
[8]ページ先頭