Partilhar via


PageAsyncTask Construtores

Definição

Inicializa uma nova instância da classe PageAsyncTask.

Sobrecargas

PageAsyncTask(Func<CancellationToken,Task>)

Inicializa uma nova instância da classe PageAsyncTask usando um manipulador de eventos que permite que a tarefa seja cancelada.

PageAsyncTask(Func<Task>)

Inicializa uma nova instância da classe PageAsyncTask usando um manipulador de eventos que permite que a tarefa seja manipulada.

PageAsyncTask(BeginEventHandler, EndEventHandler, EndEventHandler, Object)

Inicializa uma nova instância da classe PageAsyncTask usando o valor padrão para a execução em paralelo.

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

Inicializa uma nova instância da classe PageAsyncTask usando o valor especificado para a execução em paralelo.

PageAsyncTask(Func<CancellationToken,Task>)

Inicializa uma nova instância da classe PageAsyncTask usando um manipulador de eventos que permite que a tarefa seja cancelada.

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))

Parâmetros

handler
Func<CancellationToken,Task>

Um manipulador de eventos.

Comentários

Esse construtor encapsula um TaskEventHandler delegado para que o PageAsyncTask objeto possa integrar o código assíncrono (com base em Task objetos) com o recurso de páginas assíncronas ASP.NET Web Forms existente. ASP.NET sinalizará o CancellationToken objeto que é passado para um TaskEventHandler delegado para cancelamento com base no AsyncTimeout atributo definido na @ Page diretiva da página da Web. Quando o AsyncTimeout valor for atingido, o CancellationToken objeto será sinalizado. O CancellationToken parâmetro deve ser passado para qualquer APIs assíncronas que são chamadas pela implementação da TaskEventHandler classe.

Aplica-se a

PageAsyncTask(Func<Task>)

Inicializa uma nova instância da classe PageAsyncTask usando um manipulador de eventos que permite que a tarefa seja manipulada.

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))

Parâmetros

handler
Func<Task>

Um manipulador de eventos.

Aplica-se a

PageAsyncTask(BeginEventHandler, EndEventHandler, EndEventHandler, Object)

Inicializa uma nova instância da classe PageAsyncTask usando o valor padrão para a execução em paralelo.

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)

Parâmetros

beginHandler
BeginEventHandler

O manipulador a chamar ao iniciar uma tarefa assíncrona.

endHandler
EndEventHandler

O manipulador a chamar quando a tarefa foi concluída com êxito dentro do período de tempo limite.

timeoutHandler
EndEventHandler

O manipulador a chamar quando a tarefa não foi concluída com êxito dentro do período de tempo limite.

state
Object

O objeto que representa o estado da tarefa.

Exceções

O parâmetro beginHandler ou o parâmetro endHandler não é especificado.

Comentários

Essa implementação do construtor define a ExecuteInParallel propriedade para que false a tarefa assíncrona não seja processada em paralelo com outras tarefas na página.

Aplica-se a

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

Inicializa uma nova instância da classe PageAsyncTask usando o valor especificado para a execução em paralelo.

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)

Parâmetros

beginHandler
BeginEventHandler

O manipulador a chamar ao iniciar uma tarefa assíncrona.

endHandler
EndEventHandler

O manipulador a chamar quando a tarefa foi concluída com êxito dentro do período de tempo limite.

timeoutHandler
EndEventHandler

O manipulador a chamar quando a tarefa não foi concluída com êxito dentro do período de tempo limite.

state
Object

O objeto que representa o estado da tarefa.

executeInParallel
Boolean

O valor que indica se a tarefa pode ser processada em paralelo a outras tarefas.

Exceções

O parâmetro beginHandler ou o parâmetro endHandler não é especificado.

Exemplos

O exemplo de código a seguir cria três tarefas assíncronas que são processadas paralelamente umas às outras. Este exemplo faz parte de um exemplo maior encontrado na visão geral da PageAsyncTask classe.

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)

Comentários

Essa implementação do construtor permite que você defina se a tarefa assíncrona será processada em paralelo com outras tarefas na página.

Aplica-se a