SqlParameter.Precision Propriété

Définition

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; }
[System.Data.DataSysDescription("DbDataParameter_Precision")]
public byte Precision { get; set; }
member this.Precision : byte with get, set
[<System.Data.DataSysDescription("DbDataParameter_Precision")>]
member this.Precision : byte with get, set
Public Property Precision As Byte

Valeur de propriété

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

Attributs

Exemples

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

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);
}
Private Sub AddSqlParameter(ByVal command As SqlCommand)

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

    command.Parameters.Add(parameter)
End Sub

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 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 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 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 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.

S’applique à

Voir aussi