SqlParameter.Scale Proprietà

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v5.2.0

Ottiene o imposta il numero di posizioni decimali in cui viene risolto 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

Valore della proprietà

Byte

Numero di cifre decimali in cui viene risolta la proprietà Value. Il valore predefinito è 0.

Implementazioni

Scale

Esempio

Nell'esempio seguente viene creato un oggetto SqlParameter e vengono impostate alcune delle relative proprietà.

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

Commenti

La Scale proprietà viene utilizzata dai parametri con un oggetto SqlDbType .Decimal

Avviso

I dati possono essere troncati se la Scale proprietà non è specificata in modo esplicito e i dati nel server non rientrano nella scala 0 (impostazione predefinita).

Non è necessario specificare i valori per le Precision proprietà e Scale per i parametri di input, perché possono essere dedotti dal valore del parametro. Precision e Scale sono necessari per i parametri di output e per gli scenari in cui è necessario specificare metadati completi per un parametro senza indicare un valore, ad esempio specificando un valore Null con una precisione e una scala specifiche.

Nota

L'uso di questa proprietà per la creazione condivisa dei dati passati al database non è supportato. Per arrotondare, troncare o in caso contrario forzare i dati prima di passarlo al database, usare la Math classe che fa parte dello spazio dei nomi prima di System assegnare un valore alla proprietà del Value parametro.

Nota

I provider di dati .NET Framework inclusi in .NET Framework versione 1.0 non verificano i Precision valori dei Decimal parametri o Scale . Ciò può causare l'inserimento di dati troncati nell'origine dati. Se si usa .NET Framework versione 1.0, convalidare i Precision valori e SqlParameter prima di Decimal impostare il valore del parametro. Scale i valori che superano la scala dei Decimal parametri vengono ancora troncati.