SearchExpression 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供方法來搜尋一個或多個欄位中的字串值，並與指定的字串值進行比較。
public ref class SearchExpression : System::Web::UI::WebControls::Expressions::ParameterDataSourceExpressionpublic class SearchExpression : System.Web.UI.WebControls.Expressions.ParameterDataSourceExpressiontype SearchExpression = class
inherit ParameterDataSourceExpressionPublic Class SearchExpression
Inherits ParameterDataSourceExpression- 繼承
範例
下列範例示範如何在 AdventureWorks 資料庫的 Products 資料表中，搜尋以控制項中指定之字串開頭的產品 SearchTextBox 。 控制項中所傳回的結果 LinqDataSource 會顯示在 GridView 控制項中。
這個程式碼範例是 逐步解說：使用宣告式語法在網頁中篩選資料時，所提供之較大範例的一部分。
備註
此 QueryExtender 控制項可讓您使用類別來篩選網頁中的資料 SearchExpression 。 類別會將 SearchExpression 欄位或欄位中指定的字串與您提供的值進行比較。 運算式會執行「開頭為」、「包含」或「結尾為」搜尋。 您必須為和屬性指定值，才能 SearchType DataFields 表示您想要執行的搜尋類型，以及您想要搜尋的資料欄位。 如果您在控制項中使用的 LINQ 提供者 QueryExtender 支援區分大小寫，您可以使用 ComparisonType 屬性來啟用或忽略區分大小寫。
ASP.NET 控制項可提供搜尋的值。 若要指定這個屬性，您可以將 ControlID ControlParameter 物件中類別的屬性設定 SearchExpression 為 ASP.NET 控制項的識別碼。 例如，如果在文字方塊中輸入要搜尋的值，則 ControlID 必須將屬性設定為文字方塊控制項的識別碼。 您可以將 SearchExpression 類別與其他支援的運算式搭配使用 QueryExtender ，例如 RangeExpression 篩選。 例如，您可以搜尋包含字串 "茶" 的產品名稱，以及介於100和200之間的標價。
建構函式
| SearchExpression() |
初始化 SearchExpression 類別的新執行個體。 |
屬性
| ComparisonType |
取得或設定要執行的字串比較類型。 |
| Context |
取得擁有者控制項的 HttpContext 執行個體。 (繼承來源 DataSourceExpression) |
| DataFields |
取得或設定要搜尋的單一欄位或欄位的逗點分隔清單。 |
| DataSource |
取得與擁有者控制項相關聯的資料來源物件。 (繼承來源 DataSourceExpression) |
| IsTrackingViewState |
取得值，這個值指出資料來源運算式物件是否正在追蹤其檢視狀態變更。 (繼承來源 DataSourceExpression) |
| Owner |
取得擁有者控制項。 (繼承來源 DataSourceExpression) |
| Parameters |
取得與這個 DataSourceExpression 物件相關聯的參數。 (繼承來源 ParameterDataSourceExpression) |
| SearchType |
取得或設定 SearchType 值，這個值會判斷要針對字串何處進行搜尋。 |
| ViewState |
取得 StateBag 類別的執行個體，這個執行個體包含目前的檢視狀態資訊。 (繼承來源 DataSourceExpression) |
方法
| Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
| GetHashCode() |
做為預設雜湊函式。 (繼承來源 Object) |
| GetQueryable(IQueryable) |
根據 SearchExpression 物件，將 IQueryable 物件套用至指定的 SearchType 物件。 |
| GetType() |
取得目前執行個體的 Type。 (繼承來源 Object) |
| LoadViewState(Object) |
載入 ParameterDataSourceExpression 物件中必須保存的值狀態。 (繼承來源 ParameterDataSourceExpression) |
| MemberwiseClone() |
建立目前 Object 的淺層複製。 (繼承來源 Object) |
| SaveViewState() |
儲存 ParameterDataSourceExpression 物件的目前檢視狀態。 (繼承來源 ParameterDataSourceExpression) |
| SetContext(Control, HttpContext, IQueryableDataSource) |
使用指定的擁有者控制項、內容和資料來源執行運算式。 (繼承來源 ParameterDataSourceExpression) |
| SetDirty() |
標記 DataSourceExpression 物件，以便將其狀態儲存在檢視狀態中。 (繼承來源 DataSourceExpression) |
| ToString() |
傳回代表目前物件的字串。 (繼承來源 Object) |
| TrackViewState() |
追蹤 ParameterDataSourceExpression 物件的檢視狀態變更，以將變更儲存於此物件的 StateBag 物件中。 (繼承來源 ParameterDataSourceExpression) |
明確介面實作
| IStateManager.IsTrackingViewState |
當由類別實作時取得值，這個值指出資料來源運算式物件是否正在追蹤其檢視狀態變更。 (繼承來源 DataSourceExpression) |
| IStateManager.LoadViewState(Object) |
當由類別實作時，載入資料來源運算式物件先前儲存的檢視狀態。 (繼承來源 DataSourceExpression) |
| IStateManager.SaveViewState() |
當類別實作時，儲存 DataSourceExpression 物件的目前檢視狀態。 (繼承來源 DataSourceExpression) |
| IStateManager.TrackViewState() |
當由類別實作時，追蹤 DataSourceExpression 物件的檢視狀態變更，以便該變更可針對資料來源運算式物件儲存到 StateBag 物件中。 (繼承來源 DataSourceExpression) |