DbParameter.Size Proprietà

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbParameter.cs

Ottiene o imposta le dimensioni massime in byte dei dati contenuti nella colonna.

public:
 abstract property int Size { int get(); void set(int value); };

public abstract int Size { get; set; }

member this.Size : int with get, set

Public MustOverride Property Size As Integer

Valore della proprietà

Int32

Dimensioni massime in byte dei dati contenuti nella colonna. Il valore predefinito viene dedotto dal valore del parametro.

Implementazioni

Size

Commenti

La Size proprietà viene usata per i tipi binari e stringa.

Per i tipi di dati non con stringa ANSI, la Size proprietà fa riferimento al numero di byte. Per i dati stringa Unicode, Size si riferisce al numero di caratteri. Il conteggio delle stringhe non include il carattere di terminazione.

Per i tipi di dati a lunghezza variabile, Size descrive la quantità massima di dati da trasmettere al server. Ad esempio, per un valore stringa Unicode, Size può essere usato per limitare la quantità di dati inviati al server ai primi cento caratteri.

Per i parametri bidirezionali e di output e i valori restituiti, è necessario impostare il valore di Size. Non è necessario per i parametri di input e, se non è impostato in modo esplicito, il valore viene dedotto dalle dimensioni effettive del parametro specificato quando viene eseguita un'istruzione con parametri.

È possibile dedurre le DbType proprietà e Size di un parametro impostando Value. Pertanto, non è necessario specificarli. Tuttavia, non vengono esposti nelle DbParameter impostazioni delle proprietà. Ad esempio, se le dimensioni del parametro sono state dedotte, Size non contengono valore dedotto dopo l'esecuzione dell'istruzione.

Per i tipi di dati a lunghezza fissa, il valore di Size viene ignorato. Può essere recuperato a scopo informativo e restituisce la quantità massima di byte usata dal provider durante la trasmissione del valore del parametro al server.

Se la dimensione del valore fornito per un DbParameter valore supera l'oggetto specificato Size, l'oggetto ValueDbParameter dell'oggetto conterrà il valore specificato, troncato alla dimensione dell'oggetto DbParameter.

Per i parametri di tipo DbType.String, il valore di Size è lunghezza in caratteri Unicode. Per i parametri di tipo DbType.Xml, Size viene ignorato.

Vedi anche

• Panoramica di ADO.NET