DbParameter.Size プロパティ

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

public abstract int Size { get; set; }

member this.Size : int with get, set

Public MustOverride Property Size As Integer

プロパティ値

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

実装

注釈

プロパティは Size 、バイナリ型と文字列型に使用されます。

文字列以外のデータ型と ANSI 文字列データの Size 場合、 プロパティはバイト数を参照します。 Unicode 文字列データの場合、 Size は文字数を参照します。 文字列のカウントに終端文字は含まれません。

可変長データ型の場合は、 Size サーバーに送信するデータの最大量を記述します。 たとえば、Unicode 文字列値の場合は、 を使用して、 Size サーバーに送信されるデータの量を最初の 100 文字に制限できます。

双方向パラメーターと出力パラメーターと戻り値の場合は、 の Size値を設定する必要があります。 これは入力パラメーターには必要ありません。明示的に設定されていない場合、パラメーター化されたステートメントの実行時に、指定したパラメーターの実際のサイズから値が推論されます。

DbTypeパラメーターの プロパティと Size プロパティは、 を設定Valueすることで推論できます。 そのため、指定する必要はありません。 ただし、プロパティ設定では DbParameter 公開されません。 たとえば、 パラメーターのサイズが推論された場合、 Size ステートメントの実行後に推論された値は含まれません。

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

に指定された値のサイズが指定した DbParameterSizeを超える場合、 の DbParameter にはValue指定した値が格納され、 の DbParameterSize に切り捨てられます。

型DbTypeStringのパラメーターの場合、 のSize値は Unicode 文字の長さです。 型DbTypeXmlのパラメーターの場合、 Size は無視されます。

適用対象

こちらもご覧ください

• ADO.NET の概要