OracleLob.CopyTo Metoda

Definice

Obor názvů:

System.Data.OracleClient

Sestavení:

System.Data.OracleClient.dll

Zkopíruje z tohoto OracleLob do cílového umístění OracleLob.

Přetížení

CopyTo(OracleLob)	Zkopíruje z tohoto OracleLob do cílového umístění OracleLob.
CopyTo(OracleLob, Int64)	Zkopíruje z této OracleLob adresy do cílového umístění OracleLob se zadaným množstvím dat.
CopyTo(Int64, OracleLob, Int64, Int64)	Zkopíruje z toho OracleLob do cílového umístění OracleLob se zadaným množstvím dat a posunem zdroje.

CopyTo(OracleLob)

Zkopíruje z tohoto OracleLob do cílového umístění OracleLob.

public:
 long CopyTo(System::Data::OracleClient::OracleLob ^ destination);

public long CopyTo (System.Data.OracleClient.OracleLob destination);

override this.CopyTo : System.Data.OracleClient.OracleLob -> int64

Public Function CopyTo (destination As OracleLob) As Long

Parametry

destination

OracleLob

Cíl OracleLob.

Návraty

Int64

Počet zkopírovaných bajtů. Tím se vyloučí všechny polstrované bajty.

Výjimky

ArgumentNullException

Hodnota OracleLob zadaná v parametru destination má hodnotu null.

InvalidOperationException

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

OracleException

Došlo k chybě Oracle.

Poznámky

Podkladové datové typy musí být vždy stejné. Pokud například kopírujete z objektu NClob, musí být NClobcílem OracleLob také .

Pokud je posun cíle za koncem cíle LOB, rozšíří se hodnota , LOB do které se data kopírují. Mezera mezi koncem LOB a cílovým posunem za koncem je vyplněna nulami pro BLOB datové typy a mezery pro CLOB datové typy a NCLOB datové typy.

Chcete-li zapisovat do LOB, musíte načíst klauzuli LOB pomocí klauzule FOR UPDATE v příkazu SQL SELECT a musí být spuštěna místní transakce.

Poznámka

V této verzi může operace zápisu do jen LOB pro čtení proběhnout úspěšně, ale neaktualizovat LOB na serveru. V takovém 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.

Metoda CopyTo před provedením operace kopírování nevymaže obsah cíle OracleLob .

CopyTo(OracleLob, Int64)

Zkopíruje z této OracleLob adresy do cílového umístění OracleLob se zadaným množstvím dat.

public:
 long CopyTo(System::Data::OracleClient::OracleLob ^ destination, long destinationOffset);

public long CopyTo (System.Data.OracleClient.OracleLob destination, long destinationOffset);

override this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64

Public Function CopyTo (destination As OracleLob, destinationOffset As Long) As Long

Parametry

destination

OracleLob

Cíl OracleLob.

destinationOffset

Int64

Posun, do kterého chcete kopírovat. U CLOB datových typů a NCLOB musí jít o sudý počet bajtů.

Návraty

Int64

Počet zkopírovaných bajtů. Tím se vyloučí všechny polstrované bajty.

Výjimky

ArgumentNullException

Hodnota OracleLob zadaná v parametru destination je úplná.

ArgumentOutOfRangeException

Hodnota zadaná v parametru destinationOffset je menší než nula nebo větší než 4 gigabajty.

-nebo-

Hodnota zadaná v parametru destinationOffset pro CLOB datový typ nebo NCLOB není sudá.

-nebo-

Datové typy a NCLOB je nutné zadat CLOB jako sudý počet bajtů.

InvalidOperationException

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

OracleException

Došlo k chybě Oracle.

Poznámky

Podkladové datové typy musí být vždy stejné. Pokud například kopírujete z objektu NClob, musí být NClobcílem OracleLob také .

Pokud je posun cíle za koncem cíle LOB, rozšíří se hodnota , LOB do které se data kopírují. Mezera mezi koncem a cílovým LOB posunem za koncem je vyplněna nulami pro BLOB datové typy a mezery pro CLOB datové typy a NCLOB .

Chcete-li zapisovat do LOB, musíte načíst klauzuli LOB pomocí klauzule FOR UPDATE v příkazu SQL SELECT a musí být spuštěna místní transakce.

Poznámka

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

Metoda CopyTo před provedením operace kopírování nevymaže obsah cíle OracleLob .

CopyTo(Int64, OracleLob, Int64, Int64)

Zkopíruje z toho OracleLob do cílového umístění OracleLob se zadaným množstvím dat a posunem zdroje.

public:
 long CopyTo(long sourceOffset, System::Data::OracleClient::OracleLob ^ destination, long destinationOffset, long amount);

public long CopyTo (long sourceOffset, System.Data.OracleClient.OracleLob destination, long destinationOffset, long amount);

override this.CopyTo : int64 * System.Data.OracleClient.OracleLob * int64 * int64 -> int64

Public Function CopyTo (sourceOffset As Long, destination As OracleLob, destinationOffset As Long, amount As Long) As Long

Parametry

sourceOffset

Int64

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

destination

OracleLob

Cíl OracleLobSystem.Data.OracleClient.

destinationOffset

Int64

Cílový posun, do kterého se má kopírovat. U CLOB datových typů a NCLOB musí jít o sudé číslo.

amount

Int64

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

Návraty

Int64

Počet zkopírovaných bajtů. Tím se vyloučí všechny polstrované bajty.

Výjimky

ArgumentNullException

Hodnota OracleLob zadaná v parametru destination je úplná.

ArgumentOutOfRangeException

Hodnota zadaná v parametru amount, sourceOffsetnebo destinationOffset je menší než nula nebo větší než 4 gigabajty.

-nebo-

Hodnota zadaná v parametru amount, sourceOffsetnebo destinationOffset pro CLOB datový typ nebo NCLOB není sudá.

InvalidOperationException

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

OracleException

Došlo k chybě Oracle.

Poznámky

Podkladové datové typy musí být vždy stejné. Pokud například kopírujete z objektu NClob, musí být NClobcílem OracleLob také .

Pokud je posun cíle za koncem cíle LOB, rozšíří se hodnota , LOB do které se data kopírují. Mezera mezi koncem a cílovým LOB posunem za koncem je vyplněna nulami pro BLOB datové typy a mezery pro CLOB datové typy a NCLOB .

Chcete-li zapisovat do LOB, musíte načíst klauzuli LOB pomocí klauzule FOR UPDATE v příkazu SQL SELECT a musí být spuštěna místní transakce.

Poznámka

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

Metoda CopyTo před provedením operace kopírování nevymaže obsah cíle OracleLob .