DbParameter.Size プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
列内のデータの最大サイズ (バイト単位) を取得または設定します。
public:
abstract property int Size { int get(); void set(int value); };public abstract int Size { get; set; }member this.Size : int with get, setPublic MustOverride Property Size As Integerプロパティ値
列内のデータの最大サイズ (バイト単位)。 既定値はパラメーター値から推論されます。
実装
注釈
Size プロパティは、バイナリ型と文字列型に使用されます。
文字列以外のデータ型と ANSI 文字列データの場合、 Size プロパティはバイト数を参照します。 Unicode 文字列データの場合、 Size は文字数を参照します。 文字列の数には、終了文字は含まれません。
可変長データ型の場合、 Size はサーバーに送信するデータの最大量を記述します。 たとえば、Unicode 文字列値の場合、 Size 使用して、サーバーに送信されるデータの量を最初の 100 文字に制限できます。
双方向パラメーターと出力パラメーターと戻り値の場合は、 Sizeの値を設定する必要があります。 これは入力パラメーターには必要ありません。明示的に設定しない場合は、パラメーター化されたステートメントの実行時に、指定されたパラメーターの実際のサイズから値が推論されます。
パラメーターの DbType プロパティと Size プロパティは、 Value設定することで推論できます。 そのため、指定する必要はありません。 ただし、 DbParameter プロパティ設定では公開されません。 たとえば、パラメーターのサイズが推論された場合、 Size にはステートメントの実行後に推論された値は含まれません。
固定長データ型の場合、 Size の値は無視されます。 これは情報を得るために取得でき、パラメーターの値をサーバーに送信するときにプロバイダーが使用する最大バイト数を返します。
DbParameterに指定された値のサイズが指定したSizeを超えた場合、DbParameterのValueには指定した値が含まれます。この値は、DbParameterのサイズに切り捨てられます。
DbType.String 型のパラメーターの場合、Sizeの値は Unicode 文字の長さです。
DbType.Xml 型のパラメーターの場合、Sizeは無視されます。
