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 les données de ce OracleLob.
Surcharges
| Nom | Description |
|---|---|
| Erase() |
Efface toutes les données de ce OracleLob. |
| Erase(Int64, Int64) |
Efface la quantité de données spécifiée de ce OracleLob. |
Erase()
Efface toutes les données de ce 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 n’est pas dans une transaction, l’objet a la OracleLob valeur Null ou la connexion est fermée.
L’objet a été 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 le LOBfichier , vous devez avoir récupéré la LOB clause FOR UPDATE dans l’instruction SQL SELECT, et vous devez avoir démarré une transaction locale.
Note
Dans cette version, une opération d’écriture dans une lecture seule LOB peut réussir, mais ne met pas à jour le LOB serveur. Dans ce cas, toutefois, la copie locale du fichier LOB est mise à jour. Par conséquent, les opérations de lecture ultérieures sur l’objet OracleLob peuvent renvoyer les résultats de l’opération d’écriture.
S’applique à
Erase(Int64, Int64)
Efface la quantité de données spécifiée de ce 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
Décalage à partir duquel effacer. Pour les types de données et NCLOB pour CLOB les types de données, il doit s’agir d’un nombre pair.
- amount
- Int64
Quantité de données, en octets, à effacer. Pour les types de données et NCLOB pour CLOB les types de données, il doit s’agir d’un nombre pair.
Retours
Nombre d’octets effacés.
Exceptions
L’opération n’est pas dans une transaction, l’objet a la OracleLob valeur Null ou la connexion est fermée.
L’objet a été fermé ou supprimé.
Une erreur Oracle s’est produite.
Remarques
La somme des valeurs dans les offset paramètres peut amount être supérieure à celle de la OracleLobtaille du . Par conséquent, la spécification d’une valeur supérieure à celle retournée par la Length propriété réussit ; toutefois Erase , elle s’efface uniquement à la fin du OracleLob. (De même, si une valeur négative est passée à offset, Erase réussit, mais efface uniquement à partir du début du OracleLob.) Ce comportement est différent de celui des Read méthodes et Write offre l’avantage d’être en mesure d’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 le LOBfichier , vous devez avoir récupéré la LOB clause FOR UPDATE dans l’instruction SQL SELECT, et vous devez avoir démarré une transaction locale.
Note
Dans cette version, une opération d’écriture dans une lecture seule LOB peut réussir, mais ne met pas à jour le LOB serveur. Dans ce cas, toutefois, la copie locale du fichier LOB est mise à jour. Par conséquent, les opérations de lecture ultérieures sur l’objet OracleLob peuvent renvoyer les résultats de l’opération d’écriture.