PageAsyncTask Класс

Определение

Содержит информацию относительно асинхронной задачи, зарегистрированной на странице.Contains information about an asynchronous task registered to a page. Этот класс не наследуется.This class cannot be inherited.

public ref class PageAsyncTask sealed
public sealed class PageAsyncTask
type PageAsyncTask = class
Public NotInheritable Class PageAsyncTask
Наследование
PageAsyncTask

Примеры

В следующем примере кода три асинхронных задачи регистрируются на странице и выполняются параллельно.The following code example registers three asynchronous tasks to a page and executes them in parallel. Каждая задача вызывает метод, который просто приводит к переходу потока в спящий режим в течение 5 секунд.Each task calls a method that merely causes the thread to sleep for 5 seconds.

<%@ Page Language="C#" Async="true" AsyncTimeout="35"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    
  protected void Page_Load(object sender, EventArgs e)
  {
      
    // Define the asynchronuous task.
    Samples.AspNet.CS.Controls.SlowTask slowTask1 =    
      new Samples.AspNet.CS.Controls.SlowTask();
    Samples.AspNet.CS.Controls.SlowTask slowTask2 =
    new Samples.AspNet.CS.Controls.SlowTask();
    Samples.AspNet.CS.Controls.SlowTask slowTask3 =
    new Samples.AspNet.CS.Controls.SlowTask();
    
    // <Snippet3> 
    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);
    // </Snippet3>
      
    // Execute the register asynchronous task.
    Page.ExecuteRegisteredAsyncTasks();

    TaskMessage.InnerHtml = slowTask1.GetAsyncTaskProgress()+ "<br />" + slowTask2.GetAsyncTaskProgress() + "<br />" + slowTask3.GetAsyncTaskProgress();

  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Asynchronous Task Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <span id="TaskMessage" runat="server">
      </span>
    </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
      
        ' Define the asynchronuous task.
        Dim slowTask1 As New Samples.AspNet.VB.Controls.SlowTask()
        Dim slowTask2 As New Samples.AspNet.VB.Controls.SlowTask()
        Dim slowTask3 As New Samples.AspNet.VB.Controls.SlowTask()
     
        ' <Snippet3>
        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)
        ' </Snippet3>
      
        ' Execute the register asynchronous task.
        Page.ExecuteRegisteredAsyncTasks()

        TaskMessage.InnerHtml = slowTask1.GetAsyncTaskProgress() + "<br />" + slowTask2.GetAsyncTaskProgress() + "<br />" + slowTask3.GetAsyncTaskProgress()

    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    <span id="TaskMessage" runat="server">
      </span>
    </div>
    </form>
</body>
</html>
using System;
using System.Web;
using System.Web.UI;
using System.Threading;

namespace Samples.AspNet.CS.Controls
{
    public class SlowTask
    {
        private String _taskprogress;
        private AsyncTaskDelegate _dlgt;

        // Create delegate.
        protected delegate void AsyncTaskDelegate();

        public String GetAsyncTaskProgress()
        {
            return _taskprogress;
        }
        public void ExecuteAsyncTask()
        {
            // Introduce an artificial delay to simulate a delayed 
            // asynchronous task.
            Thread.Sleep(TimeSpan.FromSeconds(5.0));
        }

        // Define the method that will get called to
        // start the asynchronous task.
        public IAsyncResult OnBegin(object sender, EventArgs e,
            AsyncCallback cb, object extraData)
        {
            _taskprogress = "AsyncTask started at: " + DateTime.Now + ". ";

            _dlgt = new AsyncTaskDelegate(ExecuteAsyncTask);
            IAsyncResult result = _dlgt.BeginInvoke(cb, extraData);

            return result;
        }

        // Define the method that will get called when
        // the asynchronous task is ended.
        public void OnEnd(IAsyncResult ar)
        {
            _taskprogress += "AsyncTask completed at: " + DateTime.Now;
            _dlgt.EndInvoke(ar);
        }

        // Define the method that will get called if the task
        // is not completed within the asynchronous timeout interval.
        public void OnTimeout(IAsyncResult ar)
        {
            _taskprogress += "AsyncTask failed to complete " +
                "because it exceeded the AsyncTimeout parameter.";
        }
    }
}
Imports System.Threading

Namespace Samples.AspNet.VB.Controls

    Public Class SlowTask
        Private _taskprogress As String
        Private _dlgt As AsyncTaskDelegate

        ' Create delegate.
        Protected Delegate Sub AsyncTaskDelegate()

        Public Function GetAsyncTaskProgress() As String
            Return _taskprogress
        End Function

        Public Sub ExecuteAsyncTask()
            ' Introduce an artificial delay to simulate a delayed 
            ' asynchronous task.
            Thread.Sleep(TimeSpan.FromSeconds(5.0))
        End Sub

        ' Define the method that will get called to
        ' start the asynchronous task.
        Public Function OnBegin(ByVal sender As Object, ByVal e As EventArgs, ByVal cb As AsyncCallback, ByVal extraData As Object) As IAsyncResult
            _taskprogress = "AsyncTask started at: " + DateTime.Now.ToString + ". "

            _dlgt = New AsyncTaskDelegate(AddressOf ExecuteAsyncTask)
            Dim result As IAsyncResult = _dlgt.BeginInvoke(cb, extraData)

            Return result
        End Function

        ' Define the method that will get called when
        ' the asynchronous task is ended.
        Public Sub OnEnd(ByVal ar As IAsyncResult)
            _taskprogress += "AsyncTask completed at: " + DateTime.Now.ToString
            _dlgt.EndInvoke(ar)
        End Sub


        ' Define the method that will get called if the task
        ' is not completed within the asynchronous timeout interval.
        Public Sub OnTimeout(ByVal ar As IAsyncResult)
            _taskprogress += "AsyncTask failed to complete " + _
                "because it exceeded the AsyncTimeout parameter."
        End Sub
    End Class
