OracleLob.Erase Méthode

  • Référence

Définition

Espace de noms:
System.Data.OracleClient
Assembly:
System.Data.OracleClient.dll

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

Int64

Nombre d'octets effacés.

Exceptions

InvalidOperationException

L'opération ne fait pas partie d'une transaction, l'objet OracleLob est de type null ou la connexion est fermée.

ObjectDisposedException

L'objet était fermé ou supprimé.

OracleException

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 , LOBvous 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

Int64

Nombre d'octets effacés.

Exceptions

InvalidOperationException

L'opération ne fait pas partie d'une transaction, l'objet OracleLob est de type null ou la connexion est fermée.

ObjectDisposedException

L'objet était fermé ou supprimé.

OracleException

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 , LOBvous 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 à