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입니다.

예제

다음 코드 예제에 사용 하 여 필터링 된 데이터를 표시 하는 방법을 보여 줍니다.는 ObjectDataSource 중간 계층 비즈니스 개체에서 데이터를 검색 하는 컨트롤 및 GridView 결과 표시 하는 컨트롤입니다. 코드 예제에서는 구성를 TextBox 컨트롤을 GridView 컨트롤을는 ObjectDataSource 제어 및 제출 단추. 기본적으로 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 개체는 이름이 있이 필요가 없습니다. 데이터 소스 컨트롤 일치 하는 매개 변수 이름을 사용할 수 있지만 한 Parameter SQL 쿼리 또는 비즈니스 메서드 시그니처에서 매개 변수를 사용 하 여 컬렉션의 개체입니다. 예를 들어 합니다 SqlDataSource 컨트롤의 이름을 사용할 수는 Parameter 매개 변수가 있는 SQL 쿼리의 자리 표시자와 일치 하는 개체입니다. 마찬가지로,는 SqlDataSource 컨트롤의 이름을 사용할 수는 Parameter 개체를 FilterParameters 자리 표시자에 맞도록 컬렉션을 FilterExpression 속성. 일부 경우에는 이름은 사용 되지 않습니다 및 순서를 Parameter 개체에 추가 됩니다을 ParameterCollection 컬렉션이 더 중요 합니다. 자세한 내용은 SqlDataSource 컨트롤을 사용 하 여 매개 변수를 사용 하 여 하 고 ObjectDataSource 컨트롤을 사용 하 여 매개 변수를 사용 하 여입니다.

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

적용 대상

추가 정보