DataSourceSelectArguments 類別

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

提供一項機制，讓資料繫結控制項於擷取資料時，用來向資料來源控制項要求資料相關的作業。 此類別無法獲得繼承。

public ref class DataSourceSelectArguments sealed

public sealed class DataSourceSelectArguments

type DataSourceSelectArguments = class

Public NotInheritable Class DataSourceSelectArguments

繼承

Object

DataSourceSelectArguments

備註

資料繫結控制項會 DataSourceSelectArguments 使用 類別來要求資料來源控制項對結果集執行其他資料相關作業，例如排序資料或傳回特定資料子集。 列舉會列舉 DataSourceCapabilities 這些資料相關的作業。 下表指出 類別如何 DataSourceSelectArguments 支援這些資料相關作業。

功能	相關的 DataSourceSelectArguments 屬性
DataSourceCapabilities.Sort	SortExpression
DataSourceCapabilities.Page	StartRowIndex, MaximumRows
DataSourceCapabilities.RetrieveTotalRowCount	RetrieveTotalRowCount, TotalRowCount

資料繫結控制項會明確呼叫 PerformSelect 方法來系結資料，這會呼叫 Select(DataSourceSelectArguments, DataSourceViewSelectCallback) 它們所關聯的資料來源控制項方法。 如此一來，資料繫結控制項會視需要從資料來源控制項擷取資料。 Select(DataSourceSelectArguments, DataSourceViewSelectCallback)因為方法接受 DataSourceSelectArguments 參數，資料繫結控制項負責建立和管理 DataSourceSelectArguments 物件，並在從資料來源控制項擷取資料時傳遞至 Select(DataSourceSelectArguments, DataSourceViewSelectCallback) 方法。

在某些情況下，資料繫結控制項可能不需要任何其他資料相關功能。 在此情況下，資料繫結控制項會將 Empty 引數物件傳遞至 Select(DataSourceSelectArguments, DataSourceViewSelectCallback) 方法。

針對已排序的結果集，資料繫結控制項會在執行時間檢查資料來源檢視的屬性 CanSort ，並使用 方法新增 DataSourceCapabilities.Sort 功能 AddSupportedCapabilities(DataSourceCapabilities) 。 作為個別作業，資料繫結控制項可以藉由在傳遞至 Select(DataSourceSelectArguments, DataSourceViewSelectCallback) 方法的物件上 DataSourceSelectArguments 設定 SortExpression 屬性，從資料來源控制項要求已排序的結果集。

對於分頁案例，資料繫結控制項會在執行時間檢查資料來源檢視的屬性 CanPage ，並使用 方法新增 DataSourceCapabilities.Page 功能 AddSupportedCapabilities(DataSourceCapabilities) 。 做為個別作業，資料繫結控制項可以藉由在傳遞至 Select(DataSourceSelectArguments, DataSourceViewSelectCallback) 方法的物件上 DataSourceSelectArguments 設定 StartRowIndex 和 MaximumRows 屬性，向資料來源控制項要求資料子集以進行分頁。

若要擷取分頁案例的總數據列計數，資料繫結控制項會在執行時間檢查資料來源檢視的屬性 CanRetrieveTotalRowCount ，並使用 方法新增 DataSourceCapabilities.RetrieveTotalRowCount 功能 AddSupportedCapabilities(DataSourceCapabilities) 。 作為個別作業，資料繫結控制項可以藉由在傳遞至 Select(DataSourceSelectArguments, DataSourceViewSelectCallback) 方法的物件上 DataSourceSelectArguments 設定 RetrieveTotalRowCount 屬性，向資料來源控制項要求總數據列計數以進行分頁。 Select(DataSourceSelectArguments, DataSourceViewSelectCallback)當方法傳回時，屬性會包含 TotalRowCount 資料列計數總計。

重要

如果已設定任何 DataSourceSelectArguments 屬性，但目前系結的資料來源控制項不支援要求的功能， InvalidOperationException 則會在呼叫 方法時 DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) 擲回例外狀況。

建構函式

DataSourceSelectArguments()	初始化 DataSourceSelectArguments 類別預設的新執行個體。
DataSourceSelectArguments(Int32, Int32)	針對分頁案例，使用指定的起始位置和傳回的資料列數目，初始化 DataSourceSelectArguments 類別的新執行個體。
DataSourceSelectArguments(String)	使用指定的排序運算式，初始化 DataSourceSelectArguments 類別的新執行個體。
DataSourceSelectArguments(String, Int32, Int32)	針對分頁案例，使用指定的排序運算式、起始位置和傳回的資料列數目，初始化 DataSourceSelectArguments 類別的新執行個體。

屬性

Empty	取得排序運算式設定為 DataSourceSelectArguments 的 Empty 物件。
MaximumRows	取得或設定值，表示資料來源控制項為資料擷取作業傳回的資料列最大數目。
RetrieveTotalRowCount	取得或設定值，指出資料擷取作業時資料來源控制項是否應該擷取所有資料列的計數。
SortExpression	取得或設定運算式，資料來源檢視可用來排序 Select(DataSourceSelectArguments, DataSourceViewSelectCallback) 方法所擷取的資料。
StartRowIndex	取得或設定值，表示資料擷取作業期間，於擷取資料列時，資料來源控制項應該使用的起始位置。
TotalRowCount	取得或設定資料擷取作業時擷取的資料列數目。

方法

AddSupportedCapabilities(DataSourceCapabilities)	將一項功能加入至 DataSourceSelectArguments 執行個體，這項功能可用來比較支援的功能和要求的功能。
Equals(Object)	判斷指定的 DataSourceSelectArguments 執行個體和目前執行個體是否相等。
GetHashCode()	傳回 DataSourceSelectArguments 型別的雜湊碼。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
RaiseUnsupportedCapabilitiesError(DataSourceView)	比較 ExecuteSelect(DataSourceSelectArguments) 作業要求的功能與指定資料來源檢視支援的功能。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• DataSourceCapabilities