This documentation is archived and is not being maintained.

OracleLob.Erase Method ()

Erases all data from this OracleLob.

Namespace: System.Data.OracleClient
Assembly: System.Data.OracleClient (in system.data.oracleclient.dll)

public long Erase ()
public long Erase ()
public function Erase () : long
Not applicable.

Return Value

The number of bytes erased.

Exception typeCondition

InvalidOperationException

The operation is not within a transaction, the OracleLob object is null, or the connection is closed.

ObjectDisposedException

The object was closed or disposed.

OracleException

An Oracle error has occurred.

Erase does not truncate data. The LOB length remains the same for a BLOB data type, and the erased data is replaced by 0x00. CLOB and NCLOB data types are replaced by spaces.

To write to the LOB, you must have retrieved the LOB using the FOR UPDATE clause in the SQL SELECT statement, and you must have a local transaction started.

NoteNote:

In this release, a write operation to a read-only LOB might succeed, but does not update the LOB on the server. In this case, however, the local copy of the LOB is updated. Therefore, later read operations on the OracleLob object might return the results of the write operation.

Windows 98, Windows Server 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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1
Show: