OleDbParameter.Size 屬性

定義

命名空間:

System.Data.OleDb

組件:

System.Data.OleDb.dll

套件:

System.Data.OleDb v8.0.0

來源:

DbParameterHelper.cs

取得或設定資料行中資料的最大大小 (以位元組為單位)。

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

屬性值

Int32

資料行中資料的最大大小 (以位元組為單位)。 預設值是由參數值推斷。

實作

Size

範例

下列範例會建立 並 OleDbParameter 設定其部分屬性。

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;  
 }  

備註

屬性 Size 用於二進位和字串類型。

針對非字串數據類型和 ANSI 字串資料， Size 屬性會參考位元元組數目。 若為 Unicode 字串數據， Size 請參閱字元數。 字串的計數不包含終止字元。

針對可變長度數據類型， Size 描述要傳輸至伺服器的最大數據量。 例如，針對 Unicode 字串值， Size 可用來將傳送至伺服器的數據量限製為前 100 個字元。

針對雙向和輸出參數，以及傳回值，您必須設定的值 Size。 這並非輸入參數的必要專案，如果未明確設定，則會在執行參數化語句時，從指定參數的實際大小推斷 的值。

DbType您可以藉由設定 Value來推斷參數的、 OleDbType和 Size 屬性。 因此，您不需要指定它們。 不過，它們不會在屬性設定中 OleDbParameter 公開。 例如，如果已推斷參數的大小， Size 則不會在語句執行之後包含推斷的值。

若為固定長度數據類型，則會忽略的值 Size 。 它可以擷取以供參考之用，並傳回提供者在將 參數值傳送至伺服器時所使用的位元組數量上限。

如果 提供給 OleDbParameter 的值大小超過指定的 Size， Value 則的 OleDbParameter 包含指定值，並截斷為的大小 OleDbParameter。

另請參閱

• 使用命令