OracleLob.CopyTo Metoda

Definicja

Kopiuje z tego OracleLob do lokalizacji docelowej OracleLob .Copies from this OracleLob to a destination OracleLob.

Przeciążenia

CopyTo(OracleLob)

Kopiuje z tego OracleLob do lokalizacji docelowej OracleLob .Copies from this OracleLob to a destination OracleLob.

CopyTo(OracleLob, Int64)

Kopiuje z tego OracleLob miejsca do lokalizacji docelowej OracleLob o określonej ilości danych.Copies from this OracleLob to a destination OracleLob with the specified amount of data.

CopyTo(Int64, OracleLob, Int64, Int64)

Kopiuje z tego OracleLob do lokalizacji docelowej OracleLob o określonej ilości danych i przesunięcia źródła.Copies from this OracleLob to a destination OracleLob with the specified amount of data, and the source offset.

CopyTo(OracleLob)

Kopiuje z tego OracleLob do lokalizacji docelowej OracleLob .Copies from this OracleLob to a 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

Parametry

destination
OracleLob

Miejsce docelowe OracleLob .The destination OracleLob.

Zwraca

Int64

Liczba skopiowanych bajtów.The number of bytes copied. Spowoduje to wykluczenie wszystkich uzupełnionych bajtów.This excludes any padded bytes.

Wyjątki

OracleLobOkreślony w destination parametrze ma wartość null.The OracleLob specified in the destination parameter is null.

Operacja nie znajduje się w transakcji, OracleLob obiekt ma wartość null lub połączenie jest zamknięte.The operation is not within a transaction, the OracleLob object is null, or the connection is closed.

Wystąpił błąd programu Oracle.An Oracle error has occurred.

Uwagi

Podstawowe typy danych muszą zawsze być takie same.The underlying data types must always be the same. Na przykład, jeśli kopiujesz z, obiekt NClob docelowy OracleLob musi być również NClob .For example, if you are copying from an NClob, the destination OracleLob must also be an NClob.

Jeśli przesunięcie docelowe wykracza poza koniec miejsca docelowego LOB , LOB do którego dane są kopiowane, są rozszerzane.If the destination offset is beyond the end of destination LOB, the LOB to which the data is being copied is extended. Odstęp między końcem LOB i przesunięciem docelowym poza końcem jest dopełniany zerami dla BLOB typów danych i spacji dla CLOB typów danych i NCLOB .The space between the end of the LOB and the destination offset beyond the end is padded with zeros for BLOB data types and spaces for CLOB and NCLOB data types.

Aby można było zapisać w LOB , należy pobrać LOB klauzulę using for Update w instrukcji SQL SELECT, a użytkownik musi mieć uruchomioną transakcję lokalną.To write to the LOB, you must have retrieved the LOB using the FOR UPDATE clause in the SQL SELECT statement, and you must have a local transaction started.

Uwaga

W tej wersji operacja zapisu w trybie tylko do odczytu LOB może powieść się, ale nie zaktualizować LOB na serwerze programu.In this release, a write operation to a read-only LOB might succeed, but not update the LOB on the server. W takim przypadku jednak lokalna kopia programu LOB zostanie zaktualizowana.In this case, however, the local copy of the LOB will be updated. W związku z tym późniejsze operacje odczytu na OracleLob obiekcie mogą zwrócić wyniki operacji zapisu.Therefore, later read operations on the OracleLob object might return the results of the write operation.

CopyToMetoda nie czyści zawartości miejsca docelowego OracleLob przed wykonaniem operacji kopiowania.The CopyTo method does not clear the contents of the destination OracleLob before performing the copy operation.

Dotyczy

CopyTo(OracleLob, Int64)

Kopiuje z tego OracleLob miejsca do lokalizacji docelowej OracleLob o określonej ilości danych.Copies from this OracleLob to a destination OracleLob with the specified amount of data.

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

Parametry

destination
OracleLob

Miejsce doceloweOracleLobThe destination OracleLob

destinationOffset
Int64

Przesunięcie, do którego ma zostać skopiowane.The offset to which to copy. Dla CLOB i NCLOB typów danych, musi to być parzysta liczba bajtów.For CLOB and NCLOB data types, this must be an even number of bytes.

Zwraca

Int64

Liczba skopiowanych bajtów.The number of bytes copied. Spowoduje to wykluczenie wszystkich uzupełnionych bajtów.This excludes any padded bytes.

Wyjątki

OracleLobOkreślony w destination parametrze jest pełny.The OracleLob specified in the destination parameter is full.

Wartość określona w destinationOffset parametrze jest mniejsza od zera lub większa niż 4 gigabajty.A value specified in the destinationOffset parameter is less than zero or greater than 4 gigabytes.

-lub--or- Wartość określona w destinationOffset parametrze CLOB lub dla NCLOB typu danych nie jest parzysta.A value specified in the destinationOffset parameter for a CLOB or NCLOB data type is not even.

-lub--or- Należy określić CLOB i podać NCLOB typy danych jako parzystą liczbę bajtów.You must specify CLOB and NCLOB data types as an even number of bytes.

Operacja nie znajduje się w transakcji, OracleLob obiekt ma wartość null lub połączenie jest zamknięte.The operation is not within a transaction, the OracleLob object is null, or the connection is closed.

Wystąpił błąd programu Oracle.An Oracle error has occurred.

Uwagi

Podstawowe typy danych muszą zawsze być takie same.The underlying data types must always be the same. Na przykład, jeśli kopiujesz z, obiekt NClob docelowy OracleLob musi być również NClob .For example, if you are copying from an NClob, the destination OracleLob must also be an NClob.

