次の方法で共有


OracleLob.CopyTo メソッド

定義

この 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);
member this.CopyTo : System.Data.OracleClient.OracleLob -> int64
override this.CopyTo : System.Data.OracleClient.OracleLob -> int64
Public Function CopyTo (destination As OracleLob) As Long

パラメーター

destination
OracleLob

コピー先の OracleLob

戻り値

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

例外

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

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

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);
member this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64
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 データ型の場合、これは偶数のバイト数である必要があります。

戻り値

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

例外

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

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

- または -

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

- または -

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

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

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);
member this.CopyTo : int64 * System.Data.OracleClient.OracleLob * int64 * int64 -> int64
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 型の場合、これは偶数である必要があります。

戻り値

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

例外

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

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

- または -

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

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

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

注釈

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

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

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

注意

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

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

適用対象