SessionParameter クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SessionParameter クラス

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

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

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

Visual Basic (宣言)

Public Class SessionParameter
    Inherits Parameter

Visual Basic (使用法)

Dim instance As SessionParameter

public class SessionParameter : Parameter

C++

public ref class SessionParameter : public
 Parameter

public class SessionParameter extends Parameter

JScript

public class SessionParameter extends
 Parameter

解説

SessionParameter クラスを使用すると、HttpSessionState 変数の値を、SQL パラメータクエリ、ビジネスオブジェクトのメソッド、またはフィルタ処理式で使用されるパラメータにバインドできます。

SessionParameter クラスは、Parameter クラスから継承したこれらのプロパティに加えて、SessionField プロパティを提供しています。SessionField プロパティは、SessionParameter を使って値を取得する際のセッション変数を識別します。

メモ
SessionParameter オブジェクトが指定されていても、対応するセッション変数が設定されていないと、データをパラメータにバインドするコントロールは例外をスローします。同様に、セッション変数が null 参照 (Visual Basic では Nothing) で設定された場合、データは表示されません。このような状況を防ぐには、必要に応じて DefaultValue プロパティを設定します。

メモ

SessionParameter オブジェクトが指定されていても、対応するセッション変数が設定されていないと、データをパラメータにバインドするコントロールは例外をスローします。同様に、セッション変数が null 参照 (Visual Basic では Nothing) で設定された場合、データは表示されません。このような状況を防ぐには、必要に応じて DefaultValue プロパティを設定します。

使用例

SessionParameter オブジェクトを使用して、Web ブラウザセッションに格納された従業員 ID の値を SQL パラメータクエリにバインドする方法を次のコード例に示します。まず、SessionParameter オブジェクトを SqlDataSource コントロールの SelectParameters コレクションに追加しています。次に、SelectCommand プロパティに設定された SQL パラメータクエリが、このオブジェクトを使用してデータを取得し、それを GridView コントロールに表示しています。SessionParameter オブジェクトには DefaultValue プロパティが設定されているため、この例を実行する前に "empid" という名前のセッション変数を設定しなかったとしてもデータが表示されます。

Visual Basic

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

.NET Framework のセキュリティ

AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

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

スレッドセーフ

この型の 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

参照

関連項目
SessionParameter メンバ
System.Web.UI.WebControls 名前空間
ControlParameter クラス
CookieParameter クラス
FormParameter クラス
ProfileParameter クラス
QueryStringParameter クラス
その他の技術情報
データソースコントロールの概要
データソースコントロールとパラメータの使用

>> 「SessionParameter クラス」を含む用語の索引
SessionParameter クラスのページへのリンク

SessionParameter クラスとは？わかりやすく解説

SessionParameter クラス

「SessionParameter クラス」の関連用語


	© 2025 Microsoft.All rights reserved.

SessionParameter クラスとは？ わかりやすく解説

SessionParameter クラス

急上昇のことば

「SessionParameter クラス」の関連用語

SessionParameter クラスとは？わかりやすく解説