OracleLob.CopyTo Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Overloads
| Name | Description |
|---|---|
| CopyTo(OracleLob) | |
| CopyTo(OracleLob, Int64) |
Kopieert van dit OracleLob naar een bestemming OracleLob met de opgegeven hoeveelheid gegevens. |
| CopyTo(Int64, OracleLob, Int64, Int64) |
Kopieert hiervan OracleLob naar een bestemming OracleLob met de opgegeven hoeveelheid gegevens en de bronverschil. |
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 LongParameters
Retouren
Het aantal gekopieerde bytes. Dit sluit eventuele opgevulde bytes uit.
Uitzonderingen
De OracleLob opgegeven in de destination parameter is null.
De bewerking bevindt zich niet binnen een transactie, het OracleLob object is null of de verbinding is gesloten.
Er is een Oracle-fout opgetreden.
Opmerkingen
De onderliggende gegevenstypen moeten altijd hetzelfde zijn. Als u bijvoorbeeld kopieert vanuit een NClob, moet de bestemming OracleLob ook een NClob.
Als de doelverrekening buiten het einde van het doel LOBvalt, wordt de LOB gegevens waarop de gegevens worden gekopieerd, uitgebreid. De ruimte tussen het einde van de LOB en de doelverschil voorbij het einde wordt opgevuld met nullen voor BLOB gegevenstypen en spaties voor CLOB en NCLOB gegevenstypen.
Als u naar de LOBinstructie WILT schrijven, moet u het LOB gebruik van de FOR UPDATE-component in de SQL SELECT-instructie hebben opgehaald en moet u een lokale transactie hebben gestart.
Note
In deze release kan een schrijfbewerking naar een alleen-lezenbewerking LOB slagen, maar niet de LOB bewerking op de server bijwerken. In dit geval wordt de lokale kopie van de LOB kopie echter bijgewerkt. Daarom kunnen latere leesbewerkingen op het OracleLob object de resultaten van de schrijfbewerking retourneren.
De CopyTo methode wist de inhoud van de bestemming OracleLob niet voordat de kopieerbewerking wordt uitgevoerd.
Van toepassing op
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 LongParameters
- destinationOffset
- Int64
De offset waarnaar moet worden gekopieerd. Voor CLOB en NCLOB gegevenstypen moet dit een even aantal bytes zijn.
Retouren
Het aantal gekopieerde bytes. Dit sluit eventuele opgevulde bytes uit.
Uitzonderingen
De OracleLob opgegeven in de destination parameter is vol.
Een waarde die is opgegeven in de destinationOffset parameter is kleiner dan nul of groter dan 4 gigabyte.
– of –
Een waarde die is opgegeven in de destinationOffset parameter voor een CLOB of NCLOB gegevenstype, is niet eens.
– of –
U moet gegevenstypen CLOB opgeven NCLOB als een even aantal bytes.
De bewerking bevindt zich niet binnen een transactie, het OracleLob object is null of de verbinding is gesloten.
Er is een Oracle-fout opgetreden.
Opmerkingen
De onderliggende gegevenstypen moeten altijd hetzelfde zijn. Als u bijvoorbeeld kopieert vanuit een NClob, moet de bestemming OracleLob ook een NClob.
Als de doelverrekening buiten het einde van het doel LOBvalt, wordt de LOB gegevens waarop de gegevens worden gekopieerd, uitgebreid. De ruimte tussen het einde en LOB het doelverschil buiten het einde wordt opgevuld met nullen voor BLOB gegevenstypen en spaties voor CLOB en NCLOB gegevenstypen.
Als u naar de LOBinstructie WILT schrijven, moet u het LOB gebruik van de FOR UPDATE-component in de SQL SELECT-instructie hebben opgehaald en moet u een lokale transactie hebben gestart.
Note
In deze release kan een schrijfbewerking naar een alleen-lezenbewerking LOB slagen, maar wordt de LOB bewerking niet bijgewerkt op de server. In dit geval wordt de lokale kopie van de kopie LOB echter bijgewerkt. Daarom kunnen latere leesbewerkingen op het OracleLob object de resultaten van de schrijfbewerking retourneren.
De CopyTo methode wist de inhoud van de bestemming OracleLob niet voordat de kopieerbewerking wordt uitgevoerd.
Van toepassing op
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 LongParameters
- sourceOffset
- Int64
De offset van waaruit moet worden gekopieerd. Voor CLOB en NCLOB gegevenstypen moet dit een even getal zijn.
- destination
- OracleLob
De bestemming OracleLobSystem.Data.OracleClient.
- destinationOffset
- Int64
De doel offset waarnaar moet worden gekopieerd. Voor CLOB en NCLOB gegevenstypen moet dit een even getal zijn.
- amount
- Int64
De hoeveelheid gegevens, in bytes, die u wilt kopiëren. Voor CLOB en NCLOB gegevenstypen moet dit een even getal zijn.
Retouren
Het aantal gekopieerde bytes. Dit sluit eventuele opgevulde bytes uit.
Uitzonderingen
De OracleLob opgegeven in de destination parameter is vol.
Een waarde die is opgegeven in de amount, sourceOffsetof destinationOffset parameter is kleiner dan nul of groter dan 4 gigabytes.
– of –
Een waarde die is opgegeven in de amountparameter sourceOffsetdestinationOffsetvoor een CLOB of NCLOB gegevenstype, is niet eens.
De bewerking bevindt zich niet binnen een transactie, het OracleLob object is null of de verbinding is gesloten.
Er is een Oracle-fout opgetreden.
Opmerkingen
De onderliggende gegevenstypen moeten altijd hetzelfde zijn. Als u bijvoorbeeld kopieert vanuit een NClob, moet de bestemming OracleLob ook een NClob.
Als de doelverrekening buiten het einde van het doel LOBvalt, wordt de LOB gegevens waarop de gegevens worden gekopieerd, uitgebreid. De ruimte tussen het einde en LOB het doelverschil buiten het einde wordt opgevuld met nullen voor BLOB gegevenstypen en spaties voor CLOB en NCLOB gegevenstypen.
Als u naar de LOBinstructie WILT schrijven, moet u het LOB gebruik van de FOR UPDATE-component in de SQL SELECT-instructie hebben opgehaald en moet u een lokale transactie hebben gestart.
Note
In deze release kan een schrijfbewerking naar een alleen-lezenbewerking LOB slagen, maar wordt de LOB bewerking niet bijgewerkt op de server. In dit geval wordt de lokale kopie van de kopie LOB echter bijgewerkt. Daarom kunnen latere leesbewerkingen op het OracleLob object de resultaten van de schrijfbewerking retourneren.
De CopyTo methode wist de inhoud van de bestemming OracleLob niet voordat de kopieerbewerking wordt uitgevoerd.
