SqlParameter Constructores

Referencia

Definición

Espacio de nombres:: System.Data.SqlClient

Ensamblado:: System.Data.SqlClient.dll

Ensamblado:: System.Data.dll

Ensamblados:: netstandard.dll, System.Data.SqlClient.dll

Paquete:: System.Data.SqlClient v4.8.6

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

Inicializa una nueva instancia de la clase SqlParameter.

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.

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter()
    With parameter
        .ParameterName = "@Description"
        .IsNullable = True
        .SqlDbType = SqlDbType.VarChar
        .Direction = ParameterDirection.Output
        .Size = 88
    End With

    command.Parameters.Add(parameter)
End Sub

Consulte también

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> System.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

ArgumentException

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.

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand, _
    ByVal paramValue As String)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar)
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
        .Size = 88
        .Value = paramValue
    End With

    command.Parameters.Add(parameter)
End Sub

Comentarios

El tipo de datos y, si procede, Size y Precision se deducen del valor del dbType parámetro .

Consulte también

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 System.Data.SqlClient.SqlParameter : string * obj -> System.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.

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88, "Description")
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
    End With

    command.Parameters.Add(parameter)
End Sub

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.

Consulte también

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> System.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

ArgumentException

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.

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand, _
    ByVal paramValue As String)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88)
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
        .Value = paramValue
    End With

    command.Parameters.Add(parameter)
End Sub

Comentarios

El tamaño se deduce del valor del dbType parámetro si no se establece explícitamente en el size parámetro .

Consulte también

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> System.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 este SqlParameter se usa en una llamada a Update.

Excepciones

ArgumentException

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.

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88, "Description")
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
    End With

    command.Parameters.Add(parameter)
End Sub

Comentarios

El tamaño se deduce del valor del dbType parámetro si no se establece explícitamente en el size parámetro .

Consulte también

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> System.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.

sourceVersion: DataRowVersion

Uno de los valores de DataRowVersion.

value: Object

Object que es el valor de SqlParameter.

Excepciones

ArgumentException

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.

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 11, ParameterDirection.Input, _
        True, 0, 0, "Description", DataRowVersion.Current, _
        "garden hose")
    parameter.IsNullable = True

    command.Parameters.Add(parameter)
End Sub

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 .

Consulte también

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> System.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 este SqlParameter se usa en una llamada a Update.

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 Size Precision se deducen del valor del dbType parámetro si no se establecen explícitamente en los size parámetros y precision .

Consulte también

Se aplica a

Compartir a través de

SqlParameter Constructores

Definición

Sobrecargas

SqlParameter()

Ejemplos

Consulte también

Se aplica a

SqlParameter(String, SqlDbType)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

SqlParameter(String, Object)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

SqlParameter(String, SqlDbType, Int32)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

SqlParameter(String, SqlDbType, Int32, String)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)

Parámetros

Comentarios

Consulte también

Se aplica a

Recursos adicionales