SqlParameter Constructores

Definición

Espacio de nombres:: System.Data.SqlClient

Ensamblado:: System.Data.dll

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

Nombre	Description
SqlParameter()	Inicializa una nueva instancia de la clase SqlParameter.
SqlParameter(String, SqlDbType)	Inicializa una nueva instancia de la SqlParameter clase que usa el nombre del parámetro y el tipo de datos.
SqlParameter(String, Object)	Inicializa una nueva instancia de la SqlParameter clase que usa el nombre del parámetro y un valor del nuevo SqlParameter.
SqlParameter(String, SqlDbType, Int32)	Inicializa una nueva instancia de la SqlParameter clase que usa el nombre del parámetro, , SqlDbTypey el tamaño.
SqlParameter(String, SqlDbType, Int32, String)	Inicializa una nueva instancia de la SqlParameter clase que usa el nombre del parámetro, SqlDbTypeel , 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 SqlParameter clase que usa el nombre del parámetro, el tipo del parámetro, el tamaño del parámetro, una ParameterDirection, la precisión del parámetro, la escala del parámetro, la columna de origen, un DataRowVersion objeto que se va a 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 SqlParameter clase 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 DataRowVersion valores, un valor booleano para la asignación de columnas de origen, el valor de , el nombre de `SqlParameter`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 SqlParameter clase que usa el nombre del 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 SqlDbType valores.

Excepciones

ArgumentException

El valor proporcionado en el dbType parámetro es un tipo de datos 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 SqlParameter clase que usa el nombre del parámetro y un valor del nuevo 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

que Object 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

Al especificar un Object en el parámetro value, el SqlDbType se deduce del tipo Microsoft .NET del Object.

Tenga cuidado al usar esta sobrecarga del SqlParameter constructor para especificar valores de parámetro entero. Dado que esta sobrecarga toma un value de tipo Object, debe convertir el valor entero en un Object tipo cuando el valor es cero, como se muestra en el ejemplo de C# siguiente.

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 SqlParameter clase que usa el nombre del parámetro, , SqlDbTypey 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 SqlDbType valores.

size: Int32

Longitud del parámetro.

Excepciones

ArgumentException

El valor proporcionado en el dbType parámetro es un tipo de datos 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 valor size 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 SqlParameter clase que usa el nombre del parámetro, SqlDbTypeel , 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 SqlDbType valores.

size: Int32

Longitud del parámetro.

sourceColumn: String

Nombre de la columna de origen (SourceColumn) si se SqlParameter usa en una llamada a Update.

Excepciones

ArgumentException

El valor proporcionado en el dbType parámetro es un tipo de datos 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 valor size 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 SqlParameter clase que usa el nombre del parámetro, el tipo del parámetro, el tamaño del parámetro, una ParameterDirection, la precisión del parámetro, la escala del parámetro, la columna de origen, un DataRowVersion objeto que se va a 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 SqlDbType valores.

size: Int32

Longitud del parámetro.

direction: ParameterDirection

Uno de los ParameterDirection valores.

isNullable: Boolean

true si el valor del campo puede ser NULL; de lo contrario, false.

precision: Byte

Número total de dígitos a la izquierda y derecha del separador decimal al que Value se resuelve.

scale: Byte

Número total de posiciones decimales a las que Value se resuelve.

sourceColumn: String

Nombre de la columna de origen (SourceColumn) si se SqlParameter usa en una llamada a Update.

sourceVersion: DataRowVersion

Uno de los DataRowVersion valores.

value: Object

que Object es el valor de .SqlParameter

Excepciones

ArgumentException

El valor proporcionado en el dbType parámetro es un tipo de datos 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 SqlParameter clase 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 DataRowVersion valores, un valor booleano para la asignación de columnas de origen, el valor de , el nombre de SqlParameterla 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 SqlDbType valores.

size: Int32

Longitud del parámetro.

direction: ParameterDirection

Uno de los ParameterDirection valores.

precision: Byte

Número total de dígitos a la izquierda y derecha del separador decimal al que Value se resuelve.

scale: Byte

Número total de posiciones decimales a las que Value se resuelve.

sourceColumn: String

Nombre de la columna de origen (SourceColumn) si se SqlParameter usa en una llamada a Update.

sourceVersion: DataRowVersion

Uno de los DataRowVersion valores.

sourceColumnNullMapping: Boolean

true si la columna de origen admite valores NULL; false si no es así.

value: Object

que Object 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

Comentarios

¿Le ha resultado útil esta página?