SessionParameter クラス

定義

セッション変数の値をパラメーター オブジェクトにバインドします。

public ref class SessionParameter : System::Web::UI::WebControls::Parameter
public class SessionParameter : System.Web.UI.WebControls.Parameter
type SessionParameter = class
    inherit Parameter
Public Class SessionParameter
Inherits Parameter
継承
SessionParameter

次の例は、 オブジェクトの使用方法を SessionParameter 示しています。 この例では、別のページが という名前 empidのセッション変数に従業員 ID 値を格納していることを前提としています。 このページの例では、クエリの empid 句でセッション変数を Where 使用し、クエリの結果をコントロールに GridView 表示します。 DefaultValueオブジェクトの SessionParameter プロパティは 5 に設定されているため、例を実行する前に という名前empidのセッション変数が設定されていない場合、employeeID値が 5 のレコードのデータは引き続き表示されます。

<%@ Page language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<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="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<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>

注釈

SessionParameterオブジェクトは、通常、データベース クエリの 句に変数の値をHttpSessionStateWhere含めるために使用されます。 プロパティは SessionField 、 が値を取得する SessionParameter セッション変数を識別します。

注意

オブジェクトを使用してデータをパラメーターにバインドするコントロールでは、 SessionParameter 指定されたセッション変数が設定されていない場合に例外がスローされることがあります。 このエラーを回避するには (必要に応じて) プロパティを設定します DefaultValue

コンストラクター

SessionParameter()

SessionParameter クラスの名前のない新しいインスタンスを初期化します。

SessionParameter(SessionParameter)

original パラメーターで指定されたインスタンスの値を使用して、SessionParameter クラスの新しいインスタンスを初期化します。

SessionParameter(String, DbType, String)

指定された名前と型を使用し、指定されたセッション状態の名前/値ペアにパラメーターをバインドして、SessionParameter クラスの新しいインスタンスを初期化します。 このコンストラクターは、データベース型用です。

SessionParameter(String, String)

バインド先のセッション状態の名前/値ペアを識別する文字列を指定して、SessionParameter クラスの名前付きの新しいインスタンスを初期化します。

SessionParameter(String, TypeCode, String)

バインド先のセッション状態の名前/値ペアを識別する文字列を指定して、SessionParameter クラスの厳密に型指定された名前付きの新しいインスタンスを初期化します。

プロパティ

ConvertEmptyStringToNull

Parameter オブジェクトのバインド先の値が Empty の場合に、その値を null に変換する必要があるかどうかを示す値を取得または設定します。

(継承元 Parameter)
DbType

パラメーターのデータベース型を取得または設定します。

(継承元 Parameter)
DefaultValue

パラメーターの既定値を指定します。Evaluate(HttpContext, Control) メソッドの呼び出し時に、パラメーターはこの値にバインドされ、初期化前の状態に戻されます。

(継承元 Parameter)
Direction

Parameter オブジェクトを使用して値をコントロールにバインドするかどうか、またはそのコントロールを使用して値を変更できるかどうかを示します。

(継承元 Parameter)
IsTrackingViewState

Parameter オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。

(継承元 Parameter)
Name

パラメーターの名前を取得または設定します。

(継承元 Parameter)
SessionField

パラメーターのバインド先のセッション変数の名前を取得または設定します。

Size

パラメーターのサイズを取得または設定します。

(継承元 Parameter)
Type

パラメーターの型を取得または設定します。

(継承元 Parameter)
ViewState

同一のページに対する複数の要求にわたって、Parameter オブジェクトのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。

(継承元 Parameter)

メソッド

Clone()

現在の SessionParameter インスタンスの複製を返します。

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
Evaluate(HttpContext, Control)

SessionParameter オブジェクトの値を更新して返します。

GetDatabaseType()

現在の DbType インスタンスの CLR 型と等価な Parameter 値を取得します。

(継承元 Parameter)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
LoadViewState(Object)

データ ソース ビューの、以前保存したビューステートを復元します。

(継承元 Parameter)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
OnParameterChanged()

OnParametersChanged(EventArgs) オブジェクトを格納する ParameterCollection コレクションの Parameter メソッドを呼び出します。

(継承元 Parameter)
SaveViewState()

ページがサーバーにポスト バックされた時間以降に発生した、Parameter オブジェクトのビューステートへの変更を保存します。

(継承元 Parameter)
SetDirty()

Parameter オブジェクトの状態がビューステートで記録されるように、このオブジェクトをマークします。

(継承元 Parameter)
ToString()

このインスタンスの値を、それと等価の文字列形式に変換します。

(継承元 Parameter)
TrackViewState()

Parameter オブジェクトがビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState オブジェクトに格納して、同じページに対する複数の要求にわたって永続化できます。

(継承元 Parameter)

明示的なインターフェイスの実装

ICloneable.Clone()

現在の Parameter インスタンスの複製を返します。

(継承元 Parameter)
IStateManager.IsTrackingViewState

Parameter オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。

(継承元 Parameter)
IStateManager.LoadViewState(Object)

データ ソース ビューの、以前保存したビューステートを復元します。

(継承元 Parameter)
IStateManager.SaveViewState()

ページがサーバーにポスト バックされた時間以降に発生した、Parameter オブジェクトのビューステートへの変更を保存します。

(継承元 Parameter)
IStateManager.TrackViewState()

Parameter オブジェクトがビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState オブジェクトに格納して、同じページに対する複数の要求にわたって永続化できます。

(継承元 Parameter)

適用対象

こちらもご覧ください