End Namespace

Комментарии

ASP.NET версии 2,0 позволяет регистрировать несколько задач на странице и выполнять их асинхронно перед визуализацией страницы.ASP.NET version 2.0 allows you to register multiple tasks to a page and run them asynchronously prior to rendering the page. Вы можете указать, что задача должна выполняться асинхронно, если это процесс является очень длительным, и не нужно, чтобы другие процессы были связаны во время выполнения.You might specify that a task be run asynchronously if it is a slow process and you do not want other processes to be tied up while it is executing. Асинхронные задачи могут выполняться параллельно или последовательно.The asynchronous tasks can be executed in parallel or sequentially.

Объект должен быть зарегистрирован на странице с RegisterAsyncTask помощью метода. PageAsyncTaskA PageAsyncTask object must be registered to the page through the RegisterAsyncTask method. Сама страница не должна обрабатываться асинхронно для выполнения асинхронных задач.The page itself does not have to be processed asynchronously to execute asynchronous tasks. Можно задать Async false для атрибута значение (как показано в следующем примере кода) или директиву Page, и асинхронные задачи будут обрабатываться асинхронно: trueYou can set the Async attribute to either true (as shown in the following code example) or false on the page directive and the asynchronous tasks will still be processed asynchronously:

<%@ Page Async="true" %>

Если атрибут имеет falseзначение, то поток, выполняющий страницу, будет заблокирован до тех пор, пока не будут выполнены все асинхронные задачи. AsyncWhen the Async attribute is set to false, the thread that executes the page will be blocked until all asynchronous tasks are complete.

Все асинхронные задачи, зарегистрированные до события, PreRenderComplete будут автоматически выполняться страницей, если они еще не были выполнены.Any asynchronous tasks registered before the PreRenderComplete event will be executed automatically by the page if they have not already been executed. Эти асинхронные задачи, зарегистрированные после события, PreRenderComplete должны выполняться явным образом с ExecuteRegisteredAsyncTasks помощью метода.Those asynchronous tasks registered after the PreRenderComplete event must be executed explicitly through the ExecuteRegisteredAsyncTasks method. Метод также можно использовать для запуска задач PreRenderComplete перед событием. ExecuteRegisteredAsyncTasksThe ExecuteRegisteredAsyncTasks method can also be used to start tasks before the PreRenderComplete event. ExecuteRegisteredAsyncTasks Метод выполняет все зарегистрированные асинхронные задачи на странице, которые не были выполнены.The ExecuteRegisteredAsyncTasks method executes all the registered asynchronous tasks on the page that have not been executed.

По умолчанию время ожидания асинхронной задачи истечет, если оно не было завершено в течение 45 секунд.By default, an asynchronous task will time out if it has not completed within 45 seconds. Можно указать другое значение времени ожидания в файле Web. config или в директиве Page.You can specify a different time-out value in either the Web.config file or the page directive. Раздел файла Web. config asyncTimeout содержит атрибут, как показано ниже. <pages>The <pages> section of the Web.config file contains an asyncTimeout attribute, as shown below.

<system.web>

<pages asyncTimeout="30">

</pages>

</system.web>

Директива Page содержит AsyncTimeout атрибут.The page directive contains an AsyncTimeout attribute.

<%@ Page AsyncTimeout="30" %>

Конструкторы

PageAsyncTask(BeginEventHandler, EndEventHandler, EndEventHandler, Object)

Инициализирует новый экземпляр класса PageAsyncTask с использованием заданного по умолчанию значения для параллельного выполнения.Initializes a new instance of the PageAsyncTask class using the default value for executing in parallel.

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

Инициализирует новый экземпляр класса PageAsyncTask с использованием указанного значения для параллельного выполнения.Initializes a new instance of the PageAsyncTask class using the specified value for executing in parallel.

PageAsyncTask(Func<CancellationToken,Task>)

Инициализирует новый экземпляр класса PageAsyncTask, используя обработчик событий, позволяющий отменить задачу.Initializes a new instance of the PageAsyncTask class using an event handler that enables the task to be canceled.

PageAsyncTask(Func<Task>)

Инициализирует новый экземпляр класса PageAsyncTask, используя обработчик событий, позволяющий обработать задачу.Initializes a new instance of the PageAsyncTask class using an event handler that enables the task to be handled.

Свойства

BeginHandler

Возвращает метод для вызова при запуске асинхронной задачи.Gets the method to call when beginning an asynchronous task.

EndHandler

Возвращает метод для вызова при успешном завершении задачи до истечения времени ожидания.Gets the method to call when the task completes successfully within the time-out period.

ExecuteInParallel

Возвращает значение, показывающее, может ли данная задача обрабатываться параллельно с другими задачами.Gets a value that indicates whether the task can be processed in parallel with other tasks.

State

Возвращает объект, который представляет состояние задачи.Gets an object that represents the state of the task.

TimeoutHandler

Возвращает метод для вызова в случае, если задача не завершилась успешно до истечения времени ожидания.Gets the method to call when the task does not complete successfully within the time-out period.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к