Freigeben über


PageAsyncTask Konstruktoren

Definition

Initialisiert eine neue Instanz der PageAsyncTask-Klasse.

Überlädt

Name Beschreibung
PageAsyncTask(Func<CancellationToken,Task>)

Initialisiert eine neue Instanz der PageAsyncTask Klasse mithilfe eines Ereignishandlers, mit dem die Aufgabe abgebrochen werden kann.

PageAsyncTask(Func<Task>)

Initialisiert eine neue Instanz der PageAsyncTask Klasse mithilfe eines Ereignishandlers, der die Verarbeitung der Aufgabe ermöglicht.

PageAsyncTask(BeginEventHandler, EndEventHandler, EndEventHandler, Object)

Initialisiert eine neue Instanz der PageAsyncTask Klasse mithilfe des Standardwerts für die parallele Ausführung.

PageAsyncTask(BeginEventHandler, EndEventHandler, EndEventHandler, Object, Boolean)

Initialisiert eine neue Instanz der PageAsyncTask Klasse mithilfe des angegebenen Werts für die parallele Ausführung.

PageAsyncTask(Func<CancellationToken,Task>)

Initialisiert eine neue Instanz der PageAsyncTask Klasse mithilfe eines Ereignishandlers, mit dem die Aufgabe abgebrochen werden kann.

public:
 PageAsyncTask(Func<System::Threading::CancellationToken, System::Threading::Tasks::Task ^> ^ handler);
public PageAsyncTask(Func<System.Threading.CancellationToken,System.Threading.Tasks.Task> handler);
new System.Web.UI.PageAsyncTask : Func<System.Threading.CancellationToken, System.Threading.Tasks.Task> -> System.Web.UI.PageAsyncTask
Public Sub New (handler As Func(Of CancellationToken, Task))

Parameter

handler
Func<CancellationToken,Task>

Ein Ereignishandler.

Hinweise

Dieser Konstruktor umschließt einen TaskEventHandler Delegaten, sodass das PageAsyncTask Objekt asynchronen Code (basierend auf Task Objekten) in das vorhandene feature ASP.NET Web Forms asynchrone Seiten integrieren kann. ASP.NET signalisiert das CancellationToken Objekt, das basierend auf dem AsyncTimeout Attribut in der @ Page Direktive der Webseite an einen TaskEventHandler Delegaten zur Abbruch übergeben wird. Wenn der AsyncTimeout Wert erreicht wurde, wird das CancellationToken Objekt signalisiert. Der CancellationToken Parameter muss an alle asynchronen APIs übergeben werden, die von der Implementierung der TaskEventHandler Klasse aufgerufen werden.

Gilt für:

PageAsyncTask(Func<Task>)

Initialisiert eine neue Instanz der PageAsyncTask Klasse mithilfe eines Ereignishandlers, der die Verarbeitung der Aufgabe ermöglicht.

public:
 PageAsyncTask(Func<System::Threading::Tasks::Task ^> ^ handler);
public PageAsyncTask(Func<System.Threading.Tasks.Task> handler);
new System.Web.UI.PageAsyncTask : Func<System.Threading.Tasks.Task> -> System.Web.UI.PageAsyncTask
Public Sub New (handler As Func(Of Task))

Parameter

handler
Func<Task>

Ein Ereignishandler.

Gilt für:

PageAsyncTask(BeginEventHandler, EndEventHandler, EndEventHandler, Object)

Initialisiert eine neue Instanz der PageAsyncTask Klasse mithilfe des Standardwerts für die parallele Ausführung.

public:
 PageAsyncTask(System::Web::BeginEventHandler ^ beginHandler, System::Web::EndEventHandler ^ endHandler, System::Web::EndEventHandler ^ timeoutHandler, System::Object ^ state);
public PageAsyncTask(System.Web.BeginEventHandler beginHandler, System.Web.EndEventHandler endHandler, System.Web.EndEventHandler timeoutHandler, object state);
new System.Web.UI.PageAsyncTask : System.Web.BeginEventHandler * System.Web.EndEventHandler * System.Web.EndEventHandler * obj -> System.Web.UI.PageAsyncTask
Public Sub New (beginHandler As BeginEventHandler, endHandler As EndEventHandler, timeoutHandler As EndEventHandler, state As Object)

Parameter

beginHandler
BeginEventHandler

Der Handler, der beim Starten einer asynchronen Aufgabe aufgerufen werden soll.

endHandler
EndEventHandler

Der Handler, der aufgerufen werden soll, wenn die Aufgabe innerhalb des Timeoutzeitraums erfolgreich abgeschlossen wird.

