SqlParameter.Precision 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 maximal de chiffres utilisés pour représenter la propriété Value.

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

public byte Precision { get; set; }

member this.Precision : byte with get, set

Public Property Precision As Byte

Valeur de propriété

Byte

Nombre maximal de chiffres utilisés pour représenter la propriété Value. La valeur par défaut est 0. Indique que le fournisseur de données définit la précision pour Value.

Implémente

Precision

Exemples

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

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command)
    {
        SqlParameter parameter = new SqlParameter("@Price", SqlDbType.Decimal);
        parameter.Value = 3.1416;
        parameter.Precision = 8;
        parameter.Scale = 4;

        command.Parameters.Add(parameter);
    }
}

Remarques

La Precision propriété est utilisée par les paramètres qui ont la SqlDbType valeur Decimal.

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 à partir de la valeur de 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 contraindre les données passées à la base de données n’est pas prise en charge. Pour arrondir, tronquer ou contraindre 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 Microsoft .NET Framework inclus dans le .NET Framework version 1.0 ne vérifient pas les Precision valeurs de Decimal paramètre ou Scale . 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 Scale de avant de Decimal définir la valeur du paramètre. Lorsque vous utilisez .NET Framework version 1.1 ou une version ultérieure, une exception est levée si une Decimal valeur de paramètre est définie avec un non valide Precision. Scale les valeurs qui dépassent l’échelle Decimal des paramètres sont toujours tronquées.