Aracılığıyla paylaş

SqlParameter.Size Özellik

Tanım

Ad Alanı:
System.Data.SqlClient
Bütünleştirilmiş Kod:
System.Data.SqlClient.dll
Bütünleştirilmiş Kod:
System.Data.dll
Kaynak:
System.Data.SqlClient.notsupported.cs

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:
 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

Özellik Değeri

Int32

Sütundaki verilerin bayt cinsinden en büyük boyutu. Varsayılan değer parametre değerinden çıkarılır.

Uygulamalar

Size
Öznitelikler
DataSysDescriptionAttribute

Örnekler

Aşağıdaki örnek, bir SqlParameter oluşturur ve özelliklerinden bazılarını ayarlar.

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

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 Unicode Size karakterlerinin uzunluğu anlamına gelir. türünde SqlType.XmlSize 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 sunucuya Size gönderilen veri miktarını ilk yüz karakterle sınırlamak için kullanılabilir.

Açıkça ayarlanmazsa, 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. Bilgilendirici amaçlarla 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.

Şunlara uygulanır

Ayrıca bkz.