PageAsyncTaskとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

PageAsyncTask クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

ページに登録されている非同期タスクに関する情報を格納します。このクラスは継承できません。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 PageAsyncTask

Visual Basic (使用法)

Dim instance As PageAsyncTask

public sealed class PageAsyncTask

C++

public ref class PageAsyncTask sealed

public final class PageAsyncTask

JScript

public final class PageAsyncTask

解説

ASP.NET Version 2.0 を使用すると、1 つのページに複数のタスクを登録し、ページを表示する前にこれらのタスクを非同期に実行できます。処理に時間のかかるタスクがある場合、このタスクの実行中に他のプロセスが停滞しないように、このタスクを非同期で実行するように指定できます。非同期タスクは並列処理することも順次処理することもできます。

PageAsyncTask オブジェクトは、RegisterAsyncTask メソッドを使用してページに登録する必要があります。非同期タスクを実行するために、ページ自体を非同期で処理する必要はありません。ページディレクティブで Async 属性を (次のコード例に示すように) true に設定しても false に設定しても、非同期タスクは非同期で処理されます。

<%@ Page Async="true" %>

Async 属性を false に設定した場合、すべての非同期タスクが完了するまで、ページを実行するスレッドがブロックされます。

PreRenderComplete イベントの前に登録された非同期タスクがまだ実行されていない場合、ページによって自動的に実行されます。PreRenderComplete イベントの後に登録された非同期タスクは、ExecuteRegisteredAsyncTasks メソッドを使用して明示的に実行する必要があります。ExecuteRegisteredAsyncTasks メソッドを使用して、PreRenderComplete イベントの前にタスクを開始することもできます。ExecuteRegisteredAsyncTasks メソッドにより、ページに登録されている、まだ実行されていないすべての非同期タスクが実行されます。

既定では、非同期タスクは 45 秒以内に完了しなかった場合、タイムアウトになります。Web.config ファイルまたはページディレクティブで別のタイムアウト値を指定できます。Web.config ファイルの <pages> セクションでは、次に示すように、asyncTimeout 属性が定義されます。

<system.web>

<pages asyncTimeout="30">

</pages>

</system.web>

ページディレクティブでは、次に示すように、AsyncTimeout 属性が定義されます。

<%@ Page AsyncTimeout="30" %>

使用例

3 つの非同期タスクをページに登録し、並列で処理する方法を次のコード例に示します。各タスクは、単にスレッドを 5 秒間スリープ状態にするメソッドを呼び出します。

Visual Basic

<%@ 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()
     
        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)
      
        ' Execute the register asynchronous task.
        Page.ExecuteRegisteredAsyncTasks()

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

    End Sub
</script>

<html  >
<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>

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

<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();
    
    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);
      
    // Execute the register asynchronous task.
    Page.ExecuteRegisteredAsyncTasks();

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

  }
</script>

<html  >
<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>

Visual Basic

Imports Microsoft.VisualBasic
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

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.";
        }
    }
}

.NET Framework のセキュリティ

AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)。要求値 : LinkDemand。アクセス許可値 : Minimal。
AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)。要求値 : InheritanceDemand。アクセス許可値 : Minimal。

継承階層

System.Object
System.Web.UI.PageAsyncTask

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PageAsyncTask メンバ
System.Web.UI 名前空間

PageAsyncTask コンストラクタ (BeginEventHandler, EndEventHandler, EndEventHandler, Object)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

並列実行のために既定値を使用して、PageAsyncTask クラスの新しいインスタンスを初期化します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    beginHandler As BeginEventHandler, _
    endHandler As EndEventHandler, _
    timeoutHandler As EndEventHandler, _
    state As Object _
)

Visual Basic (使用法)

Dim beginHandler As BeginEventHandler
Dim endHandler As EndEventHandler
Dim timeoutHandler As EndEventHandler
Dim state As Object

Dim instance As New PageAsyncTask(beginHandler,
 endHandler, timeoutHandler, state)

public PageAsyncTask (
    BeginEventHandler beginHandler,
    EndEventHandler endHandler,
    EndEventHandler timeoutHandler,
    Object state
)

C++

public:
PageAsyncTask (
    BeginEventHandler^ beginHandler, 
    EndEventHandler^ endHandler, 
    EndEventHandler^ timeoutHandler, 
    Object^ state
)

public PageAsyncTask (
    BeginEventHandler beginHandler, 
    EndEventHandler endHandler, 
    EndEventHandler timeoutHandler, 
    Object state
)

JScript

public function PageAsyncTask (
    beginHandler : BeginEventHandler, 
    endHandler : EndEventHandler, 
    timeoutHandler : EndEventHandler, 
    state : Object
)

パラメータ

beginHandler: 非同期タスクの開始時に呼び出すハンドラ。

endHandler: タイムアウト期限内にタスクが正常に完了したときに呼び出すハンドラ。

timeoutHandler: タイムアウト期限内にタスクが正常に完了しなかったときに呼び出すハンドラ。

state: タスクの状態を表すオブジェクト。

例外

例外の種類	条件
ArgumentNullException	beginHandler パラメータまたは endHandler パラメータが指定されていません。

解説

このコンストラクタを実装すると、ExecuteInParallel プロパティが false に設定され、非同期タスクがページの他のタスクと並列で処理されなくなります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PageAsyncTask クラス
PageAsyncTask メンバ
System.Web.UI 名前空間

PageAsyncTask コンストラクタ (BeginEventHandler, EndEventHandler, EndEventHandler, Object, Boolean)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

