OleDbParameter.Size Properti

Definisi

Ruang nama:

System.Data.OleDb

Rakitan:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v9.0.0-preview.5.24306.7

Sumber:

DbParameterHelper.cs

Mendapatkan atau mengatur ukuran maksimum, dalam byte, dari data dalam kolom.

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

Nilai Properti

Int32

Ukuran maksimum, dalam byte, dari data dalam kolom. Nilai default disimpulkan dari nilai parameter.

Penerapan

Size

Contoh

Contoh berikut membuat OleDbParameter dan mengatur beberapa propertinya.

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;  
 }  

Keterangan

Properti Size digunakan untuk jenis biner dan string.

Untuk jenis data nonstring dan data string ANSI, Size properti mengacu pada jumlah byte. Untuk data string Unicode, Size mengacu pada jumlah karakter. Hitungan untuk string tidak menyertakan karakter yang mengakhiri.

Untuk jenis data dengan panjang variabel, Size menjelaskan jumlah maksimum data yang akan dikirimkan ke server. Misalnya, untuk nilai string Unicode, Size dapat digunakan untuk membatasi jumlah data yang dikirim ke server ke 100 karakter pertama.

Untuk parameter dua arah dan output, dan mengembalikan nilai, Anda harus menetapkan nilai Size. Ini tidak diperlukan untuk parameter input, dan jika tidak diatur secara eksplisit, nilai disimpulkan dari ukuran aktual parameter yang ditentukan saat pernyataan berparameter dijalankan.

Properti DbType, OleDbType, dan Size dari parameter dapat disimpulkan dengan mengatur Value. Oleh karena itu, Anda tidak diharuskan untuk menentukannya. Namun, mereka tidak terekspos dalam OleDbParameter pengaturan properti. Misalnya, jika ukuran parameter telah disimpulkan, Size tidak berisi nilai yang disimpulkan setelah eksekusi pernyataan.

Untuk jenis data dengan panjang tetap, nilai Size diabaikan. Ini dapat diambil untuk tujuan informasi, dan mengembalikan jumlah maksimum byte yang digunakan penyedia saat mengirimkan nilai parameter ke server.

Jika ukuran nilai yang disediakan untuk OleDbParameter melebihi yang ditentukan Size, Value dari OleDbParameter berisi nilai yang ditentukan, dipotok ke ukuran OleDbParameter.

Lihat juga

• Bekerja dengan Perintah