次の方法で共有

OracleLob.CopyTo メソッド (Int64, OracleLob, Int64, Int64)

メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。

データ サイズとコピー先のオフセットを指定して、この OracleLob からコピー先の OracleLob にコピーします。

Overloads Public Function CopyTo( _
   ByVal sourceOffset As Long, _   ByVal destination As OracleLob, _   ByVal destinationOffset As Long, _   ByVal amount As Long _) As Long
[C#]
public long CopyTo(longsourceOffset,OracleLobdestination,longdestinationOffset,longamount);
[C++]
public: __int64 CopyTo(__int64sourceOffset,OracleLob* destination,__int64destinationOffset,__int64amount);
[JScript]
public function CopyTo(
   sourceOffset : long,destination : OracleLob,destinationOffset : long,amount : long) : long;

パラメータ

  • sourceOffset
    コピー元のオフセット。 CLOB 型および NCLOB 型の場合、これは偶数である必要があります。
  • destination
    コピー先の System.Data.OracleClient の OracleLob 。
  • destinationOffset
    コピー先のオフセット。 CLOB 型および NCLOB 型の場合、これは偶数である必要があります。
  • amount
    コピーするデータのサイズ (バイト単位)。 CLOB 型および NCLOB 型の場合、これは偶数である必要があります。

戻り値

コピーされたバイト数これはすべての埋め込みバイトを除外します。

例外

例外の種類 条件
ArgumentNullException destination パラメータで指定されている OracleLob が null です。
ArgumentOutOfRangeException amount 、 sourceOffset 、または destinationOffset パラメータで指定したパラメータの値が 0 未満であるか、4 GB を超えています。

または

amount 、 sourceOffset 、または destinationOffset パラメータで CLOB または NCLOB データ型に指定した値が偶数ではありません。
InvalidOperationException LOB に書き込むには、トランザクション内でこの操作を実行する必要があります。

または

OracleLob オブジェクトが null です。

または

接続が閉じています。
OracleException Oracle エラーが発生しました。

解説

基になるデータ型は常に同じである必要があります。たとえば、 NClob からコピーする場合、コピー先の OracleLob も NClob である必要があります。

コピー先のオフセットがコピー先の LOB の末尾を超える場合、データのコピー先となる LOB は拡張されます。 LOB の末尾からコピー先のオフセットまでは、 BLOB の場合は 0 で埋められ、 CLOB 型および NCLOB 型の場合は空白で埋められます。

メモ   このリリースでは、読み取り専用の LOB に対する書き込み操作が成功する可能性がありますが、サーバー上の LOB は更新されません。ただし、この場合、 LOB のローカル コピーは更新されます。したがって、 OracleLob オブジェクトに対するその後の読み取り操作では、書き込み操作の結果が返される可能性があります。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

OracleLob クラス | OracleLob メンバ | System.Data.OracleClient 名前空間 | OracleLob.CopyTo オーバーロードの一覧