SqlParameter.Value Proprietà

Definizione

Ottiene o imposta il valore del parametro.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

Valore della proprietà

Oggetto Object che rappresenta il valore del parametro.An Object that is the value of the parameter. Il valore predefinito è null.The default value is null.

Implementazioni

Attributi

Esempi

Nell'esempio seguente viene creata una SqlParameter e vengono impostate alcune delle relative proprietà.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

Commenti

Per i parametri di input, il valore viene associato al SqlCommand inviato al server.For input parameters, the value is bound to the SqlCommand that is sent to the server. Per i parametri di output e valori restituiti, il valore viene impostato al completamento del SqlCommand e dopo la chiusura del SqlDataReader.For output and return value parameters, the value is set on completion of the SqlCommand and after the SqlDataReader is closed.

Questa proprietà può essere impostata su null o DBNull.Value.This property can be set to null or DBNull.Value. Utilizzare DBNull.Value per inviare un valore NULL come valore del parametro.Use DBNull.Value to send a NULL value as the value of the parameter. Usare null o non impostare Value per usare il valore predefinito per il parametro.Use null or do not set Value to use the default value for the parameter.

Se i dati XML non Unicode vengono passati come stringa, viene generata un'eccezione.An exception is thrown if non-Unicode XML data is passed as a string.

Se l'applicazione specifica il tipo di database, il valore associato viene convertito in quel tipo quando il provider invia i dati al server.If the application specifies the database type, the bound value is converted to that type when the provider sends the data to the server. Il provider tenta di convertire qualsiasi tipo di valore se supporta l'interfaccia IConvertible.The provider tries to convert any type of value if it supports the IConvertible interface. Gli errori di conversione possono verificarsi se il tipo specificato non è compatibile con il valore.Conversion errors may result if the specified type is not compatible with the value.

È possibile dedurre entrambe le proprietà DbType e SqlDbType impostando il valore.Both the DbType and SqlDbType properties can be inferred by setting the Value.

La proprietà Value viene sovrascritta da SqlDataAdapter.UpdateCommand.The Value property is overwritten by SqlDataAdapter.UpdateCommand.

Per informazioni sul flusso, vedere supporto del flusso SqlClient.For information about streaming, see SqlClient Streaming Support.

Si applica a

Vedi anche