OracleLob.Erase 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.
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.