並列実行のために指定した値を使用して、PageAsyncTask クラスの新しいインスタンスを初期化します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    beginHandler As BeginEventHandler, _
    endHandler As EndEventHandler, _
    timeoutHandler As EndEventHandler, _
    state As Object, _
    executeInParallel As Boolean _
)

Visual Basic (使用法)

Dim beginHandler As BeginEventHandler
Dim endHandler As EndEventHandler
Dim timeoutHandler As EndEventHandler
Dim state As Object
Dim executeInParallel As Boolean

Dim instance As New PageAsyncTask(beginHandler,
 endHandler, timeoutHandler, state, executeInParallel)

public PageAsyncTask (
    BeginEventHandler beginHandler,
    EndEventHandler endHandler,
    EndEventHandler timeoutHandler,
    Object state,
    bool executeInParallel
)

C++

public:
PageAsyncTask (
    BeginEventHandler^ beginHandler, 
    EndEventHandler^ endHandler, 
    EndEventHandler^ timeoutHandler, 
    Object^ state, 
    bool executeInParallel
)

public PageAsyncTask (
    BeginEventHandler beginHandler, 
    EndEventHandler endHandler, 
    EndEventHandler timeoutHandler, 
    Object state, 
    boolean executeInParallel
)

JScript

public function PageAsyncTask (
    beginHandler : BeginEventHandler, 
    endHandler : EndEventHandler, 
    timeoutHandler : EndEventHandler, 
    state : Object, 
    executeInParallel : boolean
)

パラメータ

beginHandler: 非同期タスクの開始時に呼び出すハンドラ。

endHandler: タイムアウト期限内にタスクが正常に完了したときに呼び出すハンドラ。

timeoutHandler: タイムアウト期限内にタスクが正常に完了しなかったときに呼び出すハンドラ。

state: タスクの状態を表すオブジェクト。

executeInParallel: このタスクを他のタスクと並列で処理できるかどうかを示す値。

例外

例外の種類	条件
ArgumentNullException	beginHandler パラメータまたは endHandler パラメータが指定されていません。

解説

このコンストラクタを実装すると、非同期タスクがページの他のタスクと並列で処理されるかどうかを設定できます。

使用例

互いに並列で実行される 3 つの非同期タスクを作成する方法を次のコード例に示します。この例は PageAsyncTask クラスの概要で取り上げているコード例の一部です。

Visual Basic

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)

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);

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PageAsyncTask クラス
PageAsyncTask メンバ
System.Web.UI 名前空間

PageAsyncTask コンストラクタ

PageAsyncTask クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
PageAsyncTask (BeginEventHandler, EndEventHandler, EndEventHandler, Object)	並列実行のために既定値を使用して、PageAsyncTask クラスの新しいインスタンスを初期化します。
PageAsyncTask (BeginEventHandler, EndEventHandler, EndEventHandler, Object, Boolean)	並列実行のために指定した値を使用して、PageAsyncTask クラスの新しいインスタンスを初期化します。

参照

PageAsyncTask プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	BeginHandler	非同期タスクの開始時に呼び出すメソッドを取得します。
	EndHandler	タイムアウト期限内にタスクが正常に完了したときに呼び出すメソッドを取得します。
	ExecuteInParallel	このタスクを他のタスクと並列で処理できるかどうかを示す値を取得します。
	State	タスクの状態を表すオブジェクトを取得します。
	TimeoutHandler	タイムアウト期限内にタスクが正常に完了しなかったときに呼び出すメソッドを取得します。

参照

PageAsyncTask メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

PageAsyncTask メンバ

ページに登録されている非同期タスクに関する情報を格納します。このクラスは継承できません。

PageAsyncTask データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

	名前	説明
	PageAsyncTask	オーバーロードされます。 PageAsyncTask クラスの新しいインスタンスを初期化します。

パブリックプロパティ

	名前	説明
	BeginHandler	非同期タスクの開始時に呼び出すメソッドを取得します。
	EndHandler	タイムアウト期限内にタスクが正常に完了したときに呼び出すメソッドを取得します。
	ExecuteInParallel	このタスクを他のタスクと並列で処理できるかどうかを示す値を取得します。
	State	タスクの状態を表すオブジェクトを取得します。
	TimeoutHandler	タイムアウト期限内にタスクが正常に完了しなかったときに呼び出すメソッドを取得します。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

PageAsyncTaskとは？わかりやすく解説

PageAsyncTask クラス

PageAsyncTask コンストラクタ (BeginEventHandler, EndEventHandler, EndEventHandler, Object)

PageAsyncTask コンストラクタ (BeginEventHandler, EndEventHandler, EndEventHandler, Object, Boolean)

PageAsyncTask コンストラクタ

関連項目

PageAsyncTask プロパティ

関連項目

PageAsyncTask メソッド

関連項目

PageAsyncTask メンバ

関連項目

「PageAsyncTask」の関連用語


	© 2025 Microsoft.All rights reserved.

PageAsyncTaskとは？ わかりやすく解説

PageAsyncTask クラス

PageAsyncTask コンストラクタ (BeginEventHandler, EndEventHandler, EndEventHandler, Object)

PageAsyncTask コンストラクタ (BeginEventHandler, EndEventHandler, EndEventHandler, Object, Boolean)

PageAsyncTask コンストラクタ

関連項目

PageAsyncTask プロパティ

関連項目

PageAsyncTask メソッド

関連項目

PageAsyncTask メンバ

関連項目

急上昇のことば

「PageAsyncTask」の関連用語

PageAsyncTaskとは？わかりやすく解説