SqlParameter Constructores
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
| SqlParameter() |
Inicializa una nueva instancia de la clase SqlParameter. |
| SqlParameter(String, SqlDbType) |
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre de parámetro y el tipo de datos. |
| SqlParameter(String, Object) |
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre de parámetro y un valor del nuevo elemento SqlParameter. |
| SqlParameter(String, SqlDbType, Int32) |
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre del parámetro, el SqlDbType y el tamaño. |
| SqlParameter(String, SqlDbType, Int32, String) |
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre del parámetro, el SqlDbType, el tamaño y el nombre de la columna de origen. |
| SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object) |
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre, el tipo y el tamaño del parámetro, una ParameterDirection, l precisión y la escala del parámetro, la columna de origen, una DataRowVersion que se usará y el valor del parámetro. |
| SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String) |
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre del parámetro, el tipo del parámetro, la longitud del parámetro, la dirección, la precisión, la escala, el nombre de la columna de origen, uno de los valores de DataRowVersion, un valor booleano para la asignación de la columna de origen, el valor de |
SqlParameter()
Inicializa una nueva instancia de la clase SqlParameter.
public:
SqlParameter();public SqlParameter ();Public Sub New ()Ejemplos
En el ejemplo siguiente se crea y SqlParameter se establecen algunas de sus propiedades.
using Microsoft.Data.SqlClient;
class Program
{
private static void AddSqlParameter(SqlCommand command)
{
SqlParameter parameter = new SqlParameter();
parameter.ParameterName = "@Description";
parameter.IsNullable = true;
parameter.SqlDbType = SqlDbType.VarChar;
parameter.Direction = ParameterDirection.Output;
parameter.Size = 88;
command.Parameters.Add(parameter);
}
}
Se aplica a
SqlParameter(String, SqlDbType)
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre de parámetro y el tipo de datos.
public:
SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType);public SqlParameter (string parameterName, System.Data.SqlDbType dbType);new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> Microsoft.Data.SqlClient.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType)Parámetros
- parameterName
- String
Nombre del parámetro que se va a asignar.
Excepciones
El valor proporcionado en el parámetro dbType es un tipo de datos de back-end no válido.
Ejemplos
En el ejemplo siguiente se crea y SqlParameter se establecen algunas de sus propiedades.
using Microsoft.Data.SqlClient;
class Program
{
private static void AddSqlParameter(SqlCommand command, string paramValue)
{
SqlParameter parameter = new SqlParameter("@Description", SqlDbType.VarChar);
parameter.IsNullable = true;
parameter.Direction = ParameterDirection.Output;
parameter.Size = 88;
parameter.Value = paramValue;
command.Parameters.Add(parameter);
}
}
Comentarios
El tipo de datos y, si procede, Size y Precision se deducen del valor del dbType parámetro .
Se aplica a
SqlParameter(String, Object)
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre de parámetro y un valor del nuevo elemento SqlParameter.
public:
SqlParameter(System::String ^ parameterName, System::Object ^ value);public SqlParameter (string parameterName, object value);new Microsoft.Data.SqlClient.SqlParameter : string * obj -> Microsoft.Data.SqlClient.SqlParameterPublic Sub New (parameterName As String, value As Object)Parámetros
- parameterName
- String
Nombre del parámetro que se va a asignar.
- value
- Object
Object que es el valor de SqlParameter.
Ejemplos
En el ejemplo siguiente se crea y SqlParameter se establecen algunas de sus propiedades.
using Microsoft.Data.SqlClient;
class Program
{
private static void AddSqlParameter(SqlCommand command)
{
SqlParameter parameter = new SqlParameter("@Description",
SqlDbType.VarChar, 88, "Description");
parameter.IsNullable = true;
parameter.Direction = ParameterDirection.Output;
command.Parameters.Add(parameter);
}
}
Comentarios
Cuando se especifica en Object el parámetro , SqlDbType se deduce del tipo de Microsoft .NET Framework de Objectvalue .
Tenga cuidado al usar esta sobrecarga del SqlParameter constructor para especificar valores de parámetros enteros. 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#.
Parameter = new SqlParameter("@pname", (object)0);
Si no realiza esta conversión, el compilador supone que está intentando llamar a la sobrecarga del SqlParameter(String, SqlDbType) constructor.
Se aplica a
SqlParameter(String, SqlDbType, Int32)
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre del parámetro, el SqlDbType y el tamaño.
public:
SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size);public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size);new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> Microsoft.Data.SqlClient.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType, size As Integer)Parámetros
- parameterName
- String
Nombre del parámetro que se va a asignar.
- size
- Int32
Longitud del parámetro.
Excepciones
El valor proporcionado en el parámetro dbType es un tipo de datos de back-end no válido.
Ejemplos
En el ejemplo siguiente se crea y SqlParameter se establecen algunas de sus propiedades.
using Microsoft.Data.SqlClient;
class Program
{
private static void AddSqlParameter(SqlCommand command,
string paramValue)
{
SqlParameter parameter = new SqlParameter("@Description",
SqlDbType.VarChar, 88);
parameter.IsNullable = true;
parameter.Direction = ParameterDirection.Output;
parameter.Value = paramValue;
command.Parameters.Add(parameter);
}
}
Comentarios
El tamaño se deduce del valor del dbType parámetro si no se establece explícitamente en el size parámetro .
Se aplica a
SqlParameter(String, SqlDbType, Int32, String)
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre del parámetro, el SqlDbType, el tamaño y el nombre de la columna de origen.
public:
SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::String ^ sourceColumn);public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, string sourceColumn);new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> Microsoft.Data.SqlClient.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType, size As Integer, sourceColumn As String)Parámetros
- parameterName
- String
Nombre del parámetro que se va a asignar.
- size
- Int32
Longitud del parámetro.
- sourceColumn
- String
Nombre de la columna de origen (SourceColumn) si se SqlParameter usa en una llamada a Update(DataSet)>.
Excepciones
El valor proporcionado en el parámetro dbType es un tipo de datos de back-end no válido.
Ejemplos
En el ejemplo siguiente se crea y SqlParameter se establecen algunas de sus propiedades.
using Microsoft.Data.SqlClient;
class Program
{
private static void AddSqlParameter(SqlCommand command)
{
SqlParameter parameter = new SqlParameter("@Description",
SqlDbType.VarChar, 88, "Description");
parameter.IsNullable = true;
parameter.Direction = ParameterDirection.Output;
command.Parameters.Add(parameter);
}
}
Comentarios
El tamaño se deduce del valor del dbType parámetro si no se establece explícitamente en el size parámetro .
Se aplica a
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre, el tipo y el tamaño del parámetro, una ParameterDirection, l precisión y la escala del parámetro, la columna de origen, una DataRowVersion que se usará y el valor del parámetro.
public:
SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::Data::ParameterDirection direction, bool isNullable, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, System::Object ^ value);public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, System.Data.ParameterDirection direction, bool isNullable, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, object value);new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> Microsoft.Data.SqlClient.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType, size As Integer, direction As ParameterDirection, isNullable As Boolean, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, value As Object)Parámetros
- parameterName
- String
Nombre del parámetro que se va a asignar.
- size
- Int32
Longitud del parámetro.
- direction
- ParameterDirection
Uno de los valores de ParameterDirection.
- isNullable
- Boolean
true si el valor del campo puede ser null; de lo contrario, false.
- precision
- Byte
Número total de dígitos situados a la izquierda y a la derecha del separador decimal con que se resuelve Value.
- sourceColumn
- String
Nombre de la columna de origen (SourceColumn) si este SqlParameter se usa en una llamada a Update(DataSet).
- sourceVersion
- DataRowVersion
Uno de los valores de DataRowVersion.
- value
- Object
Object que es el valor de SqlParameter.
Excepciones
El valor proporcionado en el parámetro dbType es un tipo de datos de back-end no válido.
Ejemplos
En el ejemplo siguiente se crea y SqlParameter se establecen algunas de sus propiedades.
using Microsoft.Data.SqlClient;
class Program
{
private static void AddSqlParameter(SqlCommand command)
{
SqlParameter parameter = new SqlParameter("@Description",
SqlDbType.VarChar, 11, ParameterDirection.Input,
true, 0, 0, "Description", DataRowVersion.Current,
"garden hose");
parameter.IsNullable = true;
command.Parameters.Add(parameter);
}
}
Comentarios
Size y Precision se deducen del valor del dbType parámetro si no se establecen explícitamente en los size parámetros y precision .
Se aplica a
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre del parámetro, el tipo del parámetro, la longitud del parámetro, la dirección, la precisión, la escala, el nombre de la columna de origen, uno de los valores de DataRowVersion, un valor booleano para la asignación de la columna de origen, el valor de SqlParameter, el nombre de la base de datos donde se encuentra la colección de esquemas para esta instancia XML, el esquema relacional propietario donde se encuentra la colección de esquemas para esta instancia XML y el nombre de la colección de esquemas para este parámetro.
public:
SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::Data::ParameterDirection direction, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, bool sourceColumnNullMapping, System::Object ^ value, System::String ^ xmlSchemaCollectionDatabase, System::String ^ xmlSchemaCollectionOwningSchema, System::String ^ xmlSchemaCollectionName);public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, System.Data.ParameterDirection direction, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, bool sourceColumnNullMapping, object value, string xmlSchemaCollectionDatabase, string xmlSchemaCollectionOwningSchema, string xmlSchemaCollectionName);new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> Microsoft.Data.SqlClient.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType, size As Integer, direction As ParameterDirection, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, sourceColumnNullMapping As Boolean, value As Object, xmlSchemaCollectionDatabase As String, xmlSchemaCollectionOwningSchema As String, xmlSchemaCollectionName As String)Parámetros
- parameterName
- String
Nombre del parámetro que se va a asignar.
- size
- Int32
Longitud del parámetro.
- direction
- ParameterDirection
Uno de los valores de ParameterDirection.
- precision
- Byte
Número total de dígitos situados a la izquierda y a la derecha del separador decimal con que se resuelve Value.
- sourceColumn
- String
Nombre de la columna de origen (SourceColumn) si se SqlParameter usa en una llamada a Update(DataSet)>.
- sourceVersion
- DataRowVersion
Uno de los valores de DataRowVersion.
- sourceColumnNullMapping
- Boolean
true si la columna de origen acepta valores null; false en caso contrario.
- value
- Object
Object que es el valor de SqlParameter.
- xmlSchemaCollectionDatabase
- String
Nombre de la base de datos donde se encuentra la colección de esquemas para esta instancia XML.
- xmlSchemaCollectionOwningSchema
- String
Esquema relacional propietario donde se encuentra la colección de esquemas para esta instancia XML.
- xmlSchemaCollectionName
- String
Nombre de la colección de esquemas para este parámetro.
Comentarios
y SizePrecision se deducen del valor del dbType parámetro si no se establecen explícitamente en los size parámetros y precision .