Parameter.Name Eigenschaft

Definition

Ruft den Namen des Parameters ab oder legt ihn fest.

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

Eigenschaftswert

Der Name des Parameters. Der Standardwert ist Empty.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie gefilterte Daten mithilfe eines Steuerelements ObjectDataSource zum Abrufen von Daten aus einem Geschäftsobjekt der mittleren Ebene und einem GridView Steuerelement zum Anzeigen der Ergebnisse angezeigt werden. Das Codebeispiel besteht aus einem TextBox Steuerelement, einem GridView Steuerelement, dem ObjectDataSource -Steuerelement und einer Schaltfläche "Senden". Standardmäßig wird das TextBox Steuerelement mit dem Namen eines der Northwind Mitarbeiter aufgefüllt. Das GridView Steuerelement zeigt Informationen zu dem Mitarbeiter an, der durch den Namen im TextBox Steuerelement identifiziert wird. Um Daten zu einem anderen Mitarbeiter abzurufen, geben Sie den vollständigen Namen des Mitarbeiters in das TextBox Steuerelement ein, und klicken Sie auf die Schaltfläche.

Die FilterExpression -Eigenschaft gibt einen Ausdruck an, der verwendet wird, um die von der SelectMethod -Eigenschaft abgerufenen Daten zu filtern. Sie verwendet Parameterplatzhalter, die für die in der FilterParameters Auflistung enthaltenen Parameter ausgewertet werden. In diesem Beispiel wird der Parameterplatzhalter durch einzelne Anführungszeichen begrenzt, da der Typ des Parameters ein Zeichenfolgentyp ist, der Leerzeichen enthalten kann. Wenn der Typ des Parameters ein numerischer Oder Datumstyp ist, sind anführungsgebundene Anführungszeichen nicht erforderlich.

Dieses Codebeispiel ist Teil eines größeren Beispiels für die FilterExpression -Eigenschaft der ObjectDataSource -Klasse.

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

Hinweise

Parameter -Objekte müssen keinen Namen haben. Datenquellensteuerelemente können jedoch den Parameternamen verwenden, um ein Parameter Objekt in einer Auflistung mit einem Parameter in einer SQL-Abfrage oder Geschäftsmethodensignatur abzugleichen. Beispielsweise kann das SqlDataSource Steuerelement den Namen des Parameter -Objekts verwenden, um einem Platzhalter in einer parametrisierten SQL-Abfrage zu entsprechen. Auf ähnliche Weise kann das SqlDataSource Steuerelement den Namen eines Parameter Objekts in der FilterParameters Auflistung verwenden, um einem Platzhalter in der FilterExpression -Eigenschaft zu entsprechen. In einigen Fällen wird der Name nicht verwendet, und die Reihenfolge, in der das Parameter Objekt einer ParameterCollection Auflistung hinzugefügt wird, ist wichtiger. Weitere Informationen finden Sie unter Verwenden von Parametern mit dem SqlDataSource-Steuerelement und Verwenden von Parametern mit dem ObjectDataSource-Steuerelement.

Wenn der Name des Parameters geändert wird, wird die OnParameterChanged -Methode aufgerufen.

Gilt für:

Weitere Informationen