OracleLob.CopyTo Metode

Definisi

Ruang nama:

System.Data.OracleClient

Rakitan:

System.Data.OracleClient.dll

Menyalin dari ini OracleLob ke tujuan OracleLob.

Overload

CopyTo(OracleLob)	Menyalin dari ini OracleLob ke tujuan OracleLob.
CopyTo(OracleLob, Int64)	Menyalin dari ini OracleLob ke tujuan OracleLob dengan jumlah data yang ditentukan.
CopyTo(Int64, OracleLob, Int64, Int64)	Menyalin dari ini OracleLob ke tujuan OracleLob dengan jumlah data yang ditentukan, dan offset sumber.

CopyTo(OracleLob)

Menyalin dari ini OracleLob ke tujuan OracleLob.

public:
 long CopyTo(System::Data::OracleClient::OracleLob ^ destination);

public long CopyTo (System.Data.OracleClient.OracleLob destination);

override this.CopyTo : System.Data.OracleClient.OracleLob -> int64

Public Function CopyTo (destination As OracleLob) As Long

Parameter

destination

OracleLob

Tujuan OracleLob.

Mengembalikan

Int64

Jumlah byte yang disalin. Ini mengecualikan byte padded apa pun.

Pengecualian

ArgumentNullException

Yang OracleLob ditentukan dalam destination parameter adalah null.

InvalidOperationException

Operasi tidak berada dalam transaksi, OracleLob objek null, atau koneksi ditutup.

OracleException

Terjadi kesalahan Oracle.

Keterangan

Jenis data yang mendasar harus selalu sama. Misalnya, jika Anda menyalin dari NClob, tujuannya OracleLob juga harus berupa NClob.

Jika offset tujuan berada di luar akhir tujuan LOB, LOB tempat data sedang disalin diperpanjang. Ruang antara akhir LOB dan offset tujuan di luar akhir dilapisi dengan nol untuk BLOB jenis data dan spasi untuk CLOB jenis data dan NCLOB .

Untuk menulis ke LOB, Anda harus telah mengambil LOB menggunakan klausa FOR UPDATE dalam pernyataan SQL SELECT, dan Anda harus memulai transaksi lokal.

Catatan

Dalam rilis ini, operasi tulis ke baca-saja LOB mungkin berhasil, tetapi tidak memperbarui LOB di server. Namun, dalam hal ini, salinan LOB lokal akan diperbarui. Oleh karena itu, operasi baca nanti pada OracleLob objek mungkin mengembalikan hasil operasi tulis.

Metode CopyTo ini tidak menghapus isi tujuan OracleLob sebelum melakukan operasi penyalinan.

CopyTo(OracleLob, Int64)

Menyalin dari ini OracleLob ke tujuan OracleLob dengan jumlah data yang ditentukan.

public:
 long CopyTo(System::Data::OracleClient::OracleLob ^ destination, long destinationOffset);

public long CopyTo (System.Data.OracleClient.OracleLob destination, long destinationOffset);

override this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64

Public Function CopyTo (destination As OracleLob, destinationOffset As Long) As Long

Parameter

destination

OracleLob

Tujuan OracleLob.

destinationOffset

Int64

Offset yang akan disalin. Untuk CLOB jenis data dan NCLOB , ini harus berupa jumlah byte yang merata.

Mengembalikan

Int64

Jumlah byte yang disalin. Ini mengecualikan byte padded apa pun.

Pengecualian

ArgumentNullException

yang OracleLob ditentukan dalam destination parameter penuh.

ArgumentOutOfRangeException

Nilai yang ditentukan dalam destinationOffset parameter kurang dari nol atau lebih besar dari 4 gigabyte.

-atau-

Nilai yang ditentukan dalam destinationOffset parameter untuk CLOB jenis data atau NCLOB bahkan tidak.

-atau-

Anda harus menentukan CLOB jenis data dan NCLOB sebagai jumlah byte genap.

