Parameter.Name Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

String

Der Name des Parameters. Der Standardwert ist Empty.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie gefilterte Daten mithilfe eines ObjectDataSource Steuerelements 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 für einen anderen Mitarbeiter abzurufen, geben Sie den vollständigen Namen des Mitarbeiters im TextBox Steuerelement ein, und klicken Sie auf die Schaltfläche.

Die FilterExpression -Eigenschaft gibt einen Ausdruck an, der zum Filtern der von der SelectMethod -Eigenschaft abgerufenen Daten verwendet wird. Es werden Parameterplatzhalter verwendet, die für die in der FilterParameters Auflistung enthaltenen Parameter ausgewertet werden. In diesem Beispiel wird der Parameterplatzhalter durch einfache 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 begrenzungsgebundene Anführungszeichen nicht erforderlich.

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

<%@ 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 einen Platzhalter in einer parametrisierten SQL-Abfrage zuzuordnen. Auf ähnliche Weise kann das SqlDataSource Steuerelement den Namen eines Parameter Objekts in der FilterParameters Auflistung verwenden, um einen Platzhalter in der FilterExpression -Eigenschaft abzugleichen. 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

Type