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, set
Public Overrides Property Size As Integer
Public 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 サーバーに送信されるデータの量を最初の 100 文字に制限するために使用できます。
明示的に設定されていない場合、サイズは、指定されたパラメーター値の実際のサイズから推測されます。
パラメーター値の小数部がサイズより大きい場合は、サイズと一致するように値が切り捨てられます。
固定長データ型の場合、値 Size は無視されます。 情報を得るために取得でき、パラメーターの値をサーバーに送信するときにプロバイダーが使用する最大バイト数を返します。
ストリーミングの詳細については、「 SqlClient Streaming Support」を参照してください。