OracleLob.CopyTo Metoda

Definicja

Przestrzeń nazw:: System.Data.OracleClient

Zestaw:: System.Data.OracleClient.dll

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.

Kopie z tego OracleLob do miejsca docelowego OracleLob.

Przeciążenia

Nazwa	Opis
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 NClobobiektu , miejsce docelowe OracleLob musi być również .NClob

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

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

Note

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

Metoda CopyTo nie czyści 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 chcesz skopiować. 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 parzysta.

— lub —

Należy 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 NClobobiektu , miejsce docelowe OracleLob musi być również .NClob

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

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

Note

W tej wersji operacja zapisu tylko LOB do odczytu może zakończyć się powodzeniem, ale nie aktualizuje LOB serwera. 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 czyści 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 miejsca docelowego, 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 parzysta.

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 NClobobiektu , miejsce docelowe OracleLob musi być również .NClob

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

Note

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

Dotyczy

Opinia

Czy ta strona była pomocna?