OleDbParameter.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 contenuti nella colonna.
public:
virtual property int Size { int get(); void set(int value); };public:
property int Size { int get(); void set(int value); };public override int Size { get; set; }[System.Data.DataSysDescription("DbDataParameter_Size")]
public int Size { get; set; }member this.Size : int with get, set[<System.Data.DataSysDescription("DbDataParameter_Size")>]
member this.Size : int with get, setPublic Overrides Property Size As IntegerPublic Property Size As IntegerValore della proprietà
Dimensioni massime in byte dei dati contenuti nella colonna. Il valore predefinito viene dedotto dal valore del parametro.
Implementazioni
- Attributi
Esempio
Nell'esempio seguente viene creato un oggetto OleDbParameter e vengono impostate alcune delle relative proprietà.
Public Sub CreateOleDbParameter()
Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"
Dim parameter As New OleDbParameter("Description", OleDbType.VarChar)
parameter.Direction = ParameterDirection.Output
parameter.Size = myValue.Length
parameter.Value = myValue
End Sub 'CreateOleDbParameter
public void CreateOleDbParameter()
{
string myValue = "12 foot scarf - multiple colors, one previous owner";
OleDbParameter parameter = new OleDbParameter("Description", OleDbType.VarChar);
parameter.Direction = ParameterDirection.Output;
parameter.Size = myValue.Length;
parameter.Value = myValue;
}
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 delle stringhe non include il carattere di terminazione.
Per i tipi di dati a lunghezza variabile, Size viene descritta 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 100 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 di viene dedotto dalle dimensioni effettive del parametro specificato quando viene eseguita un'istruzione con parametri.
È possibile dedurre le DbTypeproprietà , OleDbTypee Size di un parametro impostando Value. Pertanto, non è necessario specificarli. Tuttavia, non vengono esposti nelle OleDbParameter impostazioni delle proprietà. Ad esempio, se le dimensioni del parametro sono state dedotte, Size non contiene il 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 OleDbParameter oggetto supera l'oggetto specificato Size, l'oggetto Value dell'oggetto OleDbParameter contiene il valore specificato, troncato alla dimensione dell'oggetto OleDbParameter.
