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합니다.

대상 오프셋이 대상 LOBLOB 의 끝을 벗어나면 데이터가 복사되는 가 확장됩니다. 끝과 끝 이후의 LOB 대상 오프셋 사이의 공간은 데이터 형식 및 데이터 형식의 공백 CLOBNCLOB 에 대해 BLOB 0으로 채워집니다.

에 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가 null인 경우

ArgumentOutOfRangeException

destinationOffset 매개 변수에 지정된 값이 0보다 작거나 4GB보다 큰 경우

또는

CLOB 또는 NCLOB 데이터 형식의 destinationOffset 매개 변수에서 지정된 값이 짝수가 아닌 경우

또는

CLOB 및 NCLOB 데이터 형식을 짝수 바이트로 지정해야 하는 경우

InvalidOperationException

작업이 트랜잭션에 속하지 않거나, OracleLob 개체가 null이거나, 연결이 닫힌 경우

OracleException

Oracle 오류가 발생한 경우

설명

기본 데이터 형식은 항상 동일해야 합니다. 예를 들어 에서 NClob복사하는 경우 대상 OracleLob 도 이어야 NClob합니다.

대상 오프셋이 대상 LOBLOB 의 끝을 벗어나면 데이터가 복사되는 가 확장됩니다. 끝과 끝 이후의 LOB 대상 오프셋 사이의 공간은 데이터 형식과 및 NCLOB 데이터 형식의 공백에 대해 BLOBCLOB 0으로 채워집니다.

에 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가 null인 경우

ArgumentOutOfRangeException

amount, sourceOffset 또는 destinationOffset 매개 변수에 지정된 값이 0보다 작거나 4GB보다 큰 경우

또는

CLOB 또는 NCLOB 데이터 형식의 amount, sourceOffset 및 destinationOffset 매개 변수에서 지정된 값이 짝수가 아닌 경우

InvalidOperationException

작업이 트랜잭션에 속하지 않거나, OracleLob 개체가 null이거나, 연결이 닫힌 경우

OracleException

Oracle 오류가 발생한 경우

설명

기본 데이터 형식은 항상 동일해야 합니다. 예를 들어 에서 NClob복사하는 경우 대상 OracleLob 도 이어야 NClob합니다.

대상 오프셋이 대상 LOBLOB 의 끝을 벗어나면 데이터가 복사되는 가 확장됩니다. 끝과 끝 이후의 LOB 대상 오프셋 사이의 공간은 데이터 형식과 및 NCLOB 데이터 형식의 공백에 대해 BLOBCLOB 0으로 채워집니다.

에 LOB쓰려면 SQL SELECT 문에서 FOR UPDATE 절을 사용하여 를 검색 LOB 해야 하며 로컬 트랜잭션이 시작되어야 합니다.

참고

이 릴리스에서는 읽기 전용 LOB 에 대한 쓰기 작업이 성공할 수 있지만 서버에서 을 LOB 업데이트하지는 않습니다. 그러나 이 경우 의 LOB 로컬 복사본이 업데이트됩니다. 따라서 나중에 개체에 대한 OracleLob 읽기 작업은 쓰기 작업의 결과를 반환할 수 있습니다.

메서드는 CopyTo 복사 작업을 수행하기 전에 대상 OracleLob 의 내용을 지우지 않습니다.