ParameterCollection.Add Метод

Определение

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

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Parameter Добавляет объект в коллекцию.

Перегрузки

Имя	Описание
Add(Parameter)	Добавляет указанный Parameter объект в конец коллекции.
Add(String, String)	Parameter Создает объект с указанным именем и значением по умолчанию и добавляет его в конец коллекции.
Add(String, DbType, String)	Parameter Создает объект с указанным именем, типом базы данных и значением по умолчанию и добавляет его в конец коллекции.
Add(String, TypeCode, String)	Parameter Создает объект с указанным именем и TypeCodeзначением по умолчанию и добавляет его в конец коллекции.

Add(Parameter)

Добавляет указанный Parameter объект в конец коллекции.

public:
 int Add(System::Web::UI::WebControls::Parameter ^ parameter);

public int Add(System.Web.UI.WebControls.Parameter parameter);

member this.Add : System.Web.UI.WebControls.Parameter -> int

Public Function Add (parameter As Parameter) As Integer

Параметры

parameter: Parameter

Добавление Parameter в коллекцию.

Возвращаемое значение

Int32

Значение индекса добавленного элемента.

Примеры

В следующем примере кода показано, как использовать элемент управления AccessDataSource и объект FormParameter для отображения сведений из базы данных Microsoft Access в элементе управления GridView. Объект FormParameter добавляется в коллекцию SelectParameters Add(Parameter) с помощью метода.

Important

В этом примере есть текстовое поле, которое принимает входные данные пользователя, которое является потенциальной угрозой безопасности. По умолчанию ASP.NET веб-страницы проверяют, что входные данные пользователя не включают скрипт или ЭЛЕМЕНТЫ HTML. Дополнительные сведения см. в разделе "Обзор эксплойтов скриптов".

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

void Page_Load(Object sender, EventArgs e){

  // You can add a FormParameter to the AccessDataSource control's
  // SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear();

  // Security Note: The AccessDataSource uses a FormParameter,
  // Security Note: which does not perform validation of input from the client.
  // Security Note: To validate the value of the FormParameter,
  // Security Note: handle the Selecting event.

  FormParameter formParam = new FormParameter("lastname","LastNameBox");
  formParam.Type=TypeCode.String;
  AccessDataSource1.SelectParameters.Add(formParam);
}

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

      <br />
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

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

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

Private Sub Page_Load(sender As Object, e As EventArgs)

  ' You can add a FormParameter to the AccessDataSource control's
  ' SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear()

  ' Security Note: The AccessDataSource uses a FormParameter,
  ' Security Note: which does not perform validation of input from the client.
  ' Security Note: To validate the value of the FormParameter,
  ' Security Note: handle the Selecting event.

  Dim formParam As New FormParameter("lastname","LastNameBox")
  formParam.Type=TypeCode.String
  AccessDataSource1.SelectParameters.Add(formParam)
End Sub ' Page_Load

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

      <br />
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

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

Add(Parameter) Используйте метод для добавления Parameter объекта в конец коллекции. Эта реализация метода принимает Parameter объект, param указанный параметром, и добавляет его в коллекцию.

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

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

Add(String, String)

Parameter Создает объект с указанным именем и значением по умолчанию и добавляет его в конец коллекции.

public:
 int Add(System::String ^ name, System::String ^ value);

public int Add(string name, string value);

member this.Add : string * string -> int

Public Function Add (name As String, value As String) As Integer

Параметры

name: String

Имя параметра.

value: String

Строка, которая служит значением по умолчанию для параметра.

Возвращаемое значение

Int32

Значение индекса добавленного элемента.

Add(String, String) Используйте метод для создания и добавления Parameter объекта со значением по умолчанию к концу коллекции. Эта реализация метода создает Parameter объект, используя имя и значение по умолчанию, указанное namevalue соответствующими параметрами, и добавляет его в коллекцию.

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

Parameter

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

Add(String, DbType, String)

Parameter Создает объект с указанным именем, типом базы данных и значением по умолчанию и добавляет его в конец коллекции.

public:
 int Add(System::String ^ name, System::Data::DbType dbType, System::String ^ value);

public int Add(string name, System.Data.DbType dbType, string value);

member this.Add : string * System.Data.DbType * string -> int

Public Function Add (name As String, dbType As DbType, value As String) As Integer

Параметры

name: String

Имя параметра.

dbType: DbType

Тип базы данных параметра.

value: String

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

Возвращаемое значение

Int32

Значение индекса добавленного элемента.

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

Add(String, TypeCode, String)

Parameter Создает объект с указанным именем и TypeCodeзначением по умолчанию и добавляет его в конец коллекции.

public:
 int Add(System::String ^ name, TypeCode type, System::String ^ value);

public int Add(string name, TypeCode type, string value);

member this.Add : string * TypeCode * string -> int

Public Function Add (name As String, type As TypeCode, value As String) As Integer

Параметры

name: String

Имя параметра.

type: TypeCode

Тип параметра.

value: String

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

Возвращаемое значение

Int32

Значение индекса добавленного элемента.

Add(String, TypeCode, String) Используйте метод для создания и добавления строго типизированного Parameter объекта со значением по умолчанию в конец коллекции. Эта реализация метода создает Parameter объект с помощью имени, типа и значения, указанного nametypevalue параметрами, соответственно, и добавляет его в коллекцию.

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

Parameter

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

Обратная связь

Были ли сведения на этой странице полезными?

ParameterCollection.Add Метод

Определение

Перегрузки

Add(Parameter)

Параметры

Возвращаемое значение

Примеры

Комментарии

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

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

Add(String, String)

Параметры

Возвращаемое значение

Комментарии

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

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

Add(String, DbType, String)

Параметры

Возвращаемое значение

Комментарии

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

Add(String, TypeCode, String)

Параметры

Возвращаемое значение

Комментарии

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

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