Поделиться через

Parameter.Name Свойство

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Возвращает или задает имя параметра.

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

Значение свойства

String

Имя параметра. Значение по умолчанию — Empty.

Примеры

В следующем примере кода показано, как отображать отфильтрованные данные с помощью ObjectDataSource элемента управления для получения данных из бизнес-объекта среднего уровня и GridView элемента управления для отображения результатов. Пример кода состоит из TextBox элемента управления, GridView элемента управления, ObjectDataSource элемента управления и кнопки "Отправить". По умолчанию TextBox элемент управления заполняется именем одного из Northwind сотрудников. Элемент GridView управления отображает сведения о сотруднике, определяемом именем в элементе TextBox управления. Чтобы получить данные о другом сотруднике, введите полное имя сотрудника в элементе TextBox управления и нажмите кнопку.

Свойство FilterExpression задает выражение, используемое для фильтрации данных, полученных свойством SelectMethod . В нем используются заполнители параметров, которые оцениваются параметрами, содержащимися в FilterParameters коллекции. В этом примере заполнитель параметра привязан одними кавычками, так как тип параметра является строковым типом, который может содержать пробелы. Если тип параметра является числовым или типом даты, ограничивающие кавычки не требуются.

Этот пример кода является частью более крупного примера, предоставленного ObjectDataSource для FilterExpression свойства класса.

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

Комментарии

Parameter объекты не требуются для имени; Однако элементы управления источниками данных могут использовать имя параметра для сопоставления Parameter объекта в коллекции с параметром в sql-запросе или сигнатуре бизнес-метода. Например, SqlDataSource элемент управления может использовать имя Parameter объекта для сопоставления заполнителя в параметризованном SQL-запросе. Аналогичным образом SqlDataSource элемент управления может использовать имя Parameter объекта в FilterParameters коллекции для сопоставления заполнителя в свойстве FilterExpression . В некоторых случаях имя не используется, а порядок добавления объекта в ParameterParameterCollection коллекцию является более важным. Дополнительные сведения см. в разделе "Использование параметров" с элементом управления SqlDataSource и использованием параметров с элементом управления ObjectDataSource.

Если имя параметра изменено, OnParameterChanged вызывается метод.

Применяется к

См. также раздел