InvalidOperationException

Operasi tidak berada dalam transaksi, OracleLob objek null, atau koneksi ditutup.

OracleException

Terjadi kesalahan Oracle.

Keterangan

Jenis data yang mendasar harus selalu sama. Misalnya, jika Anda menyalin dari NClob, tujuannya OracleLob juga harus berupa NClob.

Jika offset tujuan berada di luar akhir tujuan LOB, LOB tempat data sedang disalin diperpanjang. Ruang antara akhir dan LOB offset tujuan di luar akhir dilapisi dengan nol untuk BLOB jenis data dan spasi untuk CLOB jenis data dan NCLOB .

Untuk menulis ke LOB, Anda harus telah mengambil LOB menggunakan klausa FOR UPDATE dalam pernyataan SQL SELECT, dan Anda harus memulai transaksi lokal.

Catatan

Dalam rilis ini, operasi tulis ke baca-saja LOB mungkin berhasil, tetapi tidak memperbarui LOB di server. Namun, dalam hal ini, salinan lokal diperbarui LOB . Oleh karena itu, operasi baca nanti pada OracleLob objek mungkin mengembalikan hasil operasi tulis.

Metode CopyTo ini tidak menghapus isi tujuan OracleLob sebelum melakukan operasi penyalinan.

CopyTo(Int64, OracleLob, Int64, Int64)

Menyalin dari ini OracleLob ke tujuan OracleLob dengan jumlah data yang ditentukan, dan offset sumber.

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);

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

Parameter

sourceOffset

Int64

Offset yang akan disalin. Untuk CLOB jenis data dan NCLOB , ini harus berupa angka genap.

destination

OracleLob

Tujuan OracleLobSystem.Data.OracleClient.

destinationOffset

Int64

Offset tujuan yang akan disalin. Untuk CLOB jenis data dan NCLOB , ini harus berupa angka genap.

amount

Int64

Kuantitas data, dalam byte, untuk disalin. Untuk CLOB jenis data dan NCLOB , ini harus berupa angka genap.

Mengembalikan

Int64

Jumlah byte yang disalin. Ini mengecualikan byte padded apa pun.

Pengecualian

ArgumentNullException

yang OracleLob ditentukan dalam destination parameter penuh.

ArgumentOutOfRangeException

Nilai yang ditentukan dalam amountparameter , sourceOffset, atau destinationOffset kurang dari nol atau lebih besar dari 4 gigabyte.

-atau-

Nilai yang ditentukan dalam amountparameter , sourceOffset, atau destinationOffset untuk CLOB jenis data atau NCLOB bahkan tidak.

InvalidOperationException

Operasi tidak berada dalam transaksi, OracleLob objek null, atau koneksi ditutup.

OracleException

Terjadi kesalahan Oracle.

Keterangan

Jenis data yang mendasar harus selalu sama. Misalnya, jika Anda menyalin dari NClob, tujuannya OracleLob juga harus berupa NClob.

Jika offset tujuan berada di luar akhir tujuan LOB, LOB tempat data sedang disalin diperpanjang. Ruang antara akhir dan LOB offset tujuan di luar akhir dilapisi dengan nol untuk BLOB jenis data dan spasi untuk CLOB jenis data dan NCLOB .

Untuk menulis ke LOB, Anda harus telah mengambil LOB menggunakan klausa FOR UPDATE dalam pernyataan SQL SELECT, dan Anda harus memulai transaksi lokal.

Catatan

Dalam rilis ini, operasi tulis ke baca-saja LOB mungkin berhasil, tetapi tidak memperbarui LOB di server. Namun, dalam hal ini, salinan lokal diperbarui LOB . Oleh karena itu, operasi baca nanti pada OracleLob objek mungkin mengembalikan hasil operasi tulis.

Metode CopyTo ini tidak menghapus isi tujuan OracleLob sebelum melakukan operasi penyalinan.