PostBackOptions クラス
アセンブリ: System.Web (system.web.dll 内)


PostBackOptions クラスを使用すると、コントロールでクライアント側のスクリプトを生成し、ポストバック イベントを実行できます。PostBackOptions クラスは、TargetControl プロパティにより、ポストバック イベントを実行するコントロールへの参照も提供します。ポストバック イベントは、ClientScriptManager.GetPostBackEventReference メソッドに渡された PostBackOptions オブジェクトに指定されたオプションに基づいて作成されます。
通常は、サーバーへのポストバックは Submit ボタンや Image ボタンなどの要素によって実行されます。ただし、クライアント側の JavaScript を生成することで、別のコントロールでポストバック イベントを実行できます。

Button コントロールの OnClick イベントを使用して、HyperLink コントロールのクライアント側のスクリプトを生成する方法を次のコード例に示します。このスクリプトを使用して、HyperLink コントロールでポストバック イベントを発生させることができます。myPostBackOptions オブジェクトの ActionUrl プロパティが "Page2.aspx" に設定されているので、この例で示されていない "Page2.aspx" という名前の別のページに Web フォーム ページがポストバックされます。この例を使用するには、プロジェクト (つまりディレクトリ) に "Page2.aspx" という名前の別の Web ページを追加する必要があります。
Partial Class postbackoptionsvb Inherits System.Web.UI.Page Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs) ' Create a new PostBackOptions object and set its properties. Dim myPostBackOptions As PostBackOptions = New PostBackOptions(Me) myPostBackOptions.ActionUrl = "Page2.aspx" myPostBackOptions.AutoPostBack = False myPostBackOptions.RequiresJavaScriptProtocol = True myPostBackOptions.PerformValidation = True ' Add the client-side script to the HyperLink1 control. HyperLink1.NavigateUrl = Page.ClientScript.GetPostBackEventReference(myPostBackOptions) Label1.Text = "Click this hyperlink to initiate a postback event." End Sub Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load If Page.IsPostBack Then Label1.Text = "A postback event has occurred." End If End Sub End Class
using System; using System.Data; using System.Configuration; using System.Collections; using System.Web; using System.Web.Security; using System.Web.UI; using System.Web.UI.WebControls; using System.Web.UI.WebControls.WebParts; using System.Web.UI.HtmlControls; public partial class postbackoptionscs : System.Web.UI.Page { protected void Page_Load(object sender, EventArgs e) { if (Page.IsPostBack) { Label1.Text = "A postback event has occurred."; } } protected void Button1_Click(object sender, EventArgs e) { // Create a new PostBackOptions object and set its properties. PostBackOptions myPostBackOptions = new PostBackOptions(this); myPostBackOptions.ActionUrl = "Page2.aspx"; myPostBackOptions.AutoPostBack = false; myPostBackOptions.RequiresJavaScriptProtocol = true; myPostBackOptions.PerformValidation = true; // Add the client-side script to the HyperLink1 control. HyperLink1.NavigateUrl = Page.ClientScript.GetPostBackEventReference(myPostBackOptions); Label1.Text = "Click this hyperlink to initiate a postback event."; } }
前述の分離コード ファイルを実行するときに使用できる Web ページのコード例を次に示します。
<%@ Page Language="VB" AutoEventWireup="true" CodeFile="postbackoptions.aspx.vb" Inherits="postbackoptionsvb" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html > <head id="Head1" runat="server"> <title>PostBackOptions Example</title> </head> <body> <form id="form1" runat="server"> <h3>PostBackOptions Example Page</h3> Click this button to create client-side script for the Postback hyperlink that causes a postback event to occur. <br /> <asp:Button id="Button1" runat="server" text="Create Script" onclick="Button1_Click" /> <br /><br /> <asp:Label id="Label1" runat="server" text=""></asp:Label> <br /> <asp:HyperLink id="HyperLink1" runat="server" text="Postback"></asp:HyperLink> <br /> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="postbackoptions.aspx.cs" Inherits="postbackoptionscs" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html > <head id="Head1" runat="server"> <title>PostBackOptions Example</title> </head> <body> <form id="form1" runat="server"> <h3>PostBackOptions Example Page</h3> Click this button to create client-side script for the Postback hyperlink that causes a postback event to occur. <br /> <asp:Button id="Button1" runat="server" text="Create Script" onclick="Button1_Click" /> <br /><br /> <asp:Label id="Label1" runat="server" text=""> </asp:Label> <br /> <asp:HyperLink id="HyperLink1" runat="server" text="Postback"> </asp:HyperLink> </form> </body> </html>

System.Web.UI.PostBackOptions


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


PostBackOptions コンストラクタ (Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)
アセンブリ: System.Web (system.web.dll 内)

Public Sub New ( _ targetControl As Control, _ argument As String, _ actionUrl As String, _ autoPostBack As Boolean, _ requiresJavaScriptProtocol As Boolean, _ trackFocus As Boolean, _ clientSubmit As Boolean, _ performValidation As Boolean, _ validationGroup As String _ )
Dim targetControl As Control Dim argument As String Dim actionUrl As String Dim autoPostBack As Boolean Dim requiresJavaScriptProtocol As Boolean Dim trackFocus As Boolean Dim clientSubmit As Boolean Dim performValidation As Boolean Dim validationGroup As String Dim instance As New PostBackOptions(targetControl, argument, actionUrl, autoPostBack, requiresJavaScriptProtocol, trackFocus, clientSubmit, performValidation, validationGroup)
public PostBackOptions ( Control targetControl, string argument, string actionUrl, bool autoPostBack, bool requiresJavaScriptProtocol, bool trackFocus, bool clientSubmit, bool performValidation, string validationGroup )
public: PostBackOptions ( Control^ targetControl, String^ argument, String^ actionUrl, bool autoPostBack, bool requiresJavaScriptProtocol, bool trackFocus, bool clientSubmit, bool performValidation, String^ validationGroup )
public PostBackOptions ( Control targetControl, String argument, String actionUrl, boolean autoPostBack, boolean requiresJavaScriptProtocol, boolean trackFocus, boolean clientSubmit, boolean performValidation, String validationGroup )
public function PostBackOptions ( targetControl : Control, argument : String, actionUrl : String, autoPostBack : boolean, requiresJavaScriptProtocol : boolean, trackFocus : boolean, clientSubmit : boolean, performValidation : boolean, validationGroup : String )

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


PostBackOptions コンストラクタ (Control, String)
アセンブリ: System.Web (system.web.dll 内)

Dim targetControl As Control Dim argument As String Dim instance As New PostBackOptions(targetControl, argument)

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


PostBackOptions コンストラクタ (Control)
アセンブリ: System.Web (system.web.dll 内)


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


PostBackOptions コンストラクタ

名前 | 説明 |
---|---|
PostBackOptions (Control) | 対象のコントロール データを指定して、PostBackOptions クラスの新しいインスタンスを初期化します。 |
PostBackOptions (Control, String) | 対象のコントロールおよび引数データを指定して、PostBackOptions クラスの新しいインスタンスを初期化します。 |
PostBackOptions (Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String) | インスタンスのプロパティに対して指定した値を使用して、PostBackOptions クラスの新しいインスタンスを初期化します。 |

PostBackOptions プロパティ

名前 | 説明 | |
---|---|---|
![]() | ActionUrl | Web フォーム ページのポストバックの対象の URL を取得または設定します。 |
![]() | Argument | ポストバック イベントで転送される省略可能な引数を取得または設定します。 |
![]() | AutoPostBack | ユーザー アクションへの応答としてフォームがサーバーに自動的にポストバックされるかどうかを示す値を取得または設定します。 |
![]() | ClientSubmit | クライアント側スクリプトからポストバック イベントが発生するかどうかを示す値を取得または設定します。 |
![]() | PerformValidation | ポストバック イベントが発生する前にクライアント側の検証が必要かどうかを示す値を取得または設定します。 |
![]() | RequiresJavaScriptProtocol | クライアント側スクリプトに対して javascript: プレフィックスが生成されるかどうかを示す値を取得または設定します。 |
![]() | TargetControl | ポストバック イベントを受け取る対象のコントロールを取得します。 |
![]() | TrackFocus | ポストバック イベントが現在のスクロール位置にページを返し、対象のコントロールにフォーカスを返すかどうかを示す値を取得または設定します。 |
![]() | ValidationGroup | PostBackOptions オブジェクトがサーバーにポストバックされるときに検証が実行されるコントロールのグループを取得または設定します。 |

PostBackOptions メソッド

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

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

PostBackOptions メンバ
ポストバック イベントを実行するためにクライアント側の JavaScript を生成する方法を指定します。
PostBackOptions データ型で公開されるメンバを以下の表に示します。


名前 | 説明 | |
---|---|---|
![]() | ActionUrl | Web フォーム ページのポストバックの対象の URL を取得または設定します。 |
![]() | Argument | ポストバック イベントで転送される省略可能な引数を取得または設定します。 |
![]() | AutoPostBack | ユーザー アクションへの応答としてフォームがサーバーに自動的にポストバックされるかどうかを示す値を取得または設定します。 |
![]() | ClientSubmit | クライアント側スクリプトからポストバック イベントが発生するかどうかを示す値を取得または設定します。 |
![]() | PerformValidation | ポストバック イベントが発生する前にクライアント側の検証が必要かどうかを示す値を取得または設定します。 |
![]() | RequiresJavaScriptProtocol | クライアント側スクリプトに対して javascript: プレフィックスが生成されるかどうかを示す値を取得または設定します。 |
![]() | TargetControl | ポストバック イベントを受け取る対象のコントロールを取得します。 |
![]() | TrackFocus | ポストバック イベントが現在のスクロール位置にページを返し、対象のコントロールにフォーカスを返すかどうかを示す値を取得または設定します。 |
![]() | ValidationGroup | PostBackOptions オブジェクトがサーバーにポストバックされるときに検証が実行されるコントロールのグループを取得または設定します。 |

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

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

Weblioに収録されているすべての辞書からPostBackOptionsを検索する場合は、下記のリンクをクリックしてください。

- PostBackOptionsのページへのリンク