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


SessionParameter クラスを使用すると、HttpSessionState 変数の値を、SQL パラメータ クエリ、ビジネス オブジェクトのメソッド、またはフィルタ処理式で使用されるパラメータにバインドできます。
SessionParameter クラスは、Parameter クラスから継承したこれらのプロパティに加えて、SessionField プロパティを提供しています。SessionField プロパティは、SessionParameter を使って値を取得する際のセッション変数を識別します。
![]() |
---|
SessionParameter オブジェクトが指定されていても、対応するセッション変数が設定されていないと、データをパラメータにバインドするコントロールは例外をスローします。同様に、セッション変数が null 参照 (Visual Basic では Nothing) で設定された場合、データは表示されません。このような状況を防ぐには、必要に応じて DefaultValue プロパティを設定します。 |

SessionParameter オブジェクトを使用して、Web ブラウザ セッションに格納された従業員 ID の値を SQL パラメータ クエリにバインドする方法を次のコード例に示します。まず、SessionParameter オブジェクトを SqlDataSource コントロールの SelectParameters コレクションに追加しています。次に、SelectCommand プロパティに設定された SQL パラメータ クエリが、このオブジェクトを使用してデータを取得し、それを GridView コントロールに表示しています。SessionParameter オブジェクトには DefaultValue プロパティが設定されているため、この例を実行する前に "empid" という名前のセッション変数を設定しなかったとしてもデータが表示されます。
<%@ Page language="VB"%> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <HTML> <body> <form id="Form1" method="post" runat="server"> <P>Show My Orders:</P> <asp:SqlDataSource id="OdbcDataSource1" runat="server" ProviderName="System.Data.Odbc" ConnectionString="dsn=MyOdbcDsn;" SelectCommand="SELECT OrderId, CustomerId, OrderDate FROM Orders WHERE EmployeeID = ? ORDER BY CustomerId ASC;"> <SelectParameters> <asp:SessionParameter Name="empid" SessionField="empid" DefaultValue="5" /> </SelectParameters> </asp:SqlDataSource> <p> <asp:GridView id="GridView1" runat="server" DataSourceID="OdbcDataSource1" /> </p> </form> </body> </HTML>
<%@ Page language="C#"%> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <HTML> <body> <form id="Form1" method="post" runat="server"> <P>Show My Orders:</P> <asp:SqlDataSource id="OdbcDataSource1" runat="server" ProviderName="System.Data.Odbc" ConnectionString="dsn=MyOdbcDsn;" SelectCommand="SELECT OrderId, CustomerId, OrderDate FROM Orders WHERE EmployeeID = ? ORDER BY CustomerId ASC;"> <SelectParameters> <asp:SessionParameter Name="empid" SessionField="empid" DefaultValue="5" /> </SelectParameters> </asp:SqlDataSource> <p> <asp:GridView id="GridView1" runat="server" DataSourceID="OdbcDataSource1" /> </p> </form> </body> </HTML>
<%@ Page language="VJ#"%> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <HTML> <body> <form id="Form1" method="post" runat="server"> <P>Show My Orders:</P> <asp:SqlDataSource id="OdbcDataSource1" runat="server" ProviderName="System.Data.Odbc" ConnectionString="dsn=MyOdbcDsn;" SelectCommand = "SELECT OrderId, CustomerId, OrderDate FROM Orders WHERE EmployeeID = ? ORDER BY CustomerId ASC;"> <SelectParameters> <asp:SessionParameter Name="empid" SessionField="empid" DefaultValue="5" /> </SelectParameters> </asp:SqlDataSource> <p> <asp:GridView id="GridView1" runat="server" DataSourceID="OdbcDataSource1" /> </p> </form> </body> </HTML>


System.Web.UI.WebControls.Parameter
System.Web.UI.WebControls.SessionParameter


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


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


SessionParameter コンストラクタで作成された SessionParameter オブジェクトは、すべてのプロパティに既定値を使用して初期化されます。SessionField プロパティは String.Empty に初期化されます。また、Name プロパティは String.Empty に初期化され、Type プロパティは TypeCode.Object に初期化されます。さらに、Direction プロパティは ParameterDirection.Input に初期化され、DefaultValue プロパティは null 参照 (Visual Basic では Nothing) に初期化されます。

