PostBackOptionsとは? わかりやすく解説

PostBackOptions クラス

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

ポストバック イベントを実行するためにクライアント側の JavaScript を生成する方法を指定します。

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

Public NotInheritable Class
 PostBackOptions
Dim instance As PostBackOptions
public sealed class PostBackOptions
public ref class PostBackOptions sealed
public final class PostBackOptions
public final class PostBackOptions
解説解説
使用例使用例

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.Object
  System.Web.UI.PostBackOptions
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
PostBackOptions メンバ
System.Web.UI 名前空間
GetPostBackEventReference

PostBackOptions コンストラクタ (Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)

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

インスタンスのプロパティに対して指定した値を使用して、PostBackOptions クラスの新しいインスタンスを初期化します。

名前空間: System.Web.UI
アセンブリ: 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
)

パラメータ

targetControl

ポストバック イベントを受け取る Control。

argument

ポストバック イベント時に渡される省略可能なパラメータ。

actionUrl

ポストバックの対象。

autoPostBack

ユーザー アクションへの応答としてサーバーにフォームを自動的にポストバックする場合は true。それ以外の場合は false。

requiresJavaScriptProtocol

javascript: プレフィックスが必要な場合は true。それ以外の場合は false。

trackFocus

ポストバック イベントが現在のスクロール位置にページを返し、対象のコントロールにフォーカスを返す場合は true。それ以外の場合は false。

clientSubmit

クライアントのスクリプトによってポストバック イベントを発生させることができる場合は true。それ以外の場合は false。

performValidation

ポストバック イベントが発生する前にクライアント側の検証が必要な場合は true。それ以外の場合は false。

validationGroup

サーバーへのポストバック時に、PostBackOptions によって発生する検証の対象となるコントロールのグループ。

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
PostBackOptions クラス
PostBackOptions メンバ
System.Web.UI 名前空間

PostBackOptions コンストラクタ (Control, String)

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

対象のコントロールおよび引数データを指定して、PostBackOptions クラスの新しいインスタンスを初期化します。

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

Public Sub New ( _
    targetControl As Control, _
    argument As String _
)
Dim targetControl As Control
Dim argument As String

Dim instance As New PostBackOptions(targetControl,
 argument)
public PostBackOptions (
    Control targetControl,
    string argument
)
public:
PostBackOptions (
    Control^ targetControl, 
    String^ argument
)
public PostBackOptions (
    Control targetControl, 
    String argument
)
public function PostBackOptions (
    targetControl : Control, 
    argument : String
)

パラメータ

targetControl

ポストバック イベントを受け取る Control。

argument

ポストバック イベント時に渡される省略可能なパラメータ。

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
PostBackOptions クラス
PostBackOptions メンバ
System.Web.UI 名前空間
TargetControl
Argument

PostBackOptions コンストラクタ (Control)


PostBackOptions コンストラクタ


PostBackOptions プロパティ


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

参照参照

関連項目

PostBackOptions クラス
System.Web.UI 名前空間
GetPostBackEventReference

PostBackOptions メソッド


PostBackOptions メンバ

ポストバック イベントを実行するためにクライアント側の JavaScript を生成する方法を指定します。

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


パブリック コンストラクタパブリック コンストラクタ
パブリック プロパティパブリック プロパティ
パブリック メソッドパブリック メソッド
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

PostBackOptions クラス
System.Web.UI 名前空間
GetPostBackEventReference



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「PostBackOptions」の関連用語

PostBackOptionsのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



PostBackOptionsのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS