Control.InvokeAsync Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Aşırı Yüklemeler

Name	Description
InvokeAsync(Func<CancellationToken,ValueTask>, CancellationToken)	Denetimin tanıtıcısına sahip olan iş parçacığında belirtilen zaman uyumsuz geri çağırmayı zaman uyumsuz olarak yürütür.
InvokeAsync(Action, CancellationToken)	Denetimin tanıtıcısına sahip olan iş parçacığında belirtilen zaman uyumlu geri çağırmayı zaman uyumsuz olarak çağırır.
InvokeAsync<T>(Func<T>, CancellationToken)	Denetimin tanıtıcısına sahip olan iş parçacığında belirtilen zaman uyumlu geri çağırmayı zaman uyumsuz olarak çağırır.
InvokeAsync<T>(Func<CancellationToken,ValueTask<T>>, CancellationToken)	Denetimin tanıtıcısına sahip olan iş parçacığında belirtilen zaman uyumsuz geri çağırmayı yürütür.

InvokeAsync(Func<CancellationToken,ValueTask>, CancellationToken)

Kaynak:

Control.cs

Denetimin tanıtıcısına sahip olan iş parçacığında belirtilen zaman uyumsuz geri çağırmayı zaman uyumsuz olarak yürütür.

public System.Threading.Tasks.Task InvokeAsync(Func<System.Threading.CancellationToken,System.Threading.Tasks.ValueTask> callback, System.Threading.CancellationToken cancellationToken = default);

