Parameter.Name Właściwość

Definicja

Pobiera lub ustawia nazwę parametru.

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

Wartość właściwości

String

Nazwa parametru. Wartość domyślna to Empty.

Przykłady

Poniższy przykład kodu przedstawia sposób wyświetlania przefiltrowanych danych przy użyciu ObjectDataSource kontrolki w celu pobrania danych z obiektu biznesowego warstwy środkowej i GridView kontrolki w celu wyświetlenia wyników. Przykładowy kod składa się z TextBox kontrolki, GridView kontrolki, kontrolki ObjectDataSource i przycisku Prześlij. Domyślnie kontrolka TextBox jest wypełniana nazwą jednego z Northwind pracowników. Kontrolka GridView wyświetla informacje o pracowniku zidentyfikowanym przez nazwę w kontrolce TextBox . Aby pobrać dane innego pracownika, wprowadź pełne imię i nazwisko pracownika w kontrolce TextBox i kliknij przycisk.

Właściwość FilterExpression określa wyrażenie używane do filtrowania danych pobranych przez SelectMethod właściwość. Używa symboli zastępczych parametrów, które są oceniane dla parametrów zawartych w FilterParameters kolekcji. W tym przykładzie symbol zastępczy parametru jest powiązany z pojedynczymi cudzysłowami, ponieważ typ parametru jest typem ciągu, który może zawierać spacje. Jeśli typ parametru jest typem liczbowym lub typem daty, nie są potrzebne znaki cudzysłowu.

Ten przykład kodu jest częścią większego przykładu ObjectDataSource podanego dla FilterExpression właściwości klasy.

<%@ 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>

Uwagi

Parameterobiekty nie są wymagane do posiadania nazwy; jednak kontrolki źródła danych mogą używać nazwy parametru do dopasowania Parameter obiektu w kolekcji z parametrem w SQL zapytania lub sygnatury metody biznesowej. Na przykład kontrolka SqlDataSource może używać nazwy Parameter obiektu do dopasowania symbolu zastępczego w sparametryzowanym zapytaniu SQL. Podobnie kontrolka SqlDataSource może używać nazwy Parameter obiektu w FilterParameters kolekcji do dopasowania symbolu zastępczego FilterExpression we właściwości. W niektórych przypadkach nazwa nie jest używana, a kolejność dodawania Parameter ParameterCollection obiektu do kolekcji jest ważniejsza. Aby uzyskać więcej informacji, zobacz Using Parameters with the SqlDataSource Control and Using Parameters with the ObjectDataSource Control (Używanie parametrów za pomocą kontrolki ObjectDataSource).

Jeśli nazwa parametru zostanie zmieniona, metoda jest wywoływana OnParameterChanged .

Dotyczy

Zobacz też