OracleLob.CopyTo Méthode

Définition

Espace de noms:: System.Data.OracleClient

Assembly:: System.Data.OracleClient.dll

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.

Copie de ceci OracleLob vers une destination OracleLob.

Surcharges

Nom	Description
CopyTo(OracleLob)	Copie de ceci OracleLob vers une destination OracleLob.
CopyTo(OracleLob, Int64)	Copie de ceci OracleLob vers une destination OracleLob avec la quantité de données spécifiée.
CopyTo(Int64, OracleLob, Int64, Int64)	Copie de cela OracleLob vers une destination OracleLob avec la quantité de données spécifiée et le décalage source.

CopyTo(OracleLob)

Copie de ceci OracleLob vers une destination OracleLob.

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. Cela exclut les octets rembourrés.

Exceptions

ArgumentNullException

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

InvalidOperationException

L’opération n’est pas dans une transaction, l’objet a la OracleLob valeur 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 identiques. Par exemple, si vous copiez à partir d’un NClob, la destination OracleLob doit également être un NClob.

Si le décalage de destination dépasse la fin de la destination LOB, auquel LOB les données sont copiées sont étendues. L’espace entre la fin et le décalage de destination au-delà de la fin est rempli avec des zéros pour LOB les types de BLOB données et les espaces pour les types de données et CLOB les NCLOB types de données.

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 sur une lecture seule LOB peut réussir, mais pas mettre à jour le LOB serveur. Dans ce cas, toutefois, la copie locale du LOB fichier sera 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.

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 de ceci OracleLob vers une destination OracleLob 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

Décalage vers lequel copier. Pour les types de données et CLOB pour NCLOB les types de données, il doit s’agir d’un nombre pair d’octets.

Retours

Int64

Nombre d’octets copiés. Cela exclut les octets rembourrés.

Exceptions

ArgumentNullException

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

ArgumentOutOfRangeException

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

- ou -

Une valeur spécifiée dans le paramètre d’un destinationOffset type de données ou CLOB d’un NCLOB type de données n’est pas égale.

- ou -

Vous devez spécifier et CLOB les NCLOB types de données comme un nombre pair d’octets.

InvalidOperationException

L’opération n’est pas dans une transaction, l’objet a la OracleLob valeur 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 identiques. Par exemple, si vous copiez à partir d’un NClob, la destination OracleLob doit également être un NClob.

Si le décalage de destination dépasse la fin de la destination LOB, auquel LOB les données sont copiées sont étendues. L’espace entre la fin et le décalage de destination au-delà de LOB la fin est rempli avec des zéros pour BLOB les types de données et les espaces pour les types de données et CLOB les NCLOB types de données.

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.

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 cela OracleLob vers une destination OracleLob avec la quantité de données spécifiée et le décalage 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

Décalage à partir duquel copier. Pour les types de données et CLOB pour NCLOB les types de données, il doit s’agir d’un nombre pair.

destination: OracleLob

OracleLob System.Data.OracleClientDestination .

destinationOffset: Int64

Décalage de destination vers lequel copier. Pour les types de données et CLOB pour NCLOB les types de données, il doit s’agir d’un nombre pair.

amount: Int64

Quantité de données, en octets, à copier. Pour les types de données et CLOB pour NCLOB les types de données, il doit s’agir d’un nombre pair.

Retours

Int64

Nombre d’octets copiés. Cela exclut les octets rembourrés.

Exceptions

ArgumentNullException

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

ArgumentOutOfRangeException

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

- ou -

Une valeur spécifiée dans le amount, sourceOffsetou destinationOffset paramètre d’un type de données ou CLOB d’un NCLOB type de données n’est pas égale.

InvalidOperationException

L’opération n’est pas dans une transaction, l’objet a la OracleLob valeur 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 identiques. Par exemple, si vous copiez à partir d’un NClob, la destination OracleLob doit également être un NClob.

Si le décalage de destination dépasse la fin de la destination LOB, auquel LOB les données sont copiées sont étendues. L’espace entre la fin et le décalage de destination au-delà de LOB la fin est rempli avec des zéros pour BLOB les types de données et les espaces pour les types de données et CLOB les NCLOB types de données.

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

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

S’applique à

Commentaires

Cette page a-t-elle été utile ?