OracleLob.Append メソッド

.NET Framework クラス ライブラリ リファレンス

OracleLob.Append メソッド

指定した LOB のデータを現在の LOB に追加します。

名前空間: System.Data.OracleClient
アセンブリ: System.Data.OracleClient (system.data.oracleclient.dll 内)
構文

Visual Basic (宣言)

Public Sub Append ( _
    source As OracleLob _
)

Visual Basic (使用法)

Dim instance As OracleLob
Dim source As OracleLob

instance.Append(source)

C#

public void Append (
    OracleLob source
)

C++

public:
void Append (
    OracleLob^ source
)

J#

public void Append (
    OracleLob source
)

JScript

public function Append (
    source : OracleLob
)

パラメータ

source

データの追加元の LOB。

例外

例外の種類	条件
ArgumentNullException	ソースの OracleLob が null です。
InvalidOperationException	ソースの OracleLob が null か、接続が閉じられています。
ObjectDisposedException	ソースの OracleLob オブジェクトが閉じているか破棄されています。
OracleException	Oracle エラーが発生しました。

解説

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

ソースのすべての LOB のデータは、現在の LOB の末尾に追加されます。この処理によって、どの LOB の位置も評価されず、変更もされません。

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

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OracleLob クラス
OracleLob メンバ
System.Data.OracleClient 名前空間