JoinableTaskFactory.Run Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Przeciążenia
Run(Func<Task>) |
Uruchamia określoną metodę asynchroniczną w celu ukończenia, a synchronicznie blokuje wątek wywołujący. |
Run(Func<Task>, JoinableTaskCreationOptions) |
Uruchamia określoną metodę asynchroniczną w celu ukończenia, a synchronicznie blokuje wątek wywołujący. |
Run<T>(Func<Task<T>>, JoinableTaskCreationOptions) |
Uruchamia określoną metodę asynchroniczną w celu ukończenia, a synchronicznie blokuje wątek wywołujący. |
Run<T>(Func<Task<T>>) |
Uruchamia określoną metodę asynchroniczną w celu ukończenia, a synchronicznie blokuje wątek wywołujący. |
Run(Func<Task>)
Uruchamia określoną metodę asynchroniczną w celu ukończenia, a synchronicznie blokuje wątek wywołujący.
public:
void Run(Func<System::Threading::Tasks::Task ^> ^ asyncMethod);
public void Run (Func<System.Threading.Tasks.Task> asyncMethod);
member this.Run : Func<System.Threading.Tasks.Task> -> unit
Public Sub Run (asyncMethod As Func(Of Task))
Parametry
Uwagi
Każdy wyjątek zgłoszony przez delegata jest ponownie wprowadzany w oryginalnym typie do obiektu wywołującego tej metody.
Po wznowieniu delegata z wydajności oczekiwania domyślne zachowanie jest wznowienie w oryginalnym kontekście, jak zwykłe wykonanie metody asynchronicznej. Jeśli na przykład obiekt wywołujący był w wątku głównym, wykonanie zostanie wznowione po oczekiwaniu na główny wątek; ale jeśli został uruchomiony w wątku wątku wątku, zostanie wznowione w wątku wątku puli wątków.
// On threadpool or Main thread, this method will block
// the calling thread until all async operations in the
// delegate complete.
joinableTaskFactory.Run(async delegate {
// still on the threadpool or Main thread as before.
await OperationAsync();
// still on the threadpool or Main thread as before.
await Task.Run(async delegate {
// Now we're on a threadpool thread.
await Task.Yield();
// still on a threadpool thread.
});
// Now back on the Main thread (or threadpool thread if that's where we started).
});
Dotyczy
Run(Func<Task>, JoinableTaskCreationOptions)
Uruchamia określoną metodę asynchroniczną w celu ukończenia, a synchronicznie blokuje wątek wywołujący.
public:
void Run(Func<System::Threading::Tasks::Task ^> ^ asyncMethod, Microsoft::VisualStudio::Threading::JoinableTaskCreationOptions creationOptions);
public void Run (Func<System.Threading.Tasks.Task> asyncMethod, Microsoft.VisualStudio.Threading.JoinableTaskCreationOptions creationOptions);
member this.Run : Func<System.Threading.Tasks.Task> * Microsoft.VisualStudio.Threading.JoinableTaskCreationOptions -> unit
Public Sub Run (asyncMethod As Func(Of Task), creationOptions As JoinableTaskCreationOptions)
Parametry
- creationOptions
- JoinableTaskCreationOptions
Element JoinableTaskCreationOptions używany do dostosowywania zachowania zadania.
Dotyczy
Run<T>(Func<Task<T>>, JoinableTaskCreationOptions)
Uruchamia określoną metodę asynchroniczną w celu ukończenia, a synchronicznie blokuje wątek wywołujący.
public:
generic <typename T>
T Run(Func<System::Threading::Tasks::Task<T> ^> ^ asyncMethod, Microsoft::VisualStudio::Threading::JoinableTaskCreationOptions creationOptions);
public T Run<T> (Func<System.Threading.Tasks.Task<T>> asyncMethod, Microsoft.VisualStudio.Threading.JoinableTaskCreationOptions creationOptions);
member this.Run : Func<System.Threading.Tasks.Task<'T>> * Microsoft.VisualStudio.Threading.JoinableTaskCreationOptions -> 'T
Public Function Run(Of T) (asyncMethod As Func(Of Task(Of T)), creationOptions As JoinableTaskCreationOptions) As T
Parametry typu
- T
Typ wartości zwracanej przez operację asynchroniczną.
Parametry
- creationOptions
- JoinableTaskCreationOptions
Element JoinableTaskCreationOptions używany do dostosowywania zachowania zadania.
Zwraca
Wynik zadania zwrócony przez asyncMethod
.
Uwagi
Każdy wyjątek zgłoszony przez delegata jest ponownie wprowadzany w oryginalnym typie do obiektu wywołującego tej metody.
Po wznowieniu delegata z wydajności oczekiwania domyślne zachowanie jest wznowienie w oryginalnym kontekście, jak zwykłe wykonanie metody asynchronicznej. Jeśli na przykład obiekt wywołujący był w wątku głównym, wykonanie zostanie wznowione po oczekiwaniu na główny wątek; ale jeśli został uruchomiony w wątku wątku wątku, zostanie wznowione w wątku wątku puli wątków.
// On threadpool or Main thread, this method will block
// the calling thread until all async operations in the
// delegate complete.
joinableTaskFactory.Run(async delegate {
// still on the threadpool or Main thread as before.
await OperationAsync();
// still on the threadpool or Main thread as before.
await Task.Run(async delegate {
// Now we're on a threadpool thread.
await Task.Yield();
// still on a threadpool thread.
});
// Now back on the Main thread (or threadpool thread if that's where we started).
});
Dotyczy
Run<T>(Func<Task<T>>)
Uruchamia określoną metodę asynchroniczną w celu ukończenia, a synchronicznie blokuje wątek wywołujący.
public:
generic <typename T>
T Run(Func<System::Threading::Tasks::Task<T> ^> ^ asyncMethod);
public T Run<T> (Func<System.Threading.Tasks.Task<T>> asyncMethod);
member this.Run : Func<System.Threading.Tasks.Task<'T>> -> 'T
Public Function Run(Of T) (asyncMethod As Func(Of Task(Of T))) As T
Parametry typu
- T
Typ wartości zwracanej przez operację asynchroniczną.
Parametry
Zwraca
Wynik zadania zwrócony przez asyncMethod
.
Uwagi
Każdy wyjątek zgłoszony przez delegata jest ponownie wprowadzany w oryginalnym typie do obiektu wywołującego tej metody.
Po wznowieniu delegata z wydajności oczekiwania domyślne zachowanie jest wznowienie w oryginalnym kontekście, jak zwykłe wykonanie metody asynchronicznej. Jeśli na przykład obiekt wywołujący był w wątku głównym, wykonanie zostanie wznowione po oczekiwaniu na główny wątek; ale jeśli został uruchomiony w wątku wątku wątku, zostanie wznowione w wątku wątku puli wątków.
Zapoznaj się z dokumentacją Run(Func<Task>) przeciążenia, aby zapoznać się z przykładem.