PageAsyncTask Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.