Partilhar via


OracleLob.CopyTo Método

Definição

Copia deste OracleLob para um destino OracleLob.

Sobrecargas

CopyTo(OracleLob)

Copia deste OracleLob para um destino 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)

Copia deste OracleLob para um destino OracleLob.

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

O OracleLob de destino.

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)

Copia deste OracleLob para um destino OracleLob com a quantidade de dados 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

O OracleLob de destino.

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)

Copia deste OracleLob para um destino OracleLob com a quantidade especificada de dados e o deslocamento de origem.

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

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.

Aplica-se a