SqlParameter.Value Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Pacchetto:
System.Data.SqlClient v4.8.6

Ottiene o imposta il valore del parametro.

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

Valore della proprietà

Object

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

Implementazioni

Value
Attributi
TypeConverterAttribute DataSysDescriptionAttribute

Esempio

Nell'esempio seguente viene creato un oggetto SqlParameter e vengono impostate alcune delle relative proprietà.

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

Commenti

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

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 determinare se il tipo specificato non è compatibile con il valore .

È possibile dedurre entrambe le DbType proprietà e SqlDbType impostando Value.

La Value proprietà viene sovrascritta da SqlDataAdapter.UpdateCommand.

Per informazioni sullo streaming, vedere Supporto per lo streaming sqlClient.

Si applica a

Vedi anche