OracleLob.CopyTo Método

Definición

Realiza una copia de este objeto OracleLob en un objeto OracleLob de destino.Copies from this OracleLob to a destination OracleLob.

Sobrecargas

CopyTo(OracleLob)

Realiza una copia de este objeto OracleLob en un objeto OracleLob de destino.Copies from this OracleLob to a destination OracleLob.

CopyTo(OracleLob, Int64)

Copia datos de este objeto OracleLob en un objeto OracleLob de destino con la cantidad de datos especificada.Copies from this OracleLob to a destination OracleLob with the specified amount of data.

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.Copies from this OracleLob to a destination OracleLob with the specified amount of data, and the source offset.

CopyTo(OracleLob)

Realiza una copia de este objeto OracleLob en un objeto OracleLob de destino.Copies from this OracleLob to a destination OracleLob.

public:
 long CopyTo(System::Data::OracleClient::OracleLob ^ destination);
public long CopyTo (System.Data.OracleClient.OracleLob destination);
override this.CopyTo : System.Data.OracleClient.OracleLob -> int64
Public Function CopyTo (destination As OracleLob) As Long

Parámetros

destination
OracleLob

OracleLob de destino.The destination OracleLob.

Devoluciones

Número de bytes que se han copiado.The number of bytes copied. No se incluyen los bytes de relleno.This excludes any padded bytes.

Excepciones

El objeto OracleLob especificado en el parámetro destination es null.The OracleLob specified in the destination parameter is null.

La operación no está dentro de una transacción, el objeto OracleLob es null, o la conexión está cerrada.The operation is not within a transaction, the OracleLob object is null, or the connection is closed.

Se produjo un error de Oracle.An Oracle error has occurred.

Comentarios

Los tipos de datos subyacentes siempre deben ser iguales.The underlying data types must always be the same. Por ejemplo, si va a copiar desde un NClob, el destino OracleLob también debe ser NClob.For example, if you are copying from an NClob, the destination OracleLob must also be an NClob.

Si el desplazamiento de destino está más allá del final LOBdel destino LOB , se amplía el en el que se copian los datos.If the destination offset is beyond the end of destination LOB, the LOB to which the data is being copied is extended. El espacio que hay entre el final LOB del y el desplazamiento de destino más allá del final se rellena con BLOB ceros para tipos de datos CLOB y NCLOB espacios para tipos de datos y.The space between the end of the LOB and the destination offset beyond the end is padded with zeros for BLOB data types and spaces for CLOB and NCLOB data types.

Para escribir en LOB, debe haber LOB recuperado mediante la cláusula for Update en la instrucción SELECT de SQL y debe haber iniciado una transacción local.To write to the LOB, you must have retrieved the LOB using the FOR UPDATE clause in the SQL SELECT statement, and you must have a local transaction started.

Nota

En esta versión, una operación de escritura en un solo LOB lectura podría realizarse correctamente, pero no LOB actualizar en el servidor.In this release, a write operation to a read-only LOB might succeed, but not update the LOB on the server. Sin embargo, en este caso, se actualizará la LOB copia local de.In this case, however, the local copy of the LOB will be updated. Por lo tanto, las operaciones de OracleLob lectura posteriores en el objeto podrían devolver los resultados de la operación de escritura.Therefore, later read operations on the OracleLob object might return the results of the write operation.

El CopyTo método no borra el contenido del destino OracleLob antes de realizar la operación de copia.The CopyTo method does not clear the contents of the destination OracleLob before performing the copy operation.

CopyTo(OracleLob, Int64)

Copia datos de este objeto OracleLob en un objeto OracleLob de destino con la cantidad de datos especificada.Copies from this OracleLob to a destination OracleLob with the specified amount of data.

public:
 long CopyTo(System::Data::OracleClient::OracleLob ^ destination, long destinationOffset);
public long CopyTo (System.Data.OracleClient.OracleLob destination, long destinationOffset);
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.The destination OracleLob

destinationOffset
Int64

Posición de desplazamiento en la que se va a copiar.The offset to which to copy. Para los tipos de datos CLOB y NCLOB, debe ser un número par de bytes.For CLOB and NCLOB data types, this must be an even number of bytes.

Devoluciones

Número de bytes que se han copiado.The number of bytes copied. No se incluyen los bytes de relleno.This excludes any padded bytes.

Excepciones

El objeto OracleLob especificado en el parámetro destination es null.The OracleLob specified in the destination parameter is full.

Un valor especificado en el parámetro destinationOffset es menor que cero o mayor que 4 gigabytes.A value specified in the destinationOffset parameter is less than zero or greater than 4 gigabytes.

O bien-or- Un valor especificado en el parámetro destinationOffset para un tipo de datos CLOB o NCLOB no es par.A value specified in the destinationOffset parameter for a CLOB or NCLOB data type is not even.

O bien-or- Debe especificar los tipos de datos CLOB y NCLOB como un número par de bytes.You must specify CLOB and NCLOB data types as an even number of bytes.

La operación no está dentro de una transacción, el objeto OracleLob es null, o la conexión está cerrada.The operation is not within a transaction, the OracleLob object is null, or the connection is closed.

Se produjo un error de Oracle.An Oracle error has occurred.

Comentarios

