Page.RegisterRequiresRaiseEvent メソッド
ASP.NET サーバー コントロールが Page オブジェクトで処理されたときに、このコントロールをイベントの発生を要求するコントロールとして登録します。
名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文
'宣言
Public Overridable Sub RegisterRequiresRaiseEvent ( _
control As IPostBackEventHandler _
)
'使用
Dim instance As Page
Dim control As IPostBackEventHandler
instance.RegisterRequiresRaiseEvent(control)
public virtual void RegisterRequiresRaiseEvent (
IPostBackEventHandler control
)
public:
virtual void RegisterRequiresRaiseEvent (
IPostBackEventHandler^ control
)
public void RegisterRequiresRaiseEvent (
IPostBackEventHandler control
)
public function RegisterRequiresRaiseEvent (
control : IPostBackEventHandler
)
適用できません。
パラメータ
- control
登録するコントロール。
解説
1 つのページ要求について登録できるサーバー コントロールは 1 つだけです。フォームのポスト データ内にコントロール ID が含まれていないコントロールの場合は、RegisterRequiresRaiseEvent を使用する必要があります。また、登録されるコントロールは、IPostBackEventHandler インターフェイスを実装する必要があります。
使用例
RegisterRequiresRaiseEvent メソッドを使用して、イベントの発生を要求するコントロールとしてButton Web サーバー コントロールを登録する方法を次のコード例に示します。最初の Button コントロールを登録したら、コード内で宣言されている 2 個目の Button コントロールが最初のボタンのクリック イベントの結果をページにポストバックするようにできます。
Sub DisplayUserName(Sender As Object, e As EventArgs)
Response.Write("Welcome to " + Server.HtmlEncode(userName.Text))
End Sub
Sub MyRaiseEvent(Sender As Object, e As EventArgs)
'Raises a post back event for a control.
Me.RaisePostBackEvent(userButton, "")
End Sub
Sub Page_Load(Sender As Object, e As EventArgs)
'Registers a control as one that requires postback handling
Me.RegisterRequiresRaiseEvent(userButton)
End Sub
void DisplayUserName(Object sender, EventArgs ea)
{
Response.Write("Welcome to " + Server.HtmlEncode(userName.Text));
}
void RaiseEvent(Object sender, EventArgs ea)
{
// Raise a post back event for a control.
this.RaisePostBackEvent(userButton, "");
}
void Page_Load(Object sender, EventArgs ea)
{
// Register a control as one that requires postback handling.
this.RegisterRequiresRaiseEvent(userButton);
}
void DisplayUserName(Object sender, EventArgs ea)
{
get_Response().Write("Welcome to "
+ get_Server().HtmlEncode(userName.get_Text()));
} //DisplayUserName
void RaiseEvent(Object sender, EventArgs ea)
{
// Raise a post back event for a control.
this.RaisePostBackEvent(userButton, "");
} //RaiseEvent
void Page_Load(Object sender, EventArgs ea)
{
// Register a control as one that requires postback handling.
this.RegisterRequiresRaiseEvent(userButton);
} //Page_Load
プラットフォーム
Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition
Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。
バージョン情報
.NET Framework
サポート対象 : 3.0,2.0,1.1,1.0