EntityDataSource.WhereParameters プロパティ

定義

WHERE 句を作成するために使用されるパラメーターのコレクションを取得します。

public:
 property System::Web::UI::WebControls::ParameterCollection ^ WhereParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection WhereParameters { get; }
[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.WhereParameters : System.Web.UI.WebControls.ParameterCollection
Public ReadOnly Property WhereParameters As ParameterCollection

プロパティ値

WHERE 句の作成に使用されるパラメーター。

実装

属性

次の例の .aspx ファイルの XML マークアップは、コントロールから値を取得し、パラメーターとして プロパティに Where 渡します。

<asp:EntityDataSource ID="SalesOrderHeader" runat="server"
  ConnectionString="name=AdventureWorksEntities"
  DefaultContainerName="AdventureWorksEntities" EnableDelete="True"
  EnableInsert="True" EnableUpdate="True" EntitySetName="SalesOrderHeader"
  EntityTypeFilter="" OrderBy="it.TotalDue DESC" Select=""
   Where="it.OnlineOrderFlag = TRUE AND it.TotalDue > @ordercost">
  <WhereParameters>
    <asp:ControlParameter ControlID="costLimit" DbType="Int32"
      DefaultValue="2500" Name="ordercost" PropertyName="Text" />
  </WhereParameters>
</asp:EntityDataSource>

前の XML の例は、 という名前onlineOrdersの次ObjectQuery<T>の例と同じです。

ObjectQuery<SalesOrderHeader> onlineOrders =
      context.SalesOrderHeader
       .Where("it.OnlineOrderFlag = TRUE AND it.TotalDue > @ordercost",
         new ObjectParameter("ordercost", orderCost))
        .OrderBy("it.TotalDue DESC");

注釈

クラスの Where メソッドと同様に ObjectQuery<T> 、 プロパティに割り当てられた述語にパラメーターを Where 渡すことができます。 コントロールの プロパティはWhereParametersEntityDataSourceParameterCollectionクエリの WHERE 句に指定するパラメーターを含む を指定します。 プロパティは WhereParameters 、名前付き引数を使用して、 プロパティに指定された文字列で指定されたパラメーターを Where 参照します。

プロパティが WhereParameters 設定されていない場合、パラメーターの置換は行われません。 WHERE 句の前に記号 "@" が付いたパラメーター名はすべて、 内に一致する名前を ParameterCollection持つ必要があります。 内のパラメーターには Null 値を ParameterCollection使用できません。

適用対象