OracleLob.CopyTo 方法

定義

命名空間:

System.Data.OracleClient

組件:

System.Data.OracleClient.dll

從這個 OracleLob 複製到目的 OracleLob。

多載

CopyTo(OracleLob)	從這個 OracleLob 複製到目的 OracleLob。
CopyTo(OracleLob, Int64)	以指定的資料量，從這個 OracleLob 複製到目的 OracleLob。
CopyTo(Int64, OracleLob, Int64, Int64)	以指定的資料量和來源位移，從這個 OracleLob 複製到目的 OracleLob。

CopyTo(OracleLob)

從這個 OracleLob 複製到目的 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

參數

destination

OracleLob

目的 OracleLob。

傳回

Int64

已複製的位元組數目。 這會排除任何填補位元組。

例外狀況

ArgumentNullException

在 destination 參數中所指定的 OracleLob 為 null。

InvalidOperationException

作業不在交易中、OracleLob 物件為 null，或是連接已關閉。

OracleException

發生 Oracle 錯誤。

備註

基礎數據類型必須一律相同。 例如，如果您要從 NClob複製 ，目的地 OracleLob 也必須是 NClob。

如果目的地位移超出目的地 LOB的結尾， LOB 則會擴充要複製資料的 。 結尾與結尾LOB以外的目的地位移之間的空間會填補數據類型的零BLOB，以及和 NCLOB 數據類型的CLOB空格。

若要寫入 LOB至 ，您必須已在 SQL SELECT 語句中使用 FOR UPDATE 子句擷取 LOB ，而且必須啟動本機交易。

注意

這個版本中，唯讀 LOB 的寫入作業可能會成功，但不會更新 LOB 伺服器上的 。 不過，在此情況下，將會更新 的 LOB 本機複本。 因此，物件上的 OracleLob 稍後讀取作業可能會傳回寫入作業的結果。

方法 CopyTo 在執行複製作業之前，不會清除目的地 OracleLob 的內容。

CopyTo(OracleLob, Int64)

以指定的資料量，從這個 OracleLob 複製到目的 OracleLob。

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

參數

destination

OracleLob

目的 OracleLob。

destinationOffset

Int64

要複製的目的位置。 對 CLOB 和 NCLOB 資料型別而言，這必須是偶數的位元組。

傳回

Int64

已複製的位元組數目。 這會排除任何填補位元組。

例外狀況

ArgumentNullException

destination 參數中指定的 OracleLob 已滿。

ArgumentOutOfRangeException

destinationOffset 參數中所指定的值小於零，或是大於 4 GB。

-或-

CLOB 或 NCLOB 資料型別的 destinationOffset 參數中指定的值不是偶數。

-或-

您必須將 CLOB 和 NCLOB 資料型別指定為偶數位元組數。

InvalidOperationException

作業不在交易中、OracleLob 物件為 null，或是連接已關閉。

OracleException

發生 Oracle 錯誤。

備註

基礎數據類型必須一律相同。 例如，如果您要從 NClob複製 ，目的地 OracleLob 也必須是 NClob。

如果目的地位移超出目的地 LOB的結尾， LOB 則會擴充要複製資料的 。 結尾與目的地位移之間的間距超出結尾LOB，會填補數據類型的零BLOB，以及和 NCLOB 數據類型的CLOB空格。

若要寫入 LOB至 ，您必須已在 SQL SELECT 語句中使用 FOR UPDATE 子句擷取 LOB ，而且必須啟動本機交易。

注意

這個版本中，唯讀 LOB 的寫入作業可能會成功，但不會更新 LOB 伺服器上的 。 不過，在此情況下，會更新 的 LOB 本機複本。 因此，物件上的 OracleLob 稍後讀取作業可能會傳回寫入作業的結果。

方法 CopyTo 在執行複製作業之前，不會清除目的地 OracleLob 的內容。

CopyTo(Int64, OracleLob, Int64, Int64)

以指定的資料量和來源位移，從這個 OracleLob 複製到目的 OracleLob。

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

參數

sourceOffset

Int64

要複製的來源位移。 對 CLOB 和 NCLOB 資料型別而言，這必須是偶數。

destination

OracleLob

目的 OracleLobSystem.Data.OracleClient。

destinationOffset

Int64

要複製的目的位移。 對 CLOB 和 NCLOB 資料型別而言，這必須是偶數。

amount

Int64

要複製的資料量，以位元組為單位。 對 CLOB 和 NCLOB 資料型別而言，這必須是偶數。

傳回

Int64

已複製的位元組數目。 這會排除任何填補位元組。

例外狀況

ArgumentNullException

destination 參數中指定的 OracleLob 已滿。

ArgumentOutOfRangeException

amount、sourceOffset 或 destinationOffset 參數中所指定的值小於零，或是大於 4 GB。

-或-

CLOB 或 NCLOB 資料型別的 amount、sourceOffset 或 destinationOffset 參數中指定的值不是偶數。

InvalidOperationException

作業不在交易中、OracleLob 物件為 null，或是連接已關閉。

OracleException

發生 Oracle 錯誤。

備註

基礎數據類型必須一律相同。 例如，如果您要從 NClob複製 ，目的地 OracleLob 也必須是 NClob。

如果目的地位移超出目的地 LOB的結尾， LOB 則會擴充要複製資料的 。 結尾與目的地位移之間的間距超出結尾LOB，會填補數據類型的零BLOB，以及和 NCLOB 數據類型的CLOB空格。

若要寫入 LOB至 ，您必須已在 SQL SELECT 語句中使用 FOR UPDATE 子句擷取 LOB ，而且必須啟動本機交易。

注意

這個版本中，唯讀 LOB 的寫入作業可能會成功，但不會更新 LOB 伺服器上的 。 不過，在此情況下，會更新 的 LOB 本機複本。 因此，物件上的 OracleLob 稍後讀取作業可能會傳回寫入作業的結果。

方法 CopyTo 在執行複製作業之前，不會清除目的地 OracleLob 的內容。