OracleLob.Erase Metoda

Definice

Obor názvů:

System.Data.OracleClient

Sestavení:

System.Data.OracleClient.dll

Vymaže data z tohoto OracleLob.

Přetížení

Erase()	Vymaže všechna data z tohoto souboru OracleLob.
Erase(Int64, Int64)	Vymaže zadané množství dat z tohoto OracleLob.

Erase()

Vymaže všechna data z tohoto souboru OracleLob.

public:
 long Erase();

public long Erase ();

member this.Erase : unit -> int64

Public Function Erase () As Long

Návraty

Int64

Počet vymazaných bajtů.

Výjimky

InvalidOperationException

Operace není v rámci transakce, OracleLob objekt má hodnotu null nebo je připojení uzavřeno.

ObjectDisposedException

Objekt byl uzavřen nebo odstraněn.

OracleException

Došlo k chybě Oracle.

Poznámky

Erase nezkrátí data. Délka LOB datového typu zůstane stejná BLOB a vymazaná data se nahradí 0x00. CLOB a NCLOB datové typy jsou nahrazeny mezerami.

Chcete-li zapisovat do LOBpříkazu , musíte mít načtenou LOB klauzuli pomocí klauzule FOR UPDATE v příkazu SQL SELECT a musíte mít spuštěnou místní transakci.

Poznámka

V této verzi může být operace zápisu jen LOB pro čtení úspěšná, ale neaktualizuje LOB na serveru. V tomto případě se ale místní kopie LOB aktualizuje. Proto pozdější operace čtení u objektu OracleLob můžou vrátit výsledky operace zápisu.

Erase(Int64, Int64)

Vymaže zadané množství dat z tohoto OracleLob.

public:
 long Erase(long offset, long amount);

public long Erase (long offset, long amount);

member this.Erase : int64 * int64 -> int64

Public Function Erase (offset As Long, amount As Long) As Long

Parametry

offset

Int64

Posun, ze kterého se má vymazat. U CLOB datových typů a NCLOB musí jít o sudé číslo.

amount

Int64

Množství dat v bajtech, které se mají vymazat. U CLOB datových typů a NCLOB musí jít o sudé číslo.

Návraty

Int64

Počet vymazaných bajtů.

Výjimky

InvalidOperationException

Operace není v rámci transakce, OracleLob objekt má hodnotu null nebo je připojení uzavřeno.

ObjectDisposedException

Objekt byl uzavřen nebo odstraněn.

OracleException

Došlo k chybě Oracle.

Poznámky

Součet hodnot v parametrech offset a amount může být větší než součet velikosti parametru OracleLob. Proto zadání hodnoty větší, než je hodnota vrácená Length vlastností, bude úspěšné, ale Erase vymaže se pouze na konec objektu OracleLob. (Podobně platí, že pokud je do offsetsouboru předána záporná hodnota, Erase bude úspěšná, ale vymaže se pouze od začátku OracleLob.) Toto chování se liší od chování metod a Write a nabízí výhodu v tom, že Read je možné vymazat všechna data z hodnoty zadané pomocíoffset, aniž by došlo k dalšímu zaokrouhlování na server, aby se ověřila skutečná velikost.

Erase nezkrátí data. Délka LOB datového typu zůstane stejná BLOB a vymazaná data se nahradí 0x00. CLOB a NCLOB datové typy jsou nahrazeny mezerami.

Chcete-li zapisovat do LOBpříkazu , musíte mít načtenou LOB klauzuli pomocí klauzule FOR UPDATE v příkazu SQL SELECT a musíte mít spuštěnou místní transakci.

Poznámka

V této verzi může být operace zápisu jen LOB pro čtení úspěšná, ale neaktualizuje LOB na serveru. V tomto případě se ale místní kopie LOB aktualizuje. Proto pozdější operace čtení u objektu OracleLob můžou vrátit výsledky operace zápisu.