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
| Name | Beschreibung |
|---|---|
| CopyTo(OracleLob) | |
| CopyTo(OracleLob, Int64) |
Kopiert von dieser OracleLob daten in ein Ziel OracleLob mit der angegebenen Datenmenge. |
| CopyTo(Int64, OracleLob, Int64, Int64) |
Kopiert von dieser OracleLob daten in ein Ziel OracleLob mit der angegebenen Datenmenge und dem Quelloffset. |
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. Dadurch werden alle aufgefüllten Bytes ausgeschlossen.
Ausnahmen
Der OracleLob im destination Parameter angegebene Parameter ist NULL.
Der Vorgang befindet sich nicht innerhalb einer Transaktion, das OracleLob Objekt ist NULL, oder die Verbindung wird geschlossen.
Ein Oracle-Fehler ist aufgetreten.
Hinweise
Die zugrunde liegenden Datentypen müssen immer gleich sein. Wenn Sie z. B. aus einem NClobKopieren kopieren, muss das Ziel OracleLob auch ein NClob.
Wenn der Zieloffset über das Ende des Ziels LOBhinausgeht, wird die LOB Daten, in die die Daten kopiert werden, erweitert. Der Abstand zwischen dem Ende des LOB Und des Zieloffsets über das Ende hinaus wird mit Nullen für BLOB Datentypen und Leerzeichen für CLOB und NCLOB Datentypen aufgefüllt.
Um in das LOBElement zu schreiben, müssen Sie die Verwendung der LOB FOR UPDATE-Klausel in der SQL SELECT-Anweisung abgerufen haben, und Sie müssen eine lokale Transaktion gestartet haben.
Note
In dieser Version ist ein Schreibvorgang in einen schreibgeschützten LOB Vorgang möglicherweise erfolgreich, aber nicht auf LOB dem Server aktualisiert. In diesem Fall wird jedoch die lokale Kopie der LOB Datei aktualisiert. Daher können später 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, in den kopiert werden soll. Für CLOB und NCLOB Datentypen muss dies eine gerade Anzahl von Bytes sein.
Gibt zurück
Die Anzahl der kopierten Bytes. Dadurch werden alle aufgefüllten Bytes ausgeschlossen.
Ausnahmen
Der OracleLob im destination Parameter angegebene Parameter ist voll.
Ein wert, der destinationOffset im Parameter angegeben ist, ist kleiner als null oder größer als 4 Gigabyte.
-oder-
Ein wert, der destinationOffset im Parameter für einen CLOB Oder NCLOB Datentyp angegeben ist, ist nicht einmal.
-oder-
Sie müssen Datentypen als gerade Anzahl von Bytes angeben CLOB und NCLOB angeben.
Der Vorgang befindet sich nicht innerhalb einer Transaktion, das OracleLob Objekt ist NULL, oder die Verbindung wird geschlossen.
Ein Oracle-Fehler ist aufgetreten.
Hinweise
Die zugrunde liegenden Datentypen müssen immer gleich sein. Wenn Sie z. B. aus einem NClobKopieren kopieren, muss das Ziel OracleLob auch ein NClob.
Wenn der Zieloffset über das Ende des Ziels LOBhinausgeht, wird die LOB Daten, in die die Daten kopiert werden, erweitert. Der Abstand zwischen Dem Ende und LOB Zieloffset über das Ende hinaus wird mit Nullen für BLOB Datentypen und Leerzeichen für CLOB und NCLOB Datentypen aufgefüllt.
Um in das LOBElement zu schreiben, müssen Sie die Verwendung der LOB FOR UPDATE-Klausel in der SQL SELECT-Anweisung abgerufen haben, und Sie müssen eine lokale Transaktion gestartet haben.
Note
In dieser Version ist ein Schreibvorgang in einen schreibgeschützten LOB Vorgang möglicherweise erfolgreich, aktualisiert jedoch nicht den LOB Server. In diesem Fall wird jedoch die lokale Kopie der Datei LOB aktualisiert. Daher können später 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, aus dem kopiert werden soll. Für CLOB und NCLOB Datentypen muss dies eine gerade Zahl sein.
- destination
- OracleLob
Das Ziel OracleLobSystem.Data.OracleClient.
- destinationOffset
- Int64
Der Zieloffset, in den kopiert werden soll. Für CLOB und NCLOB Datentypen muss dies eine gerade Zahl sein.
- amount
- Int64
Die Zu kopierende Datenmenge in Byte. Für CLOB und NCLOB Datentypen muss dies eine gerade Zahl sein.
Gibt zurück
Die Anzahl der kopierten Bytes. Dadurch werden alle aufgefüllten Bytes ausgeschlossen.
Ausnahmen
Der OracleLob im destination Parameter angegebene Parameter ist voll.
Ein wert, der amountim , sourceOffsetoder destinationOffset Parameter angegeben ist kleiner als 0 oder größer als 4 Gigabyte.
-oder-
Ein wert, der amountim , sourceOffsetoder destinationOffset Parameter für einen CLOB oder NCLOB Datentyp angegeben ist, ist nicht einmal.
Der Vorgang befindet sich nicht innerhalb einer Transaktion, das OracleLob Objekt ist NULL, oder die Verbindung wird geschlossen.
Ein Oracle-Fehler ist aufgetreten.
Hinweise
Die zugrunde liegenden Datentypen müssen immer gleich sein. Wenn Sie z. B. aus einem NClobKopieren kopieren, muss das Ziel OracleLob auch ein NClob.
Wenn der Zieloffset über das Ende des Ziels LOBhinausgeht, wird die LOB Daten, in die die Daten kopiert werden, erweitert. Der Abstand zwischen Dem Ende und LOB Zieloffset über das Ende hinaus wird mit Nullen für BLOB Datentypen und Leerzeichen für CLOB und NCLOB Datentypen aufgefüllt.
Um in das LOBElement zu schreiben, müssen Sie die Verwendung der LOB FOR UPDATE-Klausel in der SQL SELECT-Anweisung abgerufen haben, und Sie müssen eine lokale Transaktion gestartet haben.
Note
In dieser Version ist ein Schreibvorgang in einen schreibgeschützten LOB Vorgang möglicherweise erfolgreich, aktualisiert jedoch nicht den LOB Server. In diesem Fall wird jedoch die lokale Kopie der Datei LOB aktualisiert. Daher können später 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.
