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) 메서드. 데이터 바인딩된 컨트롤을 별도 작업으로 설정 하 여 데이터 소스 컨트롤에서 설정 하는 정렬된 된 결과 요청할 수 있습니다는 SortExpression 속성을 DataSourceSelectArguments 에 전달 된 개체는 Select(DataSourceSelectArguments, DataSourceViewSelectCallback) 메서드.

페이징 시나리오를 위해 데이터 바인딩된 컨트롤을 데이터 원본 뷰를 확인 CanPage 속성에서 런타임 및 추가 DataSourceCapabilities.Page 기능을 사용 하는 AddSupportedCapabilities(DataSourceCapabilities) 메서드. 별도 작업으로 데이터 바인딩된 컨트롤을 요청할 수 데이터 하위 집합 페이징에 대 한 데이터 소스 컨트롤에서 설정 하 여 합니다 StartRowIndex 및 MaximumRows 속성에는 DataSourceSelectArguments 에 전달 된 개체는 Select(DataSourceSelectArguments, DataSourceViewSelectCallback) 메서드.

데이터 바인딩된 컨트롤 페이징 시나리오를 위해 총 행 수를 검색 하려면 데이터 원본 뷰를 확인 CanRetrieveTotalRowCount 속성에서 런타임 및 추가 DataSourceCapabilities.RetrieveTotalRowCount 기능을 사용 하는 AddSupportedCapabilities(DataSourceCapabilities) 메서드. 별도 작업으로 데이터 바인딩된 컨트롤을 요청할 수 총 행 수를 페이징에 대 한 데이터 소스 컨트롤에서 설정 하 여는 RetrieveTotalRowCount 속성에는 DataSourceSelectArguments 에 전달 된 개체는 Select(DataSourceSelectArguments, DataSourceViewSelectCallback) 메서드. 경우는 Select(DataSourceSelectArguments, DataSourceViewSelectCallback) 메서드는 반환 된 총 행 수에 포함 된를 TotalRowCount 속성입니다.

중요

하나라는 DataSourceSelectArguments 속성을 설정 하지만 현재 바인딩된 데이터 소스 컨트롤 필요한 기능을 지원 하지 않습니다는 InvalidOperationException 때 예외가 throw 됩니다는 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