ParameterCollection.Add Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Agrega un objeto Parameter a la colección.
Sobrecargas
| Add(Parameter) |
Agrega el objeto Parameter especificado al final de la colección. |
| Add(String, String) |
Crea un objeto Parameter con el nombre y valor predeterminado especificados y lo anexa al final de la colecció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. |
| 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. |
Add(Parameter)
Agrega el objeto Parameter especificado al final de la colección.
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 -> intPublic Function Add (parameter As Parameter) As IntegerParámetros
Devoluciones
El valor de índice del elemento que se ha agregado.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar un AccessDataSource control y un FormParameter objeto para mostrar información de una base de datos de Microsoft Access en un GridView control. El FormParameter objeto se agrega a la SelectParameters colección mediante el Add(Parameter) método .
Importante
Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante scripts.
<%@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 Add(Parameter) método para anexar un Parameter objeto al final de la colección. Esta implementación del método toma el Parameter objeto especificado por el param parámetro y lo anexa a la colección.
Consulte también
Se aplica a
Add(String, String)
Crea un objeto Parameter con el nombre y valor predeterminado especificados y lo anexa al final de la colección.
public:
int Add(System::String ^ name, System::String ^ value);public int Add (string name, string value);member this.Add : string * string -> intPublic Function Add (name As String, value As String) As IntegerParámetros
- name
- String
El nombre del parámetro.
- value
- String
Una cadena que actúa como un valor predeterminado para el parámetro.
Devoluciones
El valor de índice del elemento que se ha agregado.
Ejemplos
En el ejemplo de código siguiente se muestra cómo se puede usar el Add(String, String) método para agregar nuevos Parameter objetos a una ParameterCollection colección proporcionando los name parámetros y value . En este ejemplo, se agrega un Parameter objeto a un comando Update de un control de origen de datos de Access enlazado al valor de un 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. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante scripts.
<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
Use el Add(String, String) método para crear y anexar un Parameter objeto con un valor predeterminado al final de la colección. Esta implementación del método crea el Parameter objeto utilizando el nombre y el valor predeterminado especificados por los name parámetros y value , respectivamente, y los anexa a la colección.
Consulte también
Se aplica a
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.
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 -> intPublic Function Add (name As String, dbType As DbType, value As String) As IntegerParámetros
- name
- String
El nombre del parámetro.
- dbType
- DbType
Tipo de base de datos del parámetro.
- value
- String
Valor predeterminado del parámetro.
Devoluciones
El valor de índice del elemento que se ha agregado.
Comentarios
Este método es para los tipos de base de datos. Use el Add(String, TypeCode, String) método para los tipos CLR.
Se aplica a
Add(String, TypeCode, String)
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 -> intPublic Function Add (name As String, type As TypeCode, value As String) As IntegerParámetros
- name
- String
El nombre del parámetro.
- type
- TypeCode
Tipo del parámetro.
- value
- String
Valor predeterminado del parámetro.
Devoluciones
El valor de índice del elemento que se ha agregado.
Ejemplos
En el ejemplo de código siguiente se muestra cómo se puede usar el Add(String, TypeCode, String) método para agregar nuevos Parameter objetos a una ParameterCollection colección proporcionando los nameparámetros , valuey type . En este ejemplo, se agrega un Parameter objeto a un comando Update de un control de origen de datos de Access que proporciona el valor de la hora actual del sistema. El parámetro se agrega con el 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>
Comentarios
Utilice el Add(String, TypeCode, String) método para crear y anexar un objeto fuertemente tipado Parameter con un valor predeterminado al final de la colección. Esta implementación del método crea el Parameter objeto utilizando el nombre, el tipo y el valor especificados por los nameparámetros , type y value , respectivamente, y los anexa a la colección.
