SqlParameter.Size 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定資料行中資料的最大大小 (以位元組為單位)。
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, setPublic Overrides Property Size As IntegerPublic Property Size As Integer屬性值
資料行中資料的最大大小 (以位元組為單位)。 預設值是由參數值推斷。
實作
- 屬性
範例
下列範例會建立 ， SqlParameter 並設定其部分屬性。
static void CreateSqlParameterSize()
{
string description = "12 foot scarf - multiple colors, one previous owner";
SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar);
parameter.Direction = ParameterDirection.InputOutput;
parameter.Size = description.Length;
parameter.Value = description;
}
Private Sub CreateSqlParameterSize()
Dim description As String = "12 foot scarf - multiple colors, one previous owner"
Dim parameter As New SqlParameter("Description", SqlDbType.VarChar)
parameter.Direction = ParameterDirection.InputOutput
parameter.Size = description.Length
parameter.Value = description
End Sub
備註
傳回值不受此屬性影響;預存程式的傳回參數一律是固定大小的整數。
對於具有可變長度類型的輸出參數 (nvarchar，例如) ，參數的大小會定義保留輸出參數的緩衝區大小。 輸出參數可以截斷為使用 Size指定的大小。 針對字元類型，使用 Size 指定的大小是以字元為單位。
屬性 Size 用於二進位和字串類型。 針對 類型的 SqlType.String參數， Size 表示 Unicode 字元的長度。 若為 類型的 SqlType.Xml參數， Size 則會忽略 。
對於非字串數據類型和 ANSI 字串數據， Size 屬性會參考位元元數目。 若為 Unicode 字串數據， Size 則是指字元數。 字串的計數不包含終止字元。
針對可變長度數據類型， Size 描述要傳輸至伺服器的最大數據量。 例如，針對 Unicode 字串值， Size 可用來將傳送至伺服器的數據量限制為前一百個字元。
如果未明確設定，則會從指定參數值的實際大小推斷大小。
如果參數值的分數部分大於大小，則會截斷該值以符合大小。
若為固定長度數據類型，則會忽略的值 Size 。 它可以擷取以供參考之用，並傳回提供者在將參數值傳輸至伺服器時所使用的最大位元元組數量。
如需串流的相關信息，請參閱 SqlClient 串流支援。
