OracleLob.CopyTo Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
CopyTo(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)
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
Parameter
Mengembalikan
Jumlah byte yang disalin. Ini mengecualikan byte padded apa pun.
Pengecualian
Yang OracleLob ditentukan dalam destination
parameter adalah null.
Operasi tidak berada dalam transaksi, OracleLob objek null, atau koneksi ditutup.
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.
Berlaku untuk
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 -> int64
override this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64
Public Function CopyTo (destination As OracleLob, destinationOffset As Long) As Long
Parameter
- destinationOffset
- Int64
Offset yang akan disalin. Untuk CLOB
jenis data dan NCLOB
, ini harus berupa jumlah byte yang merata.
Mengembalikan
Jumlah byte yang disalin. Ini mengecualikan byte padded apa pun.
Pengecualian
yang OracleLob ditentukan dalam destination
parameter penuh.
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.
Operasi tidak berada dalam transaksi, OracleLob objek null, atau koneksi ditutup.
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.
Berlaku untuk
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 -> 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
Parameter
- sourceOffset
- Int64
Offset yang akan disalin. Untuk CLOB
jenis data dan NCLOB
, ini harus berupa angka genap.
- destination
- OracleLob
Tujuan OracleLob
System.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
Jumlah byte yang disalin. Ini mengecualikan byte padded apa pun.
Pengecualian
yang OracleLob ditentukan dalam destination
parameter penuh.
Nilai yang ditentukan dalam amount
parameter , sourceOffset
, atau destinationOffset
kurang dari nol atau lebih besar dari 4 gigabyte.
-atau-
Nilai yang ditentukan dalam amount
parameter , sourceOffset
, atau destinationOffset
untuk CLOB
jenis data atau NCLOB
bahkan tidak.
Operasi tidak berada dalam transaksi, OracleLob objek null, atau koneksi ditutup.
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.