EntityDataSource.WhereParameters 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.Entity.dll

取得用於建立 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

屬性值

ParameterCollection

用於建立 WHERE 子句的參數。

實作

WhereParameters

屬性

BrowsableAttribute PersistenceModeAttribute

範例

下列範例中的 XML 標記在 .aspx 檔案中，會從 控制項擷取值，並將它當做參數傳遞至 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 範例與下列 ObjectQuery<T> 名稱 onlineOrders 相同：

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 述詞。 控制項 WhereParameters 的 EntityDataSource 屬性會 ParameterCollection 指定 ，其中包含要提供給查詢之 WHERE 子句的參數。 屬性 WhereParameters 會使用具名引數來參考提供給 Where 屬性之字串中指定的參數。

WhereParameters如果未設定屬性，則不會進行任何參數替代。 WHERE 子句前面加上符號的所有參數名稱「 @" ，都必須在 中 ParameterCollection 具有相符的名稱。 中參數 ParameterCollection 不允許 Null 值。