member this.InvokeAsync : Func<System.Threading.CancellationToken, System.Threading.Tasks.ValueTask> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function InvokeAsync (callback As Func(Of CancellationToken, ValueTask), Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

callback

Func<CancellationToken,ValueTask>

Yürütülecek zaman uyumsuz işlev, bir CancellationToken alır ve döndürür ValueTask.

cancellationToken

CancellationToken

İptal belirteci.

Döndürülenler

Task

Zaman uyumsuz çağırma işlemini temsil eden bir görev.

Özel durumlar

InvalidOperationException

Denetimin tanıtıcısı henüz oluşturulmadı.

Açıklamalar

Geri çağırma, denetimin tanıtıcısına sahip olan iş parçacığına göre sıraya alınır ve ardından beklenir. Özel durumlar çağırana geri yayılır. Ayrıca, döndürülen görevin geri çağırma ile ilişkili görev olmadığını, kullanıcı arabirimi iş parçacığına geri çağırmayı sıralama işlemini temsil eden bir görev olduğunu da unutmayın. yerine döndüren Task bir ValueTaskgeri çağırma geçirmeniz gerekiyorsa, özgün Görevi sarmalayan yeni ValueTask(Task) bir oluşturmak için 'nin oluşturucusunu kullanınValueTask. CancellationToken hem denetimin tanıtıcısına sahip iş parçacığına geri çağırmayı düzenlerken hem de geri çağırma yürütülürken dikkate alınır.

Zaman uyumsuz bir geri çağırmayı zaman uyumsuz olarak yürütmek istiyorsanız, aşırı yüklemeyi InvokeAsync<T>(Func<T>, CancellationToken) veya aşırı yüklemeyi InvokeAsync(Action, CancellationToken)kullanın.

InvokeAsync(Action, CancellationToken)

Kaynak:

Control.cs

Denetimin tanıtıcısına sahip olan iş parçacığında belirtilen zaman uyumlu geri çağırmayı zaman uyumsuz olarak çağırır.

public System.Threading.Tasks.Task InvokeAsync(Action callback, System.Threading.CancellationToken cancellationToken = default);

member this.InvokeAsync : Action * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function InvokeAsync (callback As Action, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

callback

Action

Yürütülecek zaman uyumlu eylem.

cancellationToken

CancellationToken

İptal belirteci.

Döndürülenler

Task

Zaman uyumsuz çağırma işlemini temsil eden bir görev.

Açıklamalar

Bu yönteme bir CancellationToken geçirdiğinizde yöntemi döndürülür, ancak geri çağırma yine yürütülür. Geri çağırma kullanıcı arabirimi iş parçacığında çalışır ve kullanıcı arabirimi iş parçacığını da engeller. InvokeAsync bu durumda, yalnızca geri çağırmayı ileti kuyruğunun sonuna kuyruğa alır ve hemen döndürür, ancak geri çağırma yürütülür çalıştırılmaz ui iş parçacığını çalıştığı süre boyunca engellemeye devam eder. Bu nedenle, bir denetimin özelliğini veya benzerini güncelleştirmek gibi geri çağırmada yalnızca kısa eşitleme çalıştırma işlemlerini yürütmeniz önerilir.

Uzun süre çalışan bir işlem yürütmek istiyorsanız, aşırı yükleme InvokeAsync(Func<CancellationToken,ValueTask>, CancellationToken) veya InvokeAsync<T>(Func<CancellationToken,ValueTask<T>>, CancellationToken)kullandığınızdan emin olarak bunun yerine zaman uyumsuz geri çağırmalar kullanmayı göz önünde bulundurun.

InvokeAsync<T>(Func<T>, CancellationToken)

Kaynak:

Control.cs

Denetimin tanıtıcısına sahip olan iş parçacığında belirtilen zaman uyumlu geri çağırmayı zaman uyumsuz olarak çağırır.

public System.Threading.Tasks.Task<T> InvokeAsync<T>(Func<T> callback, System.Threading.CancellationToken cancellationToken = default);

member this.InvokeAsync : Func<'T> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'T>

Public Function InvokeAsync(Of T) (callback As Func(Of T), Optional cancellationToken As CancellationToken = Nothing) As Task(Of T)

Tür Parametreleri

T

Zaman uyumlu geri çağırmanın dönüş türü.

Parametreler

callback

Func<T>

Yürütülecek zaman uyumlu işlev.

cancellationToken

CancellationToken

İptal belirteci.

Döndürülenler

Task<T>

İşlemi temsil eden ve işlevin sonucunu içeren bir görev.

Açıklamalar

Bu yönteme bir CancellationToken geçirdiğinizde yöntemi döndürülür, ancak geri çağırma yine yürütülür. Geri çağırma kullanıcı arabirimi iş parçacığında çalışır ve kullanıcı arabirimi iş parçacığını da engeller. Bu durumda InvokeAsync yalnızca geri çağırmayı ileti kuyruğunun sonuna kuyruğa alır ve hemen döndürür, ancak geri çağırma yürütülür çalıştırılmaz kullanıcı arabirimini çalıştığı süre boyunca engellemeye devam eder. Bu nedenle, bir denetimin özelliğini veya benzerini güncelleştirmek gibi geri çağırmada yalnızca kısa eşitleme çalıştırma işlemlerini yürütmeniz önerilir.

Uzun süre çalışan bir işlem yürütmek istiyorsanız, bunun yerine aşağıda açıklanan aşırı yüklemelerle kullandığınız zaman uyumsuz geri çağırmaları InvokeAsync kullanmayı göz önünde bulundurun.

Önemli: Ayrıca, bu aşırı yüklemeyi kullanarak bu Görevin beklenmeyeceğini ancak hemen döndürüleceğini ve "engage-and-forget" özelliklerine sahip olduğunu döndüren bir geri Task çağırma geçirirseniz unutmayın. Geçirdiğiniz görevin beklenmesini istiyorsanız aşırı yüklemeyi InvokeAsync(Func<CancellationToken,ValueTask>, CancellationToken) veya InvokeAsync<T>(Func<CancellationToken,ValueTask<T>>, CancellationToken)kullandığınızdan emin olun.

InvokeAsync<T>(Func<CancellationToken,ValueTask<T>>, CancellationToken)

Kaynak:

Control.cs

Denetimin tanıtıcısına sahip olan iş parçacığında belirtilen zaman uyumsuz geri çağırmayı yürütür.

public System.Threading.Tasks.Task<T> InvokeAsync<T>(Func<System.Threading.CancellationToken,System.Threading.Tasks.ValueTask<T>> callback, System.Threading.CancellationToken cancellationToken = default);

member this.InvokeAsync : Func<System.Threading.CancellationToken, System.Threading.Tasks.ValueTask<'T>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'T>

Public Function InvokeAsync(Of T) (callback As Func(Of CancellationToken, ValueTask(Of T)), Optional cancellationToken As CancellationToken = Nothing) As Task(Of T)

Tür Parametreleri

T

Zaman uyumsuz geri çağırmanın dönüş türü.

Parametreler

callback

Func<CancellationToken,ValueTask<T>>

Yürütülecek zaman uyumsuz işlev, bir CancellationToken alır ve döndürür ValueTask<TResult>.

cancellationToken

CancellationToken

İptal belirteci.

Döndürülenler

Task<T>

İşlemi temsil eden ve işlevin tür Tsonucunu içeren bir görev.

Özel durumlar

InvalidOperationException

Denetimin tanıtıcısı henüz oluşturulmadı.

Açıklamalar

Geri çağırma, denetimin tanıtıcısına sahip olan iş parçacığına göre sıraya alınır ve ardından beklenir. Özel durumlar çağırana geri yayılır. Ayrıca, döndürülen görevin geri çağırma ile ilişkili görev olmadığını, kullanıcı arabirimi iş parçacığına geri çağırmayı sıralama işlemini temsil eden bir görev olduğunu da unutmayın. yerine döndüren Task<TResult> bir ValueTask<TResult>geri çağırma geçirmeniz gerekiyorsa, özgün Görevi sarmalayan yeni ValueTask<TResult>(Task<TResult>) bir oluşturmak için 'nin oluşturucusunu kullanınValueTask<TResult>. CancellationToken hem denetimin tanıtıcısına sahip iş parçacığına geri çağırmayı düzenlerken hem de geri çağırma yürütülürken dikkate alınır.

Zaman uyumsuz bir geri çağırmayı zaman uyumsuz olarak yürütmek istiyorsanız, aşırı yüklemeyi InvokeAsync<T>(Func<T>, CancellationToken) veya aşırı yüklemeyi InvokeAsync(Action, CancellationToken)kullanın.