OracleLob.CopyTo Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| Nombre | Description |
|---|---|
| CopyTo(OracleLob) | |
| CopyTo(OracleLob, Int64) |
Copia de esto OracleLob en un destino OracleLob con la cantidad de datos especificada. |
| CopyTo(Int64, OracleLob, Int64, Int64) |
Copia de este OracleLob en un destino OracleLob con la cantidad de datos especificada y el desplazamiento de origen. |
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 LongParámetros
Devoluciones
Número de bytes copiados. Esto excluye los bytes rellenados.
Excepciones
El OracleLob especificado en el destination parámetro es NULL.
La operación no está dentro de una transacción, el OracleLob objeto es null o se cierra la conexión.
Se ha producido un error de Oracle.
Comentarios
Los tipos de datos subyacentes siempre deben ser los mismos. Por ejemplo, si va a copiar desde , NClobel destino OracleLob también debe ser .NClob
Si el desplazamiento de destino está más allá del final del destino LOB, se extiende el LOB al que se copian los datos. El espacio entre el final del LOB y el desplazamiento de destino más allá del final se rellena con ceros para BLOB los tipos de datos y los espacios para CLOB los tipos de datos y NCLOB .
Para escribir en LOB, debe haber recuperado el uso de la LOB cláusula FOR UPDATE en la instrucción SQL SELECT y debe haber iniciado una transacción local.
Note
En esta versión, una operación de escritura en un solo LOB lectura podría realizarse correctamente, pero no actualizar en LOB el servidor. Sin embargo, en este caso, se actualizará la copia local de .LOB Por lo tanto, las operaciones de lectura posteriores en el OracleLob objeto podrían devolver los resultados de la operación de escritura.
El CopyTo método no borra el contenido del destino OracleLob antes de realizar la operación de copia.
Se aplica 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 LongParámetros
- destinationOffset
- Int64
Desplazamiento al que se va a copiar. Para CLOB los tipos de datos y NCLOB , debe ser un número par de bytes.
Devoluciones
Número de bytes copiados. Esto excluye los bytes rellenados.
Excepciones
El OracleLob especificado en el destination parámetro está lleno.
Un valor especificado en el destinationOffset parámetro es menor que cero o mayor que 4 gigabytes.
O bien
Un valor especificado en el destinationOffset parámetro para un CLOB tipo de datos o NCLOB no es ni siquiera.
O bien
Debe especificar CLOB y NCLOB los tipos de datos como un número par de bytes.
La operación no está dentro de una transacción, el OracleLob objeto es null o se cierra la conexión.
Se ha producido un error de Oracle.
Comentarios
Los tipos de datos subyacentes siempre deben ser los mismos. Por ejemplo, si va a copiar desde , NClobel destino OracleLob también debe ser .NClob
Si el desplazamiento de destino está más allá del final del destino LOB, se extiende el LOB al que se copian los datos. El espacio entre el final y el desplazamiento de LOB destino más allá del final se rellena con ceros para BLOB los tipos de datos y los espacios para CLOB los tipos de datos y NCLOB los tipos de datos.
Para escribir en LOB, debe haber recuperado el uso de la LOB cláusula FOR UPDATE en la instrucción SQL SELECT y debe haber iniciado una transacción local.
Note
En esta versión, una operación de escritura en un solo LOB lectura podría realizarse correctamente, pero no actualiza en LOB el servidor. Sin embargo, en este caso, se actualiza la copia local de .LOB Por lo tanto, las operaciones de lectura posteriores en el OracleLob objeto podrían devolver los resultados de la operación de escritura.
El CopyTo método no borra el contenido del destino OracleLob antes de realizar la operación de copia.
Se aplica 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 LongParámetros
- sourceOffset
- Int64
Desplazamiento desde el que se va a copiar. Para CLOB los tipos de datos y NCLOB , debe ser un número par.
- destination
- OracleLob
OracleLob
System.Data.OracleClientDestino .
- destinationOffset
- Int64
Desplazamiento de destino al que se va a copiar. Para CLOB los tipos de datos y NCLOB , debe ser un número par.
- amount
- Int64
Cantidad de datos, en bytes, que se van a copiar. Para CLOB los tipos de datos y NCLOB , debe ser un número par.
Devoluciones
Número de bytes copiados. Esto excluye los bytes rellenados.
Excepciones
El OracleLob especificado en el destination parámetro está lleno.
Un valor especificado en el amountparámetro , sourceOffseto destinationOffset es menor que cero o mayor que 4 gigabytes.
O bien
Un valor especificado en el amountparámetro , sourceOffseto destinationOffset para un CLOB tipo de datos o NCLOB no es ni siquiera.
La operación no está dentro de una transacción, el OracleLob objeto es null o se cierra la conexión.
Se ha producido un error de Oracle.
Comentarios
Los tipos de datos subyacentes siempre deben ser los mismos. Por ejemplo, si va a copiar desde , NClobel destino OracleLob también debe ser .NClob
Si el desplazamiento de destino está más allá del final del destino LOB, se extiende el LOB al que se copian los datos. El espacio entre el final y el desplazamiento de LOB destino más allá del final se rellena con ceros para BLOB los tipos de datos y los espacios para CLOB los tipos de datos y NCLOB los tipos de datos.
Para escribir en LOB, debe haber recuperado el uso de la LOB cláusula FOR UPDATE en la instrucción SQL SELECT y debe haber iniciado una transacción local.
Note
En esta versión, una operación de escritura en un solo LOB lectura podría realizarse correctamente, pero no actualiza en LOB el servidor. Sin embargo, en este caso, se actualiza la copia local de .LOB Por lo tanto, las operaciones de lectura posteriores en el OracleLob objeto podrían devolver los resultados de la operación de escritura.
El CopyTo método no borra el contenido del destino OracleLob antes de realizar la operación de copia.
