OracleLob.CopyTo Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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)
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 LongParametri
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)
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 LongParametri
- 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)
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 LongParametri
- 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.
