共用方式為

SqlParameter.Size 屬性

定義

命名空間:
System.Data.SqlClient
組件:
System.Data.SqlClient.dll
組件:
System.Data.dll
來源:
System.Data.SqlClient.notsupported.cs

取得或設定欄位內資料的最大大小（以位元組為單位）。

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, set
Public Overrides Property Size As Integer
Public Property Size As Integer

屬性值

Int32

欄位內資料的最大大小（以位元組為單位）。 預設值是從參數值推斷而來。

實作

Size
屬性
DataSysDescriptionAttribute

範例

以下範例會建立 並 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 串流支援。

適用於

另請參閱