SqlParameter.Value Properti

  • Referensi

Definisi

Ruang nama:
System.Data.SqlClient
Rakitan:
System.Data.SqlClient.dll
Rakitan:
System.Data.dll
Paket:
System.Data.SqlClient v4.8.6

Mendapatkan atau menetapkan nilai parameter.

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

Nilai Properti

Object

Object Yang merupakan nilai parameter. Nilai default-nya adalah null.

Penerapan

Value
Atribut
TypeConverterAttribute DataSysDescriptionAttribute

Contoh

Contoh berikut membuat SqlParameter dan mengatur beberapa propertinya.

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

Keterangan

Untuk parameter input, nilai terikat ke SqlCommand yang dikirim ke server. Untuk parameter nilai output dan pengembalian, nilai diatur pada penyelesaian SqlCommand dan setelah SqlDataReader ditutup.

Properti ini dapat diatur ke null atau DBNull.Value. Gunakan DBNull.Value untuk mengirim nilai NULL sebagai nilai parameter. Gunakan null atau jangan atur Value untuk menggunakan nilai default untuk parameter .

Pengecualian dilemparkan jika data XML non-Unicode diteruskan sebagai string.

Jika aplikasi menentukan jenis database, nilai terikat dikonversi ke jenis tersebut saat penyedia mengirim data ke server. Penyedia mencoba mengonversi semua jenis nilai jika mendukung IConvertible antarmuka. Kesalahan konversi dapat mengakibatkan jika jenis yang ditentukan tidak kompatibel dengan nilai.

DbType Properti dan SqlDbType dapat disimpulkan dengan mengatur Nilai.

Properti Value ditimpa oleh SqlDataAdapter.UpdateCommand.

Untuk informasi tentang streaming, lihat Dukungan Streaming SqlClient.

Berlaku untuk

Lihat juga