SqlParameter.Value Propiedad

Definición

Obtiene o establece el valor del parámetro.Gets or sets the value of the parameter.

public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
[System.Data.DataSysDescription("DataParameter_Value")]
public object Value { get; set; }
member this.Value : obj with get, set
Public Property Value As Object

Valor de propiedad

Object que es el valor del parámetro.An Object that is the value of the parameter. El valor predeterminado es null.The default value is null.

Implementaciones

Atributos

Ejemplos

En el ejemplo siguiente se crea una SqlParameter y se establecen algunas de sus propiedades.The following example creates a SqlParameter and sets some of its properties.

static void CreateSqlParameterVersion()
{
    SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar, 88);
    parameter.Value = "garden hose";
}
Private Sub CreateSqlParameterVersion()
    Dim parameter As New SqlParameter("Description", SqlDbType.VarChar, 88)
    parameter.Value = "garden hose"
End Sub

Comentarios

En el caso de los parámetros de entrada, el valor se enlaza a la SqlCommand que se envía al servidor.For input parameters, the value is bound to the SqlCommand that is sent to the server. En el caso de los parámetros de salida y valor devuelto, el valor se establece al finalizar el SqlCommand y después de que se cierre el SqlDataReader.For output and return value parameters, the value is set on completion of the SqlCommand and after the SqlDataReader is closed.

Esta propiedad se puede establecer en null o DBNull.Value.This property can be set to null or DBNull.Value. Utilice DBNull.Value para enviar un valor NULL como valor del parámetro.Use DBNull.Value to send a NULL value as the value of the parameter. Utilice null o no establezca Value para usar el valor predeterminado del parámetro.Use null or do not set Value to use the default value for the parameter.

Se produce una excepción si los datos XML no Unicode se pasan como una cadena.An exception is thrown if non-Unicode XML data is passed as a string.

Si la aplicación especifica el tipo de base de datos, el valor enlazado se convierte a ese tipo cuando el proveedor envía los datos al servidor.If the application specifies the database type, the bound value is converted to that type when the provider sends the data to the server. El proveedor intenta convertir cualquier tipo de valor si es compatible con la interfaz IConvertible.The provider tries to convert any type of value if it supports the IConvertible interface. Pueden producirse errores de conversión si el tipo especificado no es compatible con el valor.Conversion errors may result if the specified type is not compatible with the value.

Las propiedades DbType y SqlDbType se pueden inferir estableciendo el valor.Both the DbType and SqlDbType properties can be inferred by setting the Value.

SqlDataAdapter.UpdateCommandsobrescribe la propiedad Value.The Value property is overwritten by SqlDataAdapter.UpdateCommand.

Para obtener información sobre el streaming, vea compatibilidad con la transmisión por secuencias de SqlClient.For information about streaming, see SqlClient Streaming Support.

Se aplica a

Consulte también: