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

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

前 | 次 |

# GetChars

このメソッドは、列の指定されたオフセット(文字表示)から、最高の場合最大文字数を使用して、指定された文字配列を作成します。

宣言

    // C#
    public override long GetChars(int index, long fieldOffset, char[] buffer,
        int bufferOffset, int length);

パラメータ

- `index`

  ゼロベースの列索引

- `fieldOffset`

  読取り開始対象の列内の索引(文字)

- `buffer`

  データの読取り先の文字配列

- `bufferOffset`

  データ読取り開始対象の、バッファ内の索引(文字)

- `length`

  読取りを行う最大文字数(文字)

戻り値

読取りが終了した文字数

実装

`IDataRecord`

例外

`InvalidOperationException` - 接続またはリーダーがクローズされているか、`Read()`が呼び出されていないか、すべての行が読み取られています。

`IndexOutOfRangeException` - 列索引が無効です。

`InvalidCastException` - この列型のアクセッサ・メソッドが無効か、列値が`NULL`です。

備考

このメソッドは、バッファに読み取られた文字数を戻します。メソッドが同じ列に対して前に呼び出されている場合は、文字数は実際のフィールド長より短くなる場合があります。

NULL参照がバッファに渡された場合、文字表示のフィールド長が戻されます。

このメソッドを呼び出す前に`IsDBNull`を呼び出して、`NULL`値を確認してください。

関連項目:

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

- OracleDataReaderクラス

- OracleDataReaderメンバー