DbParameter.Size Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta le dimensioni massime, in byte, dei dati all'interno della colonna.
public:
abstract property int Size { int get(); void set(int value); };public abstract int Size { get; set; }member this.Size : int with get, setPublic MustOverride Property Size As IntegerValore della proprietà
Dimensione massima, in byte, dei dati all'interno della colonna. Il valore predefinito viene dedotto dal valore del parametro.
Implementazioni
Commenti
La Size proprietà viene utilizzata per i tipi binari e stringa.
Per i tipi di dati nonstring e i dati stringa ANSI, la Size proprietà fa riferimento al numero di byte. Per i dati stringa Unicode, Size fa riferimento al numero di caratteri. Il conteggio per le 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. Questa operazione non è necessaria per i parametri di input e, se non impostata in modo esplicito, il valore viene dedotto dalle dimensioni effettive del parametro specificato quando viene eseguita un'istruzione con parametri.
Le DbType proprietà e Size di un parametro possono essere dedotte impostando Value. Pertanto, non è necessario specificarli. Tuttavia, non vengono esposte nelle DbParameter impostazioni delle proprietà. Ad esempio, se la dimensione del parametro è stata dedotta, Size non contiene 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 utilizzata 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 Value dell'oggetto DbParameter conterrà il valore specificato, troncato alle dimensioni 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.
