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

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

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

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

Public NotInheritable Class
 PostBackOptions

Visual Basic (使用法)

Dim instance As PostBackOptions

C#

public sealed class PostBackOptions

C++

public ref class PostBackOptions sealed

J#

public final class PostBackOptions

JScript

public final class PostBackOptions

解説

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

通常は、サーバーへのポストバックは Submit ボタンや Image ボタンなどの要素によって実行されます。ただし、クライアント側の JavaScript を生成することで、別のコントロールでポストバックイベントを実行できます。

使用例

Button コントロールの OnClick イベントを使用して、HyperLink コントロールのクライアント側のスクリプトを生成する方法を次のコード例に示します。このスクリプトを使用して、HyperLink コントロールでポストバックイベントを発生させることができます。myPostBackOptions オブジェクトの ActionUrl プロパティが "Page2.aspx" に設定されているので、この例で示されていない "Page2.aspx" という名前の別のページに Web フォームページがポストバックされます。この例を使用するには、プロジェクト (つまりディレクトリ) に "Page2.aspx" という名前の別の Web ページを追加する必要があります。

Visual Basic

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

C#

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 ページのコード例を次に示します。

Visual Basic

<%@ 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>

C#

<%@ 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) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

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

参照

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

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

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)

C#

public PostBackOptions (
    Control targetControl,
    string argument,
    string actionUrl,
    bool autoPostBack,
    bool requiresJavaScriptProtocol,
    bool trackFocus,
    bool clientSubmit,
    bool performValidation,
    string validationGroup
)

C++

public:
PostBackOptions (
    Control^ targetControl, 
    String^ argument, 
    String^ actionUrl, 
    bool autoPostBack, 
    bool requiresJavaScriptProtocol, 
    bool trackFocus, 
    bool clientSubmit, 
    bool performValidation, 
    String^ validationGroup
)

J#

public PostBackOptions (
    Control targetControl, 
    String argument, 
    String actionUrl, 
    boolean autoPostBack, 
    boolean requiresJavaScriptProtocol, 
    boolean trackFocus, 
    boolean clientSubmit, 
    boolean performValidation, 
    String validationGroup
)

JScript

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 によって発生する検証の対象となるコントロールのグループ。

プラットフォーム

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

参照

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

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim targetControl As Control
Dim argument As String

Dim instance As New PostBackOptions(targetControl,
 argument)

C#

public PostBackOptions (
    Control targetControl,
    string argument
)

C++

public:
PostBackOptions (
    Control^ targetControl, 
    String^ argument
)

J#

public PostBackOptions (
    Control targetControl, 
    String argument
)

JScript

public function PostBackOptions (
    targetControl : Control, 
    argument : String
)

パラメータ

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

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

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

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

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

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

Visual Basic (宣言)

Public Sub New ( _
    targetControl As Control _
)

Visual Basic (使用法)

Dim targetControl As Control

Dim instance As New PostBackOptions(targetControl)

C#

public PostBackOptions (
    Control targetControl
)

C++

public:
PostBackOptions (
    Control^ targetControl
)

J#

public PostBackOptions (
    Control targetControl
)

JScript

public function PostBackOptions (
    targetControl : Control
)

パラメータ

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

プラットフォーム

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

参照

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

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

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

	名前	説明
	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 から継承されます。)

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

PostBackOptions クラス

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

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

PostBackOptions コンストラクタ (Control)

PostBackOptions コンストラクタ

関連項目

PostBackOptions プロパティ

関連項目

PostBackOptions メソッド

関連項目

PostBackOptions メンバ

関連項目

「PostBackOptions」の関連用語


	© 2025 Microsoft.All rights reserved.

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

PostBackOptions クラス

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

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

PostBackOptions コンストラクタ (Control)

PostBackOptions コンストラクタ

関連項目

PostBackOptions プロパティ

関連項目

PostBackOptions メソッド

関連項目

PostBackOptions メンバ

関連項目

急上昇のことば

「PostBackOptions」の関連用語

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