Los tipos de datos subyacentes siempre deben ser iguales.The underlying data types must always be the same. Por ejemplo, si va a copiar desde un NClob, el destino OracleLob también debe ser NClob.For example, if you are copying from an NClob, the destination OracleLob must also be an NClob.

Si el desplazamiento de destino está más allá del final LOBdel destino LOB , se amplía el en el que se copian los datos.If the destination offset is beyond the end of destination LOB, the LOB to which the data is being copied is extended. El espacio que hay entre el LOB final y el desplazamiento de destino más allá del final se rellena BLOB con ceros para tipos de CLOB datos NCLOB y espacios para tipos de datos y.The space between the end of LOB and destination offset beyond the end is padded with zeros for BLOB data types and spaces for CLOB and NCLOB data types.

Para escribir en LOB, debe haber LOB recuperado mediante la cláusula for Update en la instrucción SELECT de SQL y debe haber iniciado una transacción local.To write to the LOB, you must have retrieved the LOB using the FOR UPDATE clause in the SQL SELECT statement, and you must have a local transaction started.

Nota

En esta versión, una operación de escritura en un solo LOB lectura puede realizarse correctamente, pero no LOB actualiza en el servidor.In this release, a write operation to a read-only LOB might succeed, but does not update the LOB on the server. Sin embargo, en este caso, LOB se actualiza la copia local de.In this case, however, the local copy of the LOB is updated. Por lo tanto, las operaciones de OracleLob lectura posteriores en el objeto podrían devolver los resultados de la operación de escritura.Therefore, later read operations on the OracleLob object might return the results of the write operation.

El CopyTo método no borra el contenido del destino OracleLob antes de realizar la operación de copia.The CopyTo method does not clear the contents of the destination OracleLob before performing the copy operation.

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.Copies from this OracleLob to a destination OracleLob with the specified amount of data, and the source offset.

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);
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.The offset from which to copy. Para los tipos de datos CLOB y NCLOB, debe ser un número par.For CLOB and NCLOB data types, this must be an even number.

destination
OracleLob

El destino OracleLobSystem.Data.OracleClient.The destination OracleLobSystem.Data.OracleClient.

destinationOffset
Int64

Posición de desplazamiento de destino en la que se va a copiar.The destination offset to which to copy. Para los tipos de datos CLOB y NCLOB, debe ser un número par.For CLOB and NCLOB data types, this must be an even number.

amount
Int64

Cantidad de datos, en bytes que se va a copiar.The quantity of data, in bytes, to copy. Para los tipos de datos CLOB y NCLOB, debe ser un número par.For CLOB and NCLOB data types, this must be an even number.

Devoluciones

Número de bytes que se han copiado.The number of bytes copied. No se incluyen los bytes de relleno.This excludes any padded bytes.

Excepciones

El objeto OracleLob especificado en el parámetro destination es null.The OracleLob specified in the destination parameter is full.

Un valor especificado en el parámetro amount, sourceOffset o destinationOffset es menor que cero o mayor que 4 gigabytes.A value specified in the amount, sourceOffset, or destinationOffset parameter is less than zero or greater than 4 gigabytes.

O bien-or- Un valor especificado en el parámetro amount, sourceOffset o destinationOffset para un tipo de datos CLOB o NCLOB no es par.A value specified in the amount, sourceOffset, or destinationOffset parameter for a CLOB or NCLOB data type is not even.

La operación no está dentro de una transacción, el objeto OracleLob es null, o la conexión está cerrada.The operation is not within a transaction, the OracleLob object is null, or the connection is closed.

Se produjo un error de Oracle.An Oracle error has occurred.

Comentarios

Los tipos de datos subyacentes siempre deben ser iguales.The underlying data types must always be the same. Por ejemplo, si va a copiar desde un NClob, el destino OracleLob también debe ser NClob.For example, if you are copying from an NClob, the destination OracleLob must also be an NClob.

Si el desplazamiento de destino está más allá del final LOBdel destino LOB , se amplía el en el que se copian los datos.If the destination offset is beyond the end of destination LOB, the LOB to which the data is being copied is extended. El espacio que hay entre el LOB final y el desplazamiento de destino más allá del final se rellena BLOB con ceros para tipos de CLOB datos NCLOB y espacios para tipos de datos y.The space between the end of LOB and destination offset beyond the end is padded with zeros for BLOB data types and spaces for CLOB and NCLOB data types.

Para escribir en LOB, debe haber LOB recuperado mediante la cláusula for Update en la instrucción SELECT de SQL y debe haber iniciado una transacción local.To write to the LOB, you must have retrieved the LOB using the FOR UPDATE clause in the SQL SELECT statement, and you must have a local transaction started.

Nota

En esta versión, una operación de escritura en un solo LOB lectura puede realizarse correctamente, pero no LOB actualiza en el servidor.In this release, a write operation to a read-only LOB might succeed, but does not update the LOB on the server. Sin embargo, en este caso, LOB se actualiza la copia local de.In this case, however, the local copy of the LOB is updated. Por lo tanto, las operaciones de OracleLob lectura posteriores en el objeto podrían devolver los resultados de la operación de escritura.Therefore, later read operations on the OracleLob object might return the results of the write operation.

El CopyTo método no borra el contenido del destino OracleLob antes de realizar la operación de copia.The CopyTo method does not clear the contents of the destination OracleLob before performing the copy operation.

Se aplica a