OracleLob.Erase Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Consente di cancellare i dati da questo oggetto OracleLob.
Overload
| Erase() |
Consente di cancellare tutti i dati da questo oggetto OracleLob. |
| Erase(Int64, Int64) |
Consente di cancellare la quantità specificata di dati da questo oggetto OracleLob. |
Erase()
Consente di cancellare tutti i dati da questo oggetto OracleLob.
public:
long Erase();public long Erase ();member this.Erase : unit -> int64Public Function Erase () As LongRestituisce
Numero di byte cancellati.
Eccezioni
L'operazione non è presente all'interno di una transazione, l'oggetto OracleLob è null oppure la connessione è chiusa.
L'oggetto è stato chiuso o eliminato.
Si è verificato un errore Oracle.
Commenti
Erase non tronca i dati. La LOB lunghezza rimane invariata per un BLOB tipo di dati e i dati cancellati vengono sostituiti da 0x00.
CLOB e NCLOB i tipi di dati vengono sostituiti da spazi.
Per scrivere in LOB, è necessario aver recuperato la LOB clausola FOR UPDATE nell'istruzione SQL SELECT e è necessario avviare una transazione locale.
Nota
In questa versione un'operazione di scrittura in una sola lettura LOB potrebbe avere esito positivo, ma non aggiorna l'oggetto LOB nel server. In questo caso, tuttavia, la copia locale dell'oggetto LOB viene aggiornata. Pertanto, le operazioni di lettura successive sull'oggetto OracleLob potrebbero restituire i risultati dell'operazione di scrittura.
Si applica a
Erase(Int64, Int64)
Consente di cancellare la quantità specificata di dati da questo oggetto OracleLob.
public:
long Erase(long offset, long amount);public long Erase (long offset, long amount);member this.Erase : int64 * int64 -> int64Public Function Erase (offset As Long, amount As Long) As LongParametri
- offset
- Int64
Offset da cui cancellare. Per i tipi di dati CLOB e NCLOB, deve trattarsi di un numero pari.
- amount
- Int64
Quantità di dati in byte da cancellare. Per i tipi di dati CLOB e NCLOB, deve trattarsi di un numero pari.
Restituisce
Numero di byte cancellati.
Eccezioni
L'operazione non è presente all'interno di una transazione, l'oggetto OracleLob è null oppure la connessione è chiusa.
L'oggetto è stato chiuso o eliminato.
Si è verificato un errore Oracle.
Commenti
La somma dei valori nei offset parametri e amount può essere maggiore di quella delle dimensioni dell'oggetto OracleLob. Pertanto, specificando un valore maggiore di quello restituito dalla Length proprietà ha esito positivo; tuttavia Erase , cancella solo alla fine dell'oggetto OracleLob. Analogamente, se un valore negativo viene passato a offset, Erase avrà esito positivo, ma solo cancellare a partire dall'inizio di OracleLob.) Questo comportamento è diverso da quello dei Read metodi e Write e offre il vantaggio di poter cancellare tutti i dati dal valore specificato offset senza effettuare un giro di ritorno aggiuntivo al server per verificare le dimensioni effettive.
Erase non tronca i dati. La LOB lunghezza rimane invariata per un BLOB tipo di dati e i dati cancellati vengono sostituiti da 0x00.
CLOB e NCLOB i tipi di dati vengono sostituiti da spazi.
Per scrivere in LOB, è necessario aver recuperato la LOB clausola FOR UPDATE nell'istruzione SQL SELECT e è necessario avviare una transazione locale.
Nota
In questa versione un'operazione di scrittura in una sola lettura LOB potrebbe avere esito positivo, ma non aggiorna l'oggetto LOB nel server. In questo caso, tuttavia, la copia locale dell'oggetto LOB viene aggiornata. Pertanto, le operazioni di lettura successive sull'oggetto OracleLob potrebbero restituire i risultati dell'operazione di scrittura.
