OracleLob.CopyTo Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| CopyTo(OracleLob) | |
| CopyTo(OracleLob, Int64) |
Kopiert die angegebene Datenmenge aus diesem OracleLob in ein Ziel-OracleLob. |
| CopyTo(Int64, OracleLob, Int64, Int64) |
Kopiert die angegebene Datenmenge vom angegebenen Quelloffset dieses OracleLob in ein Ziel-OracleLob. |
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 LongParameter
Gibt zurück
Die Anzahl der kopierten Bytes. Dabei werden Füllzeichenbytes ausgelassen.
Ausnahmen
Das im destination-Parameter angegebene OracleLob ist NULL.
Die Operation befindet sich nicht innerhalb einer Transaktion, das OracleLob-Objekt ist NULL, oder die Verbindung ist geschlossen.
Es ist ein Oracle-Fehler aufgetreten.
Hinweise
Die zugrunde liegenden Datentypen müssen immer identisch sein. Wenn Sie z. B. aus einem NClobkopieren, muss das Ziel OracleLob ebenfalls ein NClobsein.
Wenn der Zieloffset über das Ende des Ziels LOBhinaus liegt, wird der LOB erweitert, in den die Daten kopiert werden. Der Abstand zwischen dem Ende von LOB und dem Zieloffset über das Ende hinaus ist mit Nullen für BLOB Datentypen und Leerzeichen für CLOB Datentypen und NCLOB Datentypen aufgefüllt.
Um in zu LOBschreiben, müssen Sie die mithilfe der FOR UPDATE-Klausel LOB in der SQL SELECT-Anweisung abgerufen haben, und Sie müssen eine lokale Transaktion gestartet haben.
Hinweis
In dieser Version kann ein Schreibvorgang für einen schreibgeschützten LOB Vorgang erfolgreich sein, aber nicht auf LOB dem Server aktualisiert werden. In diesem Fall wird jedoch die lokale Kopie des LOB aktualisiert. Daher können spätere Lesevorgänge für das OracleLob Objekt die Ergebnisse des Schreibvorgangs zurückgeben.
Die CopyTo -Methode löscht den Inhalt des Ziels OracleLob nicht, bevor der Kopiervorgang ausgeführt wird.
Gilt für:
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 LongParameter
- destinationOffset
- Int64
Der Offset, an den kopiert werden soll. Bei CLOB-Datentypen und NCLOB-Datentypen muss dies eine gerade Anzahl von Bytes sein.
Gibt zurück
Die Anzahl der kopierten Bytes. Dabei werden Füllzeichenbytes ausgelassen.
Ausnahmen
Das im destination-Parameter angegebene OracleLob ist voll.
Ein im destinationOffset-Parameter angegebener Wert ist kleiner als 0 (null) oder größer als 4 Gigabyte.
- oder -
Ein im destinationOffset-Parameter für einen CLOB-Datentyp oder einen NCLOB-Datentyp angegebener Wert ist ungerade.
- oder -
Sie müssen CLOB-Datentypen und NCLOB-Datentypen als gerade Anzahl von Bytes angeben.
Die Operation befindet sich nicht innerhalb einer Transaktion, das OracleLob-Objekt ist NULL, oder die Verbindung ist geschlossen.
Es ist ein Oracle-Fehler aufgetreten.
Hinweise
Die zugrunde liegenden Datentypen müssen immer identisch sein. Wenn Sie z. B. aus einem NClobkopieren, muss das Ziel OracleLob ebenfalls ein NClobsein.
Wenn der Zieloffset über das Ende des Ziels LOBhinaus liegt, wird der LOB erweitert, in den die Daten kopiert werden. Der Abstand zwischen dem Ende von LOB und dem Zieloffset über das Ende hinaus wird mit Nullen für BLOB Datentypen und Leerzeichen für CLOB und NCLOB Datentypen aufgefüllt.
Um in zu LOBschreiben, müssen Sie die mithilfe der FOR UPDATE-Klausel LOB in der SQL SELECT-Anweisung abgerufen haben, und Sie müssen eine lokale Transaktion gestartet haben.
Hinweis
In dieser Version kann ein Schreibvorgang für einen schreibgeschützten LOB Vorgang erfolgreich sein, aktualisiert aber nicht auf LOB dem Server. In diesem Fall wird jedoch die lokale Kopie des LOB aktualisiert. Daher können spätere Lesevorgänge für das OracleLob Objekt die Ergebnisse des Schreibvorgangs zurückgeben.
Die CopyTo -Methode löscht den Inhalt des Ziels OracleLob nicht, bevor der Kopiervorgang ausgeführt wird.
Gilt für:
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 LongParameter
- sourceOffset
- Int64
Der Offset, von dem kopiert werden soll. Bei CLOB-Datentypen und NCLOB-Datentypen muss dies eine gerade Zahl sein.
- destination
- OracleLob
Der Ziel-OracleLobSystem.Data.OracleClient.
- destinationOffset
- Int64
Der Zieloffset, an den kopiert werden soll. Bei CLOB-Datentypen und NCLOB-Datentypen muss dies eine gerade Zahl sein.
- amount
- Int64
Die zu kopierende Datenmenge in Bytes. Bei CLOB-Datentypen und NCLOB-Datentypen muss dies eine gerade Zahl sein.
Gibt zurück
Die Anzahl der kopierten Bytes. Dabei werden Füllzeichenbytes ausgelassen.
Ausnahmen
Das im destination-Parameter angegebene OracleLob ist voll.
Ein in den Parametern amount, sourceOffset oder destinationOffset angegebener Wert ist kleiner als 0 (null) oder größer als 4 Gigabyte.
- oder -
Ein im amount-Parameter, im sourceOffset-Parameter oder im destinationOffset-Parameter für einen CLOB-Datentyp oder einen NCLOB-Datentyp angegebener Wert ist ungerade.
Die Operation befindet sich nicht innerhalb einer Transaktion, das OracleLob-Objekt ist NULL, oder die Verbindung ist geschlossen.
Es ist ein Oracle-Fehler aufgetreten.
Hinweise
Die zugrunde liegenden Datentypen müssen immer identisch sein. Wenn Sie z. B. aus einem NClobkopieren, muss das Ziel OracleLob ebenfalls ein NClobsein.
Wenn der Zieloffset über das Ende des Ziels LOBhinaus liegt, wird der LOB erweitert, in den die Daten kopiert werden. Der Abstand zwischen dem Ende von LOB und dem Zieloffset über das Ende hinaus wird mit Nullen für BLOB Datentypen und Leerzeichen für CLOB und NCLOB Datentypen aufgefüllt.
Um in zu LOBschreiben, müssen Sie die mithilfe der FOR UPDATE-Klausel LOB in der SQL SELECT-Anweisung abgerufen haben, und Sie müssen eine lokale Transaktion gestartet haben.
Hinweis
In dieser Version kann ein Schreibvorgang für einen schreibgeschützten LOB Vorgang erfolgreich sein, aktualisiert aber nicht auf LOB dem Server. In diesem Fall wird jedoch die lokale Kopie des LOB aktualisiert. Daher können spätere Lesevorgänge für das OracleLob Objekt die Ergebnisse des Schreibvorgangs zurückgeben.
Die CopyTo -Methode löscht den Inhalt des Ziels OracleLob nicht, bevor der Kopiervorgang ausgeführt wird.
