다음을 통해 공유

Parameter.Name 속성

정의

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

매개 변수의 이름을 가져오거나 설정합니다.

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

속성 값

String

매개 변수의 이름입니다. 기본값은 Empty입니다.

예제

다음 코드 예제에서는 중간 계층 비즈니스 개체에서 데이터를 검색 하는 컨트롤 및 GridView 결과 표시 하는 컨트롤을 사용 하 여 ObjectDataSource 필터링 된 데이터를 표시 하는 방법을 보여 줍니다. 코드 예제는 컨트롤, 컨트롤, GridViewObjectDataSource 컨트롤 및 제출 단추로 구성됩니다TextBox. 기본적으로 컨트롤은 TextBox 직원 중 Northwind 하나의 이름으로 채워집니다. 컨트롤에 GridView 컨트롤의 이름으로 식별 된 직원에 대 한 정보를 표시 합니다 TextBox . 다른 직원의 데이터를 검색하려면 컨트롤에 직원의 TextBox 전체 이름을 입력하고 단추를 클릭합니다.

이 속성은 FilterExpression 속성에서 검색한 데이터를 필터링하는 데 사용되는 식을 지정합니다 SelectMethod . 컬렉션에 포함된 FilterParameters 매개 변수로 평가되는 매개 변수 자리 표시자를 사용합니다. 이 예제에서는 매개 변수의 형식이 공백을 포함할 수 있는 문자열 형식이므로 매개 변수 자리 표시자는 작은따옴표로 제한됩니다. 매개 변수의 형식이 숫자 또는 날짜 형식인 경우 경계 따옴표가 필요하지 않습니다.

이 코드 예제는 클래스의 속성에 대해 FilterExpression 제공되는 더 큰 예제의 ObjectDataSource 일부입니다.

<%@ 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">
<script runat="server">

    protected void ObjectDataSource1_Filtering(object sender, ObjectDataSourceFilteringEventArgs e)
    {
        if (Textbox1.Text == "")
        {
            e.ParameterValues.Clear();
            e.ParameterValues.Add("FullName", "Nancy Davolio");
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <p>Show all users with the following name.</p>

        <asp:textbox id="Textbox1" runat="server" text="Nancy Davolio" />

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1"
          autogeneratecolumns="False">
          <columns>
            <asp:boundfield headertext="ID" datafield="EmpID" />
            <asp:boundfield headertext="Name" datafield="FullName" />
            <asp:boundfield headertext="Street Address" datafield="Address" />
          </columns>
        </asp:gridview>

        <!-- Security Note: The ObjectDataSource uses a FormParameter,
             Security Note: which does not perform validation of input from the client. -->

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployeesAsDataSet"
          typename="Samples.AspNet.CS.EmployeeLogic"
          filterexpression="FullName='{0}'" OnFiltering="ObjectDataSource1_Filtering">
            <filterparameters>
              <asp:formparameter name="FullName" formfield="Textbox1" defaultvalue="Nancy Davolio" />
            </filterparameters>
        </asp:objectdatasource>

        <p><asp:button id="Button1" runat="server" text="Search" /></p>

    </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">
<script runat="server">

    Protected Sub ObjectDataSource1_Filtering(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.ObjectDataSourceFilteringEventArgs)
        If Textbox1.Text = "" Then
            e.ParameterValues.Clear()
            e.ParameterValues.Add("FullName", "Nancy Davolio")
        End If
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - VB Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <p>Show all users with the following name.</p>

        <asp:textbox id="Textbox1" runat="server" text="Nancy Davolio" />

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1"
          autogeneratecolumns="False">
          <columns>
            <asp:boundfield headertext="ID" datafield="EmpID" />
            <asp:boundfield headertext="Name" datafield="FullName" />
            <asp:boundfield headertext="Street Address" datafield="Address" />
          </columns>
        </asp:gridview>

        <!-- Security Note: The ObjectDataSource uses a FormParameter,
             Security Note: which does not perform validation of input from the client. -->

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployeesAsDataSet"
          typename="Samples.AspNet.VB.EmployeeLogic"
          filterexpression="FullName='{0}'" OnFiltering="ObjectDataSource1_Filtering">
            <filterparameters>
              <asp:formparameter name="FullName" formfield="Textbox1" defaultvalue="Nancy Davolio" />
            </filterparameters>
        </asp:objectdatasource>

        <p><asp:button id="Button1" runat="server" text="Search" /></p>

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

설명

Parameter 개체는 이름을 가질 필요가 없습니다. 그러나 데이터 원본 컨트롤은 매개 변수 이름을 사용하여 컬렉션의 개체를 SQL 쿼리 또는 비즈니스 메서드 서명의 매개 변수와 일치 Parameter 시킬 수 있습니다. 예를 들어 컨트롤은 SqlDataSource 매개 변수가 있는 SQL 쿼리의 자리 표시자와 일치하도록 개체의 Parameter 이름을 사용할 수 있습니다. 마찬가지로 컨트롤은 SqlDataSource 컬렉션의 개체 FilterParameters 이름을 사용하여 속성의 Parameter 자리 표시자와 FilterExpression 일치시킬 수 있습니다. 경우에 따라 이름이 사용되지 않으며 개체가 컬렉션에 추가 ParameterCollection 되는 Parameter 순서가 더 중요합니다. 자세한 내용은 SqlDataSource 컨트롤에서 매개 변수 사용 및 ObjectDataSource 컨트롤에서 매개 변수 사용을 참조하세요.

매개 변수의 이름이 변경되면 메서드가 OnParameterChanged 호출됩니다.

적용 대상

추가 정보