ObjectDataSource.SelectParameters 속성

  • 참조

정의

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

SelectMethod 속성에 지정된 메서드에서 사용하는 매개 변수의 컬렉션을 가져옵니다.

public:
 property System::Web::UI::WebControls::ParameterCollection ^ SelectParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection SelectParameters { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.SelectParameters : System.Web.UI.WebControls.ParameterCollection
Public ReadOnly Property SelectParameters As ParameterCollection

속성 값

ParameterCollection

SelectMethod 속성에 지정된 메서드에서 사용하는 매개 변수의 컬렉션입니다.

특성
PersistenceModeAttribute

예제

다음 코드 예제에 사용 하 여 단일 데이터 레코드를 검색 하는 방법을 보여 줍니다.는 ObjectDataSource 컨트롤에 표시 하는 DetailsView 제어 합니다. ObjectDataSource 제어를 호출 하 여 특정 직원 레코드를 검색 합니다 GetEmployee 메서드의 EmployeeLogic 클래스. GetEmployee 메서드는 직원 ID 매개 변수가 필요 합니다. ObjectDataSource 컨트롤이 사용 하는 QueryStringParameter 만들려는 태그 요소에에서는 QueryStringParameter URL에서 지정 된 쿼리 문자열 매개 변수의 값을 검색 하 고에 전달 하는 개체는 GetEmployee 메서드.

컨트롤 속성, 폼 필드, 쿠키, ASP.NET 프로필 데이터를 세션 상태와 같은 다른 원본에서 값을 검색 하려면 다른 매개 변수 클래스를 사용할 수 있습니다. 또한 select 메서드에 하드 코드 된 값을 전달 하기 위해 태그에 정의 된 매개 변수 개체를 사용할 수 있습니다. 사용할 수 있는 매개 변수 클래스에 대 한 자세한 내용은 참조 하세요. 필터링에 대 한 데이터 소스 컨트롤을 사용 하 여 매개 변수를 사용 하 여입니다.

이 예제를 실행 하려면 다음이 필요 합니다.

  • 명명 된 연결 문자열을 포함 하는 웹 사이트 NorthwindConnection 는 Northwind 데이터베이스에 연결 합니다. 자세한 내용은 참조는 ObjectDataSource 클래스 개요입니다.

  • 합니다 EmployeeLogic 코드 예제에 대 한 중 하나로 표시 되는 클래스는 ObjectDataSource 클래스 개요입니다. 클래스 파일을 App_Code 폴더에 있어야 합니다.

  • .Aspx 페이지와 샘플 코드를 실행할 수 있습니다. 쿼리 문자열 매개 변수 없이 페이지를 요청 하면 오류 메시지가 표시 됩니다. 같은 쿼리 문자열을 사용 하 여 페이지를 요청 하는 경우 ?empid=1 .aspx 파일의 이름 뒤 요청한 직원에 대 한 세부 정보가 표시 됩니다.

<%@ 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:detailsview
          id="DetailsView1"
          runat="server"
          datasourceid="ObjectDataSource1">
        </asp:detailsview>

<!-- Security Note: The ObjectDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetEmployee"
          typename="Samples.AspNet.CS.EmployeeLogic" >
          <selectparameters>
            <asp:querystringparameter name="EmployeeID" querystringfield="empid" defaultvalue="-1" />
          </selectparameters>
        </asp:objectdatasource>

    </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 - VB Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:detailsview
          id="DetailsView1"
          runat="server"
          datasourceid="ObjectDataSource1">
        </asp:detailsview>

<!-- Security Note: The ObjectDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetEmployee"
          typename="Samples.AspNet.VB.EmployeeLogic" >
          <selectparameters>
            <asp:querystringparameter name="EmployeeID" querystringfield="empid" defaultvalue="-1" />
          </selectparameters>
        </asp:objectdatasource>

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

설명

SelectParameters 속성을 가져옵니다는 SelectParameters 의 속성을 ObjectDataSourceView 개체와 연결 된를 ObjectDataSource 컨트롤.

매개 변수를 추가 하는 SelectParameters 선언적으로 사용 하 여 컬렉션을 SelectParameters 요소 또는 처리기에서 프로그래밍 방식으로 Selecting 이벤트. 런타임 시에 나열 된 매개 변수는 SelectParameters 먼저 요소를 컬렉션에 추가 됩니다. 매개 변수 컬렉션에 다음 추가 또는 제거에 대 한 처리기를 Selecting 이벤트입니다. 합니다 Selecting 이벤트가 발생 하기 전에 Select 메서드를 실행 합니다.

전에 Select 이름 및에 포함 된 매개 변수의 형식에 메서드가 실행 될를 SelectParameters 컬렉션에 지정 된 메서드의 시그니처와 일치 해야 합니다는 SelectMethod 속성입니다. 예를 들어 라는 선택 메서드 GetEmployeesByStateAndAge 사용을 string 및 매개 변수로 정수를 SelectParameters 컬렉션에는 두 개의 매개 변수가 포함 되어야 합니다. 첫 번째 매개 변수를 문자열로 해결 해야 하 고 두 번째 매개 변수는 정수를 확인 해야 합니다. 태그에서 두 매개 변수를 지정할 수 있습니다는 SelectParameters 요소입니다. 수 또는 추가할 수 있습니다는 Selecting 이벤트 처리기 또는 1 개의 매개 변수가 태그에 추가 될 수 있으며 다른 하나는 프로그래밍 방식으로 추가할 수 있습니다.

자세한 내용은 ObjectDataSource 컨트롤을 사용 하 여 매개 변수를 사용 하 여 하며 SelectMethod 속성입니다.

중요

코드에 Selecting 이벤트 처리기 또는 지정 된 메서드에서 SelectMethod 속성을 클라이언트에서 수신 되는 모든 매개 변수 값의 유효성을 검사 하는 있는지 확인 합니다.

적용 대상

추가 정보