OleDbParameter.Size 屬性

定義

命名空間:

System.Data.OleDb

組件:

System.Data.OleDb.dll

套件:

System.Data.OleDb v11.0.0-preview.2.26159.112

來源:

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參數的 、 OleDbType以及 Size 性質可以透過設定 Value來推斷。 因此，你不必特別指定。 然而，它們並不會暴露在 OleDbParameter 物業環境中。 例如，如果參數的大小已被推斷 Size ，則在敘述執行後不包含推斷的值。

對於固定長度的資料型別，忽略了 的 Size 值。 可為資訊目的檢索，並回傳提供者在傳送參數值給伺服器時所使用的最大位元組數。

若給出的值 OleDbParameter 大小超過指定 Size值， Value 則 的 OleDbParameter 包含指定值，截斷為 的大小 OleDbParameter。

另請參閱

• 與指令合作