Condividi tramite


OracleLob.CopyTo Metodo

Definizione

Consente di copiare da questo oggetto OracleLob a un oggetto OracleLob di destinazione.

Overload

CopyTo(OracleLob)

Consente di copiare da questo oggetto OracleLob a un oggetto OracleLob di destinazione.

CopyTo(OracleLob, Int64)

Consente di copiare dall'oggetto OracleLob a un oggetto OracleLob di destinazione con la quantità specificata di dati.

CopyTo(Int64, OracleLob, Int64, Int64)

Consente di copiare dall'oggetto OracleLob a un oggetto OracleLob di destinazione con la quantità specificata di dati e l'offset di origine.

CopyTo(OracleLob)

Consente di copiare da questo oggetto OracleLob a un oggetto OracleLob di destinazione.

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

Parametri

destination
OracleLob

OracleLob di destinazione.

Restituisce

Numero di byte copiati. Sono esclusi i byte riempiti.

Eccezioni

L'oggetto OracleLob specificato nel parametro destination è null.

L'operazione non è presente all'interno di una transazione, l'oggetto OracleLob è null oppure la connessione è chiusa.

Si è verificato un errore Oracle.

Commenti

I tipi di dati sottostanti devono essere sempre uguali. Ad esempio, se si esegue la copia da un NCloboggetto , la destinazione OracleLob deve essere anche un NCloboggetto .

Se l'offset di destinazione supera la fine della destinazione LOB, a LOB cui vengono copiati i dati vengono estesi. Lo spazio compreso tra la fine dell'oggetto LOB e l'offset di destinazione oltre la fine viene riempito con zero per i tipi di dati e gli spazi per BLOBCLOB e NCLOB i tipi di dati.

Per scrivere in LOB, è necessario aver recuperato la LOB clausola FOR UPDATE nell'istruzione SQL SELECT e è necessario avviare una transazione locale.

Nota

In questa versione un'operazione di scrittura in una sola lettura LOB potrebbe avere esito positivo, ma non aggiornare l'oggetto LOB nel server. In questo caso, tuttavia, la copia locale dell'oggetto LOB verrà aggiornata. Pertanto, le operazioni di lettura successive sull'oggetto OracleLob potrebbero restituire i risultati dell'operazione di scrittura.

Il CopyTo metodo non cancella il contenuto della destinazione OracleLob prima di eseguire l'operazione di copia.

Si applica a

CopyTo(OracleLob, Int64)

Consente di copiare dall'oggetto OracleLob a un oggetto OracleLob di destinazione con la quantità specificata di dati.

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

Parametri

destination
OracleLob

OracleLob di destinazione.

destinationOffset
Int64

Offset in cui copiare. Per i tipi di dati CLOB e NCLOB deve trattarsi di un numero pari di byte.

Restituisce

Numero di byte copiati. Sono esclusi i byte riempiti.

Eccezioni

L'oggetto OracleLob specificato nel parametro destination è null.

Un valore specificato nel parametro destinationOffset è minore di zero o maggiore di 4 GB.

-oppure-

Un valore specificato nel parametro destinationOffset per un tipo di dati CLOB o NCLOB non è pari.

-oppure-

È necessario specificare i tipi di dati CLOB e NCLOB come un numero pari di byte.

L'operazione non è presente all'interno di una transazione, l'oggetto OracleLob è null oppure la connessione è chiusa.

Si è verificato un errore Oracle.

Commenti

I tipi di dati sottostanti devono essere sempre uguali. Ad esempio, se si esegue la copia da un NCloboggetto , la destinazione OracleLob deve essere anche un NCloboggetto .

Se l'offset di destinazione supera la fine della destinazione LOB, a LOB cui vengono copiati i dati vengono estesi. Lo spazio compreso tra la fine e l'offset di LOB destinazione oltre la fine viene riempito con zero per i tipi di dati e gli spazi per BLOBCLOB e NCLOB i tipi di dati.

Per scrivere in LOB, è necessario aver recuperato la LOB clausola FOR UPDATE nell'istruzione SQL SELECT e è necessario avviare una transazione locale.

Nota

In questa versione un'operazione di scrittura in una sola lettura LOB potrebbe avere esito positivo, ma non aggiorna l'oggetto LOB nel server. In questo caso, tuttavia, la copia locale dell'oggetto LOB viene aggiornata. Pertanto, le operazioni di lettura successive sull'oggetto OracleLob potrebbero restituire i risultati dell'operazione di scrittura.

Il CopyTo metodo non cancella il contenuto della destinazione OracleLob prima di eseguire l'operazione di copia.

Si applica a

CopyTo(Int64, OracleLob, Int64, Int64)

Consente di copiare dall'oggetto OracleLob a un oggetto OracleLob di destinazione con la quantità specificata di dati e l'offset di origine.

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

Parametri

sourceOffset
Int64

Offset da cui copiare. Per i tipi di dati CLOB e NCLOB, deve trattarsi di un numero pari.

destination
OracleLob

Elemento OracleLobSystem.Data.OracleClient di destinazione.

destinationOffset
Int64

Offset di destinazione della copia. Per i tipi di dati CLOB e NCLOB, deve trattarsi di un numero pari.

amount
Int64

Quantità di dati in byte da copiare. Per i tipi di dati CLOB e NCLOB, deve trattarsi di un numero pari.

Restituisce

Numero di byte copiati. Sono esclusi i byte riempiti.

Eccezioni

L'oggetto OracleLob specificato nel parametro destination è null.

Un valore specificato nel parametro amount, sourceOffset o destinationOffset è minore di zero o maggiore di 4 GB.

-oppure-

Un valore specificato nel parametro amount, sourceOffset o destinationOffset per un tipo di dati CLOB o NCLOB non è pari.

L'operazione non è presente all'interno di una transazione, l'oggetto OracleLob è null oppure la connessione è chiusa.

Si è verificato un errore Oracle.

Commenti

I tipi di dati sottostanti devono essere sempre uguali. Ad esempio, se si esegue la copia da un NCloboggetto , la destinazione OracleLob deve essere anche un NCloboggetto .

Se l'offset di destinazione supera la fine della destinazione LOB, a LOB cui vengono copiati i dati vengono estesi. Lo spazio compreso tra la fine e l'offset di LOB destinazione oltre la fine viene riempito con zero per i tipi di dati e gli spazi per BLOBCLOB e NCLOB i tipi di dati.

Per scrivere in LOB, è necessario aver recuperato la LOB clausola FOR UPDATE nell'istruzione SQL SELECT e è necessario avviare una transazione locale.

Nota

In questa versione un'operazione di scrittura in una sola lettura LOB potrebbe avere esito positivo, ma non aggiorna l'oggetto LOB nel server. In questo caso, tuttavia, la copia locale dell'oggetto LOB viene aggiornata. Pertanto, le operazioni di lettura successive sull'oggetto OracleLob potrebbero restituire i risultati dell'operazione di scrittura.

Il CopyTo metodo non cancella il contenuto della destinazione OracleLob prima di eseguire l'operazione di copia.

Si applica a