OracleLob.CopyTo Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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)
public:
long CopyTo(System::Data::OracleClient::OracleLob ^ destination);public long CopyTo (System.Data.OracleClient.OracleLob destination);member this.CopyTo : System.Data.OracleClient.OracleLob -> int64override this.CopyTo : System.Data.OracleClient.OracleLob -> int64Public Function CopyTo (destination As OracleLob) As LongParametry
Návraty
Počet zkopírovaných bajtů. Tím se vyloučí všechny polstrované bajty.
Výjimky
Hodnota OracleLob zadaná v parametru destination má hodnotu null.
Operace není v rámci transakce, OracleLob objekt má hodnotu null nebo je připojení ukončeno.
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 .
Platí pro
CopyTo(OracleLob, Int64)
public:
long CopyTo(System::Data::OracleClient::OracleLob ^ destination, long destinationOffset);public long CopyTo (System.Data.OracleClient.OracleLob destination, long destinationOffset);member this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64override this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64Public Function CopyTo (destination As OracleLob, destinationOffset As Long) As LongParametry
- 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
Počet zkopírovaných bajtů. Tím se vyloučí všechny polstrované bajty.
Výjimky
Hodnota OracleLob zadaná v parametru destination je úplná.
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ů.
Operace není v rámci transakce, OracleLob objekt má hodnotu null nebo je připojení ukončeno.
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 .
Platí pro
CopyTo(Int64, OracleLob, Int64, Int64)
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);member this.CopyTo : int64 * System.Data.OracleClient.OracleLob * int64 * int64 -> int64override this.CopyTo : int64 * System.Data.OracleClient.OracleLob * int64 * int64 -> int64Public Function CopyTo (sourceOffset As Long, destination As OracleLob, destinationOffset As Long, amount As Long) As LongParametry
- 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
Počet zkopírovaných bajtů. Tím se vyloučí všechny polstrované bajty.
Výjimky
Hodnota OracleLob zadaná v parametru destination je úplná.
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á.
Operace není v rámci transakce, OracleLob objekt má hodnotu null nebo je připojení ukončeno.
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 .
