PageAsyncTask Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.