Compartir a través de


SqlParameter Constructores

Definición

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

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.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType)

Parámetros

parameterName
String

Nombre del parámetro que se va a asignar.

dbType
SqlDbType

Uno de los valores de SqlDbType.

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.SqlParameter
Public 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.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer)

Parámetros

parameterName
String

Nombre del parámetro que se va a asignar.

dbType
SqlDbType

Uno de los valores de SqlDbType.

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.SqlParameter
Public 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.

dbType
SqlDbType

Uno de los valores de SqlDbType.

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.SqlParameter
Public 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.

dbType
SqlDbType

Uno de los valores de SqlDbType.

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.

scale
Byte

Número total de posiciones decimales 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.SqlParameter
Public 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.

dbType
SqlDbType

Uno de los valores de SqlDbType.

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.

scale
Byte

Número total de posiciones decimales 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 .

Se aplica a