OracleLob.CopyTo Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Przeciążenia
| CopyTo(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)
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 LongParametry
Zwraca
Liczba skopiowanych bajtów. Wyklucza to wszystkie wypełnione bajty.
Wyjątki
Określony OracleLob w parametrze destination ma wartość null.
Operacja nie znajduje się w transakcji, OracleLob obiekt ma wartość null lub połączenie jest zamknięte.
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)
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 LongParametry
- 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
Liczba skopiowanych bajtów. Wyklucza to wszystkie wypełnione bajty.
Wyjątki
Określony OracleLob w parametrze destination jest pełny.
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.
Operacja nie znajduje się w transakcji, OracleLob obiekt ma wartość null lub połączenie jest zamknięte.
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)
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 LongParametry
- 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
Liczba skopiowanych bajtów. Wyklucza to wszystkie wypełnione bajty.
Wyjątki
Określony OracleLob w parametrze destination jest pełny.
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.
Operacja nie znajduje się w transakcji, OracleLob obiekt ma wartość null lub połączenie jest zamknięte.
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.
