共用方式為

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 參數進行評估。 在此範例中，參數佔位符被單引號界定，因為參數的型別是字串型別，可能包含空格。 若參數類型為數字或日期型，則不需要界引號。

此程式碼範例是類別屬性更大FilterExpressionObjectDataSource範例的一部分。

<%@ 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 控制項可以使用物件名稱 Parameter 來匹配參數化 SQL 查詢中的佔位符。 同樣地，SqlDataSource控制項也可以使用集合中FilterParameters物件的名稱Parameter來匹配屬性中的FilterExpression佔位符。 在某些情況下，名稱不被使用，物件加入ParameterCollection集合的順序Parameter更為重要。 欲了解更多資訊，請參閱「 使用參數搭配 SqlDataSource 控制 項」及 「使用參數搭配 ObjectDataSource 控制項」。

如果參數名稱被更改，該 OnParameterChanged 方法就會被呼叫。

適用於

另請參閱