SqlParameter.Value Properti

Referensi

Definisi

Ruang nama:: System.Data.SqlClient

Rakitan:: System.Data.SqlClient.dll

Rakitan:: System.Data.dll

Rakitan:: netstandard.dll, System.Data.SqlClient.dll

Paket:: System.Data.SqlClient v4.8.6

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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))]
[System.Data.DataSysDescription("DataParameter_Value")]
public object Value { get; set; }

[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public override object Value { get; set; }

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

[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
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

Bagikan melalui