BeginEventHandler デリゲートとは何？わかりやすく解説 Weblio辞書

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

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

BeginEventHandler デリゲート

アプリケーションイベントなどの非同期イベントを処理するメソッドを表します。このデリゲートは、非同期操作の開始時に呼び出されます。

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

Visual Basic (宣言)

Public Delegate Function
 BeginEventHandler ( _
    sender As Object, _
    e As EventArgs, _
    cb As AsyncCallback, _
    extraData As Object _
) As IAsyncResult

Visual Basic (使用法)

Dim instance As New BeginEventHandler(AddressOf
 HandlerMethod)

public delegate IAsyncResult BeginEventHandler (
    Object sender,
    EventArgs e,
    AsyncCallback cb,
    Object extraData
)

C++

public delegate IAsyncResult^ BeginEventHandler (
    Object^ sender, 
    EventArgs^ e, 
    AsyncCallback^ cb, 
    Object^ extraData
)

/** @delegate */
public delegate IAsyncResult BeginEventHandler (
    Object sender, 
    EventArgs e, 
    AsyncCallback cb, 
    Object extraData
)

JScript

JScript では、デリゲートは使用できますが、新規に宣言することはできません。

パラメータ

sender: イベントのソース。

e: イベントデータを格納している EventArgs。

cb: 非同期メソッドの呼び出しが完了したときに呼び出されるデリゲート。cb が null 参照 (Visual Basic では Nothing) の場合、このデリゲートは呼び出されません。

extraData: 要求を処理するために必要な追加のデータ。

戻り値
BeginEventHandler 操作の結果を表す IAsyncResult。

解説

BeginEventHandler デリゲートを作成する場合は、イベントを処理するメソッドを識別してください。イベントをイベントハンドラに関連付けるには、デリゲートのインスタンスをイベントに追加します。デリゲートを削除しない限り、そのイベントが発生すると常にイベントハンドラが呼び出されます。イベントハンドラデリゲートの詳細については、「イベントとデリゲート」を参照してください。

使用例

BeginEventHandler デリゲートを使用して、ハンドラを非同期ページとして登録するコード例を次に示します。

Visual Basic

<%@ page language="VB" Async="true"%>
<script runat="server">
  Dim myRequest As System.Net.WebRequest
  
  Sub Page_Load(ByVal sender As
 Object, ByVal e As EventArgs)
    Label1.Text = "Page_Load: Thread #" & System.Threading.Thread.CurrentThread.GetHashCode()
    
    Dim bh As New BeginEventHandler(AddressOf
 Me.BeginGetAsyncData)
    Dim eh As New EndEventHandler(AddressOf
 Me.EndGetAsyncData)
    
    Me.AddOnPreRenderCompleteAsync(bh, eh)
    
    ' Initialize the WebRequest object.
    Dim address As String
    address = "http://localhost/"
    myRequest = System.Net.WebRequest.Create(address)
    
  End Sub
  
  Function BeginGetAsyncData(ByVal src As
 Object, ByVal args As
 EventArgs, ByVal cb As AsyncCallback, ByVal state As Object) As
 IAsyncResult
    Label2.Text = "BeginGetAsyncData: Thread #" &
 System.Threading.Thread.CurrentThread.GetHashCode()
    Return Me.myRequest.BeginGetResponse(cb,
 state)
  End Function
  
  Sub EndGetAsyncData(ByVal ar As
 IAsyncResult)
    Label3.Text = "EndGetAsyncData: Thread #" &
 System.Threading.Thread.CurrentThread.GetHashCode()
    
    Dim myResponse As System.Net.WebResponse
    myResponse = Me.myRequest.EndGetResponse(ar)
    
    Dim reader As New System.IO.StreamReader(myResponse.GetResponseStream())
    result.Text = reader.ReadToEnd()
    myResponse.Close()
  End Sub
  
</script>
<html>
  <head runat="server">
    <title>
      Page.AddOnPreRenderCompleteAsync Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:label id="Label1" runat="server">
        Label 1</asp:label><br />
      <asp:label id="Label2" runat="server">
        Label 2</asp:label><br />
      <asp:label id="Label3" runat="server">
        Label 3</asp:label><br />
      <asp:textbox id="result" runat="server"
 textMode="multiLine" ReadOnly="true"
 columns="80" rows="25" />
    </form>
  </body>
</html>

<%@ page language="C#" Async="true"%>
<script runat="server">
  System.Net.WebRequest myRequest;

  void Page_Load(object sender, EventArgs e)
  {
    Label1.Text = "Page_Load: thread #" + System.Threading.Thread.CurrentThread.GetHashCode();

    BeginEventHandler bh = new BeginEventHandler(this.BeginGetAsyncData);
    EndEventHandler eh = new EndEventHandler(this.EndGetAsyncData);

    AddOnPreRenderCompleteAsync(bh, eh);

    // Initialize the WebRequest.
    string address = "http://localhost/";

    myRequest = System.Net.WebRequest.Create(address);
  }

  IAsyncResult BeginGetAsyncData(Object src, EventArgs args, AsyncCallback cb, Object
 state)
  {
    Label2.Text = "BeginGetAsyncData: thread #" + System.Threading.Thread.CurrentThread.GetHashCode();
    return myRequest.BeginGetResponse(cb, state);
  }

  void EndGetAsyncData(IAsyncResult ar)
  {
    Label3.Text = "EndGetAsyncData: thread #" + System.Threading.Thread.CurrentThread.GetHashCode();

    System.Net.WebResponse myResponse = myRequest.EndGetResponse(ar);

    result.Text = new System.IO.StreamReader(myResponse.GetResponseStream()).ReadToEnd();
    myResponse.Close();
  }

</script>
<html>
  <head runat="server">
    <title>
      Page.AddOnPreRenderCompleteAsync Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:label id="Label1" runat="server">
        Label 1</asp:label><br />
      <asp:label id="Label2" runat="server">
        Label 2</asp:label><br />
      <asp:label id="Label3" runat="server">
        Label 3</asp:label><br />
      <asp:textbox id="result" runat="server" textMode="multiLine"
 ReadOnly="true" columns="80" rows="25"
 />
    </form>
  </body>
</html>