Udostępnij za pośrednictwem

OracleLob.CopyTo Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data.OracleClient
Zestaw:
System.Data.OracleClient.dll

Kopie z tego OracleLob do miejsca docelowego OracleLob.

Przeciążenia

CopyTo(OracleLob)

Kopie z tego OracleLob do miejsca docelowego OracleLob.
CopyTo(OracleLob, Int64)

Kopie z tego OracleLob do miejsca docelowego OracleLob z określoną ilością danych.
CopyTo(Int64, OracleLob, Int64, Int64)

Kopie z tego OracleLob do miejsca docelowego OracleLob z określoną ilością danych i przesunięciem źródłowym.

CopyTo(OracleLob)

Kopie z tego OracleLob do miejsca docelowego 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.

Zwraca

Int64

Liczba skopiowanych bajtów. Wyklucza to wszystkie wypełnione bajty.

Wyjątki

ArgumentNullException

Określony OracleLob w parametrze destination ma wartość null.

InvalidOperationException

Operacja nie znajduje się w transakcji, OracleLob obiekt ma wartość null lub połączenie jest zamknięte.

OracleException

Wystąpił błąd Oracle.

Uwagi

Podstawowe typy danych muszą być zawsze takie same. Jeśli na przykład kopiujesz z obiektu NClob, miejsce docelowe OracleLob musi być również elementem NClob.

Jeśli przesunięcie miejsca docelowego wykracza poza koniec miejsca docelowego LOB, LOB do którego są kopiowane dane, jest rozszerzone. Odstęp między końcem LOB a przesunięciem docelowym poza końcem jest dopełniany zerami dla typów danych i spacji dla BLOBCLOB typów danych i NCLOB typów danych.

Aby zapisać w pliku LOB, musisz pobrać LOB klauzulę USING FOR UPDATE w instrukcji SQL SELECT i musisz mieć uruchomioną transakcję lokalną.

Uwaga

W tej wersji operacja zapisu w trybie tylko LOB do odczytu może zakończyć się powodzeniem, ale nie zaktualizować LOB jej na serwerze. W takim przypadku jednak lokalna kopia obiektu LOB zostanie zaktualizowana. W związku z tym późniejsze operacje odczytu obiektu OracleLob mogą zwracać wyniki operacji zapisu.

Metoda CopyTo nie usuwa zawartości miejsca docelowego OracleLob przed wykonaniem operacji kopiowania.

Dotyczy

CopyTo(OracleLob, Int64)

Kopie z tego OracleLob do miejsca docelowego OracleLob z określoną ilością danych.

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

destinationOffset
Int64

Przesunięcie, do którego ma być skopiowane. W przypadku CLOB typów danych i NCLOB musi to być parzysta liczba bajtów.

Zwraca

Int64

Liczba skopiowanych bajtów. Wyklucza to wszystkie wypełnione bajty.

Wyjątki

ArgumentNullException

Określony OracleLob w parametrze destination jest pełny.

ArgumentOutOfRangeException

Wartość określona w parametrze destinationOffset jest mniejsza niż zero lub większa niż 4 gigabajty.

-lub-

Wartość określona w parametrze destinationOffset dla CLOB typu danych lub NCLOB nie jest nawet równa.

-lub-

Musisz określić CLOB typy danych i NCLOB jako liczbę parzysty bajtów.

InvalidOperationException

Operacja nie znajduje się w transakcji, OracleLob obiekt ma wartość null lub połączenie jest zamknięte.

OracleException

Wystąpił błąd Oracle.

Uwagi

Podstawowe typy danych muszą być zawsze takie same. Jeśli na przykład kopiujesz z obiektu NClob, miejsce docelowe OracleLob musi być również elementem NClob.

Jeśli przesunięcie miejsca docelowego wykracza poza koniec miejsca docelowego LOB, LOB do którego są kopiowane dane, jest rozszerzone. Odstęp między przesunięciem końcowym LOB i docelowym poza końcem jest dopełniany zerami dla typów danych i spacji dla BLOBCLOB typów danych i NCLOB typów danych.

Aby zapisać w pliku LOB, musisz pobrać LOB klauzulę USING FOR UPDATE w instrukcji SQL SELECT i musisz mieć uruchomioną transakcję lokalną.

Uwaga

W tej wersji operacja zapisu tylko LOB do odczytu może zakończyć się powodzeniem, ale nie aktualizuje na LOB serwerze. W takim przypadku jednak lokalna kopia obiektu LOB jest aktualizowana. W związku z tym późniejsze operacje odczytu obiektu OracleLob mogą zwracać wyniki operacji zapisu.

Metoda CopyTo nie usuwa zawartości miejsca docelowego OracleLob przed wykonaniem operacji kopiowania.

Dotyczy

CopyTo(Int64, OracleLob, Int64, Int64)

Kopie z tego OracleLob do miejsca docelowego OracleLob z określoną ilością danych i przesunięciem źródłowym.

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 być kopiowane. W przypadku CLOB typów danych i NCLOB musi to być liczba parzysta.

destination
OracleLob

Miejsce docelowe OracleLobSystem.Data.OracleClient.

destinationOffset
Int64

Przesunięcie docelowe, do którego ma być skopiowane. W przypadku CLOB typów danych i NCLOB musi to być liczba parzysta.

amount
Int64

Ilość danych w bajtach do skopiowania. W przypadku CLOB typów danych i NCLOB musi to być liczba parzysta.

Zwraca

Int64

Liczba skopiowanych bajtów. Wyklucza to wszystkie wypełnione bajty.

Wyjątki

ArgumentNullException

Określony OracleLob w parametrze destination jest pełny.

ArgumentOutOfRangeException

Wartość określona w parametrze amount, sourceOffsetlub destinationOffset jest mniejsza niż zero lub większa niż 4 gigabajty.

-lub-

Wartość określona w parametrze amount, sourceOffsetlub destinationOffset dla CLOB typu danych lub NCLOB nie jest nawet równa.

InvalidOperationException

Operacja nie znajduje się w transakcji, OracleLob obiekt ma wartość null lub połączenie jest zamknięte.

OracleException

Wystąpił błąd Oracle.

Uwagi

Podstawowe typy danych muszą być zawsze takie same. Jeśli na przykład kopiujesz z obiektu NClob, miejsce docelowe OracleLob musi być również elementem NClob.

Jeśli przesunięcie miejsca docelowego wykracza poza koniec miejsca docelowego LOB, LOB do którego są kopiowane dane, jest rozszerzone. Odstęp między przesunięciem końcowym LOB i docelowym poza końcem jest dopełniany zerami dla typów danych i spacji dla BLOBCLOB typów danych i NCLOB typów danych.

Aby zapisać w pliku LOB, musisz pobrać LOB klauzulę USING FOR UPDATE w instrukcji SQL SELECT i musisz mieć uruchomioną transakcję lokalną.

Uwaga

W tej wersji operacja zapisu tylko LOB do odczytu może zakończyć się powodzeniem, ale nie aktualizuje na LOB serwerze. W takim przypadku jednak lokalna kopia obiektu LOB jest aktualizowana. W związku z tym późniejsze operacje odczytu obiektu OracleLob mogą zwracać wyniki operacji zapisu.

Metoda CopyTo nie usuwa zawartości miejsca docelowego OracleLob przed wykonaniem operacji kopiowania.

Dotyczy