ParameterCollection.Add Método

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Adiciona um objeto de Parameter à coleção.

Sobrecargas

Add(Parameter)

Acrescenta o objeto Parameter especificado ao final da coleção.
Add(String, String)

Cria um objeto Parameter com o nome especificado e o valor padrão e anexa-o ao final da coleção.
Add(String, DbType, String)

Cria um objeto Parameter com o nome especificado, tipo de banco de dados e valor padrão e o adiciona ao final da coleção.
Add(String, TypeCode, String)

Cria um objeto Parameter com o nome especificado, TypeCode e valor padrão e o acrescenta ao final da coleção.

Add(Parameter)

Acrescenta o objeto Parameter especificado ao final da coleção.

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

Parâmetros

parameter
Parameter

O Parameter a ser acrescentado à coleção.

Retornos

Int32

O valor de índice do item adicionado.

Exemplos

O exemplo de código a seguir demonstra como usar um AccessDataSource controle e um FormParameter objeto para exibir informações de um banco de dados do Microsoft Access em um GridView controle. O FormParameter objeto é adicionado à SelectParameters coleção usando o Add(Parameter) método .

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações de script.

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

Comentários

Use o Add(Parameter) método para acrescentar um Parameter objeto ao final da coleção. Essa implementação do método pega o Parameter objeto especificado pelo parâmetro e o param acrescenta à coleção.

Confira também

Aplica-se a

Add(String, String)

Cria um objeto Parameter com o nome especificado e o valor padrão e anexa-o ao final da coleção.

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

Parâmetros

name
String

O nome do parâmetro.

value
String

Uma cadeia de caracteres que funciona como um valor padrão para o parâmetro.

Retornos

Int32

O valor de índice do item adicionado.

Exemplos

O exemplo de código a seguir demonstra como o Add(String, String) método pode ser usado para adicionar novos Parameter objetos a uma ParameterCollection coleção fornecendo os name parâmetros e value . Neste exemplo, um Parameter objeto é adicionado a um comando Update de um controle de fonte de dados do Access associado ao valor de um TextBox controle .

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações de script.

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

Comentários

Use o Add(String, String) método para criar e acrescentar um Parameter objeto com um valor padrão ao final da coleção. Essa implementação do método cria o Parameter objeto usando o nome e o valor padrão especificados pelos name parâmetros e value , respectivamente, e o acrescenta à coleção.

Confira também

Aplica-se a

Add(String, DbType, String)

Cria um objeto Parameter com o nome especificado, tipo de banco de dados e valor padrão e o adiciona ao final da coleção.

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

Parâmetros

name
String

O nome do parâmetro.

dbType
DbType

O tipo de banco de dados do parâmetro.

value
String

O valor padrão do parâmetro.

Retornos

Int32

O valor de índice do item adicionado.

Comentários

Esse método é para tipos de banco de dados. Use o Add(String, TypeCode, String) método para tipos CLR.

Aplica-se a

Add(String, TypeCode, String)

Cria um objeto Parameter com o nome especificado, TypeCode e valor padrão e o acrescenta ao final da coleção.

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

Parâmetros

name
String

O nome do parâmetro.

type
TypeCode

O tipo do parâmetro.

value
String

O valor padrão do parâmetro.

Retornos

Int32

O valor de índice do item adicionado.

Exemplos

O exemplo de código a seguir demonstra como o Add(String, TypeCode, String) método pode ser usado para adicionar novos Parameter objetos a uma ParameterCollection coleção fornecendo os nameparâmetros , valuee type . Neste exemplo, um Parameter objeto é adicionado a um comando Update de um controle de fonte de dados do Access que fornece o valor da hora atual do sistema. O parâmetro é adicionado com o TypeCode de 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>

Comentários

Use o Add(String, TypeCode, String) método para criar e acrescentar um objeto fortemente tipado Parameter com um valor padrão ao final da coleção. Essa implementação do método cria o Parameter objeto usando o nome, o tipo e o namevalor especificados pelos parâmetros e typevalue , respectivamente, e o acrescenta à coleção.

Confira também

Aplica-se a