SessionParameter コンストラクタを使用して、SessionParameter クラスの既定のインスタンスを作成する方法を次のコード例に示します。
' In this example, the session parameter "empid" is set ' after the employee successfully logs in. Dim empid As New SessionParameter() empid.Name = "empid" empid.Type = TypeCode.Int32 empid.SessionField = "empid"

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


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


SessionParameter(SessionParameter) コンストラクタは、SessionParameter インスタンスのクローンを作成するための Protected コピー コンストラクタです。SessionParameter オブジェクトの値 (SessionField、Name、Type プロパティなど) が、すべて新しいインスタンスに転送されます。

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


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

Dim name As String Dim sessionField As String Dim instance As New SessionParameter(name, sessionField)

SessionParameter(String,String) コンストラクタを使用して作成された SessionParameter オブジェクトは、指定されたパラメータ名、およびパラメータのバインド先の HttpSessionState 名前/値ペアを識別する文字列を使用して初期化されます。Type および Direction を含むその他のプロパティは既定値を使用して初期化されます。

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


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

Dim name As String Dim type As TypeCode Dim sessionField As String Dim instance As New SessionParameter(name, type, sessionField)

SessionParameter コンストラクタを使用して作成された SessionParameter オブジェクトは、指定されたパラメータ名、Type、およびパラメータのバインド先の HttpSessionState 名前/値ペアを識別する文字列を使用して初期化されます。Direction プロパティおよび ConvertEmptyStringToNull プロパティのみ既定値で初期化されます。

