Compartilhar via


OracleLob.Erase Método

Definição

Apaga dados deste OracleLob.

Sobrecargas

Nome Description
Erase()

Apaga todos os dados deste OracleLob.

Erase(Int64, Int64)

Apaga a quantidade especificada de dados 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

Retornos

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 conexão é fechada.

O objeto foi fechado ou descartado.

Ocorreu um erro do Oracle.

Comentários

Erase não trunca dados. O LOB comprimento permanece o mesmo para um BLOB tipo de dados 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 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.

Observação

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.

Aplica-se a

Erase(Int64, Int64)

Apaga a quantidade especificada de dados 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 do qual apagar. Para CLOB e NCLOB tipos de dados, esse deve ser um número par.

amount
Int64

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

Retornos

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 conexão é fechada.

O objeto foi fechado ou descartado.

Ocorreu um erro do Oracle.

Comentários

A soma dos valores e dos offsetamount parâmetros pode ser maior que a do tamanho do OracleLob. Portanto, especificar um valor maior do que o Length retornado pela propriedade é bem-sucedido; no entanto Erase , apenas apaga até o final do OracleLob. (Da mesma forma, se um valor negativo for passado para offset, Erase será bem-sucedido, mas apenas apagará a partir do início do OracleLob.) Esse comportamento é diferente do dos métodos e dos Read métodos e oferece a vantagem de poder apagar todos os dados do valor especificado offset sem fazer uma viagem de ida e Write volta adicional ao servidor para verificar o tamanho real.

Erase não trunca dados. O LOB comprimento permanece o mesmo para um BLOB tipo de dados 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 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.

Observação

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.

Aplica-se a