Freigeben über

Parameter.Name Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen des Namens des Parameters.

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 auf mittlerer 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 "Absenden". Standardmäßig wird das TextBox Steuerelement mit dem Namen eines der Northwind Mitarbeiter aufgefüllt. Das GridView Steuerelement zeigt Informationen über den Mitarbeiter an, der durch den Namen im TextBox Steuerelement identifiziert wurde. 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 verwendet Parameterplatzhalter, die für die in der FilterParameters Auflistung enthaltenen Parameter ausgewertet werden. In diesem Beispiel wird der Parameterplatzhalter durch einfache Anführungszeichen gebunden, 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 sind nicht erforderlich, um einen Namen zu haben; Datenquellensteuerelemente können jedoch den Parameternamen verwenden, um einem Parameter Objekt in einer Auflistung mit einem Parameter in einer SQL-Abfrage- oder Geschäftsmethodensignatur zu entsprechen. Beispielsweise kann das SqlDataSource Steuerelement den Namen des Parameter Objekts verwenden, um einem Platzhalter in einer parametrisierten SQL-Abfrage zu entsprechen. Ebenso 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