Compartilhar via


PageAsyncTask Construtores

Definição

Inicializa uma nova instância da classe PageAsyncTask.

Sobrecargas

Nome Description
PageAsyncTask(Func<CancellationToken,Task>)

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

PageAsyncTask(Func<Task>)

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

PageAsyncTask(BeginEventHandler, EndEventHandler, EndEventHandler, Object)

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

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

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

PageAsyncTask(Func<CancellationToken,Task>)

Inicializa uma nova instância da PageAsyncTask classe 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 código assíncrono (baseado em Task objetos) com o recurso de páginas assíncronas do ASP.NET Web Forms existente. ASP.NET sinalizará o CancellationToken objeto que é passado para um TaskEventHandler delegado para cancelamento com base no AsyncTimeout conjunto de atributos 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 PageAsyncTask classe usando um manipulador de eventos que permite que a tarefa seja tratada.

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 PageAsyncTask classe usando o valor padrão para 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 ser chamado ao iniciar uma tarefa assíncrona.

endHandler
EndEventHandler

O manipulador a ser chamado quando a tarefa for concluída com êxito dentro do período de tempo limite.

timeoutHandler
EndEventHandler

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

state
Object

O objeto que representa o estado da tarefa.

Exceções

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

Comentários

Essa implementação do construtor define a ExecuteInParallel propriedade para false que 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 PageAsyncTask classe usando o valor especificado para 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 ser chamado ao iniciar uma tarefa assíncrona.

endHandler
EndEventHandler

O manipulador a ser chamado quando a tarefa for concluída com êxito dentro do período de tempo limite.

timeoutHandler
EndEventHandler

O manipulador a ser chamado quando a tarefa não for 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 com outras tarefas.

Exceções

O beginHandler parâmetro ou endHandler parâmetro 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