DbParameter.Size 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定欄位內資料的最大大小(以位元組為單位)。
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
屬性值
欄位內資料的最大大小(以位元組為單位)。 預設值是從參數值推斷而來。
實作
備註
此 Size 性質用於二進位與字串類型。
對於非字串資料型態和 ANSI 字串資料,屬性 Size 指的是位元組數。 對於 Unicode 字串資料,指 Size 的是字元數。 字串的計數不包含終止字元。
對於可變長度資料型別, Size 描述了傳送至伺服器的最大資料量。 例如,Unicode 字串值 Size 可用來限制傳送至伺服器的資料量為前一百個字元。
對於雙向參數和輸出參數,以及回傳值,你必須設定 的 Size值。 輸入參數不需要此設定,若未明確設定,值會根據執行參數化語句時的實際大小推斷。
DbType參數的 和 Size 性質可透過設定 Value推斷 。 因此,你不必特別指定。 然而,它們並不會暴露在 DbParameter 物業環境中。 例如,若參數大小已被推斷 Size ,則在陳述句執行後不包含推斷值。
對於固定長度資料型態,會忽略 的 Size 值。 可為資訊目的檢索,並回傳提供者在傳送參數值給伺服器時所使用的最大位元組數。
若 所提供的 DbParameter 值大小超過指定 Size值 , Value 則 的 DbParameter 將包含指定值,截斷為 的大小 DbParameter。
對於參數 DbType型為 .String,的 Size 值是以 Unicode 字元表示長度。 對於型態 DbType為 的Xml參數, Size 則忽略。