SqlParameterCollection.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í.
Sobrecargas
| Add(SqlParameter) |
Agrega el objeto SqlParameter especificado al objeto SqlParameterCollection. |
| Add(Object) |
Agrega el objeto SqlParameter especificado al objeto SqlParameterCollection. |
| Add(String, SqlDbType) |
Agrega un objeto SqlParameter a la colección SqlParameterCollection dados el nombre del parámetro y el tipo de datos. |
| Add(String, Object) |
Obsoletos.
Agrega el objeto SqlParameter especificado al objeto SqlParameterCollection. |
| Add(String, SqlDbType, Int32) |
Agrega un objeto SqlParameter a la colección SqlParameterCollection a partir del nombre de parámetro, el SqlDbType y el tamaño especificados. |
| Add(String, SqlDbType, Int32, String) |
Agrega un objeto SqlParameter a la colección SqlParameterCollection con el nombre de parámetro, el tipo de datos y la longitud de columna. |
Add(SqlParameter)
Agrega el objeto SqlParameter especificado al objeto SqlParameterCollection.
public:
Microsoft::Data::SqlClient::SqlParameter ^ Add(Microsoft::Data::SqlClient::SqlParameter ^ value);public Microsoft.Data.SqlClient.SqlParameter Add (Microsoft.Data.SqlClient.SqlParameter value);override this.Add : Microsoft.Data.SqlClient.SqlParameter -> Microsoft.Data.SqlClient.SqlParameterPublic Function Add (value As SqlParameter) As SqlParameterParámetros
- value
- SqlParameter
SqlParameter que se agrega a la colección.
Devoluciones
Un nuevo objeto SqlParameter.
Excepciones
El objeto SqlParameter especificado en el parámetro value ya se ha agregado a esta colección SqlParameterCollection o a otra.
El parámetro pasado no era SqlParameter.
El parámetro value es null.
Ejemplos
using Microsoft.Data.SqlClient;
public class Sample
{
public void AddSqlParameter(SqlCommand command)
{
command.Parameters.Add(new SqlParameter("Description", "Beverages"));
}
}
Se aplica a
Add(Object)
Agrega el objeto SqlParameter especificado al objeto SqlParameterCollection.
public:
override int Add(System::Object ^ value);public override int Add (object value);override this.Add : obj -> intPublic Overrides Function Add (value As Object) As IntegerParámetros
Devoluciones
El índice del nuevo objeto SqlParameter.
Se aplica a
Add(String, SqlDbType)
Agrega un objeto SqlParameter a la colección SqlParameterCollection dados el nombre del parámetro y el tipo de datos.
public:
Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType);public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType);override this.Add : string * System.Data.SqlDbType -> Microsoft.Data.SqlClient.SqlParameterPublic Function Add (parameterName As String, sqlDbType As SqlDbType) As SqlParameterParámetros
- parameterName
- String
El nombre del parámetro.
Devoluciones
Un nuevo objeto SqlParameter.
Ejemplos
using Microsoft.Data.SqlClient;
public class Sample
{
public void AddSqlParameter(SqlCommand command)
{
SqlParameter param = command.Parameters.Add(
"@Description", SqlDbType.NVarChar);
param.Size = 16;
param.Value = "Beverages";
}
}
Se aplica a
Add(String, Object)
Precaución
Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value). http://go.microsoft.com/fwlink/?linkid=14202
Agrega el objeto SqlParameter especificado al objeto SqlParameterCollection.
public:
Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Object ^ value);[System.Obsolete("Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value). http://go.microsoft.com/fwlink/?linkid=14202", false)]
public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, object value);[<System.Obsolete("Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value). http://go.microsoft.com/fwlink/?linkid=14202", false)>]
override this.Add : string * obj -> Microsoft.Data.SqlClient.SqlParameterPublic Function Add (parameterName As String, value As Object) As SqlParameterParámetros
- parameterName
- String
Nombre del objeto SqlParameter que se va a agregar a la colección.
Devoluciones
Un nuevo objeto SqlParameter.
Tenga cuidado al utilizar esta sobrecarga del método SqlParameterCollection.Add para especificar valores de parámetro de número entero. Dado que esta sobrecarga toma un parámetro value de tipo Object, cuando el valor entero sea cero se debe convertir en un tipo Object, tal como se muestra en el siguiente ejemplo de C#.
parameters.Add("@pname", Convert.ToInt32(0));
Si no se lleva a cabo esta conversión, el compilador supone que se está intentando llamar a la sobrecarga de SqlParameterCollection.Add (string, SqlDbType).
- Atributos
Excepciones
El objeto SqlParameter especificado en el parámetro value ya se ha agregado a esta colección SqlParameterCollection o a otra.
El parámetro value es null.
Ejemplos
using Microsoft.Data.SqlClient;
public class Sample
{
public void AddSqlParameter(SqlCommand command)
{
SqlParameter param = new SqlParameter(
"@Description", SqlDbType.NVarChar, 16);
param.Value = "Beverages";
command.Parameters.Add(param);
}
}
Se aplica a
Add(String, SqlDbType, Int32)
Agrega un objeto SqlParameter a la colección SqlParameterCollection a partir del nombre de parámetro, el SqlDbType y el tamaño especificados.
public:
Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType, int size);public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType, int size);override this.Add : string * System.Data.SqlDbType * int -> Microsoft.Data.SqlClient.SqlParameterPublic Function Add (parameterName As String, sqlDbType As SqlDbType, size As Integer) As SqlParameterParámetros
- parameterName
- String
El nombre del parámetro.
- sqlDbType
- SqlDbType
SqlDbType de SqlParameter que se agrega a la colección.
Devoluciones
Un nuevo objeto SqlParameter.
Ejemplos
using Microsoft.Data.SqlClient;
public class Sample
{
public void AddSqlParameter(SqlCommand command)
{
SqlParameter param = new SqlParameter(
"@Description", SqlDbType.NVarChar, 16);
param.Value = "Beverages";
command.Parameters.Add(param);
}
}
Comentarios
Esta sobrecarga es útil cuando se agrega un parámetro de un tipo de datos de longitud variable, como varchar o binary.
Se aplica a
Add(String, SqlDbType, Int32, String)
Agrega un objeto SqlParameter a la colección SqlParameterCollection con el nombre de parámetro, el tipo de datos y la longitud de columna.
public:
Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType, int size, System::String ^ sourceColumn);public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType, int size, string sourceColumn);override this.Add : string * System.Data.SqlDbType * int * string -> Microsoft.Data.SqlClient.SqlParameterPublic Function Add (parameterName As String, sqlDbType As SqlDbType, size As Integer, sourceColumn As String) As SqlParameterParámetros
- parameterName
- String
El nombre del parámetro.
- size
- Int32
Longitud de columna.
- sourceColumn
- String
Nombre de la columna de origen (SourceColumn) si este SqlParameter se usa en una llamada a Update(DataSet).
Devoluciones
Un nuevo objeto SqlParameter.
Ejemplos
using Microsoft.Data.SqlClient;
public class Sample
{
public void AddSqlParameter(SqlCommand cmd)
{
SqlParameter p1 = cmd.Parameters.Add("@Description", SqlDbType.NVarChar, 16, "Description");
}
}