JoinableTaskFactory.Run Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
Microsoft.VisualStudio.Threading
Zestaw:
Microsoft.VisualStudio.Threading.dll
Pakiet:
Microsoft.VisualStudio.Threading v17.9.28

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

asyncMethod
Func<Task>

Metoda asynchroniczna do wykonania.

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

asyncMethod
Func<Task>

Metoda asynchroniczna do wykonania.

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

asyncMethod
Func<Task<T>>

Metoda asynchroniczna do wykonania.

creationOptions
JoinableTaskCreationOptions

Element JoinableTaskCreationOptions używany do dostosowywania zachowania zadania.

Zwraca

T

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

asyncMethod
Func<Task<T>>

Metoda asynchroniczna do wykonania.

Zwraca

T

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.

Dotyczy