SqlParameter.Size プロパティ

定義

列内のデータの最大サイズ (バイト) を取得または設定します。

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

列内のデータの最大サイズ (バイト) です。 既定値はパラメーター値から推論されます。

実装

属性

次の例では、プロパティの一部を 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 サーバーに送信されるデータの量を最初の 100 文字に制限するために使用できます。

明示的に設定されていない場合、サイズは、指定されたパラメーター値の実際のサイズから推測されます。

パラメーター値の小数部がサイズより大きい場合は、サイズと一致するように値が切り捨てられます。

固定長データ型の場合、値 Size は無視されます。 情報を得るために取得でき、パラメーターの値をサーバーに送信するときにプロバイダーが使用する最大バイト数を返します。

ストリーミングの詳細については、「 SqlClient Streaming Support」を参照してください。

適用対象

こちらもご覧ください