SqlParameter.Scale 属性

  • 参考

定义

命名空间:
System.Data.SqlClient
程序集:
System.Data.SqlClient.dll
程序集:
System.Data.dll
包:
System.Data.SqlClient v4.8.6

获取或设置所解析的 Value 的小数位数。

public:
 property System::Byte Scale { System::Byte get(); void set(System::Byte value); };
public byte Scale { get; set; }
[System.Data.DataSysDescription("DbDataParameter_Scale")]
public byte Scale { get; set; }
member this.Scale : byte with get, set
[<System.Data.DataSysDescription("DbDataParameter_Scale")>]
member this.Scale : byte with get, set
Public Property Scale As Byte

属性值

Byte

对 Value 进行解析的小数位数。 默认值为 0。

实现

Scale
属性
DataSysDescriptionAttribute

示例

以下示例创建 SqlParameter 并设置其一些属性。

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

Private Sub CreateSqlParameterPrecisionScale()
    Dim parameter As New SqlParameter("Price", SqlDbType.Decimal)
    parameter.Value = 3.1416
    parameter.Precision = 8
    parameter.Scale = 4
End Sub

注解

属性Scale由具有 SqlDbType 、DateTime2、 DateTimeOffset或 Time的参数Decimal使用。

警告

如果未显式指定 属性， Scale 并且服务器上的数据不适合 0 (默认) ，则可能会截断数据。
DateTime2对于 类型，刻度 0 (默认) 将作为 datetime2 (7) 传递。 目前无法以 datetime2 (0) 的形式发送参数。 按预期缩放 1-7 工作。 此问题也适用于 DateTimeOffset 和 Time 。

无需为输入参数的 Precision 和 Scale 属性指定值，因为可以从参数值推断它们。 Precision 和 Scale 是输出参数所必需的，并且需要为参数指定完整的元数据而不指示值的情况，例如指定具有特定精度和小数位数的 null 值。

注意

不支持使用此属性来强制传递到数据库的数据。 若要在将数据传递到数据库之前对其进行舍入、截断或以其他方式强制数据，请在向参数的 Value 属性赋值之前使用Math属于 System 命名空间的类。

注意

.NET Framework版本 1.0 附带.NET Framework数据提供程序不会验证Precision参数值的 或 ScaleDecimal 。 这可能会导致在数据源中插入截断的数据。 如果使用 .NET Framework 版本 1.0，请在Precision设置参数值之前验证 值的 和 SqlParameterDecimal 。 Scale 超过 Decimal 参数小数位数的值仍会被截断。

适用于

另请参阅