Freigeben über


PageAsyncTask Konstruktoren

Definition

Initialisiert eine neue Instanz der PageAsyncTask-Klasse.

Überlädt

PageAsyncTask(Func<CancellationToken,Task>)

Initialisiert eine neue Instanz der PageAsyncTask-Klasse unter Verwendung eines Ereignishandlers, der ermöglicht, dass die Aufgabe abgebrochen werden kann.

PageAsyncTask(Func<Task>)

Initialisiert eine neue Instanz der PageAsyncTask-Klasse unter Verwendung eines Ereignishandlers, der ermöglicht, dass die Aufgabe verarbeitet werden kann.

PageAsyncTask(BeginEventHandler, EndEventHandler, EndEventHandler, Object)

Initialisiert eine neue Instanz der PageAsyncTask-Klasse, die den Standardwert zum parallelen Ausführen verwendet.

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

Initialisiert eine neue Instanz der PageAsyncTask-Klasse, die den angegebenen Wert zum parallelen Ausführen verwendet.

PageAsyncTask(Func<CancellationToken,Task>)

Initialisiert eine neue Instanz der PageAsyncTask-Klasse unter Verwendung eines Ereignishandlers, der ermöglicht, dass 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 eine TaskEventHandler Stellvertretung, damit das PageAsyncTask Objekt asynchronen Code (basierend auf Task Objekten) mit dem vorhandenen ASP.NET Web Forms asynchronen Seitenfeature integrieren kann. ASP.NET signalisiert das CancellationToken Objekt, das an einen TaskEventHandler Stellvertretung für eine Abbruch übergeben wird, basierend auf dem Attributsatz in der AsyncTimeout @ Page Richtlinie der Webseite. Wenn der Wert erreicht wurde, wird das AsyncTimeout 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 unter Verwendung eines Ereignishandlers, der ermöglicht, dass die Aufgabe verarbeitet werden kann.

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, die den Standardwert zum parallelen Ausführen verwendet.

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 zu Beginn einer asynchronen Aufgabe aufgerufen werden soll.

endHandler
EndEventHandler

Der Handler, der aufgerufen werden soll, wenn die Aufgabe im Timeoutzeitraum erfolgreich abgeschlossen wird.

timeoutHandler
EndEventHandler

Der Handler, der aufgerufen werden soll, wenn die Aufgabe im Timeoutzeitraum nicht erfolgreich abgeschlossen wird.

state
Object

Das Objekt, das den Zustand der Aufgabe darstellt.

Ausnahmen

Der beginHandler-Parameter oder der endHandler-Parameter ist nicht angegeben.

Hinweise

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

Gilt für

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

Initialisiert eine neue Instanz der PageAsyncTask-Klasse, die den angegebenen Wert zum parallelen Ausführen verwendet.

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 zu Beginn einer asynchronen Aufgabe aufgerufen werden soll.

endHandler
EndEventHandler

Der Handler, der aufgerufen werden soll, wenn die Aufgabe im Timeoutzeitraum erfolgreich abgeschlossen wird.

timeoutHandler
EndEventHandler

Der Handler, der aufgerufen werden soll, wenn die Aufgabe im Timeoutzeitraum nicht erfolgreich abgeschlossen wird.

state
Object

Das Objekt, das den Zustand der Aufgabe darstellt.

executeInParallel
Boolean

Der Wert, der angibt, ob die Aufgabe parallel mit anderen Aufgaben verarbeitet werden kann.

Ausnahmen

Der beginHandler-Parameter oder der endHandler-Parameter ist nicht angegeben.

Beispiele

Im folgenden Codebeispiel werden drei asynchrone Vorgänge erstellt, die parallel zueinander verarbeitet werden. In diesem Beispiel handelt es sich um ein größeres Beispiel, das in der PageAsyncTask Klassenübersicht gefunden wurde.

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 Vorgängen auf der Seite verarbeitet wird.

Gilt für