OracleLob.Erase Método

Definição

Apaga dados deste OracleLob.

Sobrecargas

Name Description
Erase()

Apaga todos os dados deste OracleLob.

Erase(Int64, Int64)

Apaga a quantidade de dados especificada deste OracleLob.

Erase()

Apaga todos os dados deste OracleLob.

public:
 long Erase();
public long Erase();
member this.Erase : unit -> int64
Public Function Erase () As Long

Devoluções

O número de bytes apagados.

Exceções

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

O objeto foi fechado ou descartado.

Ocorreu um erro da Oracle.

Observações

Erase não trunca os dados. O LOB comprimento mantém-se igual para um BLOB tipo de dado, e os dados apagados são substituídos por 0x00. CLOB e NCLOB os tipos de dados são substituídos por espaços.

Para escrever no LOB, deve ter recuperado usando LOB a 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 escrita para um modo só LOB leitura pode ter sucesso, mas não atualiza o LOB no servidor. Neste caso, no entanto, a cópia local do LOB é atualizada. Portanto, operações de leitura posteriores no OracleLob objeto podem devolver os resultados da operação de escrita.

Aplica-se a

Erase(Int64, Int64)

Apaga a quantidade de dados especificada deste OracleLob.

public:
 long Erase(long offset, long amount);
public long Erase(long offset, long amount);
member this.Erase : int64 * int64 -> int64
Public Function Erase (offset As Long, amount As Long) As Long

Parâmetros

offset
Int64

O deslocamento a partir do qual apagar. Para CLOB os tipos de dados e, NCLOB este deve ser um número par.

amount
Int64

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

Devoluções

O número de bytes apagados.

Exceções

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

O objeto foi fechado ou descartado.

Ocorreu um erro da Oracle.

Observações

A soma dos valores nos offset parâmetros e amount pode ser maior do que a do tamanho do OracleLob. Portanto, especificar um valor superior ao devolvido pela Length propriedade tem sucesso; no entanto Erase , apenas apaga até ao fim do OracleLob. (De forma semelhante, se um valor negativo for passado para offset, Erase terá sucesso, mas só apagará a partir do início do OracleLob.) Este comportamento é diferente do Read dos métodos and Write e oferece a vantagem de poder apagar todos os dados do valor especificado por offset sem fazer uma viagem adicional de ida e volta ao servidor para verificar o tamanho real.

Erase não trunca os dados. O LOB comprimento mantém-se igual para um BLOB tipo de dado, e os dados apagados são substituídos por 0x00. CLOB e NCLOB os tipos de dados são substituídos por espaços.

Para escrever no LOB, deve ter recuperado usando LOB a 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 escrita para um modo só LOB leitura pode ter sucesso, mas não atualiza o LOB no servidor. Neste caso, no entanto, a cópia local do LOB é atualizada. Portanto, operações de leitura posteriores no OracleLob objeto podem devolver os resultados da operação de escrita.

Aplica-se a