SessionParameter コンストラクタを使用して SessionParameter オブジェクトを作成し、それを SqlDataSource コントロールと共に使用して、データを DataGrid コントロールに表示する方法を次のコード例に示します。
<%@ Page language="VB" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <SCRIPT runat="server"> Private Sub Page_Load(sender As Object, e As EventArgs) Dim OdbcToSql As New SqlDataSource() ' Connect to SQL Server using an ODBC DSN. OdbcToSql.ProviderName= "System.Data.Odbc" OdbcToSql.ConnectionString = "dsn=MyOdbcDsn;" ' Use an ODBC parameterized query syntax. OdbcToSql.SelectCommand = "SELECT EmployeeID FROM Employees " & _ " WHERE Country = ? AND ReportsTo = ?" ' The country parameter has no default value, so be sure to set ' a Session variable named "country" to "UK" or "USA". Dim country As SessionParameter country = New SessionParameter("country" ,TypeCode.String,"country") Dim reportsTo As SessionParameter reportsTo = New SessionParameter("report" ,TypeCode.Int32,"report") reportsTo.DefaultValue = "2" OdbcToSql.SelectParameters.Add(country) OdbcToSql.SelectParameters.Add(reportsTo) ' Add the DataSourceControl to the page's Controls collection. Page.Controls.Add(OdbcToSql) DataGrid1.DataSource = OdbcToSql DataGrid1.DataBind() End Sub ' Page_Load </SCRIPT> <HTML> <body MS_POSITIONING="GridLayout"> <form id="Form1" method="post" runat="server"> <asp:DataGrid id="DataGrid1" style="Z-INDEX: 101; LEFT: 56px; POSITION: absolute; TOP: 56px" runat="server" /> </form> </body> </HTML>
<%@ Page language="C#" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <SCRIPT runat="server"> private void Page_Load(object sender, System.EventArgs e) { SqlDataSource OdbcToSql = new SqlDataSource(); // Connect to SQL Server using an ODBC DSN. OdbcToSql.ProviderName= "System.Data.Odbc"; OdbcToSql.ConnectionString = "dsn=MyOdbcDsn;"; // Use an ODBC parameterized query syntax. OdbcToSql.SelectCommand = "SELECT EmployeeID FROM Employees " + " WHERE Country = ? AND ReportsTo = ?"; // The country parameter has no default value, so be sure to set // a Session variable named "country" to "UK" or "USA". SessionParameter country = new SessionParameter("country",TypeCode.String ,"country"); SessionParameter reportsTo = new SessionParameter("report",TypeCode.Int32 ,"report"); reportsTo.DefaultValue = "2"; OdbcToSql.SelectParameters.Add(country); OdbcToSql.SelectParameters.Add(reportsTo); // Add the DataSourceControl to the page's Controls collection. Page.Controls.Add(OdbcToSql); DataGrid1.DataSource = OdbcToSql; DataGrid1.DataBind(); } </SCRIPT> <HTML> <body MS_POSITIONING="GridLayout"> <form id="Form1" method="post" runat="server"> <asp:DataGrid id="DataGrid1" style="Z-INDEX: 101; LEFT: 56px; POSITION: absolute; TOP: 56px" runat="server" /> </form> </body> </HTML>
<%@ Page language="VJ#" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <SCRIPT runat="server"> private void Page_Load(Object sender, System.EventArgs e) { SqlDataSource odbcToSql = new SqlDataSource(); // Connect to SQL Server using an ODBC DSN. odbcToSql.set_ProviderName("System.Data.Odbc"); odbcToSql.set_ConnectionString("dsn=MyOdbcDsn;"); // Use an ODBC parameterized query syntax. odbcToSql.set_SelectCommand("SELECT EmployeeID FROM Employees " + " WHERE Country = ? AND ReportsTo = ?"); // The country parameter has no default value, so be sure to set // a Session variable named "country" to "UK" or "USA". SessionParameter country = new SessionParameter("country",System.TypeCode.String ,"country"); SessionParameter reportsTo = new SessionParameter("report",System.TypeCode.Int32 ,"report"); reportsTo.set_DefaultValue("2"); odbcToSql.get_SelectParameters().Add(country); odbcToSql.get_SelectParameters().Add(reportsTo); // Add the DataSourceControl to the page's Controls collection. get_Page().get_Controls().Add(odbcToSql); DataGrid1.set_DataSource(odbcToSql); DataGrid1.DataBind(); } //Page_Load </SCRIPT> <HTML> <body MS_POSITIONING="GridLayout"> <form id="Form1" method="post" runat="server"> <asp:DataGrid id="DataGrid1" style="Z-INDEX: 101; LEFT: 56px; POSITION: absolute; TOP: 56px" runat="server" /> </form> </body> </HTML>

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


SessionParameter コンストラクタ

名前 | 説明 |
---|---|
SessionParameter () | SessionParameter クラスの名前のない新しいインスタンスを初期化します。 |
SessionParameter (SessionParameter) | original パラメータで指定されたインスタンスの値を使用して、SessionParameter クラスの新しいインスタンスを初期化します。 |
SessionParameter (String, String) | バインド先の HTTP Cookie を識別する文字列を指定して、SessionParameter クラスの名前付きの新しいインスタンスを初期化します。 |
SessionParameter (String, TypeCode, String) | バインド先の HTTP Cookie を識別する文字列を指定して、SessionParameter クラスの厳密に型指定された名前付きの新しいインスタンスを初期化します。 |

SessionParameter プロパティ

名前 | 説明 | |
---|---|---|
![]() | ConvertEmptyStringToNull | Parameter オブジェクトのバインド先の値が String.Empty の場合に、その値を null 参照 (Visual Basic では Nothing) に変換する必要があるかどうかを示す値を取得または設定します。 ( Parameter から継承されます。) |
![]() | DefaultValue | パラメータの既定値を指定します。Evaluate メソッドの呼び出し時に、パラメータはこの値にバインドされ、初期化前の状態に戻されます。 ( Parameter から継承されます。) |
![]() | Direction | Parameter オブジェクトを使用して値をコントロールにバインドするかどうか、またはそのコントロールを使用して値を変更できるかどうかを示します。 ( Parameter から継承されます。) |
![]() | Name | パラメータの名前を取得または設定します。 ( Parameter から継承されます。) |
![]() | SessionField | パラメータのバインド先のセッション変数の名前を取得または設定します。 |
![]() | Size | パラメータのサイズを取得または設定します。 ( Parameter から継承されます。) |
![]() | Type | パラメータの型を取得または設定します。 ( Parameter から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | IsTrackingViewState | Parameter オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。 ( Parameter から継承されます。) |
![]() | ViewState | 同一のページに対する複数の要求にわたって、Parameter オブジェクトのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。 ( Parameter から継承されます。) |

SessionParameter メソッド

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

名前 | 説明 | |
---|---|---|
![]() | Clone | オーバーライドされます。 現在の SessionParameter インスタンスの複製を返します。 |
![]() | Evaluate | オーバーライドされます。 SessionParameter オブジェクトの値を更新して返します。 |
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
![]() | LoadViewState | データ ソース ビューの、以前保存したビューステートを復元します。 ( Parameter から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
![]() | OnParameterChanged | Parameter オブジェクトを格納する ParameterCollection コレクションの OnParametersChanged メソッドを呼び出します。 ( Parameter から継承されます。) |
![]() | SaveViewState | ページがサーバーにポストバックされた時間以降に発生した、Parameter オブジェクトのビューステートへの変更を保存します。 ( Parameter から継承されます。) |
![]() | SetDirty | Parameter オブジェクトの状態がビューステートで記録されるように、このオブジェクトをマークします。 ( Parameter から継承されます。) |
![]() | TrackViewState | Parameter オブジェクトがビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState オブジェクトに格納して、同じページに対する複数の要求にわたって永続化できます。 ( Parameter から継承されます。) |

SessionParameter メンバ
セッション変数の値を、パラメータ オブジェクトにバインドします。
SessionParameter データ型で公開されるメンバを以下の表に示します。



名前 | 説明 | |
---|---|---|
![]() | ConvertEmptyStringToNull | Parameter オブジェクトのバインド先の値が String.Empty の場合に、その値を null 参照 (Visual Basic では Nothing) に変換する必要があるかどうかを示す値を取得または設定します。(Parameter から継承されます。) |
![]() | DefaultValue | パラメータの既定値を指定します。Evaluate メソッドの呼び出し時に、パラメータはこの値にバインドされ、初期化前の状態に戻されます。(Parameter から継承されます。) |
![]() | Direction | Parameter オブジェクトを使用して値をコントロールにバインドするかどうか、またはそのコントロールを使用して値を変更できるかどうかを示します。(Parameter から継承されます。) |
![]() | Name | パラメータの名前を取得または設定します。(Parameter から継承されます。) |
![]() | SessionField | パラメータのバインド先のセッション変数の名前を取得または設定します。 |
![]() | Size | パラメータのサイズを取得または設定します。(Parameter から継承されます。) |
![]() | Type | パラメータの型を取得または設定します。(Parameter から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | IsTrackingViewState | Parameter オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。(Parameter から継承されます。) |
![]() | ViewState | 同一のページに対する複数の要求にわたって、Parameter オブジェクトのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。(Parameter から継承されます。) |

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

名前 | 説明 | |
---|---|---|
![]() | Clone | オーバーライドされます。 現在の SessionParameter インスタンスの複製を返します。 |
![]() | Evaluate | オーバーライドされます。 SessionParameter オブジェクトの値を更新して返します。 |
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
![]() | LoadViewState | データ ソース ビューの、以前保存したビューステートを復元します。 (Parameter から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
![]() | OnParameterChanged | Parameter オブジェクトを格納する ParameterCollection コレクションの OnParametersChanged メソッドを呼び出します。 (Parameter から継承されます。) |
![]() | SaveViewState | ページがサーバーにポストバックされた時間以降に発生した、Parameter オブジェクトのビューステートへの変更を保存します。 (Parameter から継承されます。) |
![]() | SetDirty | Parameter オブジェクトの状態がビューステートで記録されるように、このオブジェクトをマークします。 (Parameter から継承されます。) |
![]() | TrackViewState | Parameter オブジェクトがビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState オブジェクトに格納して、同じページに対する複数の要求にわたって永続化できます。 (Parameter から継承されます。) |

- SessionParameterのページへのリンク