SqlParameter.Value Propiedad

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Obtiene o establece el valor del parámetro.

public:
 virtual property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };

[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public override object Value { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.Value : obj with get, set

Public Overrides Property Value As Object

Valor de propiedad

Object

Object que es el valor del parámetro. El valor predeterminado es null.

Implementaciones

Value

Atributos

TypeConverterAttribute

Ejemplos

En el ejemplo siguiente se crea un SqlParameter objeto y se establecen algunas de sus propiedades.

// using Microsoft.Data.SqlClient;
static void CreateSqlParameterVersion()
{
    SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar, 88);
    parameter.Value = "garden hose";
}

Comentarios

En el caso de los parámetros de entrada, el valor se enlaza al SqlCommand objeto que se envía al servidor. Para los parámetros de SqlCommand valor devuelto y de salida, el valor se establece al finalizar y después de cerrar .SqlDataReader

Esta propiedad se puede establecer en null o DBNull.Value. Use DBNull.Value para enviar un valor NULL como valor del parámetro . Use null o no establezca Value para usar el valor predeterminado para el parámetro .

Se produce una excepción si los datos XML que no son Unicode se pasan como una cadena.

Si la aplicación especifica el tipo de base de datos, el valor enlazado se convierte en ese tipo cuando el proveedor envía los datos al servidor. El proveedor intenta convertir cualquier tipo de valor si admite la IConvertible interfaz . Los errores de conversión pueden producirse si el tipo especificado no es compatible con el valor.

DbType Las propiedades y SqlDbType se pueden deducir estableciendo el valor Value.

La Value propiedad se sobrescribe mediante SqlDataAdapter.UpdateCommand.

Para obtener información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.