OdbcParameter.Size Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur ukuran maksimum data dalam kolom.
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; }
public int Size { get; set; }
member this.Size : int with get, set
Public Overrides Property Size As Integer
Public Property Size As Integer
Nilai Properti
Ukuran maksimum data dalam kolom. Nilai default disimpulkan dari nilai parameter.
Penerapan
Contoh
Contoh berikut membuat OdbcParameter dan mengatur beberapa propertinya.
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;
}
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 seratus 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, OdbcType, dan Size dari parameter dapat disimpulkan dengan mengatur Value. Oleh karena itu, Anda tidak diharuskan untuk menentukannya. Namun, mereka tidak terekspos dalam OdbcParameter pengaturan properti. Misalnya, jika ukuran parameter telah disimpulkan, Size
tidak berisi nilai yang disimpulkan setelah eksekusi pernyataan.
Catatan
OdbcParameter
Untuk dengan Direction , ParameterDirection.Output
, ParameterDirection.InputOutput
atau ParameterDirection.ReturnValue
, pengecualian dilemparkan ketika perintah dijalankan jika ukuran nilai yang dikembalikan oleh sumber data melebihi yang ditentukan Size
dari OdbcParameter.
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.