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 NClob kopieren, muss das Ziel OracleLob ebenfalls NClob sein.
Wenn der Zieloffset über dem Ende des Ziels liegt, wird der , in den die LOB LOB Daten kopiert werden, erweitert. Der Abstand zwischen dem Ende des und dem Zieloffset hinter dem Ende wird mit Nullen für Datentypen und Leerzeichen für die Datentypen LOB BLOB und CLOB NCLOB aufschlossen.
Um in zu schreiben, müssen Sie die mithilfe der FOR UPDATE-Klausel in der SELECT SQL-Anweisung abgerufen haben, und Sie müssen eine LOB LOB lokale Transaktion gestartet haben.
Hinweis
In dieser Version kann ein Schreibvorgang für eine schreibgeschützte -Funktion erfolgreich sein, aber nicht LOB auf dem Server aktualisiert LOB werden. In diesem Fall wird jedoch die lokale Kopie von LOB aktualisiert. Daher können spätere Lesevorgänge für das OracleLob -Objekt die Ergebnisse des Schreibvorgang zurückgeben.
Die CopyTo -Methode cleart den Inhalt des Ziels nicht, OracleLob bevor der Kopiervorgang durchgefü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 NClob kopieren, muss das Ziel OracleLob ebenfalls NClob sein.
Wenn der Zieloffset über dem Ende des Ziels liegt, wird der , in den die LOB LOB Daten kopiert werden, erweitert. Der Abstand zwischen dem Ende von und dem Zieloffset hinter dem Ende wird mit Nullen für Datentypen und Leerzeichen für - und LOB BLOB CLOB NCLOB -Datentypen aufschlossen.
Um in zu schreiben, müssen Sie die mithilfe der FOR UPDATE-Klausel in der SELECT SQL-Anweisung abgerufen haben, und Sie müssen eine LOB LOB lokale Transaktion gestartet haben.
Hinweis
In dieser Version kann ein Schreibvorgang für einen schreibgeschützten vorgang erfolgreich sein, aktualisiert jedoch nicht LOB den LOB auf dem Server. In diesem Fall wird jedoch die lokale Kopie von LOB aktualisiert. Daher können spätere Lesevorgänge für das OracleLob -Objekt die Ergebnisse des Schreibvorgang zurückgeben.
Die CopyTo -Methode cleart den Inhalt des Ziels nicht, OracleLob bevor der Kopiervorgang durchgefü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 NClob kopieren, muss das Ziel OracleLob ebenfalls NClob sein.
Wenn der Zieloffset über dem Ende des Ziels liegt, wird der , in den die LOB LOB Daten kopiert werden, erweitert. Der Abstand zwischen dem Ende von und dem Zieloffset hinter dem Ende wird mit Nullen für Datentypen und Leerzeichen für - und LOB BLOB CLOB NCLOB -Datentypen aufschlossen.
Um in zu schreiben, müssen Sie die mithilfe der FOR UPDATE-Klausel in der SELECT SQL-Anweisung abgerufen haben, und Sie müssen eine LOB LOB lokale Transaktion gestartet haben.
Hinweis
In dieser Version kann ein Schreibvorgang für einen schreibgeschützten vorgang erfolgreich sein, aktualisiert jedoch nicht LOB den LOB auf dem Server. In diesem Fall wird jedoch die lokale Kopie von LOB aktualisiert. Daher können spätere Lesevorgänge für das OracleLob -Objekt die Ergebnisse des Schreibvorgang zurückgeben.
Die CopyTo -Methode cleart den Inhalt des Ziels nicht, OracleLob bevor der Kopiervorgang durchgeführt wird.