SqlParameter.Value Proprietà

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v5.2.0

Ottiene o imposta il valore del parametro.

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

Valore della proprietà

Object

Oggetto Object che rappresenta il valore del parametro. Il valore predefinito è null.

Implementazioni

Value

Attributi

TypeConverterAttribute

Esempio

L'esempio seguente crea un oggetto SqlParameter e imposta alcune delle relative proprietà.

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

Commenti

Per i parametri di input, il valore è associato all'oggetto SqlCommand inviato al server. Per i parametri di output e restituiti, il valore viene impostato al completamento dell'oggetto SqlCommand e dopo la chiusura.SqlDataReader

Questa proprietà può essere impostata su null o DBNull.Value. Usare DBNull.Value per inviare un valore NULL come valore del parametro. Usare null o non impostare Value per usare il valore predefinito per il parametro.

Viene generata un'eccezione se i dati XML non Unicode vengono passati come stringa.

Se l'applicazione specifica il tipo di database, il valore associato viene convertito in tale tipo quando il provider invia i dati al server. Il provider tenta di convertire qualsiasi tipo di valore se supporta l'interfaccia IConvertible . Gli errori di conversione possono causare se il tipo specificato non è compatibile con il valore.

Entrambe le DbType proprietà e SqlDbType possono essere dedotte impostando il valore.

La Value proprietà viene sovrascritta da SqlDataAdapter.UpdateCommand.

Per informazioni sullo streaming, vedere Supporto per lo streaming di SqlClient.