OracleLob.CopyTo 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
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 -> int64override this.CopyTo : System.Data.OracleClient.OracleLob -> int64Public Function CopyTo (destination As OracleLob) As Long參數
傳回
複製的位元組數。 這排除了任何填充位元組。
例外狀況
參數中OracleLob指定的為destination空值。
操作不在交易中、 OracleLob 物件為空，或連線已關閉。
發生了神諭錯誤。
備註
底層資料類型必須始終相同。 例如，如果你從 複製NClob，OracleLob目的地也必須是 NClob。
若目的偏移量超過目的 LOB點的末端， LOB 資料被複製的範圍會被擴展。 從 的LOB末端到目的地偏移量以後的空格填充，資料型別與資料型別的空格BLOBCLOB則為零NCLOB填充。
要寫入 LOB，必須先使用 SQL SELECT 陳述句中的 FOR UPDATE 子句取得 ， LOB 並且必須啟動本地交易。
Note
在此版本中，對唯LOB讀的寫入操作可能成功，但無法在伺服器上更新。LOB 但在此情況下，遺囑的本地副本 LOB 會被更新。 因此，物件後續的讀取操作 OracleLob 可能會回傳寫入操作的結果。
此 CopyTo 方法在執行複製操作前不會清除目的地 OracleLob 內容。
適用於
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 -> int64override this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64Public Function CopyTo (destination As OracleLob, destinationOffset As Long) As Long參數
- destinationOffset
- Int64
要複製的偏移量。 對於 CLOB 和 NCLOB 資料型別，這必須是偶數個位元組。
傳回
複製的位元組數。 這排除了任何填充位元組。
例外狀況
參數中OracleLob指定的是destination滿的。
參數中指定的 destinationOffset 值小於零或大於4 GB。
-或-
參數中destinationOffsetCLOB指定的 或 NCLOB 資料型別值並非偶數。
-或-
你必須指定 CLOB 和 資料 NCLOB 型別為偶數位元組。
操作不在交易中、 OracleLob 物件為空，或連線已關閉。
發生了神諭錯誤。
備註
底層資料類型必須始終相同。 例如，如果你從 複製NClob，OracleLob目的地也必須是 NClob。
若目的偏移量超過目的 LOB點的末端， LOB 資料被複製的範圍會被擴展。 結束LOB點與目標偏移之間的空間以零填充資料BLOB型別，以及 和 資料型別的空格CLOBNCLOB。
要寫入 LOB，必須先使用 SQL SELECT 陳述句中的 FOR UPDATE 子句取得 ， LOB 並且必須啟動本地交易。
Note
在此版本中，對唯LOB讀的寫入操作可能成功，但不會在伺服器上更新 。LOB 但在此情況下，本地 LOB 副本已更新。 因此，物件後續的讀取操作 OracleLob 可能會回傳寫入操作的結果。
此 CopyTo 方法在執行複製操作前不會清除目的地 OracleLob 內容。
適用於
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 -> int64override this.CopyTo : int64 * System.Data.OracleClient.OracleLob * int64 * int64 -> int64Public 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 資料型態，這個數字必須是偶數。
傳回
複製的位元組數。 這排除了任何填充位元組。
例外狀況
參數中OracleLob指定的是destination滿的。
參數中amountsourceOffsetdestinationOffset指定的值小於零或大於4 GB。
-或-
在 、 amount或 參數中指定的 sourceOffset或 destinationOffset 資料型別值CLOB並非偶NCLOB數。
操作不在交易中、 OracleLob 物件為空，或連線已關閉。
發生了神諭錯誤。
備註
底層資料類型必須始終相同。 例如，如果你從 複製NClob，OracleLob目的地也必須是 NClob。
若目的偏移量超過目的 LOB點的末端， LOB 資料被複製的範圍會被擴展。 結束LOB點與目標偏移之間的空間以零填充資料BLOB型別，以及 和 資料型別的空格CLOBNCLOB。
要寫入 LOB，必須先使用 SQL SELECT 陳述句中的 FOR UPDATE 子句取得 ， LOB 並且必須啟動本地交易。
Note
在此版本中，對唯LOB讀的寫入操作可能成功，但不會在伺服器上更新 。LOB 但在此情況下，本地 LOB 副本已更新。 因此，物件後續的讀取操作 OracleLob 可能會回傳寫入操作的結果。
此 CopyTo 方法在執行複製操作前不會清除目的地 OracleLob 內容。
