Partager via

OracleLob.CopyTo Méthode

  • Référence

Définition

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

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

ArgumentNullException

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

InvalidOperationException

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

OracleException

Une erreur Oracle s'est produite.

Remarques

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

Si le décalage de destination est 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 du et le décalage de LOB destination au-delà de la fin est complété avec des zéros pour BLOB les types de données et les espaces pour CLOB les types de données et .NCLOB

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 une transaction locale démarrée.

Notes

Dans cette version, une opération d’écriture dans une lecture seule LOB peut réussir, mais pas mettre à jour sur LOB 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’objet OracleLob 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

ArgumentNullException

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

ArgumentOutOfRangeException

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.

InvalidOperationException

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

OracleException

Une erreur Oracle s'est produite.

Remarques

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

Si le décalage de destination est 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 et le décalage de LOB destination au-delà de la fin est complété avec des zéros pour BLOB les types de données et les espaces pour CLOB les types de données et .NCLOB

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 une transaction locale démarrée.

Notes

Dans cette version, une opération d’écriture dans une lecture seule LOB peut réussir, 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’objet OracleLob 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

OracleLob System.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

ArgumentNullException

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

ArgumentOutOfRangeException

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.

InvalidOperationException

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

OracleException

Une erreur Oracle s'est produite.

Remarques

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

Si le décalage de destination est 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 et le décalage de LOB destination au-delà de la fin est complété avec des zéros pour BLOB les types de données et les espaces pour CLOB les types de données et .NCLOB

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 une transaction locale démarrée.

Notes

Dans cette version, une opération d’écriture dans une lecture seule LOB peut réussir, 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’objet OracleLob 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 à