PageAsyncTask Construtores

Definição

Espaço de Nomes:: System.Web.UI

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da PageAsyncTask classe.

Sobrecargas

Name	Description
PageAsyncTask(Func<CancellationToken,Task>)	Inicializa uma nova instância da PageAsyncTask classe usando um gestor de eventos que permite cancelar a tarefa.
PageAsyncTask(Func<Task>)	Inicializa uma nova instância da PageAsyncTask classe usando um gestor 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 gestor de eventos que permite cancelar a tarefa.

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 gestor de eventos.

Observações

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

Aplica-se a

PageAsyncTask(Func<Task>)

Inicializa uma nova instância da PageAsyncTask classe usando um gestor 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 gestor 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 handler a chamar ao iniciar uma tarefa assíncrona.

endHandler: EndEventHandler

O handler para chamar quando a tarefa for concluída com sucesso dentro do período de time-out.

timeoutHandler: EndEventHandler

O handler para chamar quando a tarefa não é concluída com sucesso dentro do período de time-out.

state: Object

O objeto que representa o estado da tarefa.

Exceções

ArgumentNullException

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

Observações

Esta 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 handler a chamar ao iniciar uma tarefa assíncrona.

endHandler: EndEventHandler

O handler para chamar quando a tarefa for concluída com sucesso dentro do período de time-out.

timeoutHandler: EndEventHandler

O handler para chamar quando a tarefa não é concluída com sucesso dentro do período de time-out.

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

ArgumentNullException

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

Exemplos

O exemplo de código seguinte cria três tarefas assíncronas que são processadas em paralelo umas com as outras. Este exemplo faz parte de um exemplo maior encontrado na PageAsyncTask visão geral da 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)

Observações

Esta implementação do construtor permite-lhe definir se a tarefa assíncrona será processada em paralelo com outras tarefas na página.

Aplica-se a

Comentários

Esta página foi útil?