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


ParameterCollection.Add Метод

Определение

Добавляет объект 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, который требуется добавить в коллекцию.

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

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

Примеры

В следующем примере кода показано, как использовать 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

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

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

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

Примеры

В следующем примере кода показано, как Add(String, String) можно использовать метод для добавления новых Parameter объектов в ParameterCollection коллекцию путем предоставления name параметров и value . В этом примере Parameter объект добавляется в команду Update элемента управления источником данных Access, привязанного TextBox к значению элемента управления .

Важно!

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

<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 соответственно, и добавляет его в коллекцию.

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

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

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

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

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

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

Комментарии

Этот метод предназначен для типов баз данных. Add(String, TypeCode, String) Используйте метод для типов CLR.

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

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

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

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

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

Примеры

В следующем примере кода показано, как Add(String, TypeCode, String) можно использовать метод для добавления новых Parameter объектов в ParameterCollection коллекцию путем предоставления nameпараметров , valueи type . В этом примере Parameter объект добавляется в команду Update элемента управления источником данных Access, которая предоставляет значение текущего системного времени. Параметр добавляется с параметром TypeCodeDateTime.

<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 соответственно, и добавляет его в коллекцию.

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

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