다음을 통해 공유


이진 데이터 검색

적용 대상: .NET Framework .NET .NET Standard

ADO.NET 다운로드

DataReader는 기본적으로 전체 데이터 행을 사용할 수 있게 되는 즉시 들어오는 데이터를 행으로 로드합니다. 그러나 BLOB(Binary Large Object)는 단일 행에 포함할 수 없는 기가바이트 데이터를 포함할 수 있으므로 다르게 처리되어야 합니다. Command.ExecuteReader 메서드에는 CommandBehavior 인수를 사용하여 DataReader의 기본 동작을 수정하는 오버로드가 있습니다. ExecuteReader 메서드에 SequentialAccess를 전달하면 데이터 행을 로드하는 대신 데이터를 받을 때 순서대로 로드하도록 DataReader의 기본 동작을 수정할 수 있습니다. 이것은 BLOB 또는 기타 대형 데이터 구조를 로드하는 데 적합합니다.

참고 항목

SequentialAccess를 사용하도록 DataReader를 설정할 경우 반환된 필드에 액세스하는 순서에 주의해야 합니다. 행 전체를 사용할 수 있게 되는 경우 곧바로 해당 전체 행을 로드하는 DataReader의 기본 동작을 사용하면 다음 행을 읽기 전까지는 반환된 필드에 어떤 순서로든 액세스할 수 있습니다. 그러나 SequentialAccess를 사용할 때는 DataReader가 반환한 필드에 순서대로 액세스해야 합니다. 예를 들어, 쿼리에서 세 열을 반환하고 그 셋째 열이 BLOB이면 셋째 필드의 BLOB 데이터에 액세스하기 전에 첫째와 둘째 필드의 값을 반환해야 합니다. 첫째나 둘째 필드에 액세스하기 전에 셋째 필드에 액세스하면 첫째와 둘째 필드 값을 더 이상 사용할 수 없습니다. 이는 SequentialAccess가 데이터를 순서대로 반환하도록 DataReader를 수정했으므로 DataReader가 한 번 데이터를 읽은 후에는 해당 데이터를 사용할 수 없기 때문입니다.

BLOB 필드의 데이터에 액세스할 때는 DataReader의 형식화된 접근자인 GetBytes 또는 GetChars를 사용하여 배열을 데이터로 채웁니다. 캐릭터 데이터에 GetString을 사용할 수도 있지만 시스템 리소스를 절약하기 위해 전체 BLOB 값을 단일 문자열 변수에 로드하지 않을 수도 있습니다. 대신 반환될 데이터의 특정 버퍼 크기와 반환된 데이터에서 읽은 첫째 바이트 또는 문자의 시작 위치를 지정할 수 있습니다. GetBytesGetChars는 반환된 바이트 또는 문자 수를 나타내는 long 값을 반환합니다. null 배열을 GetBytes 또는 GetChars에 전달하면 반환되는 long 값은 BLOB의 총 바이트 또는 문자 수가 됩니다. 배열의 인덱스를 읽고 있는 데이터의 시작 위치로서 선택적으로 지정할 수 있습니다.

예시

다음 예제에서는 pubs 샘플 데이터베이스에서 게시자 ID와 로고를 반환합니다. 게시자 ID(pub_id)는 문자 필드이고 로고는 BLOB 이미지입니다. logo 필드는 비트맵이므로 이 예제에서는 GetBytes를 사용하여 이진 데이터를 반환합니다. 필드에 순차적으로 액세스해야 하므로 현재 데이터 행에 대해 게시자 ID가 로고에 앞서 액세스됩니다.

// Assumes that connection is a valid SqlConnection object.  
SqlCommand command = new SqlCommand(
    "SELECT pub_id, logo FROM pub_info", connection);

// Writes the BLOB to a file (*.bmp).  
System.IO.FileStream stream;
// Streams the BLOB to the FileStream object.  
System.IO.BinaryWriter writer;

// Size of the BLOB buffer.  
int bufferSize = 100;
// The BLOB byte[] buffer to be filled by GetBytes.  
byte[] outByte = new byte[bufferSize];
// The bytes returned from GetBytes.  
long retval;
// The starting position in the BLOB output.  
long startIndex = 0;

// The publisher id to use in the file name.  
string pubID = "";

// Open the connection and read data into the DataReader.  
connection.Open();
SqlDataReader reader = command.ExecuteReader(CommandBehavior.SequentialAccess);

while (reader.Read())
{
    // Get the publisher id, which must occur before getting the logo.  
    pubID = reader.GetString(0);

    // Create a file to hold the output.  
    stream = new System.IO.FileStream(
        "logo" + pubID + ".bmp", System.IO.FileMode.OpenOrCreate, System.IO.FileAccess.Write);
    writer = new System.IO.BinaryWriter(stream);

    // Reset the starting byte for the new BLOB.  
    startIndex = 0;

    // Read bytes into outByte[] and retain the number of bytes returned.  
    retval = reader.GetBytes(1, startIndex, outByte, 0, bufferSize);

    // Continue while there are bytes beyond the size of the buffer.  
    while (retval == bufferSize)
    {
        writer.Write(outByte);
        writer.Flush();

        // Reposition start index to end of last buffer and fill buffer.  
        startIndex += bufferSize;
        retval = reader.GetBytes(1, startIndex, outByte, 0, bufferSize);
    }

    // Write the remaining buffer.  
    writer.Write(outByte, 0, (int)retval);
    writer.Flush();

    // Close the output file.  
    writer.Close();
    stream.Close();
}

// Close the reader and the connection.  
reader.Close();
connection.Close();

참고 항목