Console.WindowHeight Właściwość

Definicja

Pobiera lub ustawia wysokość obszaru okna konsoli.

public static int WindowHeight { [System.Runtime.Versioning.UnsupportedOSPlatform("android")] [System.Runtime.Versioning.UnsupportedOSPlatform("browser")] [System.Runtime.Versioning.UnsupportedOSPlatform("ios")] [System.Runtime.Versioning.UnsupportedOSPlatform("tvos")] get; [System.Runtime.Versioning.SupportedOSPlatform("windows")] set; }
public static int WindowHeight { [System.Runtime.Versioning.UnsupportedOSPlatform("browser")] get; [System.Runtime.Versioning.SupportedOSPlatform("windows")] set; }
[System.Runtime.Versioning.UnsupportedOSPlatform("android")]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public static int WindowHeight { get; set; }
public static int WindowHeight { get; set; }

Wartość właściwości

Wysokość okna konsoli mierzona w wierszach.

Atrybuty

Wyjątki

Wartość WindowWidth właściwości lub wartości WindowHeight właściwości jest mniejsza lub równa 0.

-lub-

Wartość WindowHeight właściwości plus wartość WindowTop właściwości jest większa lub równa Int16.MaxValue.

-lub-

Wartość WindowWidth właściwości lub wartości WindowHeight właściwości jest większa niż największa możliwa szerokość lub wysokość okna dla bieżącej rozdzielczości ekranu i czcionki konsoli.

Błąd podczas odczytywania lub zapisywania informacji.

Operacja ustawiania jest wywoływana w systemie operacyjnym innym niż Windows.

Przykłady

W tym przykładzie przedstawiono metodę SetWindowSize oraz WindowWidth właściwości i WindowHeight . Należy uruchomić przykład, aby zobaczyć pełny efekt zmiany rozmiaru okna konsoli.

W przykładzie są raportowane wymiary okna konsoli ustawione na 85 kolumn i 43 wiersze, a następnie czeka na naciśnięcie klawisza. Po naciśnięciu dowolnego klawisza wymiary okna konsoli zostaną zmniejszone o połowę, zostaną zgłoszone nowe wymiary, a przykład czeka na inne naciśnięcie klawisza. Na koniec po naciśnięciu dowolnego klawisza okno konsoli zostanie przywrócone do oryginalnych wymiarów, a przykład zakończy działanie.

// This example demonstrates the Console.SetWindowSize method,
//                           the Console.WindowWidth property,
//                       and the Console.WindowHeight property.
using System;

class Sample
{
    public static void Main()
    {
    int origWidth, width;
    int origHeight, height;
    string m1 = "The current window width is {0}, and the " +
                "current window height is {1}.";
    string m2 = "The new window width is {0}, and the new " +
                "window height is {1}.";
    string m4 = "  (Press any key to continue...)";
//
// Step 1: Get the current window dimensions.
//
    origWidth  = Console.WindowWidth;
    origHeight = Console.WindowHeight;
    Console.WriteLine(m1, Console.WindowWidth,
                          Console.WindowHeight);
    Console.WriteLine(m4);
    Console.ReadKey(true);
//
// Step 2: Cut the window to 1/4 its original size.
//
    width  = origWidth/2;
    height = origHeight/2;
    Console.SetWindowSize(width, height);
    Console.WriteLine(m2, Console.WindowWidth,
                          Console.WindowHeight);
    Console.WriteLine(m4);
    Console.ReadKey(true);
//
// Step 3: Restore the window to its original size.
//
    Console.SetWindowSize(origWidth, origHeight);
    Console.WriteLine(m1, Console.WindowWidth,
                          Console.WindowHeight);
    }
}
/*
This example produces the following results:

The current window width is 85, and the current window height is 43.
  (Press any key to continue...)
The new window width is 42, and the new window height is 21.
  (Press any key to continue...)
The current window width is 85, and the current window height is 43.

*/

Uwagi

Próba ustawienia wartości WindowHeight właściwości podczas przekierowywania danych wyjściowych ArgumentOutOfRangeException zgłasza wyjątek lub wyjątek IOException . Aby zapobiec wyjątkowi, można ustawić wartość tej właściwości tylko wtedy, gdy IsOutputRedirected właściwość zwróci wartość false.

Dotyczy

Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1