Size
このプロパティは、データベースに送信する、またはデータベースから送信されるデータの最大サイズを、バイト数または文字数で指定します。
宣言
// C# public override int Size { get; set;}
プロパティ値
int
例外
ArgumentOutOfRangeException
- 指定したSize
値が無効です。
InvalidOperationException
- OracleParameter
オブジェクトがPL/SQL連想配列のバインドに使用される場合は、Size
= 0になります。
備考
Size
が明示的に設定されていない場合は、入力パラメータに対するバインド時にのみ、指定されたパラメータ値の実際のサイズから推測されます。出力パラメータは、サイズが明示的に定義されている必要があります。
デフォルト値は0
です。
実行前は、このプロパティは、Value
プロパティでバインドされる最大サイズを指定します。実行後は、Value
プロパティの型のサイズを格納します。
Size
は、次の型のパラメータに使用されます。
-
OracleDbType.Blob
-
OracleDbType.Char
-
OracleDbType.Clob
-
OracleDbType.LongRaw
-
OracleDbType.NChar
-
OracleDbType.NClob
-
OracleDbType.NVarchar2
-
OracleDbType.Raw
-
OracleDbType.Varchar2
前述の型については、データベースとの間で転送されるデータの最大量をSize
プロパティで説明しています。文字データの場合、Size
は文字数、バイナリ・データの場合は、バイト数になります。
固定長データ型の場合、Size
の値は無視されます。
Size
が明示的に設定されていない場合は、バインド時に指定されたパラメータ値の実際のサイズから推測されます。
ノート:
Size
には、文字列データのNULLで終了する文字は含まれません。
OracleParameter
オブジェクトがPL/SQL連想配列のバインドに使用される場合、Size
は、PL/SQL連想配列内の要素の最大数を指定します。実行前は、このプロパティは、PL/SQL連想配列内の要素の最大数を指定します。実行後は、PL/SQL連想配列内で返された要素の現行の数を指定します。Output
およびInputOutput
パラメータと戻り値の場合、Size
は、PL/SQL連想配列内の要素の最大数を指定します。
ODP.NETでは、空のPL/SQL連想配列のバインドはサポートされていません。したがって、OracleParameter
オブジェクトがPL/SQL連想配列のバインドに使用される場合、Size
を0
に設定することはできません。