OracleLob.CopyTo Méthode

Définition

Copie de OracleLob vers un OracleLob de destination.

Surcharges

CopyTo(OracleLob)

Copie de OracleLob vers un OracleLob de destination.

CopyTo(OracleLob, Int64)

Copie les données de l'objet OracleLob vers un objet OracleLob de destination avec la quantité de données spécifiée.

CopyTo(Int64, OracleLob, Int64, Int64)

Copie de cet objet OracleLob vers l'objet OracleLob de destination avec la quantité de données spécifiée et l'offset source.

CopyTo(OracleLob)

Copie de OracleLob vers un OracleLob de destination.

public:
 long CopyTo(System::Data::OracleClient::OracleLob ^ destination);
public long CopyTo (System.Data.OracleClient.OracleLob destination);
member this.CopyTo : System.Data.OracleClient.OracleLob -> int64
override this.CopyTo : System.Data.OracleClient.OracleLob -> int64
Public Function CopyTo (destination As OracleLob) As Long

Paramètres

destination
OracleLob

OracleLob de destination.

Retours

Int64

Nombre d'octets copiés. Les octets remplis sont exclus.

Exceptions

Le OracleLob spécifié dans le paramètre destination est null.

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

Une erreur Oracle s'est produite.

Remarques

Les types de données sous-jacents doivent toujours être identiques. Par exemple, si vous copiez à partir d’un NClob , la destination OracleLob doit également être un NClob .

Si le décalage de destination se situe au-delà de la fin de la destination LOB , le LOB vers lequel les données sont copiées est étendu. L’espace entre la fin de LOB et le décalage de destination au-delà de la fin est complété avec des zéros pour les types de données et les BLOB espaces pour les types de données CLOB et NCLOB .

pour écrire dans le LOB , vous devez avoir récupéré le LOB à l’aide de la clause FOR UPDATE dans l’instruction SELECT SQL, et vous devez avoir démarré une transaction locale.

Notes

Dans cette version, une opération d’écriture dans un en lecture seule LOB peut échouer, mais ne pas mettre à jour le LOB sur le serveur. Dans ce cas, toutefois, la copie locale du LOB sera mise à jour. Par conséquent, les opérations de lecture ultérieures sur l' OracleLob objet peuvent retourner les résultats de l’opération d’écriture.

La CopyTo méthode n’efface pas le contenu de la destination OracleLob avant d’effectuer l’opération de copie.

S’applique à

CopyTo(OracleLob, Int64)

Copie les données de l'objet OracleLob vers un objet OracleLob de destination avec la quantité de données spécifiée.

public:
 long CopyTo(System::Data::OracleClient::OracleLob ^ destination, long destinationOffset);
public long CopyTo (System.Data.OracleClient.OracleLob destination, long destinationOffset);
member this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64
override this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64
Public Function CopyTo (destination As OracleLob, destinationOffset As Long) As Long

Paramètres

destination
OracleLob

OracleLob de destination.

destinationOffset
Int64

L'offset auquel la copie doit être effectuée. Pour les types de données CLOB et NCLOB, il doit s'agir d'un nombre d'octets.

Retours

Int64

Nombre d'octets copiés. Les octets remplis sont exclus.

Exceptions

Le OracleLob spécifié dans le paramètre destination est complet.

Une valeur spécifiée dans le paramètre destinationOffset est inférieure à zéro ou supérieure à 4 giga-octets.

  • ou - Une valeur spécifiée dans le paramètre destinationOffset pour un type de données CLOB ou NCLOB n'est pas paire.

  • ou - Vous devez spécifier les types de données CLOB et NCLOB en tant que nombre d'octets pair.

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

Une erreur Oracle s'est produite.

Remarques

Les types de données sous-jacents doivent toujours être identiques. Par exemple, si vous copiez à partir d’un NClob , la destination OracleLob doit également être un NClob .

Si le décalage de destination se situe au-delà de la fin de la destination LOB , le LOB vers lequel les données sont copiées est étendu. L’espace entre la fin de LOB et l’offset de destination au-delà de la fin est complété par des zéros pour les types de données et les BLOB espaces pour les CLOB types de NCLOB données et.

pour écrire dans le LOB , vous devez avoir récupéré le LOB à l’aide de la clause FOR UPDATE dans l’instruction SELECT SQL, et vous devez avoir démarré une transaction locale.

Notes

Dans cette version, une opération d’écriture dans un en lecture seule LOB peut échouer, mais ne met pas à jour le LOB sur 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' OracleLob objet peuvent retourner les résultats de l’opération d’écriture.

La CopyTo méthode n’efface pas le contenu de la destination OracleLob avant d’effectuer l’opération de copie.

S’applique à

CopyTo(Int64, OracleLob, Int64, Int64)

Copie de cet objet OracleLob vers l'objet OracleLob de destination avec la quantité de données spécifiée et l'offset source.

public:
 long CopyTo(long sourceOffset, System::Data::OracleClient::OracleLob ^ destination, long destinationOffset, long amount);
public long CopyTo (long sourceOffset, System.Data.OracleClient.OracleLob destination, long destinationOffset, long amount);
member this.CopyTo : int64 * System.Data.OracleClient.OracleLob * int64 * int64 -> int64
override this.CopyTo : int64 * System.Data.OracleClient.OracleLob * int64 * int64 -> int64
Public Function CopyTo (sourceOffset As Long, destination As OracleLob, destinationOffset As Long, amount As Long) As Long

Paramètres

sourceOffset
Int64

L'offset à partir duquel la copie doit être effectuée. Pour les types de données CLOB et NCLOB, il doit s'agir d'un nombre pair.

destination
OracleLob

OracleLobSystem.Data.OracleClient de destination.

destinationOffset
Int64

L'offset de destination vers lequel la copie doit être effectuée. 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, à copier. Pour les types de données CLOB et NCLOB, il doit s'agir d'un nombre pair.

Retours

Int64

Nombre d'octets copiés. Les octets remplis sont exclus.

Exceptions

Le OracleLob spécifié dans le paramètre destination est complet.

Une valeur spécifiée dans le paramètre amount, sourceOffset ou destinationOffset est inférieure à zéro ou supérieure à 4 giga-octets.

  • ou - Une valeur spécifiée dans le paramètre amount, sourceOffset ou destinationOffset pour un type de données CLOB ou NCLOBn'est pas paire.

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

Une erreur Oracle s'est produite.

Remarques

Les types de données sous-jacents doivent toujours être identiques. Par exemple, si vous copiez à partir d’un NClob , la destination OracleLob doit également être un NClob .

Si le décalage de destination se situe au-delà de la fin de la destination LOB , le LOB vers lequel les données sont copiées est étendu. L’espace entre la fin de LOB et l’offset de destination au-delà de la fin est complété par des zéros pour les types de données et les BLOB espaces pour les CLOB types de NCLOB données et.

pour écrire dans le LOB , vous devez avoir récupéré le LOB à l’aide de la clause FOR UPDATE dans l’instruction SELECT SQL, et vous devez avoir démarré une transaction locale.

Notes

Dans cette version, une opération d’écriture dans un en lecture seule LOB peut échouer, mais ne met pas à jour le LOB sur 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' OracleLob objet peuvent retourner les résultats de l’opération d’écriture.

La CopyTo méthode n’efface pas le contenu de la destination OracleLob avant d’effectuer l’opération de copie.

S’applique à