timeoutHandler
EndEventHandler

Der Handler, der aufgerufen werden soll, wenn die Aufgabe nicht innerhalb des Timeoutzeitraums erfolgreich abgeschlossen wird.

state
Object

Das Objekt, das den Status der Aufgabe darstellt.

Ausnahmen

Der beginHandler Parameter oder endHandler Parameter ist nicht angegeben.

Hinweise

Diese Implementierung des Konstruktors legt die ExecuteInParallel Eigenschaft so fest, false dass die asynchrone Aufgabe nicht parallel zu anderen Aufgaben auf der Seite verarbeitet wird.

Gilt für:

PageAsyncTask(BeginEventHandler, EndEventHandler, EndEventHandler, Object, Boolean)

Initialisiert eine neue Instanz der PageAsyncTask Klasse mithilfe des angegebenen Werts für die parallele Ausführung.

public:
 PageAsyncTask(System::Web::BeginEventHandler ^ beginHandler, System::Web::EndEventHandler ^ endHandler, System::Web::EndEventHandler ^ timeoutHandler, System::Object ^ state, bool executeInParallel);
public PageAsyncTask(System.Web.BeginEventHandler beginHandler, System.Web.EndEventHandler endHandler, System.Web.EndEventHandler timeoutHandler, object state, bool executeInParallel);
new System.Web.UI.PageAsyncTask : System.Web.BeginEventHandler * System.Web.EndEventHandler * System.Web.EndEventHandler * obj * bool -> System.Web.UI.PageAsyncTask
Public Sub New (beginHandler As BeginEventHandler, endHandler As EndEventHandler, timeoutHandler As EndEventHandler, state As Object, executeInParallel As Boolean)

Parameter

beginHandler
BeginEventHandler

Der Handler, der beim Starten einer asynchronen Aufgabe aufgerufen werden soll.

endHandler
EndEventHandler

Der Handler, der aufgerufen werden soll, wenn die Aufgabe innerhalb des Timeoutzeitraums erfolgreich abgeschlossen wird.

timeoutHandler
EndEventHandler

Der Handler, der aufgerufen werden soll, wenn die Aufgabe nicht innerhalb des Timeoutzeitraums erfolgreich abgeschlossen wird.

state
Object

Das Objekt, das den Status der Aufgabe darstellt.

executeInParallel
Boolean

Der Wert, der angibt, ob der Vorgang parallel zu anderen Vorgängen verarbeitet werden kann.

Ausnahmen

Der beginHandler Parameter oder endHandler Parameter ist nicht angegeben.

Beispiele

Im folgenden Codebeispiel werden drei asynchrone Aufgaben erstellt, die parallel zueinander verarbeitet werden. Dieses Beispiel ist Teil eines größeren Beispiels, das in der PageAsyncTask Klassenübersicht zu finden ist.

PageAsyncTask asyncTask1 = new PageAsyncTask(slowTask1.OnBegin, slowTask1.OnEnd, slowTask1.OnTimeout, "Async1", true);
PageAsyncTask asyncTask2 = new PageAsyncTask(slowTask2.OnBegin, slowTask2.OnEnd, slowTask2.OnTimeout, "Async2", true);
PageAsyncTask asyncTask3 = new PageAsyncTask(slowTask3.OnBegin, slowTask3.OnEnd, slowTask3.OnTimeout, "Async3", true);

// Register the asynchronous task.
Page.RegisterAsyncTask(asyncTask1);
Page.RegisterAsyncTask(asyncTask2);
Page.RegisterAsyncTask(asyncTask3);
Dim asyncTask1 As New PageAsyncTask(AddressOf slowTask1.OnBegin, AddressOf slowTask1.OnEnd, AddressOf slowTask1.OnTimeout, "Async1", True)
Dim asyncTask2 As New PageAsyncTask(AddressOf slowTask2.OnBegin, AddressOf slowTask2.OnEnd, AddressOf slowTask2.OnTimeout, "Async2", True)
Dim asyncTask3 As New PageAsyncTask(AddressOf slowTask3.OnBegin, AddressOf slowTask3.OnEnd, AddressOf slowTask3.OnTimeout, "Async3", True)

' Register the asynchronous task.
Page.RegisterAsyncTask(asyncTask1)
Page.RegisterAsyncTask(asyncTask2)
Page.RegisterAsyncTask(asyncTask3)

Hinweise

Mit dieser Implementierung des Konstruktors können Sie festlegen, ob die asynchrone Aufgabe parallel zu anderen Aufgaben auf der Seite verarbeitet wird.

Gilt für: