OracleLob.Erase Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.