SqlParameter.Scale Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Obtient ou définit le nombre de décimales appliqué à la résolution de 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

Valeur de propriété

Byte

Nombre de positions décimales selon lesquelles le Value est résolu. La valeur par défaut est 0.

Implémente

Scale

Exemples

L’exemple suivant crée un SqlParameter et définit certaines de ses propriétés.

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

Remarques

La Scale propriété est utilisée par les paramètres qui ont une SqlDbType valeur de Decimal.

Avertissement

Les données peuvent être tronquées si la Scale propriété n’est pas spécifiée explicitement et si les données du serveur ne correspondent pas à l’échelle 0 (valeur par défaut).

Vous n’avez pas besoin de spécifier des valeurs pour les propriétés et Scale pour les Precision paramètres d’entrée, car elles peuvent être déduites de la valeur du paramètre. Precision et Scale sont requis pour les paramètres de sortie et pour les scénarios où vous devez spécifier des métadonnées complètes pour un paramètre sans indiquer de valeur, par exemple en spécifiant une valeur null avec une précision et une échelle spécifiques.

Notes

L’utilisation de cette propriété pour forcer les données passées à la base de données n’est pas prise en charge. Pour arrondir, tronquer ou forcer des données avant de les transmettre à la base de données, utilisez la Math classe qui fait partie de l’espace System de noms avant d’affecter une valeur à la propriété du Value paramètre.

Notes

Les fournisseurs de données .NET Framework inclus dans .NET Framework version 1.0 ne vérifient pas les Precision valeurs ou Scale des Decimal paramètres. Cela peut entraîner l’insertion de données tronquées au niveau de la source de données. Si vous utilisez .NET Framework version 1.0, validez les Precision valeurs et SqlParameter de avant de Decimal définir la valeur du paramètre. Scale les valeurs qui dépassent l’échelle des Decimal paramètres sont toujours tronquées.