Данная статья переведена с помощью средств машинного перевода. Чтобы просмотреть ее на английском языке, установите флажок Английский. Вы также можете просматривать английский текст во всплывающем окне, наводя указатель мыши на переведенный текст.
Перевод
Английский

Свойство SqlDataSource.SelectParameters

 

Опубликовано: Октябрь 2016

Возвращает коллекцию параметров, содержащий параметры, используемые SelectCommand свойство SqlDataSourceView объекта, который связан с SqlDataSource управления.

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

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public ParameterCollection SelectParameters { get; }

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

Type: System.Web.UI.WebControls.ParameterCollection

Объект ParameterCollection содержащий используемые параметры SelectCommand свойство.

Если SelectCommand содержит параметризованный запрос SQL, SelectParameters коллекции содержит любые Parameter объектов, соответствующих параметров-местозаполнителей в строке SQL.

В зависимости от поставщика ADO.NET, порядок параметров в SelectParameters коллекции может быть важной. System.Data.OleDb И System.Data.Odbc Поставщики связывание параметров в коллекции в порядке следования параметров в параметризованном SQL-запросе. System.Data.SqlClient Поставщика, который является поставщик ADO.NET по умолчанию для SqlDataSource контроля, связывает параметров в коллекции, совпадающий с именем параметра с псевдонимом заполнитель в SQL-запросе. Дополнительные сведения о параметризованных SQL-запросах и командах см. в разделе Using Parameters with the SqlDataSource Control.

SelectParameters Свойство извлекает SelectParameters свойство, которое содержится в SqlDataSourceView объект, связанный с SqlDataSource управления.

System_CAPS_security Безопасность Примечание

Значения вставляются в параметры без проверки, что является потенциальной угрозой безопасности. Используйте Selecting событий для проверки значений параметров перед выполнением запроса. Для получения дополнительной информации см. Script Exploits Overview.

В следующем примере кода показано, как для извлечения данных из базы данных Northwind в Microsoft SQL Server, установив SelectCommand свойство SQL-запрос. Параметризованный SQL-запрос и заполнитель в SelectCommand свойство сопоставляется ControlParameter объект, добавленный к SelectParameters коллекции. DropDownList Управления, который ControlParameter привязан к, выступает в качестве фильтра тем, что будет отображаться в ListBox элемента управления.

Сведения о других типах параметров, которые можно использовать в разделе Parameter Общие сведения о классе.

System_CAPS_noteПримечание

Поскольку параметр используется в предложении WHERE, использование SelectParameters свойство в примере кода функционально эквивалентен использованию FilterExpression и FilterParameters Свойства.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected="True">Sales Representative</asp:listitem>
          <asp:listitem>Sales Manager</asp:listitem>
          <asp:listitem>Vice President, Sales</asp:listitem>
      </asp:dropdownlist></p>

      <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT LastName FROM Employees WHERE Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

    </form>
  </body>
</html>

.NET Framework
Доступно с 2.0
Вернуться в начало
Показ: