Page.ExecuteRegisteredAsyncTasks 메서드

참조

정의

네임스페이스:: System.Web.UI

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

비동기 작업을 실행하기 시작합니다.

public:
 void ExecuteRegisteredAsyncTasks();

public void ExecuteRegisteredAsyncTasks ();

member this.ExecuteRegisteredAsyncTasks : unit -> unit

Public Sub ExecuteRegisteredAsyncTasks ()

예외

HttpException

비동기 작업에 예외가 있는 경우

예제

다음 코드 예제를 사용 하 여 AsyncTimeout 속성을 ExecuteRegisteredAsyncTasks 보여 줍니다는 및 RegisterAsyncTask 메서드. 시작, 종료 및 시간 제한 처리기를 사용합니다. 이 예제에서는 속성에 지정된 대로 작업에 할당된 시간을 초과하는 비동기 작업의 상황을 보여 주는 인공 지연이 AsyncTimeout 도입됩니다. 예를 들어 실제 시나리오에서는 비동기 작업을 사용하여 데이터베이스 호출 또는 이미지 생성을 수행할 수 있으며, 지정된 시간 동안 작업이 수행되지 않는 경우 시간 제한 처리기는 정상적인 성능 저하를 제공합니다.

<%@ Page Language="C#" AsyncTimeout="2"%>

<!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.MyAsyncTask mytask =    
      new Samples.AspNet.CS.Controls.MyAsyncTask();
    PageAsyncTask asynctask = new PageAsyncTask(mytask.OnBegin, mytask.OnEnd, mytask.OnTimeout, null);

    // Register the asynchronous task.
    Page.RegisterAsyncTask(asynctask);
      
    // Execute the register asynchronous task.
    Page.ExecuteRegisteredAsyncTasks();

    TaskMessage.InnerHtml = mytask.GetAsyncTaskProgress();

  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head 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" AsyncTimeout="2"%>

<!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 System.EventArgs)
    
    ' Define the asynchronuous task.
    Dim mytask As New Samples.AspNet.VB.Controls.MyAsyncTask()
    Dim asynctask As New PageAsyncTask(AddressOf mytask.OnBegin, AddressOf mytask.OnEnd, AddressOf mytask.OnTimeout, DBNull.Value)

    ' Register the asynchronous task.
    Page.RegisterAsyncTask(asynctask)
      
    ' Execute the register asynchronous task.
    Page.ExecuteRegisteredAsyncTasks()

    TaskMessage.InnerHtml = mytask.GetAsyncTaskProgress()
    
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head 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>

using System;
using System.Web;
using System.Web.UI;
using System.Threading;

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

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

        public String GetAsyncTaskProgress()
        {
            return _taskprogress;
        }
        public void DoTheAsyncTask()
        {
            // Introduce an artificial delay to simulate a delayed 
            // asynchronous task. Make this greater than the 
            // AsyncTimeout property.
            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 = "Beginning async task.";

            _dlgt = new AsyncTaskDelegate(DoTheAsyncTask);
            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 = "Asynchronous task completed.";
            _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 = "Ansynchronous task failed to complete " +
                "because it exceeded the AsyncTimeout parameter.";
        }
    }
}

Imports System.Web
Imports System.Web.UI
Imports System.Threading

Namespace Samples.AspNet.VB.Controls

    Public Class MyAsyncTask

        Private _taskprogress As String
        Private _dlgt As AsyncTaskDelegate

        ' Create delegate.
        Delegate Function AsyncTaskDelegate()

        Public Function GetAsyncTaskProgress() As String
            Return _taskprogress
        End Function

        Public Function DoTheAsyncTask()

            ' Introduce an artificial delay to simulate a delayed 
            ' asynchronous task. Make this greater than the 
            ' AsyncTimeout property.
            Thread.Sleep(TimeSpan.FromSeconds(5.0))

        End Function


        ' 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 = "Beginning async task."

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

        End Function 'OnBegin

        ' Define the method that will get called when
        ' the asynchronous task is ended.
        Public Sub OnEnd(ByVal ar As IAsyncResult)

            _taskprogress = "Asynchronous task completed."
            _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 = "Ansynchronous task failed to complete because " & _
            "it exceeded the AsyncTimeout parameter."

        End Sub

    End Class

End Namespace

설명

클래스를 사용하여 비동기 작업을 정의합니다 PageAsyncTask . 작업이 정의되고 메서드를 사용하여 RegisterAsyncTask 페이지에 등록되면 메서드를 ExecuteRegisteredAsyncTasks 호출하여 비동기 작업을 시작할 수 있습니다.

비동기 페이지에 대해 등록된 비동기 작업이 호출될 때 메서드는 ExecuteRegisteredAsyncTasks 페이지 처리 지점에서 자동으로 호출됩니다. 이 자동 호출은 ExecuteRegisteredAsyncTasks 이벤트 직전에 PreRenderComplete 발생합니다. 이 메서드에 ExecuteRegisteredAsyncTasks 대한 자동 호출 이외의 시간에 호출하려는 태스크에 대해 메서드를 호출합니다. 비동기 작업은 두 번 이상 호출될 수 있더라도 ExecuteRegisteredAsyncTasks 한 번만 실행됩니다.

속성은 AsyncTimeout 메서드를 호출할 때마다 다시 설정됩니다 ExecuteRegisteredAsyncTasks . 메서드를 AsyncTimeout 호출하기 전에 의 마지막 값이 ExecuteRegisteredAsyncTasks 우선합니다. 비동기 작업이 보다 AsyncTimeout많은 시간이 소요되는 경우 해당 ExecuteRegisteredAsyncTasks 호출 중에 호출된 후속 작업은 즉시 시간 초과됩니다.

적용 대상

다음을 통해 공유

Page.ExecuteRegisteredAsyncTasks 메서드

정의

예외

예제

설명

적용 대상

추가 정보

추가 리소스