C# Console.BufferHeight 속성 사용법과 예제

C#에서 Console.BufferHeight 속성은 콘솔 화면의 버퍼 영역(buffer area) 높이를 가져오거나(get) 설정하는(set) 데 사용됩니다.

버퍼 높이란 화면에 실제로 표시되는 창 크기와 별개로, 스크롤을 통해 확인할 수 있는 콘솔 출력 영역의 전체 행(row) 수를 의미합니다. 이 값을 조절하면 콘솔 창에서 위아래로 스크롤하며 볼 수 있는 내용의 양을 제어할 수 있습니다.

속성 사용 방법

BufferHeight 속성은 다음과 같은 형태로 사용합니다.

Console.BufferHeight

전체 예제 코드

아래는 현재 콘솔 버퍼의 높이(행 수)를 출력하는 간단한 C# 프로그램입니다.

using System;

class Demo {
    static void Main() {
        Console.WriteLine("버퍼 높이(행 수) = " + Console.BufferHeight);
    }
}

실행 결과

버퍼 높이(행 수) = 0

참고 사항

기본적으로 Windows 콘솔의 버퍼 높이는 약 300행으로 설정되어 있지만, 실행 환경이나 리디렉션된 출력 상태에 따라 반환 값이 달라질 수 있습니다. 위 예제처럼 0이 출력되는 경우도 있는데, 이는 콘솔 환경에 따라 버퍼 정보를 정상적으로 읽어오지 못했음을 의미할 수 있습니다.

또한 Console.BufferHeight는 읽기뿐만 아니라 새로운 값을 할당하여 버퍼 높이를 직접 변경할 수도 있습니다. 단, 설정하려는 값은 현재 콘솔 창의 높이(Console.WindowHeight)보다 크거나 같아야 하며, 그렇지 않으면 ArgumentOutOfRangeException 예외가 발생합니다.