DbParameter.Size 屬性

定義

命名空間:

System.Data.Common

組件:

System.Data.Common.dll

來源:

DbParameter.cs

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

public:
 abstract property int Size { int get(); void set(int value); };

public abstract int Size { get; set; }

member this.Size : int with get, set

Public MustOverride Property Size As Integer

屬性值

Int32

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

實作

Size

備註

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

對於非字串數據類型和 ANSI 字串數據， Size 屬性會參考位元元數目。 若為 Unicode 字串數據， Size 則是指字元數。 字串的計數不包含終止字元。

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

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

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

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

如果提供給 DbParameter 的值大小超過指定的 Size，的 ValueDbParameter 將包含指定值，截斷為的大小 DbParameter。

對於 類型DbTypeString為 的參數，的Size值為 Unicode 字元的長度。 對於類型 DbType為 .Xml的參數， Size 會忽略 。

另請參閱

• ADO.NET 概觀 \(部分機器翻譯\)