ObjectDataSource.SelectMethod 속성

  • 참조

정의

네임스페이스:
System.Web.UI.WebControls
어셈블리:
System.Web.dll

ObjectDataSource 컨트롤이 데이터를 검색할 때 호출하는 메서드나 함수의 이름을 가져오거나 설정합니다.

public:
 property System::String ^ SelectMethod { System::String ^ get(); void set(System::String ^ value); };
public string SelectMethod { get; set; }
member this.SelectMethod : string with get, set
Public Property SelectMethod As String

속성 값

String

ObjectDataSource에서 데이터를 검색할 때 사용하는 메서드나 함수의 이름을 나타내는 문자열입니다. 기본값은 빈 문자열("")입니다.

예제

다음 코드 예제에서는 어떻게를 GridView 컨트롤에서 사용 하 여 데이터를 표시할 수 있습니다는 ObjectDataSource Web Forms 페이지에 컨트롤입니다. ObjectDataSource 식별 하는 부분적으로 또는 완전히 정규화 된 클래스 이름을 해당 TypeName 속성과 메서드를 사용 하 여 데이터를 검색 하기 위해 호출 됩니다 해당 SelectMethod 속성입니다. 런타임 시 개체를 만든 및 리플렉션을 사용 하 여 메서드를 호출 합니다. GridView 컨트롤을 열거 합니다 IEnumerable 컬렉션에서 지정 된 메서드에 의해 반환 되는 SelectMethod 속성 및 해당 데이터를 표시 합니다.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1" />

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.CS.EmployeeLogic" />

    </form>
  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %>
<%@ Page language="vb" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - Visual Basic Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1" />

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.VB.EmployeeLogic" />

    </form>
  </body>
</html>

설명

지정된 된 메서드는 모든 메서드 시그니처를 가질 수 있지만 다음 표에 나온 형식 중 하나를 반환 하는 ObjectDataSource 성공적으로 호출할 수는 컨트롤입니다.

반환 형식 작업
IEnumerable 합니다 IEnumerable 에서 반환 되는 Select 메서드.
DataTable A DataView 사용 하 여 만들어집니다 합니다 DataTable 반환한 및는 Select 메서드.
DataView A DataView 에서 반환 되는 Select 메서드.
DataSet 첫 번째 DataTable 의 합니다 DataSet 추출 됩니다 및 DataView 만들어지고 반환한는 Select 메서드.
Object 개체 단일 요소에 래핑됩니다 IEnumerable 컬렉션에서 반환 된 Select 메서드.

SelectMethod 에 위임 하는 속성을 SelectMethod 의 속성을 ObjectDataSourceView 개체와 연결 된는 ObjectDataSource 컨트롤.

사용 하는 경우는 ObjectDataSource 클래스를 삭제 하거나 데이터를 업데이트, 매개 변수 이름에 대 한 구성 되었는지 확인 합니다 ObjectDataSource 에서 제어할 합니다 DeleteParameters 컬렉션 또는 UpdateParameters 컬렉션 select 메서드에 의해 반환 되는 열 이름과 일치 .

개체 수명

로 식별 되는 메서드를 SelectMethod 속성에는 인스턴스 메서드 일 수 있습니다 또는 static (Shared Visual Basic에서) 메서드. 인스턴스 메서드인 경우 비즈니스 개체가 만들어지고 소멸 될 때마다 지정 된 메서드는 SelectMethod 속성 이라고 합니다. 처리할 수 있습니다 합니다 ObjectCreated 및 ObjectCreating 에 지정 된 메서드 앞에 비즈니스 개체를 사용 하는 이벤트를 SelectMethod 속성 이라고 합니다. 처리할 수도 있습니다는 ObjectDisposing 메서드를 지정 된 후 발생 하는 이벤트를 SelectMethod 속성 이라고 합니다. 비즈니스 개체를 구현 하는 경우는 IDisposable 인터페이스는 Dispose 개체를 제거 하기 전에 호출 됩니다. 방법이 static (Shared Visual Basic의), 비즈니스 개체 생성 되지 않고 처리할 수 없는 합니다 ObjectCreated, ObjectCreating, 및 ObjectDisposing 이벤트입니다.

병합 하는 매개 변수

매개 변수가 추가 됩니다는 SelectParameters 이러한 원본에서 컬렉션:

  • 선언적으로 SelectParameters 요소입니다.

  • 프로그래밍 방식으로 Selecting 메서드.

먼저에 나열 된 매개 변수는 SelectParameters 요소가 추가 됩니다. 둘째, 매개 변수는 프로그래밍 방식으로 추가 및 제거에 Selecting 하기 전에 발생 하는 이벤트를 Select 메서드를 실행 합니다. 메서드는 매개 변수를 병합 된 후 확인 됩니다. 메서드 확인은 다음 섹션에 설명 되어 있습니다.

중요

클라이언트에서 받은 모든 매개 변수 값을 확인 해야 합니다. 런타임에 매개 변수 값을 SelectMethod 속성입니다.

메서드 확인

경우는 Select 메서드를 호출할 매개 변수에서 선언적으로 생성 된 데이터 바인딩된 컨트롤에서 데이터 필드를 SelectParameters 요소 및에 추가 된 매개 변수는 Selecting 이벤트 처리기 모두 병합 됩니다. (자세한 내용은 이전 섹션 참조). ObjectDataSource 호출할 메서드를 찾으려면 다음 시도 제어 합니다. 에 지정 된 이름 가진 하나 이상의 메서드를 찾습니다 먼저는 SelectMethod 속성입니다. 일치 하는 항목이 없으면는 InvalidOperationException 예외가 throw 됩니다. 일치 하는 항목이 있으면 매개 변수 이름과 일치 하는 찾습니다. 예를 들어 지정 된 형식 합니다 TypeName 속성이 라는 두 개의 메서드도 SelectARecord합니다. 하나의 SelectARecord 하나의 매개 변수가 ID, 및 다른 SelectARecord 두 매개 변수가 Name 및 Number합니다. 경우는 SelectParameters 컬렉션에 명명 된 매개 변수만 ID의 SelectARecord 메서드를만 ID 매개 변수 라고 합니다. 메서드를 확인 하는 데 매개 변수의 형식을 확인 하지 않습니다. 매개 변수의 순서는 중요 하지 않습니다.

경우는 DataObjectTypeName 속성, 메서드를 다른 방식으로 확인 됩니다. ObjectDataSource 에 지정 된 이름의 메서드를 찾습니다는 SelectMethod 는 매개 변수 형식 중 하나를 사용 하는 속성에 지정 된 된 DataObjectTypeName 속성. 이 경우 매개 변수의 이름을 중요 하지 않습니다.

적용 대상

추가 정보