OdbcParameter.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; }public int Size { get; set; }member this.Size : int with get, setPublic Overrides Property Size As IntegerPublic Property Size As Integerプロパティ値
列内のデータの最大サイズ。 既定値はパラメーター値から推論されます。
実装
例
次の例では、 OdbcParameter を作成し、そのプロパティの一部を設定します。
Public Sub CreateOdbcParameter()
Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"
Dim parameter As New OdbcParameter("Description", OdbcType.VarChar)
parameter.Direction = ParameterDirection.Output
parameter.Size = myValue.Length
parameter.Value = myValue
End Sub
public void CreateOdbcParameter()
{
string myValue = "12 foot scarf - multiple colors, one previous owner";
OdbcParameter parameter = new OdbcParameter("Description", OdbcType.VarChar);
parameter.Direction = ParameterDirection.Output;
parameter.Size = myValue.Length;
parameter.Value = myValue;
}
注釈
Size プロパティは、バイナリ型と文字列型に使用されます。
文字列以外のデータ型と ANSI 文字列データの場合、 Size プロパティはバイト数を参照します。 Unicode 文字列データの場合、 Size は文字数を参照します。 文字列の数には、終了文字は含まれません。
可変長データ型の場合、 Size はサーバーに送信するデータの最大量を記述します。 たとえば、Unicode 文字列値の場合、 Size 使用して、サーバーに送信されるデータの量を最初の 100 文字に制限できます。
双方向パラメーターと出力パラメーターと戻り値の場合は、 Sizeの値を設定する必要があります。 これは入力パラメーターには必要ありません。明示的に設定しない場合は、パラメーター化されたステートメントの実行時に、指定されたパラメーターの実際のサイズから値が推論されます。
パラメーターの DbType、 OdbcType、および Size プロパティは、 Value設定することで推論できます。 そのため、指定する必要はありません。 ただし、 OdbcParameter プロパティ設定では公開されません。 たとえば、パラメーターのサイズが推論された場合、 Size にはステートメントの実行後に推論された値は含まれません。
注
ParameterDirection.Output、ParameterDirection.InputOutput、またはParameterDirection.ReturnValueのDirectionを持つOdbcParameterの場合、データ ソースによって返される値のサイズがOdbcParameterの指定したSizeを超えた場合、コマンドが実行されると例外がスローされます。
固定長データ型の場合、 Size の値は無視されます。 これは情報を得るために取得でき、パラメーターの値をサーバーに送信するときにプロバイダーが使用する最大バイト数を返します。