Jeśli przesunięcie docelowe wykracza poza koniec miejsca docelowego LOB , LOB do którego dane są kopiowane, są rozszerzane.If the destination offset is beyond the end of destination LOB, the LOB to which the data is being copied is extended. Odstęp między końcem LOB a przesunięciem docelowym poza końcem jest dopełniany zerami dla BLOB typów danych i spacji dla typów danych CLOB i NCLOB .The space between the end of LOB and destination offset beyond the end is padded with zeros for BLOB data types and spaces for CLOB and NCLOB data types.

Aby można było zapisać w LOB , należy pobrać LOB klauzulę using for Update w instrukcji SQL SELECT, a użytkownik musi mieć uruchomioną transakcję lokalną.To write to the LOB, you must have retrieved the LOB using the FOR UPDATE clause in the SQL SELECT statement, and you must have a local transaction started.

Uwaga

W tej wersji operacja zapisu w trybie tylko do odczytu LOB może zakończyć się powodzeniem, ale nie aktualizuje LOB na serwerze.In this release, a write operation to a read-only LOB might succeed, but does not update the LOB on the server. W takim przypadku jednak lokalna kopia programu LOB jest aktualizowana.In this case, however, the local copy of the LOB is updated. W związku z tym późniejsze operacje odczytu na OracleLob obiekcie mogą zwrócić wyniki operacji zapisu.Therefore, later read operations on the OracleLob object might return the results of the write operation.

CopyToMetoda nie czyści zawartości miejsca docelowego OracleLob przed wykonaniem operacji kopiowania.The CopyTo method does not clear the contents of the destination OracleLob before performing the copy operation.

Dotyczy

CopyTo(Int64, OracleLob, Int64, Int64)

Kopiuje z tego OracleLob do lokalizacji docelowej OracleLob o określonej ilości danych i przesunięcia źródła.Copies from this OracleLob to a destination OracleLob with the specified amount of data, and the source offset.

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

Parametry

sourceOffset
Int64

Przesunięcie, z którego ma zostać skopiowane.The offset from which to copy. Dla CLOB i NCLOB typów danych, musi to być parzysta liczba.For CLOB and NCLOB data types, this must be an even number.

destination
OracleLob

Miejsce docelowe OracleLob System.Data.OracleClient .The destination OracleLobSystem.Data.OracleClient.

destinationOffset
Int64

Przesunięcie docelowe, do którego ma zostać skopiowane.The destination offset to which to copy. Dla CLOB i NCLOB typów danych, musi to być parzysta liczba.For CLOB and NCLOB data types, this must be an even number.

amount
Int64

Ilość danych (w bajtach) do skopiowania.The quantity of data, in bytes, to copy. Dla CLOB i NCLOB typów danych, musi to być parzysta liczba.For CLOB and NCLOB data types, this must be an even number.

Zwraca

Int64

Liczba skopiowanych bajtów.The number of bytes copied. Spowoduje to wykluczenie wszystkich uzupełnionych bajtów.This excludes any padded bytes.

Wyjątki

OracleLobOkreślony w destination parametrze jest pełny.The OracleLob specified in the destination parameter is full.

Wartość określona w amount sourceOffset parametrze,, lub destinationOffset jest mniejsza od zera lub większa niż 4 gigabajty.A value specified in the amount, sourceOffset, or destinationOffset parameter is less than zero or greater than 4 gigabytes.

-lub--or- Wartość określona w amount sourceOffset destinationOffset parametrze CLOB lub dla NCLOB typu danych lub nie jest parzysta.A value specified in the amount, sourceOffset, or destinationOffset parameter for a CLOB or NCLOB data type is not even.

Operacja nie znajduje się w transakcji, OracleLob obiekt ma wartość null lub połączenie jest zamknięte.The operation is not within a transaction, the OracleLob object is null, or the connection is closed.

Wystąpił błąd programu Oracle.An Oracle error has occurred.

Uwagi

Podstawowe typy danych muszą zawsze być takie same.The underlying data types must always be the same. Na przykład, jeśli kopiujesz z, obiekt NClob docelowy OracleLob musi być również NClob .For example, if you are copying from an NClob, the destination OracleLob must also be an NClob.

Jeśli przesunięcie docelowe wykracza poza koniec miejsca docelowego LOB , LOB do którego dane są kopiowane, są rozszerzane.If the destination offset is beyond the end of destination LOB, the LOB to which the data is being copied is extended. Odstęp między końcem LOB a przesunięciem docelowym poza końcem jest dopełniany zerami dla BLOB typów danych i spacji dla typów danych CLOB i NCLOB .The space between the end of LOB and destination offset beyond the end is padded with zeros for BLOB data types and spaces for CLOB and NCLOB data types.

Aby można było zapisać w LOB , należy pobrać LOB klauzulę using for Update w instrukcji SQL SELECT, a użytkownik musi mieć uruchomioną transakcję lokalną.To write to the LOB, you must have retrieved the LOB using the FOR UPDATE clause in the SQL SELECT statement, and you must have a local transaction started.

Uwaga

W tej wersji operacja zapisu w trybie tylko do odczytu LOB może zakończyć się powodzeniem, ale nie aktualizuje LOB na serwerze.In this release, a write operation to a read-only LOB might succeed, but does not update the LOB on the server. W takim przypadku jednak lokalna kopia programu LOB jest aktualizowana.In this case, however, the local copy of the LOB is updated. W związku z tym późniejsze operacje odczytu na OracleLob obiekcie mogą zwrócić wyniki operacji zapisu.Therefore, later read operations on the OracleLob object might return the results of the write operation.

CopyToMetoda nie czyści zawartości miejsca docelowego OracleLob przed wykonaniem operacji kopiowania.The CopyTo method does not clear the contents of the destination OracleLob before performing the copy operation.

Dotyczy