SqlParameter.Scale Properti

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Mendapatkan atau mengatur jumlah tempat desimal yang Value diselesaikan.

public:
 property System::Byte Scale { System::Byte get(); void set(System::Byte value); };

public byte Scale { get; set; }

member this.Scale : byte with get, set

Public Property Scale As Byte

Nilai Properti

Byte

Jumlah tempat desimal yang Value diselesaikan. Defaultnya adalah 0.

Penerapan

Scale

Contoh

Contoh berikut membuat SqlParameter dan mengatur beberapa propertinya.

// using Microsoft.Data.SqlClient;
static void CreateSqlParameterPrecisionScale()
{
    SqlParameter parameter = new SqlParameter("Price", SqlDbType.Decimal);
    parameter.Value = 3.1416;
    parameter.Precision = 8;
    parameter.Scale = 4;
}

Keterangan

Properti Scale digunakan oleh parameter yang memiliki SqlDbType dari Decimal.

Peringatan

Data dapat dipotong jika Scale properti tidak ditentukan secara eksplisit dan data di server tidak sesuai dengan skala 0 (default).

Anda tidak perlu menentukan nilai untuk Precision properti dan Scale untuk parameter input, karena dapat disimpulkan dari nilai parameter. Precision dan Scale diperlukan untuk parameter output dan untuk skenario di mana Anda perlu menentukan metadata lengkap untuk parameter tanpa menunjukkan nilai, seperti menentukan nilai null dengan presisi dan skala tertentu.

Catatan

Penggunaan properti ini untuk memaksa data yang diteruskan ke database tidak didukung. Untuk membulatkan, memotong, atau memaksa data sebelum meneruskannya ke database, gunakan Math kelas yang merupakan bagian System dari namespace sebelum menetapkan nilai ke properti parameter Value .

Catatan

.NET Framework penyedia data yang disertakan dengan .NET Framework versi 1.0 tidak memverifikasi Precision atau Scale nilai Decimal parameter. Ini dapat menyebabkan data yang terpotong disisipkan di sumber data. Jika Anda menggunakan .NET Framework versi 1.0, validasi Precision nilai dan SqlParameterDecimal sebelum mengatur nilai parameter. Scale nilai yang melebihi Decimal skala parameter masih terpotong.