OracleLob.SetLength メソッド

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

OracleLob.SetLength メソッド

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

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

Visual Basic (宣言)

Public Overrides Sub SetLength
 ( _
    value As Long _
)

Visual Basic (使用法)

Dim instance As OracleLob
Dim value As Long

instance.SetLength(value)

C#

public override void SetLength (
    long value
)

C++

public:
virtual void SetLength (
    long long value
) override

J#

public void SetLength (
    long value
)

JScript

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

.NET Framework Oracle 用データ プロバイダは、すべての CLOB データおよび NCLOB データを Unicode として処理します。したがって、CLOB 型および NCLOB 型では 1 文字が 2 バイトとなるため、これらにアクセスするときは常に複数のバイトを扱うことになります。たとえば、3 文字から成る文字列が、1 文字が 4 バイトの文字セットを使用している Oracle サーバーに NCLOB として保存されていて、SetLength 操作を実行する場合、文字列はサーバーに 12 バイトとして格納されていますが、文字列の長さは 6 バイトを指定します。

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

メモ
読み取り専用の 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 名前空間