SqlParameter.Size 屬性

  • 參考

定義

命名空間:
System.Data.SqlClient
組件:
System.Data.SqlClient.dll
組件:
System.Data.dll
套件:
System.Data.SqlClient v4.8.6

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

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 串流支援。

適用於

另請參閱