Share via

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 物件不需要有名稱;不過，資料來源控制項可能會使用參數名稱，將集合中的物件與 SQL 查詢或商務方法簽章中的參數相符 Parameter 。 例如， SqlDataSource 控制項可以使用 物件的名稱 Parameter 來比對參數化 SQL 查詢中的預留位置。 同樣地， SqlDataSource 控制項可以使用集合中的 FilterParameters 物件名稱 Parameter ，來比對 屬性中的 FilterExpression 預留位置。 在某些情況下，不會使用名稱，而且物件新增至 ParameterCollection 集合的順序 Parameter 更為重要。 如需詳細資訊，請參閱 搭配 SqlDataSource 控制項使用參數 和 搭配 ObjectDataSource 控制項使用參數。

如果參數的名稱已變更，則會 OnParameterChanged 呼叫 方法。

適用於

另請參閱