OracleLob.CopyTo Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| CopyTo(OracleLob) | |
| CopyTo(OracleLob, Int64) |
Copia deste OracleLob para um destino OracleLob com a quantidade de dados especificada. |
| CopyTo(Int64, OracleLob, Int64, Int64) |
Copia deste OracleLob para um destino OracleLob com a quantidade especificada de dados e o deslocamento de origem. |
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
Retornos
O número de bytes copiados. Isso exclui todos os bytes preenchidos.
Exceções
O OracleLob especificado no parâmetro destination é nulo.
A operação não está em uma transação, o objeto OracleLob é nulo ou a conexão é fechada.
Ocorreu um erro do Oracle.
Comentários
Os tipos de dados subjacentes sempre devem ser os mesmos. Por exemplo, se você estiver copiando de um NClob, o destino OracleLob também deverá ser um NClob.
Se o deslocamento de destino estiver além do final do destino LOB, o para o LOB qual os dados estão sendo copiados será estendido. O espaço entre o final do e o deslocamento de LOB destino além do final é preenchido com zeros para BLOB tipos de dados e espaços para CLOB tipos de dados e NCLOB .
Para gravar no LOB, você deve ter recuperado o usando a LOB cláusula FOR UPDATE na instrução SQL SELECT e deve ter uma transação local iniciada.
Observação
Nesta versão, uma operação de gravação em um somente LOB leitura pode ter êxito, mas não atualizar o LOB no servidor. Nesse caso, no entanto, a cópia local do LOB será atualizada. Portanto, operações de leitura posteriores no OracleLob objeto podem retornar os resultados da operação de gravação.
O CopyTo método não limpa o conteúdo do destino OracleLob antes de executar a operação de cópia.
Aplica-se 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
O deslocamento para o qual copiar. Para os tipos de dados CLOB e NCLOB, isso deve ser um número par de bytes.
Retornos
O número de bytes copiados. Isso exclui todos os bytes preenchidos.
Exceções
O OracleLob especificado no parâmetro destination é está cheio.
Um valor especificado no parâmetro destinationOffset é menor que zero ou maior que 4 gigabytes.
- ou -
Um valor especificado no parâmetro destinationOffset para um tipo de dados CLOB ou NCLOB não é par.
- ou -
Você deve especificar os tipos de dados CLOB e NCLOB como um número par de bytes.
A operação não está em uma transação, o objeto OracleLob é nulo ou a conexão é fechada.
Ocorreu um erro do Oracle.
Comentários
Os tipos de dados subjacentes sempre devem ser os mesmos. Por exemplo, se você estiver copiando de um NClob, o destino OracleLob também deverá ser um NClob.
Se o deslocamento de destino estiver além do final do destino LOB, o para o LOB qual os dados estão sendo copiados será estendido. O espaço entre o deslocamento de LOB fim e destino além do final é preenchido com zeros para BLOB tipos de dados e espaços para CLOB tipos de dados e NCLOB .
Para gravar no LOB, você deve ter recuperado o usando a LOB cláusula FOR UPDATE na instrução SQL SELECT e deve ter uma transação local iniciada.
Observação
Nesta versão, uma operação de gravação em um somente LOB leitura pode ter êxito, mas não atualiza o LOB no servidor. Nesse caso, no entanto, a cópia local do LOB é atualizada. Portanto, operações de leitura posteriores no OracleLob objeto podem retornar os resultados da operação de gravação.
O CopyTo método não limpa o conteúdo do destino OracleLob antes de executar a operação de cópia.
Aplica-se 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
O deslocamento do qual copiar. Para os tipos de dados CLOB e NCLOB, isso deve ser um número par.
- destination
- OracleLob
O OracleLobSystem.Data.OracleClient de destino.
- destinationOffset
- Int64
O deslocamento de destino a ser copiado. Para os tipos de dados CLOB e NCLOB, isso deve ser um número par.
- amount
- Int64
A quantidade de dados, em bytes, a serem copiados. Para os tipos de dados CLOB e NCLOB, isso deve ser um número par.
Retornos
O número de bytes copiados. Isso exclui todos os bytes preenchidos.
Exceções
O OracleLob especificado no parâmetro destination é está cheio.
Um valor especificado no parâmetro amount, sourceOffset ou destinationOffset é menor que zero ou maior que 4 gigabytes.
- ou -
Um valor especificado no parâmetro amount, sourceOffset ou destinationOffset para um tipo de dados CLOB ou NCLOB não é par.
A operação não está em uma transação, o objeto OracleLob é nulo ou a conexão é fechada.
Ocorreu um erro do Oracle.
Comentários
Os tipos de dados subjacentes sempre devem ser os mesmos. Por exemplo, se você estiver copiando de um NClob, o destino OracleLob também deverá ser um NClob.
Se o deslocamento de destino estiver além do final do destino LOB, o para o LOB qual os dados estão sendo copiados será estendido. O espaço entre o deslocamento de LOB fim e destino além do final é preenchido com zeros para BLOB tipos de dados e espaços para CLOB tipos de dados e NCLOB .
Para gravar no LOB, você deve ter recuperado o usando a LOB cláusula FOR UPDATE na instrução SQL SELECT e deve ter uma transação local iniciada.
Observação
Nesta versão, uma operação de gravação em um somente LOB leitura pode ter êxito, mas não atualiza o LOB no servidor. Nesse caso, no entanto, a cópia local do LOB é atualizada. Portanto, operações de leitura posteriores no OracleLob objeto podem retornar os resultados da operação de gravação.
O CopyTo método não limpa o conteúdo do destino OracleLob antes de executar a operação de cópia.
