OracleBFile.CopyTo Method

Definition

Copies data from this OracleBFile to a destination OracleLob.

Overloads

CopyTo(OracleLob)

Copies the entire contents of this OracleBFile to the beginning of a destination OracleLob.

CopyTo(OracleLob, Int64)

Copies the entire contents of this OracleBFile to a destination OracleLob at the specified offset.

CopyTo(Int64, OracleLob, Int64, Int64)

Copies from this OracleBFile to a destination OracleLob with the specified amount of data, the source offset, and the destination offset.

CopyTo(OracleLob)

Copies the entire contents of this OracleBFile to the beginning of a destination 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

Parameters

destination
OracleLob

The destination OracleLob.

Returns

The number of bytes copied.

Exceptions

The destination OracleLob is a null object reference.

The destination is a null OracleLob.

-or-

The connection with which this OracleBFile is associated is closed.

The OracleBFile object is closed or disposed.

Remarks

The underlying data types of the source OracleBFile and the destination OracleLob must be compatible. For example, you cannot copy binary data to a destination OracleLob that has a character data type.

You must have write access to the destination OracleLob for the CopyTo operation to execute correctly.

Applies to

CopyTo(OracleLob, Int64)

Copies the entire contents of this OracleBFile to a destination OracleLob at the specified offset.

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

Parameters

destination
OracleLob

The destination OracleLob.

destinationOffset
Int64

The offset to which to copy.

Returns

The number of bytes copied.

Exceptions

The destination OracleLob is a null object reference.

The destination is a null OracleLob.

-or-

The connection with which this OracleBFile is associated is closed.

The OracleBFile object is closed or disposed.

Remarks

The underlying data types of the source OracleBFile and the destination OracleLob must be compatible. For example, you cannot copy binary data to a destination OracleLob that has a character data type.

You must have write access to the destination OracleLob for the CopyTo operation to execute correctly.

Applies to

CopyTo(Int64, OracleLob, Int64, Int64)

Copies from this OracleBFile to a destination OracleLob with the specified amount of data, the source offset, and the destination offset.

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

Parameters

sourceOffset
Int64

The offset from which to copy.

destination
OracleLob

The destination OracleLob.

destinationOffset
Int64

The offset to which to copy.

amount
Int64

The quantity of data, in bytes, to copy.

Returns

The number of bytes copied.

Exceptions

The value of the amount parameter is less than zero or greater than 4 gigabytes.

The destination OracleLob is a null object reference.

The destination is a null OracleLob.

-or-

The connection with which this OracleBFile is associated is closed.

The OracleBFile object is closed or disposed.

Remarks

The underlying data types of the source OracleBFile and the destination OracleLob must be compatible. For example, you cannot copy binary data to a destination OracleLob that has a character data type.

You must have write access to the destination OracleLob for the CopyTo operation to execute correctly.

Applies to