プライマリ・コンテンツに移動

Oracle® Data Provider for .NET開発者ガイド ODAC 12.2c リリース1 (12.2.0.1) for Microsoft Windows E88311-03 |
| 目次 | 索引

前 | 次 |

# Size

このプロパティは、データベースに送信する、またはデータベースから送信されるデータの最大サイズを、バイト数または文字数で指定します。

宣言

    // C#
    public override int Size { get; set;}

プロパティ値

`int`

例外

`ArgumentOutOfRangeException` - 指定した`Size`値が無効です。

`InvalidOperationException` - `OracleParameter`オブジェクトがPL/SQL連想配列のバインドに使用される場合は、`Size` = 0になります。

備考

PL/SQL連想配列バインドの場合、`Size`は、PL/SQL連想配列内の要素の最大数を指定します。

`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`には、文字列データの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`に設定することはできません。

関連項目:

- Oracle.DataAccess.ClientおよびOracle.ManagedDataAccess.Clientのネームスペース

- OracleParameterクラス

- OracleParameterメンバー

- OracleDbTypeの列挙

- CollectionType

- ArrayBindSize

- ArrayBindStatus

- Value