Compartir a través de


OracleLob.CopyTo Método

Definición

Realiza una copia de este objeto OracleLob en un objeto OracleLob de destino.

Sobrecargas

CopyTo(OracleLob)

Realiza una copia de este objeto OracleLob en un objeto OracleLob de destino.

CopyTo(OracleLob, Int64)

Copia datos de este objeto OracleLob en un objeto OracleLob de destino con la cantidad de datos especificada.

CopyTo(Int64, OracleLob, Int64, Int64)

Realiza una copia desde este objeto OracleLob en un objeto OracleLob de destino con la cantidad de datos especificada, y la posición de desplazamiento de origen.

CopyTo(OracleLob)

Realiza una copia de este objeto OracleLob en un objeto OracleLob de destino.

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

Parámetros

destination
OracleLob

OracleLob de destino.

Devoluciones

Número de bytes que se han copiado. No se incluyen los bytes de relleno.

Excepciones

El objeto OracleLob especificado en el parámetro destination es null.

La operación no está dentro de una transacción, el objeto OracleLob es null, o la conexión está cerrada.

Se produjo 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 de 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 y NCLOB los tipos de datos.

Para escribir en LOB, debe haber recuperado mediante LOB la cláusula FOR UPDATE en la instrucción SQL SELECT y debe haber iniciado una transacción local.

Nota

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)

Copia datos de este objeto OracleLob en un objeto OracleLob de destino con la cantidad de datos especificada.

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

Parámetros

destination
OracleLob

OracleLob de destino.

destinationOffset
Int64

Posición de desplazamiento en la que se va a copiar. Para los tipos de datos CLOB y NCLOB, debe ser un número par de bytes.

Devoluciones

Número de bytes que se han copiado. No se incluyen los bytes de relleno.

Excepciones

El objeto OracleLob especificado en el parámetro destination es null.

Un valor especificado en el parámetro destinationOffset es menor que cero o mayor que 4 gigabytes.

o bien

Un valor especificado en el parámetro destinationOffset para un tipo de datos CLOB o NCLOB no es par.

o bien

Debe especificar los tipos de datos CLOB y NCLOB como un número par de bytes.

La operación no está dentro de una transacción, el objeto OracleLob es null, o la conexión está cerrada.

Se produjo 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 destino más allá del final se rellena con ceros para BLOB los tipos de LOB datos y los espacios para CLOB y NCLOB los tipos de datos.

Para escribir en LOB, debe haber recuperado mediante LOB la cláusula FOR UPDATE en la instrucción SQL SELECT y debe haber iniciado una transacción local.

Nota

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)

Realiza una copia desde este objeto OracleLob en un objeto OracleLob de destino con la cantidad de datos especificada, y la posición de desplazamiento de origen.

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

Parámetros

sourceOffset
Int64

Desplazamiento del que se va a copiar. Para los tipos de datos CLOB y NCLOB, debe ser un número par.

destination
OracleLob

El destino OracleLobSystem.Data.OracleClient.

destinationOffset
Int64

Posición de desplazamiento de destino en la que se va a copiar. Para los tipos de datos CLOB y NCLOB, debe ser un número par.

amount
Int64

Cantidad de datos, en bytes que se va a copiar. Para los tipos de datos CLOB y NCLOB, debe ser un número par.

Devoluciones

Número de bytes que se han copiado. No se incluyen los bytes de relleno.

Excepciones

El objeto OracleLob especificado en el parámetro destination es null.

Un valor especificado en el parámetro amount, sourceOffset o destinationOffset es menor que cero o mayor que 4 gigabytes.

o bien

Un valor especificado en el parámetro amount, sourceOffset o destinationOffset para un tipo de datos CLOB o NCLOB no es par.

La operación no está dentro de una transacción, el objeto OracleLob es null, o la conexión está cerrada.

Se produjo 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 destino más allá del final se rellena con ceros para BLOB los tipos de LOB datos y los espacios para CLOB y NCLOB los tipos de datos.

Para escribir en LOB, debe haber recuperado mediante LOB la cláusula FOR UPDATE en la instrucción SQL SELECT y debe haber iniciado una transacción local.

Nota

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