OleDbParameter.Size Özellik

Tanım

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

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

Uygulamalar

Öznitelikler

Örnekler

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

Public Sub CreateOleDbParameter()  
    Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"  
    Dim parameter As New OleDbParameter("Description", OleDbType.VarChar)  
    parameter.Direction = ParameterDirection.Output  
    parameter.Size = myValue.Length  
    parameter.Value = myValue  
End Sub 'CreateOleDbParameter  
public void CreateOleDbParameter()   
 {  
    string myValue = "12 foot scarf - multiple colors, one previous owner";  
    OleDbParameter parameter = new OleDbParameter("Description", OleDbType.VarChar);  
    parameter.Direction = ParameterDirection.Output;  
    parameter.Size = myValue.Length;  
    parameter.Value = myValue;  
 }  

Açıklamalar

Size özelliği ikili ve dize türleri için kullanı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 100 karakterle sınırlamak için kullanılabilir.

Çift yönlü ve çıkış parametreleri ve dönüş değerleri için değerini Sizeayarlamanız gerekir. Bu, giriş parametreleri için gerekli değildir ve açıkça ayarlanmazsa, parametresiz bir deyim yürütürken değeri belirtilen parametrenin gerçek boyutundan çıkarılır.

Parametresinin DbType, OleDbTypeve Size özellikleri ayarıyla Valueçıkarılabilir. Bu nedenle, bunları belirtmeniz gerekmez. Ancak, özellik ayarlarında gösterilmez OleDbParameter . Örneğin, parametrenin boyutu çıkarsandıysa, Size deyim yürütmeden sonra çıkarsanan değeri içermez.

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.

için OleDbParameter sağlanan değerin boyutu belirtilen Sizedeğerini aşarsa, Value öğesinin OleDbParameter değeri belirtilen değeri içerir ve boyutuna yuvarlanır OleDbParameter.

Şunlara uygulanır

Ayrıca bkz.