SqlParameter.Size 屬性

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

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

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

public override int Size { get; set; }

member this.Size : int with get, set

Public Overrides Property Size As Integer

屬性值

Int32

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

實作

Size

範例

下列範例會建立 並 SqlParameter 設定其部分屬性。

// using Microsoft.Data.SqlClient;
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;
}

備註

傳回值不會受到這個屬性的影響;從預存程式傳回參數一律是固定大小的整數。

對於具有可變長度類型的輸出參數 (Nvarchar，例如) ，參數的大小會定義保留輸出參數的緩衝區大小。 輸出參數可以截斷為使用 Size 指定的大小。 針對字元類型，使用 Size 指定的大小是以字元為單位。

屬性 Size 用於二進位和字串類型。 針對 類型的 SqlType.String 參數， Size 表示 Unicode 字元的長度。 若為 類型的 SqlType.Xml 參數， Size 則會忽略 。

針對非字串資料類型和 ANSI 字串資料， Size 屬性會參考位元組數目。 若為 Unicode 字串資料， Size 請參閱字元數。 字串的計數不包含終止字元。

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

如果未明確設定，則會從指定參數值的實際大小推斷大小。

如果參數值的分數部分大於大小，則會截斷該值以符合大小。

針對固定長度資料類型，會忽略 的值 Size 。 它可以擷取以供參考之用，並傳回提供者在將 參數值傳送至伺服器時所使用的位元組數量上限。

如需串流的詳細資訊，請參閱 SqlClient 串流支援。