ParameterCollection.Add Metoda

Definicja

Parameter Dodaje obiekt do kolekcji.

Przeciążenia

Add(Parameter)

Dołącza określony Parameter obiekt na końcu kolekcji.

Add(String, String)

Parameter Tworzy obiekt o określonej nazwie i wartości domyślnej i dołącza go na końcu kolekcji.

Add(String, DbType, String)

Parameter Tworzy obiekt o określonej nazwie, typie bazy danych i wartości domyślnej i dodaje go na końcu kolekcji.

Add(String, TypeCode, String)

Parameter Tworzy obiekt o określonej nazwie, TypeCodei wartości domyślnej i dołącza go na końcu kolekcji.

Add(Parameter)

Dołącza określony Parameter obiekt na końcu kolekcji.

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

Parametry

parameter
Parameter

Element Parameter do dołączenia do kolekcji.

Zwraca

Wartość indeksu dodanego elementu.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać AccessDataSource kontrolki i FormParameter obiektu do wyświetlania informacji z bazy danych programu Microsoft Access w kontrolceGridView. Obiekt FormParameter jest dodawany do SelectParameters kolekcji przy użyciu Add(Parameter) metody .

Ważne

Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (Omówienie luk w zabezpieczeniach skryptów).

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

Uwagi

Add(Parameter) Użyj metody , aby dołączyć Parameter obiekt na końcu kolekcji. Ta implementacja metody pobiera Parameter obiekt określony przez param parametr i dołącza go do kolekcji.

Zobacz też

Dotyczy

Add(String, String)

Parameter Tworzy obiekt o określonej nazwie i wartości domyślnej i dołącza go na końcu kolekcji.

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

Parametry

name
String

Nazwa parametru.

value
String

Ciąg, który służy jako wartość domyślna parametru.

Zwraca

Wartość indeksu dodanego elementu.

Przykłady

W poniższym przykładzie kodu pokazano, jak Add(String, String) można użyć metody w celu dodania nowych Parameter obiektów do ParameterCollection kolekcji przez podanie name parametrów i value . W tym przykładzie Parameter obiekt jest dodawany do polecenia Update kontrolki źródła danych programu Access powiązanej z wartością TextBox kontrolki.

Ważne

Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (Omówienie luk w zabezpieczeniach skryptów).

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

Uwagi

Add(String, String) Użyj metody , aby utworzyć i dołączyć Parameter obiekt z wartością domyślną na końcu kolekcji. Ta implementacja metody tworzy Parameter obiekt przy użyciu nazwy i wartości domyślnej name określonej odpowiednio przez parametry i value i dołącza go do kolekcji.

Zobacz też

Dotyczy

Add(String, DbType, String)

Parameter Tworzy obiekt o określonej nazwie, typie bazy danych i wartości domyślnej i dodaje go na końcu kolekcji.

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

Parametry

name
String

Nazwa parametru.

dbType
DbType

Typ bazy danych parametru.

value
String

Wartość domyślna parametru.

Zwraca

Wartość indeksu dodanego elementu.

Uwagi

Ta metoda dotyczy typów baz danych. Add(String, TypeCode, String) Użyj metody dla typów CLR.

Dotyczy

Add(String, TypeCode, String)

Parameter Tworzy obiekt o określonej nazwie, TypeCodei wartości domyślnej i dołącza go na końcu kolekcji.

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

Parametry

name
String

Nazwa parametru.

type
TypeCode

Typ parametru.

value
String

Wartość domyślna parametru.

Zwraca

Wartość indeksu dodanego elementu.

Przykłady

W poniższym przykładzie kodu pokazano, jak Add(String, TypeCode, String) można użyć metody w celu dodania nowych Parameter obiektów do ParameterCollection kolekcji przez podanie nameparametrów , valuei type . W tym przykładzie Parameter obiekt jest dodawany do polecenia Update kontrolki źródła danych programu Access, która zapewnia wartość bieżącego czasu systemowego. Parametr jest dodawany za pomocą elementu 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>

Uwagi

Add(String, TypeCode, String) Użyj metody , aby utworzyć i dołączyć silnie typizowany Parameter obiekt z wartością domyślną na końcu kolekcji. Ta implementacja metody tworzy Parameter obiekt przy użyciu nazwy, typu i wartości określonej odpowiednio przez nametype parametry i oraz value dołącza go do kolekcji.

Zobacz też

Dotyczy