SqlParameter.Size Properti

  • Referensi

Definisi

Ruang nama:
System.Data.SqlClient
Rakitan:
System.Data.SqlClient.dll
Rakitan:
System.Data.dll
Paket:
System.Data.SqlClient v4.8.6

Mendapatkan atau mengatur ukuran maksimum, dalam byte, dari 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; }
[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, set
Public Overrides Property Size As Integer
Public Property Size As Integer

Nilai Properti

Int32

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

Penerapan

Size
Atribut
DataSysDescriptionAttribute

Contoh

Contoh berikut membuat SqlParameter dan mengatur beberapa propertinya.

static void CreateSqlParameterSize()
{
    string description = "12 foot scarf - multiple colors, one previous owner";
    SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar);
    parameter.Direction = ParameterDirection.InputOutput;
    parameter.Size = description.Length;
    parameter.Value = description;
}

Private Sub CreateSqlParameterSize()
    Dim description As String = "12 foot scarf - multiple colors, one previous owner"
    Dim parameter As New SqlParameter("Description", SqlDbType.VarChar)
    parameter.Direction = ParameterDirection.InputOutput
    parameter.Size = description.Length
    parameter.Value = description
End Sub

Keterangan

Nilai yang dikembalikan tidak dipengaruhi oleh properti ini; mengembalikan parameter dari prosedur tersimpan selalu berupa bilangan bulat ukuran tetap.

Untuk parameter output dengan jenis panjang variabel (nvarchar, misalnya), ukuran parameter menentukan ukuran buffer yang memegang parameter output. Parameter output dapat dipotok ke ukuran yang ditentukan dengan Size. Untuk jenis karakter, ukuran yang ditentukan dengan Size berada dalam karakter.

Properti Size digunakan untuk jenis biner dan string. Untuk parameter jenis SqlType.String, Size berarti panjang dalam karakter Unicode. Untuk parameter jenis SqlType.Xml, Size diabaikan.

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.

Jika tidak diatur secara eksplisit, ukuran disimpulkan dari ukuran aktual dari nilai parameter yang ditentukan.

Jika bagian pecahan dari nilai parameter lebih besar dari ukurannya, maka nilai akan dipotok agar sesuai dengan ukurannya.

Untuk jenis data 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.

Untuk informasi tentang streaming, lihat Dukungan Streaming SqlClient.

Berlaku untuk

Lihat juga