OracleLob.Erase Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Efface des données dans OracleLob.
Surcharges
Erase() |
Efface toutes les données de OracleLob. |
Erase(Int64, Int64) |
Efface la quantité de données spécifiée dans OracleLob. |
Erase()
Efface toutes les données de OracleLob.
public:
long Erase();
public long Erase ();
member this.Erase : unit -> int64
Public Function Erase () As Long
Retours
Nombre d'octets effacés.
Exceptions
L'opération ne fait pas partie d'une transaction, l'objet OracleLob est de type null ou la connexion est fermée.
L'objet était fermé ou supprimé.
Une erreur Oracle s'est produite.
Remarques
Erase ne tronque pas les données. La LOB
longueur reste la même pour un BLOB
type de données, et les données effacées sont remplacées par 0x00.
CLOB
et NCLOB
les types de données sont remplacés par des espaces.
Pour écrire dans , LOB
vous devez avoir récupéré le à l’aide de LOB
la clause FOR UPDATE dans l’instruction SQL SELECT, et vous devez avoir démarré une transaction locale.
Notes
Dans cette version, une opération d’écriture dans une lecture seule LOB
peut réussir, mais ne met pas à jour sur LOB
le serveur. Dans ce cas, toutefois, la copie locale du LOB
est mise à jour. Par conséquent, les opérations de lecture ultérieures sur l’objet OracleLob peuvent retourner les résultats de l’opération d’écriture.
S’applique à
Erase(Int64, Int64)
Efface la quantité de données spécifiée dans 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
Paramètres
- offset
- Int64
L'offset à partir duquel effacer. Pour les types de données CLOB
et NCLOB
, il doit s'agir d'un nombre pair.
- amount
- Int64
Quantité de données, en octets, à effacer. Pour les types de données CLOB
et NCLOB
, il doit s'agir d'un nombre pair.
Retours
Nombre d'octets effacés.
Exceptions
L'opération ne fait pas partie d'une transaction, l'objet OracleLob est de type null ou la connexion est fermée.
L'objet était fermé ou supprimé.
Une erreur Oracle s'est produite.
Remarques
La somme des valeurs dans les offset
paramètres et amount
peut être supérieure à celle de la taille du OracleLob. Par conséquent, la spécification d’une valeur supérieure à celle retournée par la Length propriété réussit ; toutefoisErase, n’efface qu’à la fin de .OracleLob (De même, si une valeur négative est passée à offset
, Erase réussit, mais ne s’efface qu’à partir du début du OracleLob.) Ce comportement est différent de celui des Read méthodes et Write et et offre l’avantage de pouvoir effacer toutes les données de la valeur spécifiée offset
sans effectuer d’aller-retour supplémentaire au serveur pour vérifier la taille réelle.
Erase ne tronque pas les données. La LOB
longueur reste la même pour un BLOB
type de données, et les données effacées sont remplacées par 0x00.
CLOB
et NCLOB
les types de données sont remplacés par des espaces.
Pour écrire dans , LOB
vous devez avoir récupéré le à l’aide de LOB
la clause FOR UPDATE dans l’instruction SQL SELECT, et vous devez avoir démarré une transaction locale.
Notes
Dans cette version, une opération d’écriture dans une lecture seule LOB
peut réussir, mais ne met pas à jour sur LOB
le serveur. Dans ce cas, toutefois, la copie locale du LOB
est mise à jour. Par conséquent, les opérations de lecture ultérieures sur l’objet OracleLob peuvent retourner les résultats de l’opération d’écriture.