OracleLob.CopyTo 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| CopyTo(OracleLob) | |
| CopyTo(OracleLob, Int64) | |
| CopyTo(Int64, OracleLob, Int64, Int64) |
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매개 변수
반환
복사한 바이트 수입니다. 이것은 채워진 모든 바이트를 제외합니다.
예외
destination 매개 변수에 지정된 OracleLob가 null인 경우
작업이 트랜잭션에 속하지 않거나, OracleLob 개체가 null이거나, 연결이 닫힌 경우
Oracle 오류가 발생한 경우
설명
기본 데이터 형식은 항상 동일해야 합니다. 예를 들어 에서 복사하는 경우 NClob OracleLob 대상도 이어야 NClob 합니다.
대상 오프셋이 대상 의 끝을 벗어나면 LOB LOB 데이터가 복사되는 가 확장됩니다. 의 LOB 끝과 끝 이후의 대상 오프셋 사이의 공간은 및 BLOB 데이터 형식의 데이터 형식과 공백에 대해 0으로 CLOB 패딩됩니다. NCLOB
에 쓰려면 LOB LOB SQL SELECT 문에서 FOR UPDATE 절을 사용하여 를 검색해야 하며 로컬 트랜잭션이 시작되어야 합니다.
참고
이 릴리스에서는 읽기 전용에 대한 쓰기 작업이 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 데이터 형식의 경우 짝수 바이트여야 합니다.
반환
복사한 바이트 수입니다. 이것은 채워진 모든 바이트를 제외합니다.
예외
destination 매개 변수에서 지정한 OracleLob가 null인 경우
destinationOffset 매개 변수에 지정된 값이 0보다 작거나 4GB보다 큰 경우
또는
CLOB 또는 NCLOB 데이터 형식의 destinationOffset 매개 변수에서 지정된 값이 짝수가 아닌 경우
또는
CLOB 및 NCLOB 데이터 형식을 짝수 바이트로 지정해야 하는 경우
작업이 트랜잭션에 속하지 않거나, OracleLob 개체가 null이거나, 연결이 닫힌 경우
Oracle 오류가 발생한 경우
설명
기본 데이터 형식은 항상 동일해야 합니다. 예를 들어 에서 복사하는 경우 NClob OracleLob 대상도 이어야 NClob 합니다.
대상 오프셋이 대상 의 끝을 벗어나면 LOB LOB 데이터가 복사되는 가 확장됩니다. 끝 LOB 부분과 끝 이후의 대상 오프셋 사이의 공간은 및 데이터 형식에 대한 데이터 형식 및 공백에 대해 0으로 BLOB CLOB NCLOB 패딩됩니다.
에 쓰려면 LOB LOB SQL SELECT 문에서 FOR UPDATE 절을 사용하여 를 검색해야 하며 로컬 트랜잭션이 시작되어야 합니다.
참고
이 릴리스에서는 읽기 전용에 대한 쓰기 작업이 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 데이터 형식의 경우 짝수여야 합니다.
반환
복사한 바이트 수입니다. 이것은 채워진 모든 바이트를 제외합니다.
예외
destination 매개 변수에서 지정한 OracleLob가 null인 경우
amount, sourceOffset 또는 destinationOffset 매개 변수에 지정된 값이 0보다 작거나 4GB보다 큰 경우
또는
CLOB 또는 NCLOB 데이터 형식의 amount, sourceOffset 및 destinationOffset 매개 변수에서 지정된 값이 짝수가 아닌 경우
작업이 트랜잭션에 속하지 않거나, OracleLob 개체가 null이거나, 연결이 닫힌 경우
Oracle 오류가 발생한 경우
설명
기본 데이터 형식은 항상 동일해야 합니다. 예를 들어 에서 복사하는 경우 NClob OracleLob 대상도 이어야 NClob 합니다.
대상 오프셋이 대상 의 끝을 벗어나면 LOB LOB 데이터가 복사되는 가 확장됩니다. 끝 LOB 부분과 끝 이후의 대상 오프셋 사이의 공간은 및 데이터 형식에 대한 데이터 형식 및 공백에 대해 0으로 BLOB CLOB NCLOB 패딩됩니다.
에 쓰려면 LOB LOB SQL SELECT 문에서 FOR UPDATE 절을 사용하여 를 검색해야 하며 로컬 트랜잭션이 시작되어야 합니다.
참고
이 릴리스에서는 읽기 전용에 대한 쓰기 작업이 LOB 성공할 수 있지만 서버에서 를 업데이트하지는 LOB 않습니다. 그러나 이 경우 의 로컬 LOB 복사본이 업데이트됩니다. 따라서 나중에 개체에 대한 읽기 작업은 OracleLob 쓰기 작업의 결과를 반환할 수 있습니다.
CopyTo메서드는 복사 작업을 수행하기 전에 대상의 내용을 지우지 OracleLob 않습니다.