ObjectDataSource.SelectParameters プロパティとは何？わかりやすく解説 Weblio辞書

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

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

ObjectDataSource.SelectParameters プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

SelectMethod メソッドによって使用されるパラメータを格納するパラメータコレクションを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 SelectParameters As ParameterCollection

Visual Basic (使用法)

Dim instance As ObjectDataSource
Dim value As ParameterCollection

value = instance.SelectParameters

public ParameterCollection SelectParameters { get;
 }

C++

public:
property ParameterCollection^ SelectParameters {
    ParameterCollection^ get ();
}

/** @property */
public ParameterCollection get_SelectParameters ()

JScript

public function get SelectParameters
 () : ParameterCollection

プロパティ値
SelectMethod メソッドによって使用されるパラメータを格納している ParameterCollection。

解説

SelectParameters コレクションに格納されているパラメータと SelectMethod プロパティシグネチャで指定されたメソッドのパラメータは、名前と型が一致している必要があります。コレクション内のパラメータは、データバインドコントロール内のデータ、宣言によって指定されたパラメータ、およびプログラムによって追加されたパラメータによって異なります。詳細については、Select のトピックの「パラメータのマージ」および「ObjectDataSource コントロールにおけるパラメータの使用」を参照してください。

SelectParameters プロパティは、ObjectDataSource コントロールに関連付けられた ObjectDataSourceView オブジェクトが格納する SelectParameters プロパティを取得します。

オブジェクトの有効期間とメソッド解決の詳細については、SelectMethod のトピックを参照してください。

使用例

ObjectDataSource コントロールを使用して単一のデータレコードを取得し、DetailsView コントロールに表示する方法を次のコード例に示します。ObjectDataSource は、EmployeeLogic クラスの GetEmployee メソッドを呼び出して、特定の従業員レコードを取得します。GetEmployee メソッドには、従業員 ID パラメータが必要です。ObjectDataSource コントロールは、SelectParameters コレクション内の QueryStringParameter オブジェクトを使用して、GetEmployee メソッドに ID を渡します。

EmployeeLogic クラスおよび GetEmployee メソッドの実装の例を確認する場合は、ObjectDataSource のトピックを参照してください。

Visual Basic

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB"
 Assembly="Samples.AspNet.VB"
 %>
<%@ Page language="vb" %>
<html>
  <head>
    <title>ObjectDataSource - VB Example</title>
  </head>
  <body>
    <form id="Form1" method="post"
 runat="server">

        <asp:detailsview
          id="DetailsView1"
          runat="server"
          datasourceid="ObjectDataSource1">
        </asp:detailsview>

<!-- Security Note: The ObjectDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of
 input from the client.
     Security Note: To validate the value of
 the QueryStringParameter, handle the Selecting event. -->

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetEmployee"
          typename="Samples.AspNet.VB.EmployeeLogic"
 >
          <selectparameters>
            <asp:querystringparameter name="anID"
 querystringfield="empid" defaultvalue="-1"
 />
          </selectparameters>
        </asp:objectdatasource>

    </form>
  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS"
 Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<html>
  <head>
    <title>ObjectDataSource - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:detailsview
          id="DetailsView1"
          runat="server"
          datasourceid="ObjectDataSource1">
        </asp:detailsview>

<!-- Security Note: The ObjectDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the
 Selecting event. -->

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetEmployee"
          typename="Samples.AspNet.CS.EmployeeLogic" >
          <selectparameters>
            <asp:querystringparameter name="anID" querystringfield="empid"
 defaultvalue="-1" />
          </selectparameters>
        </asp:objectdatasource>

    </form>
  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.jsl"
 Assembly="Samples.AspNet.jsl" %>
<%@ Page Language="VJ#" %>
<html>
  <head>
    <title>ObjectDataSource - VJ# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:detailsview
          id="DetailsView1"
          runat="server"
          datasourceid="ObjectDataSource1">
        </asp:detailsview>

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetEmployee"
          typename="Samples.AspNet.jsl.EmployeeLogic" >
          <selectparameters>
            <asp:querystringparameter name="anID" querystringfield="empid"
 defaultvalue="-1" />
          </selectparameters>
        </asp:objectdatasource>

    </form>
  </body>
</html>