Parameter.Name Parameter.Name Parameter.Name Parameter.Name Property

Definition

Ruft den Namen des Parameters ab oder legt diesen fest.Gets or sets the name of the parameter.

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.The name of the parameter. Der Standardwert ist Emptysein.The default value is Empty.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie gefilterte Daten mit ObjectDataSource einem-Steuerelement zum Abrufen von Daten aus einem Geschäftsobjekt der GridView mittleren Ebene und einem-Steuerelement zum Anzeigen der Ergebnisse angezeigt werden.The following code example demonstrates how to display filtered data using an ObjectDataSource control to retrieve data from a middle-tier business object and a GridView control to display the results. Das Codebeispiel besteht aus einem TextBox -Steuerelement GridView , einem- ObjectDataSource Steuerelement, dem-Steuerelement und der Schaltfläche "Senden".The code example consists of a TextBox control, a GridView control, the ObjectDataSource control, and a Submit button. Standardmäßig wird das TextBox -Steuerelement mit dem Namen eines Northwind der Mitarbeiter aufgefüllt.By default, the TextBox control is populated with the name of one of the Northwind employees. Das GridView -Steuerelement zeigt Informationen zum Mitarbeiter TextBox an, der durch den Namen im-Steuerelement identifiziert wird.The GridView control displays information about the employee identified by the name in the TextBox control. Zum Abrufen von Daten auf einem anderen Mitarbeiter geben Sie den vollständigen Namen des Mitarbeiters TextBox in das Steuerelement ein und klicken auf die Schaltfläche.To retrieve data on another employee, enter the full name of the employee in the TextBox control and click the button.

Die FilterExpression -Eigenschaft gibt einen Ausdruck an, der zum Filtern der von SelectMethod der-Eigenschaft abgerufenen Daten verwendet wird.The FilterExpression property specifies an expression used to filter the data retrieved by the SelectMethod property. Dabei werden Parameter Platzhalter verwendet, die für die in der FilterParameters Auflistung enthaltenen Parameter ausgewertet werden.It uses parameter placeholders that are evaluated to the parameters contained in the FilterParameters collection. In diesem Beispiel wird der Parameter Platzhalter in einfache Anführungszeichen begrenzt, da der Typ des Parameters ein Zeichen Folgentyp ist, der Leerzeichen enthalten kann.In this example, the parameter placeholder is bounded by single quotation marks because the type of the parameter is a string type that might contain spaces. Wenn der Typ des Parameters ein numerischer oder Date-Typ ist, sind keine Begrenzungs Anführungszeichen erforderlich.If the type of the parameter is a numeric or date type, bounding quotation marks are not needed.

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die FilterExpression -Eigenschaft ObjectDataSource der-Klasse bereitgestellt wird.This code example is part of a larger example provided for the FilterExpression property of the ObjectDataSource class.

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

ParameterEs ist nicht erforderlich, dass Objekte einen Namen haben. Allerdings können Datenquellen-Steuerelemente den Parameternamen verwenden, Parameter um ein-Objekt in einer Auflistung mit einem Parameter in einer SQL-Abfrage oder einer Unternehmens Methoden Signatur abzugleichen.Parameter objects are not required to have a name; however, data source controls might use the parameter name to match a Parameter object in a collection with a parameter in a SQL query or business method signature. Das SqlDataSource -Steuerelement kann z. b. den Namen Parameter des-Objekts verwenden, um einen Platzhalter in einer parametrisierten SQL-Abfrage abzugleichen.For example, the SqlDataSource control can use the name of the Parameter object to match a placeholder in a parameterized SQL query. Ebenso kann das SqlDataSource -Steuerelement den Namen Parameter eines-Objekts in der FilterParameters Auflistung verwenden, um einem Platzhalter in FilterExpression der-Eigenschaft zu entsprechen.Similarly, the SqlDataSource control can use the name of a Parameter object in the FilterParameters collection to match a placeholder in the FilterExpression property. In einigen Fällen wird der Name nicht verwendet, und die Reihenfolge, in Parameter der das Objekt zu einer ParameterCollection Auflistung hinzugefügt wird, ist wichtiger.In some cases, the name is not used and the order in which the Parameter object is added to a ParameterCollection collection is more important. Weitere Informationen finden Sie unter Verwenden von Parametern mit dem SqlDataSource-Steuer Element und Verwenden von Parametern mit dem ObjectDataSource-SteuerElement.For more information, see Using Parameters with the SqlDataSource Control and Using Parameters with the ObjectDataSource Control.

Wenn der Name des Parameters geändert wird, wird OnParameterChanged die-Methode aufgerufen.If the name of the parameter is changed, the OnParameterChanged method is called.

Gilt für:

Siehe auch