OracleLob.SetLength メソッドとは何？わかりやすく解説 Weblio辞書

索引トップ用語の索引ランキング

OracleLob.SetLength メソッド

OracleLob ストリームの長さを、現在の長さより短い値に設定します。

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

Public Overrides Sub SetLength
 ( _
    value As Long _
)

Dim instance As OracleLob
Dim value As Long

instance.SetLength(value)

public override void SetLength (
    long value
)

public:
virtual void SetLength (
    long long value
) override

public void SetLength (
    long value
)

public override function SetLength (
    value : long
)

value: 現在の OracleLob ストリームの希望の長さ (バイト数)。CLOB 型および NCLOB 型の場合、これは偶数である必要があります。

例外の種類	条件
ArgumentOutOfRangeException	value パラメータで CLOB または NCLOB データ型に指定した値が偶数ではありません。または value で指定したパラメータの値が 0 未満であるか、4 GB を超えています。
InvalidOperationException	操作がトランザクション内で実行されていないか、OracleLob オブジェクトが null か、または接続が閉じられています。
ObjectDisposedException	オブジェクトが閉じられているか、破棄されています。
OracleException	Oracle エラーが発生しました。

OracleLob ストリームの長さを増やそうとすると失敗し、Oracle サーバーから "Message: ORA-22926: 指定された切り捨ての長さが現行の LOB 値の長さを超えています。" が返されます。

SetLength が機能するためには、ストリームが書き込みとシークの両方をサポートしていることが必要です。

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

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