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
| Nome | Descrizione |
|---|---|
| CopyTo(OracleLob) |
Copia da questo OracleLob oggetto a una destinazione OracleLob. |
| CopyTo(OracleLob, Int64) |
Copia da questo OracleLob oggetto a una destinazione OracleLob con la quantità di dati specificata. |
| CopyTo(Int64, OracleLob, Int64, Int64) |
Copia da questo OracleLob oggetto a una destinazione OracleLob 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
Valori restituiti
Numero di byte copiati. Ciò esclude tutti i byte riempiti.
Eccezioni
L'oggetto OracleLobdestination specificato nel parametro è Null.
L'operazione non si trova all'interno di una transazione, l'oggetto OracleLob è Null o la connessione viene 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 , anche la destinazione OracleLob deve essere un oggetto NClob.
Se l'offset di destinazione supera la fine della destinazione LOB, l'oggetto LOB a cui vengono copiati i dati viene esteso. Lo spazio tra la fine di e l'offset di LOB destinazione oltre la fine viene riempito con zeri per BLOB i tipi di dati e gli spazi per CLOB e NCLOB i tipi di dati.
Per scrivere in LOB, è necessario aver recuperato LOB utilizzando la clausola FOR UPDATE nell'istruzione SQL SELECT ed è necessario che sia stata avviata una transazione locale.
Note
In questa versione, un'operazione di scrittura in una sola lettura LOB potrebbe avere esito positivo, ma non aggiornare nel LOB server. In questo caso, tuttavia, la copia locale di 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 CLOB i tipi di dati e NCLOB , questo deve essere un numero pari di byte.
Valori restituiti
Numero di byte copiati. Ciò esclude tutti i byte riempiti.
Eccezioni
L'oggetto OracleLobdestination specificato nel parametro è pieno.
Un valore specificato nel destinationOffset parametro è minore di zero o maggiore di 4 gigabyte.
oppure
Un valore specificato nel destinationOffset parametro per un CLOB tipo di dati o NCLOB non è nemmeno .
oppure
È necessario specificare e CLOB i NCLOB tipi di dati come numero pari di byte.
L'operazione non si trova all'interno di una transazione, l'oggetto OracleLob è Null o la connessione viene 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 , anche la destinazione OracleLob deve essere un oggetto NClob.
Se l'offset di destinazione supera la fine della destinazione LOB, l'oggetto LOB a cui vengono copiati i dati viene esteso. Lo spazio tra la fine e l'offset di LOB destinazione oltre la fine viene riempito con zeri per BLOB i tipi di dati e gli spazi per CLOB e NCLOB i tipi di dati.
Per scrivere in LOB, è necessario aver recuperato LOB utilizzando la clausola FOR UPDATE nell'istruzione SQL SELECT ed è necessario che sia stata avviata una transazione locale.
Note
In questa versione, un'operazione di scrittura in una sola lettura LOB potrebbe avere esito positivo, ma non aggiorna nel LOB server. In questo caso, tuttavia, la copia locale di 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 CLOB i tipi di dati e NCLOB , questo deve essere un numero pari.
- destination
- OracleLob
Oggetto di destinazione OracleLobSystem.Data.OracleClient.
- destinationOffset
- Int64
Offset di destinazione in cui copiare. Per CLOB i tipi di dati e NCLOB , questo deve essere un numero pari.
- amount
- Int64
Quantità di dati, in byte, da copiare. Per CLOB i tipi di dati e NCLOB , questo deve essere un numero pari.
Valori restituiti
Numero di byte copiati. Ciò esclude tutti i byte riempiti.
Eccezioni
L'oggetto OracleLobdestination specificato nel parametro è pieno.
Un valore specificato nel amountparametro , sourceOffseto destinationOffset è minore di zero o maggiore di 4 gigabyte.
oppure
Un valore specificato nel amountparametro , sourceOffseto destinationOffset per un CLOB tipo di dati o NCLOB non è nemmeno .
L'operazione non si trova all'interno di una transazione, l'oggetto OracleLob è Null o la connessione viene 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 , anche la destinazione OracleLob deve essere un oggetto NClob.
Se l'offset di destinazione supera la fine della destinazione LOB, l'oggetto LOB a cui vengono copiati i dati viene esteso. Lo spazio tra la fine e l'offset di LOB destinazione oltre la fine viene riempito con zeri per BLOB i tipi di dati e gli spazi per CLOB e NCLOB i tipi di dati.
Per scrivere in LOB, è necessario aver recuperato LOB utilizzando la clausola FOR UPDATE nell'istruzione SQL SELECT ed è necessario che sia stata avviata una transazione locale.
Note
In questa versione, un'operazione di scrittura in una sola lettura LOB potrebbe avere esito positivo, ma non aggiorna nel LOB server. In questo caso, tuttavia, la copia locale di 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.
