OracleLob.CopyTo 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.
Surcharges
| CopyTo(OracleLob) | |
| 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)
public:
long CopyTo(System::Data::OracleClient::OracleLob ^ destination);public long CopyTo (System.Data.OracleClient.OracleLob destination);member this.CopyTo : System.Data.OracleClient.OracleLob -> int64override this.CopyTo : System.Data.OracleClient.OracleLob -> int64Public Function CopyTo (destination As OracleLob) As LongParamètres
Retours
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 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)
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 -> int64override this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64Public Function CopyTo (destination As OracleLob, destinationOffset As Long) As LongParamètres
- 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
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 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)
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 -> int64override this.CopyTo : int64 * System.Data.OracleClient.OracleLob * int64 * int64 -> int64Public Function CopyTo (sourceOffset As Long, destination As OracleLob, destinationOffset As Long, amount As Long) As LongParamè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
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 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.
