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) метода.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах 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 объектов в коллекцию ParameterCollection путем предоставления name параметров и value параметров. В этом примере Parameter объект добавляется в команду Update элемента управления источником данных Access, привязанного TextBox к значению элемента управления.

Важно!

<script runat="server">
private void UpdateRecords(Object source, EventArgs e)
{
  CheckBox cb;
  foreach(GridViewRow row in this.GridView1.Rows) {
    cb = (CheckBox) row.Cells[0].Controls[1];
    if(cb.Checked) {
      string oid = (string) row.Cells[1].Text;
      MyAccessDataSource.UpdateParameters.Add("date", TypeCode.DateTime, DateTime.Now.ToString());
      MyAccessDataSource.UpdateParameters.Add("orderid", oid);
      MyAccessDataSource.Update();
      MyAccessDataSource.UpdateParameters.Clear();
    }
  }
}
</script>

<script runat="server">
Private Sub UpdateRecords(source As Object, e As EventArgs)

  Dim cb As CheckBox
  Dim row As GridViewRow

  For Each row In GridView1.Rows

    cb = CType(row.Cells(0).Controls(1), CheckBox)
    If cb.Checked Then

      Dim oid As String
      oid = CType(row.Cells(1).Text, String)

      MyAccessDataSource.UpdateParameters.Add("date", TypeCode.DateTime, DateTime.Now.ToString())

      MyAccessDataSource.UpdateParameters.Add("orderid", oid)

      MyAccessDataSource.Update()
      MyAccessDataSource.UpdateParameters.Clear()
    End If
  Next
End Sub ' UpdateRecords
</script>

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

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

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 объектов в коллекцию ParameterCollection путем предоставления name``valueпараметров и type параметров. В этом примере Parameter объект добавляется в команду Update элемента управления источником данных Access, который предоставляет значение текущего системного времени. Параметр добавляется с параметром TypeCode DateTime.

<script runat="server">
private void UpdateRecords(Object source, EventArgs e)
{
  CheckBox cb;
  foreach(GridViewRow row in this.GridView1.Rows) {
    cb = (CheckBox) row.Cells[0].Controls[1];
    if(cb.Checked) {
      string oid = (string) row.Cells[1].Text;
      MyAccessDataSource.UpdateParameters.Add("date", TypeCode.DateTime, DateTime.Now.ToString());
      MyAccessDataSource.UpdateParameters.Add("orderid", oid);
      MyAccessDataSource.Update();
      MyAccessDataSource.UpdateParameters.Clear();
    }
  }
}
</script>

<script runat="server">
Private Sub UpdateRecords(source As Object, e As EventArgs)

  Dim cb As CheckBox
  Dim row As GridViewRow

  For Each row In GridView1.Rows

    cb = CType(row.Cells(0).Controls(1), CheckBox)
    If cb.Checked Then

      Dim oid As String
      oid = CType(row.Cells(1).Text, String)

      MyAccessDataSource.UpdateParameters.Add("date", TypeCode.DateTime, DateTime.Now.ToString())

      MyAccessDataSource.UpdateParameters.Add("orderid", oid)

      MyAccessDataSource.Update()
      MyAccessDataSource.UpdateParameters.Clear()
    End If
  Next
End Sub ' UpdateRecords
</script>

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

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

Parameter

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

ParameterCollection.Add Метод

Определение

Перегрузки

Add(Parameter)

Параметры

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

Примеры

Комментарии

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

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

Add(String, String)

Параметры

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

Примеры

Комментарии

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

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

Add(String, DbType, String)

Параметры

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

Комментарии

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

Add(String, TypeCode, String)

Параметры

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

Примеры

Комментарии

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

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

Дополнительные ресурсы