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
| 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)
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 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)
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
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)
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 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.
