OracleLob.CopyTo Yöntem

Tanım

Ad Alanı:

System.Data.OracleClient

Bütünleştirilmiş Kod:

System.Data.OracleClient.dll

Bundan OracleLob hedefine OracleLobkopyalar.

Aşırı Yüklemeler

CopyTo(OracleLob)	Bundan OracleLob hedefine OracleLobkopyalar.
CopyTo(OracleLob, Int64)	Bu OracleLob kaynaktan belirtilen miktarda veri içeren bir hedefe OracleLob kopyalar.
CopyTo(Int64, OracleLob, Int64, Int64)	Bu OracleLob kaynaktan belirtilen veri miktarına ve kaynak uzaklığına sahip bir hedefe OracleLob kopyalar.

CopyTo(OracleLob)

Bundan OracleLob hedefine OracleLobkopyalar.

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

Parametreler

destination

OracleLob

Hedef OracleLob.

Döndürülenler

Int64

Kopyalanan bayt sayısı. Bu, doldurulmuş baytları dışlar.

Özel durumlar

ArgumentNullException

OracleLob parametresinde destination belirtilen null.

InvalidOperationException

İşlem bir işlem içinde değil, OracleLob nesne null veya bağlantı kapatıldı.

OracleException

Oracle hatası oluştu.

Açıklamalar

Temel alınan veri türleri her zaman aynı olmalıdır. Örneğin, bir NClobkaynağından kopyalanıyorsanız, hedef OracleLob de olmalıdır NClob.

Hedef uzaklık hedefin LOBLOB sonunun ötesindeyse, verilerin kopyalandığı yer genişletilir. sonunun LOB sonu ile ucun ötesindeki hedef uzaklık arasındaki boşluk, veri türleri ve ve veri türleri için boşluklar için BLOBCLOBNCLOB sıfırlarla doldurulur.

öğesine yazmak için LOB, SQL SELECT deyiminde LOB FOR UPDATE yan tümcesini kullanarak öğesini almış olmanız ve yerel bir işlemin başlatılması gerekir.

Not

Bu sürümde, salt okunur LOB bir dosyaya yazma işlemi başarılı olabilir, ancak sunucusundaki öğesini LOB güncelleştiremeyebilir. Ancak bu durumda, öğesinin LOB yerel kopyası güncelleştirilir. Bu nedenle, nesnedeki OracleLob daha sonra okuma işlemleri yazma işleminin sonuçlarını döndürebilir.

CopyTo yöntemi, kopyalama işlemini gerçekleştirmeden önce hedefin OracleLob içeriğini temizlemez.

CopyTo(OracleLob, Int64)

Bu OracleLob kaynaktan belirtilen miktarda veri içeren bir hedefe OracleLob kopyalar.

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

Parametreler

destination

OracleLob

Hedef OracleLob.

destinationOffset

Int64

Kopyalanacak uzaklık. ve NCLOB veri türleri içinCLOB, bu çift bayt sayısı olmalıdır.

Döndürülenler

Int64

Kopyalanan bayt sayısı. Bu, doldurulmuş baytları dışlar.

Özel durumlar

ArgumentNullException

OracleLob parametresinde destination belirtilen tam.

ArgumentOutOfRangeException

parametresinde destinationOffset belirtilen değer sıfırdan küçük veya 4 gigabayttan büyük.

-veya-

veya NCLOB veri türü için parametresinde destinationOffset belirtilen değer CLOB eşit değildir.

-veya-

ve NCLOB veri türlerini çift bayt sayısı olarak belirtmeniz CLOB gerekir.

InvalidOperationException

İşlem bir işlem içinde değil, OracleLob nesne null veya bağlantı kapatıldı.

OracleException

Oracle hatası oluştu.

Açıklamalar

Temel alınan veri türleri her zaman aynı olmalıdır. Örneğin, bir NClobkaynağından kopyalanıyorsanız, hedef OracleLob de olmalıdır NClob.

Hedef uzaklık hedefin LOBLOB sonunun ötesindeyse, verilerin kopyalandığı yer genişletilir. Sonu ile hedefin sonunun LOB ötesindeki uzaklık arasındaki boşluk, ve veri türleri için veri türleri ve boşluklar için BLOBCLOBNCLOB sıfırlarla doldurulur.

öğesine yazmak için LOB, SQL SELECT deyiminde LOB FOR UPDATE yan tümcesini kullanarak öğesini almış olmanız ve yerel bir işlemin başlatılması gerekir.

Not

Bu sürümde, salt okunur LOB bir dosyaya yazma işlemi başarılı olabilir, ancak sunucusundaki öğesini LOB güncelleştirmez. Ancak bu durumda, yerel kopyası LOB güncelleştirilir. Bu nedenle, nesnedeki OracleLob daha sonra okuma işlemleri yazma işleminin sonuçlarını döndürebilir.

CopyTo yöntemi, kopyalama işlemini gerçekleştirmeden önce hedefin OracleLob içeriğini temizlemez.

CopyTo(Int64, OracleLob, Int64, Int64)

Bu OracleLob kaynaktan belirtilen veri miktarına ve kaynak uzaklığına sahip bir hedefe OracleLob kopyalar.

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

Parametreler

sourceOffset

Int64

Kopyalanacak uzaklık. ve NCLOB veri türleri için CLOB bu çift sayı olmalıdır.

destination

OracleLob

Hedef OracleLobSystem.Data.OracleClient.

destinationOffset

Int64

Kopyalanacak hedef uzaklık. ve NCLOB veri türleri için CLOB bu çift sayı olmalıdır.

amount

Int64

Kopyalanacak verilerin bayt cinsinden miktarı. ve NCLOB veri türleri için CLOB bu çift sayı olmalıdır.

Döndürülenler

Int64

Kopyalanan bayt sayısı. Bu, doldurulmuş baytları dışlar.

Özel durumlar

ArgumentNullException

OracleLob parametresinde destination belirtilen tam.

ArgumentOutOfRangeException

, sourceOffsetveya destinationOffset parametresinde amountbelirtilen değer sıfırdan küçük veya 4 gigabayttan büyük.

-veya-

Veya veri türü için , veya parametresinde amountbelirtilen değer CLOBNCLOB eşit değildir.destinationOffsetsourceOffset

InvalidOperationException

İşlem bir işlem içinde değil, OracleLob nesne null veya bağlantı kapatıldı.

OracleException

Oracle hatası oluştu.

Açıklamalar

Temel alınan veri türleri her zaman aynı olmalıdır. Örneğin, bir NClobkaynağından kopyalanıyorsanız, hedef OracleLob de olmalıdır NClob.

Hedef uzaklık hedefin LOBLOB sonunun ötesindeyse, verilerin kopyalandığı yer genişletilir. Sonu ile hedefin sonunun LOB ötesindeki uzaklık arasındaki boşluk, ve veri türleri için veri türleri ve boşluklar için BLOBCLOBNCLOB sıfırlarla doldurulur.

öğesine yazmak için LOB, SQL SELECT deyiminde LOB FOR UPDATE yan tümcesini kullanarak öğesini almış olmanız ve yerel bir işlemin başlatılması gerekir.

Not

Bu sürümde, salt okunur LOB bir dosyaya yazma işlemi başarılı olabilir, ancak sunucusundaki öğesini LOB güncelleştirmez. Ancak bu durumda, yerel kopyası LOB güncelleştirilir. Bu nedenle, nesnedeki OracleLob daha sonra okuma işlemleri yazma işleminin sonuçlarını döndürebilir.

CopyTo yöntemi, kopyalama işlemini gerçekleştirmeden önce hedefin OracleLob içeriğini temizlemez.