SqlParameter.Scale 屬性

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

取得或設定 Value 所解析的小數點位數。

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

屬性值

Byte

Value 解析到哪一個小數位數。 預設值是 0。

實作

Scale

範例

下列範例會建立 ， SqlParameter 並設定其部分屬性。

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

備註

Scale屬性是由 具有 SqlDbType 的參數 Decimal 所使用。

警告

如果未明確指定 屬性， Scale 而且伺服器上的資料不符合縮放比例 0， (預設) ，可能會截斷資料。

您不需要為輸入參數指定 和 Scale 屬性的值 Precision ，因為它們可以從參數值推斷。 Precision 和 Scale 是輸出參數的必要專案，以及您需要指定參數的完整中繼資料而不指出值的情況，例如指定具有特定有效位數和小數位數的 Null 值。

注意

不支援使用這個屬性來強制傳遞至資料庫的資料。 若要在將資料傳遞至資料庫之前四捨五入、截斷或其他強制型轉資料，請在將值指派給參數的 屬性之前，先使用 Math 屬於命名空間一 System 部分的 Value 類別。

注意

.NET Framework .NET Framework 1.0 版隨附的資料提供者不會驗證 Precision 或 ScaleDecimal 參數值。 這可能會導致截斷的資料插入資料來源。 如果您使用 .NET Framework 1.0 版，請先驗證 Precision 和 SqlParameterDecimal 的值，再設定參數值。 Scale 超過 Decimal 參數小數位數的值仍會遭到截斷。