OracleLob.CopyTo Método

Definição

Namespace:: System.Data.OracleClient

Assembly:: System.Data.OracleClient.dll

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.

Copia isso OracleLob para um destino OracleLob.

Sobrecargas

Nome	Description
CopyTo(OracleLob)	Copia isso OracleLob para um destino OracleLob.
CopyTo(OracleLob, Int64)	Copia isso OracleLob para um destino OracleLob com a quantidade de dados especificada.
CopyTo(Int64, OracleLob, Int64, Int64)	Copia isso OracleLob para um destino OracleLob com a quantidade de dados especificada e o deslocamento de origem.

CopyTo(OracleLob)

Copia isso 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

Int64

O número de bytes copiados. Isso exclui todos os bytes acolchoados.

Exceções

ArgumentNullException

O OracleLob especificado no destination parâmetro é nulo.

InvalidOperationException

A operação não está dentro de uma transação, o OracleLob objeto é nulo ou a conexão é fechada.

OracleException

Ocorreu um erro do Oracle.

Comentários

Os tipos de dados subjacentes devem ser sempre 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 fim do deslocamento de LOB destino além do final é adicionado com zeros para BLOB tipos de dados e espaços para CLOB e NCLOB tipos de dados.

Para gravar no LOB, você deve ter recuperado o uso da LOB cláusula FOR UPDATE na instrução SQL SELECT e deve ter uma transação local iniciada.

Note

Nesta versão, uma operação de gravação para um somente LOB leitura pode ter êxito, mas não atualizar o LOB 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 isso 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 CLOB e NCLOB tipos de dados, isso deve ser um número par de bytes.

Retornos

Int64

O número de bytes copiados. Isso exclui todos os bytes acolchoados.

Exceções

ArgumentNullException

O OracleLob especificado no destination parâmetro está cheio.

ArgumentOutOfRangeException

Um valor especificado no destinationOffset parâmetro é menor que zero ou maior que 4 gigabytes.

- ou -

Um valor especificado no destinationOffset parâmetro para um CLOB ou NCLOB tipo de dados não é sequer.

- ou -

Você deve especificar CLOB e NCLOB tipos de dados como um número par de bytes.

InvalidOperationException

A operação não está dentro de uma transação, o OracleLob objeto é nulo ou a conexão é fechada.

OracleException

Ocorreu um erro do Oracle.

Comentários

Os tipos de dados subjacentes devem ser sempre 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 fim e destino além do final é adicionado com zeros para LOB tipos de dados e espaços para BLOB e CLOB tipos de NCLOB dados.

Para gravar no LOB, você deve ter recuperado o uso da LOB cláusula FOR UPDATE na instrução SQL SELECT e deve ter uma transação local iniciada.

Note

Nesta versão, uma operação de gravação para um somente LOB leitura pode ter êxito, mas não atualiza o LOB 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 isso OracleLob para um destino OracleLob com a quantidade de dados especificada 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 CLOB e NCLOB tipos de dados, esse deve ser um número par.

destination: OracleLob

O destino OracleLobSystem.Data.OracleClient.

destinationOffset: Int64

O deslocamento de destino para o qual copiar. Para CLOB e NCLOB tipos de dados, esse deve ser um número par.

amount: Int64

A quantidade de dados, em bytes, a ser copiada. Para CLOB e NCLOB tipos de dados, esse deve ser um número par.

Retornos

Int64

O número de bytes copiados. Isso exclui todos os bytes acolchoados.

Exceções

ArgumentNullException

O OracleLob especificado no destination parâmetro está cheio.

ArgumentOutOfRangeException

Um valor especificado no amountparâmetro , ou sourceOffset é destinationOffsetmenor que zero ou maior que 4 gigabytes.

- ou -

Um valor especificado no amountparâmetro , sourceOffsetou destinationOffset para um CLOB tipo de dados ou NCLOB não é sequer.

InvalidOperationException

A operação não está dentro de uma transação, o OracleLob objeto é nulo ou a conexão é fechada.

OracleException

Ocorreu um erro do Oracle.

Comentários

Os tipos de dados subjacentes devem ser sempre os mesmos. Por exemplo, se você estiver copiando de um NClob, o destino OracleLob também deverá ser um NClob.

Para gravar no LOB, você deve ter recuperado o uso da LOB cláusula FOR UPDATE na instrução SQL SELECT e deve ter uma transação local iniciada.

Note

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

Comentários

Esta página foi útil?