SqlParameter.Size Özellik

Başvuru

Tanım

Ad Alanı:: System.Data.SqlClient

Bütünleştirilmiş Kod:: System.Data.SqlClient.dll

Bütünleştirilmiş Kod:: System.Data.dll

Bütünleştirilmiş Kodlar:: netstandard.dll, System.Data.SqlClient.dll

Paket:: System.Data.SqlClient v4.8.6

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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 boyut üst sınırı. 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, Size Unicode karakterlerinin uzunluğu 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 sunucuya Size iletilecek en fazla 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 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 uzunluktaki 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.

Şunlara uygulanır