ObjectDataSource.SelectParameters 속성

정의

SelectMethod 속성에 지정된 메서드에서 사용하는 매개 변수의 컬렉션을 가져옵니다.Gets a collection of parameters that are used by the method specified by the SelectMethod property.

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; }
member this.SelectParameters : System.Web.UI.WebControls.ParameterCollection
Public ReadOnly Property SelectParameters As ParameterCollection

속성 값

SelectMethod 속성에 지정된 메서드에서 사용하는 매개 변수의 컬렉션입니다.A collection of parameters that are used by the method specified by the SelectMethod property.

특성

예제

다음 코드 예제에 사용 하 여 단일 데이터 레코드를 검색 하는 방법을 보여 줍니다.는 ObjectDataSource 컨트롤에 표시 하는 DetailsView 제어 합니다.The following code example demonstrates how to retrieve a single data record using an ObjectDataSource control and display it in a DetailsView control. ObjectDataSource 제어를 호출 하 여 특정 직원 레코드를 검색 합니다 GetEmployee 메서드의 EmployeeLogic 클래스.The ObjectDataSource control retrieves a specific employee record by calling the GetEmployee method of the EmployeeLogic class. GetEmployee 메서드는 직원 ID 매개 변수가 필요 합니다.The GetEmployee method requires an employee ID parameter. ObjectDataSource 컨트롤이 사용 하는 QueryStringParameter 만들려는 태그 요소에에서는 QueryStringParameter URL에서 지정 된 쿼리 문자열 매개 변수의 값을 검색 하 고에 전달 하는 개체는 GetEmployee 메서드.The ObjectDataSource control uses a QueryStringParameter element in markup to create a QueryStringParameter object that will retrieve the value of a specified query-string parameter from the URL and pass it to the GetEmployee method.

컨트롤 속성, 폼 필드, 쿠키, ASP.NET 프로필 데이터를 세션 상태와 같은 다른 원본에서 값을 검색 하려면 다른 매개 변수 클래스를 사용할 수 있습니다.Other parameter classes can be used to retrieve values from other sources, such as control properties, form fields, cookies, ASP.NET profile data, or session state. 또한 select 메서드에 하드 코드 된 값을 전달 하기 위해 태그에 정의 된 매개 변수 개체를 사용할 수 있습니다.You can also use a parameter object that is defined in markup in order to pass a hard-coded value to the select method. 사용할 수 있는 매개 변수 클래스에 대 한 자세한 내용은 참조 하세요. 필터링에 대 한 데이터 소스 컨트롤을 사용 하 여 매개 변수를 사용 하 여입니다.For more information about parameter classes that are available, see Using Parameters with Data Source Controls for Filtering.

이 예제를 실행 하려면 다음이 필요 합니다.To run this example, you will need the following:

  • 명명 된 연결 문자열을 포함 하는 웹 사이트 NorthwindConnection 는 Northwind 데이터베이스에 연결 합니다.A Web site that has a connection string named NorthwindConnection that connects to the Northwind Traders database. 자세한 내용은 참조는 ObjectDataSource 클래스 개요입니다.For more information, see the ObjectDataSource class overview.

  • 합니다 EmployeeLogic 코드 예제에 대 한 중 하나로 표시 되는 클래스는 ObjectDataSource 클래스 개요입니다.The EmployeeLogic class that is shown as one of the code examples for the ObjectDataSource class overview. 클래스 파일을 App_Code 폴더에 있어야 합니다.The class file must be located in the App_Code folder.

  • .Aspx 페이지와 샘플 코드를 실행할 수 있습니다.The sample code can be run as an .aspx page. 쿼리 문자열 매개 변수 없이 페이지를 요청 하면 오류 메시지가 표시 됩니다.If you request the page without a query-string parameter, an error message is displayed. 같은 쿼리 문자열을 사용 하 여 페이지를 요청 하는 경우 ?empid=1 .aspx 파일의 이름 뒤 요청한 직원에 대 한 세부 정보가 표시 됩니다.If you request the page using a query string such as ?empid=1 after the name of the .aspx file, you will see the details for the requested employee.

<%@ 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 컨트롤.The SelectParameters property gets the SelectParameters property of the ObjectDataSourceView object that is associated with the ObjectDataSource control.

매개 변수를 추가 하는 SelectParameters 선언적으로 사용 하 여 컬렉션을 SelectParameters 요소 또는 처리기에서 프로그래밍 방식으로 Selecting 이벤트.You add parameters to the SelectParameters collection declaratively by using the SelectParameters element or programmatically in the handler for the Selecting event. 런타임 시에 나열 된 매개 변수는 SelectParameters 먼저 요소를 컬렉션에 추가 됩니다.At run time, parameters listed in the SelectParameters element are added to the collection first. 매개 변수 컬렉션에 다음 추가 또는 제거에 대 한 처리기를 Selecting 이벤트입니다.Parameters in the collection are then added or removed by the handler for the Selecting event. 합니다 Selecting 이벤트가 발생 하기 전에 Select 메서드를 실행 합니다.The Selecting event is raised before the Select method is run.

전에 Select 이름 및에 포함 된 매개 변수의 형식에 메서드가 실행 될를 SelectParameters 컬렉션에 지정 된 메서드의 시그니처와 일치 해야 합니다는 SelectMethod 속성입니다.Before the Select method is run, the names and types of the parameters that are contained in the SelectParameters collection must match the signature of the method that is specified by the SelectMethod property. 예를 들어 라는 선택 메서드 GetEmployeesByStateAndAge 사용을 string 및 매개 변수로 정수를 SelectParameters 컬렉션에는 두 개의 매개 변수가 포함 되어야 합니다.For example, if a select method named GetEmployeesByStateAndAge takes a string and an integer as parameters, the SelectParameters collection must contain two parameters. 첫 번째 매개 변수를 문자열로 해결 해야 하 고 두 번째 매개 변수는 정수를 확인 해야 합니다.The first parameter must resolve to a string and the second parameter must resolve to an integer. 태그에서 두 매개 변수를 지정할 수 있습니다는 SelectParameters 요소입니다.Both parameters can be specified in markup in the SelectParameters element. 수 또는 추가할 수 있습니다는 Selecting 이벤트 처리기 또는 1 개의 매개 변수가 태그에 추가 될 수 있으며 다른 하나는 프로그래밍 방식으로 추가할 수 있습니다.Alternatively, they can be can be added in the Selecting event handler, or one parameter can be added in markup and the other one can be added programmatically.

자세한 내용은 ObjectDataSource 컨트롤을 사용 하 여 매개 변수를 사용 하 여 하며 SelectMethod 속성입니다.For more information, see Using Parameters with the ObjectDataSource Control and the SelectMethod property.

중요

코드에 Selecting 이벤트 처리기 또는 지정 된 메서드에서 SelectMethod 속성을 클라이언트에서 수신 되는 모든 매개 변수 값의 유효성을 검사 하는 있는지 확인 합니다.In the code for the Selecting event handler or in the method that is specified by the SelectMethod property, make sure that you validate any parameter value that is received from the client.

적용 대상

추가 정보