OracleBFile.Read(Byte[], Int32, Int32) 메서드

정의

네임스페이스:

System.Data.OracleClient

어셈블리:

System.Data.OracleClient.dll

현재 OracleBFile 스트림에서 바이트의 시퀀스를 읽은 다음 읽은 바이트 수만큼 스트림 내에서 위치를 앞으로 이동합니다.

public:
 override int Read(cli::array <System::Byte> ^ buffer, int offset, int count);

public override int Read (byte[] buffer, int offset, int count);

override this.Read : byte[] * int * int -> int

Public Overrides Function Read (buffer As Byte(), offset As Integer, count As Integer) As Integer

매개 변수

buffer

Byte[]

바이트 배열입니다. 이 메서드는 지정된 바이트 배열의 값이 offset과 (offset + count) 사이에서 현재 원본으로부터 읽어온 바이트로 교체된 상태로 반환됩니다.

offset

Int32

현재 스트림에서 읽은 데이터를 저장하기 시작하는 buffer의 바이트 오프셋(0부터 시작)입니다.

count

Int32

현재 스트림에서 읽을 최대 바이트 수입니다.

반환

Int32

버퍼로 읽어온 총 바이트 수입니다. 이 바이트 수는 현재 바이트가 충분하지 않은 경우 요청된 바이트 수보다 작을 수 있으며 파일의 끝에 도달하면 0이 됩니다.

예외

ArgumentException

offset 및 count의 합계가 버퍼 길이보다 큽니다.

ArgumentNullException

buffer이 null 참조(Visual Basic의 경우 Nothing)인 경우

ArgumentOutOfRangeException

offset 또는 count가 음수입니다.

InvalidOperationException

BFILE과 관련된 연결이 닫힌 경우

IOException

I/O 오류가 발생했습니다.

ObjectDisposedException

스트림이 닫히거나 삭제된 후에 메서드가 호출된 경우

설명

메서드는 Read 현재 스트림에서 최대 count 바이트를 읽고 부터 offset저장 buffer 합니다. 스트림 내의 현재 위치는 읽은 바이트 수만큼 고급입니다. 그러나 예외가 발생하면 스트림 내의 현재 위치는 변경되지 않은 상태로 유지됩니다. Read 는 읽은 바이트 수를 반환합니다. 반환 값은 현재 위치가 스트림의 끝에 있는 경우에만 0입니다. Read 는 사용할 수 있는 데이터가 없는 경우 하나 이상의 데이터를 읽을 수 있을 때까지 차단됩니다. Read 는 파일의 끝에 도달한 경우에만 0을 반환합니다. Read 는 스트림의 끝에 도달하지 않은 경우에도 요청된 것보다 적은 바이트를 반환할 수 있습니다.

또는 Seek 메서드를 사용하여 Read 닫힌 OracleBFile 에 액세스하려는 시도는 스트림을 OracleBFile 자동으로 다시 엽니다.

다음 C# 예제에서는 Oracle 테이블에서 이 스키마를 가정합니다.

(col1 number, col2 BFILE)  

이 예제에서는 및 Seek 메서드를 Read 사용하여 개체에 OracleBFile 액세스하는 방법을 보여 줍니다.

byte[] buffer = new byte[100];  
OracleDataReader dataReader = command.ExecuteReader();  
using (dataReader) {  
    if (dataReader.Read()) {  
            OracleBFile BFile = dataReader.GetOracleBFile(1);  
        using (BFile) {  
            BFile.Seek(0, SeekOrigin.Begin);  
            BFile.Read(buffer, 0, 100);  
        }  
    }  
}