OracleLob.CopyTo メソッド

定義

名前空間:: System.Data.OracleClient

アセンブリ:: System.Data.OracleClient.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

この 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。

返品

Int64

コピーされたバイト数。これにより、埋め込まれたバイトは除外されます。

例外

ArgumentNullException

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

InvalidOperationException

操作がトランザクション内にありません。 OracleLob オブジェクトが null であるか、接続が閉じられています。

OracleException

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

注釈

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

宛先オフセットが宛先 LOBの終わりを超える場合、データのコピー先となる LOB が拡張されます。 LOBの終わりと末尾を超える宛先オフセットの間のスペースは、BLOBデータ型の場合はゼロ、CLOBおよびNCLOBデータ型の場合はスペースが埋め込まれます。

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

Note

このリリースでは、読み取り専用 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のデータ型の場合、これは偶数バイトである必要があります。

返品

Int64

コピーされたバイト数。これにより、埋め込まれたバイトは除外されます。

例外

ArgumentNullException

OracleLob パラメーターで指定されたdestinationがいっぱいです。

ArgumentOutOfRangeException

destinationOffset パラメーターで指定された値が 0 未満か、4 ギガバイトを超える値です。

-又は-

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

-又は-

CLOBデータ型とNCLOBデータ型を偶数バイトとして指定する必要があります。

InvalidOperationException

操作がトランザクション内にありません。 OracleLob オブジェクトが null であるか、接続が閉じられています。

OracleException

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

注釈

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

宛先オフセットが宛先 LOBの終わりを超える場合、データのコピー先となる LOB が拡張されます。 LOBの終わりと末尾を超える宛先オフセットの間のスペースには、BLOBデータ型の場合はゼロ、CLOBおよびNCLOBデータ型の場合はスペースが埋め込まれます。

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

Note

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のデータ型の場合、これは偶数である必要があります。

返品

Int64

コピーされたバイト数。これにより、埋め込まれたバイトは除外されます。

例外

ArgumentNullException

OracleLob パラメーターで指定されたdestinationがいっぱいです。

ArgumentOutOfRangeException

amount、sourceOffset、または destinationOffset パラメーターで指定された値が、0 未満または 4 ギガバイトを超える値です。

-又は-

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

InvalidOperationException

操作がトランザクション内にありません。 OracleLob オブジェクトが null であるか、接続が閉じられています。

OracleException

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

注釈

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

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

Note

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

適用対象

フィードバック

このページはお役に立ちましたか?