OracleLob.CopyTo メソッド

定義

名前空間:

System.Data.OracleClient

アセンブリ:

System.Data.OracleClient.dll

この OracleLob のデータをコピー先の OracleLob にコピーします。

オーバーロード

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

CopyTo(OracleLob)

この OracleLob のデータをコピー先の OracleLob にコピーします。

public:
 long CopyTo(System::Data::OracleClient::OracleLob ^ destination);

public long CopyTo (System.Data.OracleClient.OracleLob destination);

override this.CopyTo : System.Data.OracleClient.OracleLob -> int64

Public Function CopyTo (destination As OracleLob) As Long

パラメーター

destination

OracleLob

コピー先の OracleLob。

戻り値

Int64

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

例外

ArgumentNullException

destination パラメーターで指定されている OracleLob が null です。

InvalidOperationException

操作がトランザクション内で実行されていないか、OracleLob オブジェクトが null か、または接続が閉じられています。

OracleException

Oracle エラーが発生しました。

注釈

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

変換先オフセットが変換先 LOBの末尾を超えている場合は、 LOB データのコピー先となる が拡張されます。 末尾と末尾を超える宛先オフセットの間のLOBスペースには、データ型の場合は 0BLOB、および データ型の場合はスペースが埋CLOBNCLOBめ込まれます。

を に LOB書き込むには、SQL SELECT ステートメントで FOR UPDATE 句を使用して を取得 LOB し、ローカル トランザクションを開始する必要があります。

注意

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

メソッドは CopyTo 、コピー操作を実行する前に、コピー先 OracleLob の内容をクリアしません。

CopyTo(OracleLob, Int64)

この OracleLob のデータを、コピーするデータ サイズを指定して、コピー先の OracleLob にコピーします。

public:
 long CopyTo(System::Data::OracleClient::OracleLob ^ destination, long destinationOffset);

public long CopyTo (System.Data.OracleClient.OracleLob destination, long destinationOffset);

override this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64

Public Function CopyTo (destination As OracleLob, destinationOffset As Long) As Long

パラメーター

destination

OracleLob

コピー先の OracleLob。

destinationOffset

Int64

コピー先のオフセット。 CLOB データ型および NCLOB データ型の場合、これは偶数のバイト数である必要があります。

戻り値

Int64

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

例外

ArgumentNullException

destination パラメーターで指定されている OracleLob が null です。

ArgumentOutOfRangeException

destinationOffset で指定したパラメーターの値が 0 未満であるか、4 GB を超えています。

- または -

destinationOffset パラメーターで CLOB または NCLOB データ型に指定した値が偶数ではありません。

- または -

CLOB および NCLOB データ型には、偶数のバイト数を指定する必要があります。

InvalidOperationException

操作がトランザクション内で実行されていないか、OracleLob オブジェクトが null か、または接続が閉じられています。

OracleException

Oracle エラーが発生しました。

注釈

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

変換先オフセットが変換先 LOBの末尾を超えている場合は、 LOB データのコピー先となる が拡張されます。 末尾と末尾を超える宛先オフセットの間のLOBスペースには、データ型の場合は 0BLOB、および データ型の場合はスペースが埋CLOBNCLOBめ込まれます。

を に LOB書き込むには、SQL SELECT ステートメントで FOR UPDATE 句を使用して を取得 LOB し、ローカル トランザクションを開始する必要があります。

注意

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

メソッドは CopyTo 、コピー操作を実行する前に、コピー先 OracleLob の内容をクリアしません。

CopyTo(Int64, OracleLob, Int64, Int64)

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

public:
 long CopyTo(long sourceOffset, System::Data::OracleClient::OracleLob ^ destination, long destinationOffset, long amount);

public long CopyTo (long sourceOffset, System.Data.OracleClient.OracleLob destination, long destinationOffset, long amount);

override this.CopyTo : int64 * System.Data.OracleClient.OracleLob * int64 * int64 -> int64

Public Function CopyTo (sourceOffset As Long, destination As OracleLob, destinationOffset As Long, amount As Long) As Long

パラメーター

sourceOffset

Int64

コピー元のオフセット。 CLOB 型および NCLOB 型の場合、これは偶数である必要があります。

destination

OracleLob

コピー先 OracleLobSystem.Data.OracleClient。

destinationOffset

Int64

コピー先のオフセット。 CLOB 型および NCLOB 型の場合、これは偶数である必要があります。

amount

Int64

コピーするデータのサイズ (バイト単位)。 CLOB 型および NCLOB 型の場合、これは偶数である必要があります。

戻り値

Int64

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

例外

ArgumentNullException

destination パラメーターで指定されている OracleLob が null です。

ArgumentOutOfRangeException

amount、sourceOffset、または destinationOffset パラメーターで指定したパラメーターの値が 0 未満であるか、4 GB を超えています。

- または -

amount、sourceOffset、または destinationOffset パラメーターで CLOB または NCLOB データ型に指定した値が偶数ではありません。

InvalidOperationException

操作がトランザクション内で実行されていないか、OracleLob オブジェクトが null か、または接続が閉じられています。

OracleException

Oracle エラーが発生しました。

注釈

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

変換先オフセットが変換先 LOBの末尾を超えている場合は、 LOB データのコピー先となる が拡張されます。 末尾と末尾を超える宛先オフセットの間のLOBスペースには、データ型の場合は 0BLOB、および データ型の場合はスペースが埋CLOBNCLOBめ込まれます。

を に LOB書き込むには、SQL SELECT ステートメントで FOR UPDATE 句を使用して を取得 LOB し、ローカル トランザクションを開始する必要があります。

注意

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

メソッドは CopyTo 、コピー操作を実行する前に、コピー先 OracleLob の内容をクリアしません。