OdbcParameter.Size Proprietà

Definizione

Spazio dei nomi:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Pacchetto:

System.Data.Odbc v9.0.0-preview.3.24172.9

Origine:

OdbcParameterHelper.cs

Ottiene o imposta la dimensione massima dei dati all'interno della colonna.

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

public override int Size { get; set; }

member this.Size : int with get, set

Public Overrides Property Size As Integer

Valore della proprietà

Int32

Dimensione massima dei dati all'interno della colonna. Il valore predefinito viene dedotto dal valore del parametro.

Implementazioni

Size

Esempio

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

Public Sub CreateOdbcParameter()  
    Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"  
    Dim parameter As New OdbcParameter("Description", OdbcType.VarChar)  
    parameter.Direction = ParameterDirection.Output  
    parameter.Size = myValue.Length  
    parameter.Value = myValue  
End Sub   

public void CreateOdbcParameter()   
 {  
    string myValue = "12 foot scarf - multiple colors, one previous owner";  
    OdbcParameter parameter = new OdbcParameter("Description", OdbcType.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 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 di viene dedotto dalle dimensioni effettive del parametro specificato quando viene eseguita un'istruzione con parametri.

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

Nota

Per un OdbcParameter oggetto con un Direction oggetto , ParameterDirection.OutputParameterDirection.InputOutputo ParameterDirection.ReturnValue, viene generata un'eccezione quando il comando viene eseguito se le dimensioni del valore restituito dall'origine dati superano l'oggetto specificato Size di OdbcParameter.

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.

Vedi anche

• Uso dei comandi