ParameterCollection.Add Método

Definición

Agrega un objeto Parameter a la colección.Adds a Parameter object to the collection.

Sobrecargas

Add(Parameter)

Agrega el objeto Parameter especificado al final de la colección.Appends the specified Parameter object to the end of the collection.

Add(String, String)

Crea un objeto Parameter con el nombre y valor predeterminado especificados y lo anexa al final de la colección.Creates a Parameter object with the specified name and default value, and appends it to the end of the collection.

Add(String, DbType, String)

Crea un objeto Parameter con el nombre, el tipo de base de datos y el valor predeterminado especificados, y lo agrega al final de la colección.Creates a Parameter object with the specified name, database type, and default value, and adds it to the end of the collection.

Add(String, TypeCode, String)

Crea un objeto Parameter con el nombre especificado, TypeCode, y un valor predeterminado, y lo anexa al final de la colección.Creates a Parameter object with the specified name, TypeCode, and default value, and appends it to the end of the collection.

Add(Parameter)

Agrega el objeto Parameter especificado al final de la colección.Appends the specified Parameter object to the end of the collection.

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

Parámetros

parameter
Parameter

Parameter que se va a agregar a la colección.The Parameter to append to the collection.

Devoluciones

El valor de índice del elemento que se ha agregado.The index value of the added item.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar un control AccessDataSource y un objeto FormParameter para mostrar información de una base de datos de Microsoft Access en un control GridView.The following code example demonstrates how to use an AccessDataSource control and a FormParameter object to display information from a Microsoft Access database in a GridView control. El objeto FormParameter se agrega a la colección SelectParameters mediante el método Add(Parameter).The FormParameter object is added to the SelectParameters collection using the Add(Parameter) method.

Importante

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad.This example has a text box that accepts user input, which is a potential security threat. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para más información, consulte Información general sobre los ataques mediante scripts.For more information, see Script Exploits Overview.

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

Comentarios

Utilice el método Add(Parameter) para anexar un objeto Parameter al final de la colección.Use the Add(Parameter) method to append a Parameter object to the end of the collection. Esta implementación del método toma el Parameter objeto especificado por el parámetro param y lo anexa a la colección.This implementation of the method takes the Parameter object specified by the param parameter and appends it to the collection.

Consulte también:

Add(String, String)

Crea un objeto Parameter con el nombre y valor predeterminado especificados y lo anexa al final de la colección.Creates a Parameter object with the specified name and default value, and appends it to the end of the collection.

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

El nombre del parámetro.The name of the parameter.

value
String

Una cadena que actúa como un valor predeterminado para el parámetro.A string that serves as a default value for the parameter.

Devoluciones

El valor de índice del elemento que se ha agregado.The index value of the added item.

Ejemplos

En el ejemplo de código siguiente se muestra cómo se puede utilizar el método Add(String, String) para agregar nuevos objetos Parameter a una colección ParameterCollection proporcionando los parámetros name y value.The following code example demonstrates how the Add(String, String) method can be used to add new Parameter objects to a ParameterCollection collection by supplying the name and value parameters. En este ejemplo, se agrega un objeto de Parameter a un comando de actualización de un control de origen de datos de Access que está enlazado al valor de un control TextBox.In this example, a Parameter object is added to an Update command of an Access data source control that is bound to the value of a TextBox control.

Importante

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad.This example has a text box that accepts user input, which is a potential security threat. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para más información, consulte Información general sobre los ataques mediante scripts.For more information, see Script Exploits Overview.

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

Comentarios

Utilice el método Add(String, String) para crear y anexar un objeto Parameter con un valor predeterminado al final de la colección.Use the Add(String, String) method to create and append a Parameter object with a default value to the end of the collection. Esta implementación del método crea el objeto de Parameter con el nombre y el valor predeterminado especificados por los parámetros name y value, respectivamente, y lo anexa a la colección.This implementation of the method creates the Parameter object using the name and default value specified by the name and value parameters, respectively, and appends it to the collection.

Consulte también:

Add(String, DbType, String)

Crea un objeto Parameter con el nombre, el tipo de base de datos y el valor predeterminado especificados, y lo agrega al final de la colección.Creates a Parameter object with the specified name, database type, and default value, and adds it to the end of the collection.

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

Parámetros

name
String

El nombre del parámetro.The name of the parameter.

dbType
DbType

Tipo de base de datos del parámetro.The database type of the parameter.

value
String

Valor predeterminado del parámetro.The default value for the parameter.

Devoluciones

El valor de índice del elemento que se ha agregado.The index value of the added item.

Comentarios

Este método es para los tipos de base de datos.This method is for database types. Use el método Add(String, TypeCode, String) para los tipos CLR.Use the Add(String, TypeCode, String) method for CLR types.

Add(String, TypeCode, String)

Crea un objeto Parameter con el nombre especificado, TypeCode, y un valor predeterminado, y lo anexa al final de la colección.Creates a Parameter object with the specified name, TypeCode, and default value, and appends it to the end of the collection.

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

El nombre del parámetro.The name of the parameter.

type
TypeCode

Tipo de parámetroThe type of the parameter.

value
String

Valor predeterminado del parámetro.The default value for the parameter.

Devoluciones

El valor de índice del elemento que se ha agregado.The index value of the added item.

Ejemplos

En el ejemplo de código siguiente se muestra cómo se puede utilizar el método Add(String, TypeCode, String) para agregar nuevos objetos Parameter a una colección de ParameterCollection proporcionando los parámetros name, valuey type.The following code example demonstrates how the Add(String, TypeCode, String) method can be used to add new Parameter objects to a ParameterCollection collection by supplying the name, value, and type parameters. En este ejemplo, se agrega un objeto de Parameter a un comando de actualización de un control de origen de datos de Access que proporciona el valor de la hora actual del sistema.In this example, a Parameter object is added to an Update command of an Access data source control that provides the value of the current system time. El parámetro se agrega con el TypeCode de DateTime.The parameter is added with the TypeCode of 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>

Comentarios

Utilice el método Add(String, TypeCode, String) para crear y anexar un objeto Parameter fuertemente tipado con un valor predeterminado al final de la colección.Use the Add(String, TypeCode, String) method to create and append a strongly typed Parameter object with a default value to the end of the collection. Esta implementación del método crea el objeto de Parameter con el nombre, el tipo y el valor especificados por los parámetros name, type y value, respectivamente, y los anexa a la colección.This implementation of the method creates the Parameter object using the name, type and value specified by the name, type and value parameters, respectively, and appends it to the collection.

Consulte también:

Se aplica a