Teilen über


OracleLob.CopyTo Methode

Definition

Kopiert aus diesem OracleLob in ein Ziel-OracleLob.

Überlädt

CopyTo(OracleLob)

Kopiert aus diesem OracleLob in ein Ziel-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)

Kopiert aus diesem OracleLob in ein Ziel-OracleLob.

public:
 long CopyTo(System::Data::OracleClient::OracleLob ^ destination);
public long CopyTo (System.Data.OracleClient.OracleLob destination);
member this.CopyTo : System.Data.OracleClient.OracleLob -> int64
override this.CopyTo : System.Data.OracleClient.OracleLob -> int64
Public Function CopyTo (destination As OracleLob) As Long

Parameter

destination
OracleLob

Das Ziel-OracleLob.

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)

Kopiert die angegebene Datenmenge aus diesem OracleLob in ein Ziel-OracleLob.

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 -> int64
override this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64
Public Function CopyTo (destination As OracleLob, destinationOffset As Long) As Long

Parameter

destination
OracleLob

Das Ziel-OracleLob.

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)

Kopiert die angegebene Datenmenge vom angegebenen Quelloffset dieses OracleLob in ein Ziel-OracleLob.

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 -> int64
override this.CopyTo : int64 * System.Data.OracleClient.OracleLob * int64 * int64 -> int64
Public Function CopyTo (sourceOffset As Long, destination As OracleLob, destinationOffset As Long, amount As Long) As Long

Parameter

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.

Gilt für: