SqlParameter.Scale 属性

定义

获取或设置所解析的 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

属性值

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

实现

属性

示例

以下示例创建 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由具有 SqlDbTypeDateTime2DateTimeOffsetTime的参数Decimal使用。

警告

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

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

注意

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

注意

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

适用于

另请参阅