SqlParameter.Size Özellik

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Sütundaki verilerin bayt cinsinden en büyük boyutunu alır veya ayarlar.

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

Özellik Değeri

Int32

Sütundaki verilerin bayt cinsinden boyut üst sınırı. Varsayılan değer parametre değerinden çıkarılır.

Uygulamalar

Size

Örnekler

Aşağıdaki örnek bir SqlParameter oluşturur ve bazı özelliklerini ayarlar.

// using Microsoft.Data.SqlClient;
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;
}

Açıklamalar

Dönüş değerleri bu özellikten etkilenmez; saklı yordamlardan dönüş parametreleri her zaman sabit boyutlu tamsayılardır.

Değişken uzunluk türüne (örneğin nvarchar) sahip çıkış parametreleri için parametrenin boyutu, çıkış parametresini tutan arabelleğin boyutunu tanımlar. Çıkış parametresi ile Sizebelirtilen bir boyuta kesilebilir. Karakter türleri için ile Size belirtilen boyut karakter cinsindendir.

Size özelliği ikili ve dize türleri için kullanılır. türündeki SqlType.Stringparametreler için, Size Unicode karakter cinsinden uzunluk anlamına gelir. türüne SqlType.XmlSize ait parametreler yoksayılır.

Dize olmayan veri türleri ve ANSI dize verileri için özelliği bayt Size sayısına başvurur. Unicode dize verileri için karakter Size sayısına başvurur. Dize sayısı sonlandırıcı karakteri içermez.

Değişken uzunluktaki veri türleri için, Size sunucuya iletilecek maksimum veri miktarını açıklar. Örneğin, bir Unicode dize değeri için, Size sunucuya gönderilen veri miktarını ilk yüz karakterle sınırlamak için kullanılabilir.

Açıkça ayarlanmadıysa, boyut belirtilen parametre değerinin gerçek boyutundan çıkarılır.

Parametre değerinin kesirli kısmı boyuttan büyükse, değer boyutla eşleşecek şekilde kesilir.

Sabit uzunluklu veri türleri için değeri Size yoksayılır. Bilgilendirme amacıyla alınabilir ve sağlayıcının parametrenin değerini sunucuya aktarırken kullandığı maksimum bayt miktarını döndürür.

Akış hakkında bilgi için bkz . SqlClient Akış Desteği.