Console.BufferHeight Eigenschaft

Definition

Namespace:

System

Assembly:

System.Console.dll

Quelle:

Console.cs

Ruft die Höhe des Pufferbereichs ab oder legt diese fest.

public:
 static property int BufferHeight { int get(); void set(int value); };

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

[<get: System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<set: System.Runtime.Versioning.SupportedOSPlatform("windows")>]
[<get: System.Runtime.Versioning.UnsupportedOSPlatform("android")>]
[<get: System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<get: System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
static member BufferHeight : int with get, set

Public Shared Property BufferHeight As Integer

Eigenschaftswert

Int32

Die aktuelle Höhe des Pufferbereichs in Zeilen.

Attribute

UnsupportedOSPlatformAttribute SupportedOSPlatformAttribute

Ausnahmen

ArgumentOutOfRangeException

Der Wert in einem Set-Vorgang ist kleiner als oder gleich 0 (null).

- oder -

Der Wert in einem Setvorgang ist größer oder gleich Int16.MaxValue.

- oder -

Der Wert in einem Set-Vorgang ist kleiner als WindowTop + WindowHeight.

SecurityException

Der Benutzer verfügt nicht über die erforderlichen Berechtigung, um diese Aktion durchzuführen.

IOException

E/A-Fehler

PlatformNotSupportedException

Der set-Vorgang wird unter einem anderen Betriebssystem als Windows aufgerufen.

Beispiele

In diesem Beispiel werden die BufferHeight Eigenschaften und BufferWidth veranschaulicht. Das Beispiel meldet die Dimensionen eines Betriebssystemfensters, das auf eine Puffergröße von 300 Zeilen und 85 Spalten festgelegt ist.

// This example demonstrates the Console.BufferHeight and 
//                               Console.BufferWidth properties.
using namespace System;
int main()
{
   Console::WriteLine( "The current buffer height is {0} rows.", Console::BufferHeight );
   Console::WriteLine( "The current buffer width is {0} columns.", Console::BufferWidth );
}

/*
This example produces the following results:

The current buffer height is 300 rows.
The current buffer width is 85 columns.
*/

// This example demonstrates the Console.BufferHeight and
//                               Console.BufferWidth properties.
using System;

class Sample
{
    public static void Main()
    {
    Console.WriteLine("The current buffer height is {0} rows.",
                      Console.BufferHeight);
    Console.WriteLine("The current buffer width is {0} columns.",
                      Console.BufferWidth);
    }
}
/*
This example produces the following results:

The current buffer height is 300 rows.
The current buffer width is 85 columns.
*/

// This example demonstrates the Console.BufferHeight and
//                               Console.BufferWidth properties.
open System

printfn $"The current buffer height is {Console.BufferHeight} rows."
printfn $"The current buffer width is {Console.BufferWidth} columns."

// This example produces the following results:
//
// The current buffer height is 300 rows.
// The current buffer width is 85 columns.

' This example demonstrates the Console.BufferHeight and 
'                               Console.BufferWidth properties.
Class Sample
   Public Shared Sub Main()
      Console.WriteLine("The current buffer height is {0} rows.", _
                        Console.BufferHeight)
      Console.WriteLine("The current buffer width is {0} columns.", _
                        Console.BufferWidth)
   End Sub
End Class
'
'This example produces the following results:
'
'The current buffer height is 300 rows.
'The current buffer width is 85 columns.
'

Hinweise

Diese Eigenschaft definiert die Anzahl von Zeilen (oder Zeilen), die im Puffer gespeichert sind, auf den ein Konsolenmodusfenster zugreift. Im Gegensatz dazu definiert die WindowHeight -Eigenschaft die Anzahl der Zeilen, die tatsächlich zu einem bestimmten Zeitpunkt im Konsolenfenster angezeigt werden. Wenn die Anzahl der Zeilen, die tatsächlich in den Puffer geschrieben werden, die Anzahl der Zeilen überschreitet, die von der WindowHeight Eigenschaft definiert werden, kann das Fenster vertikal scrollen, sodass eine zusammenhängende Anzahl von Zeilen angezeigt wird, die der WindowHeight Eigenschaft entsprechen und sich an einer beliebigen Stelle im Puffer befinden.

Wenn ein Set-Vorgang den Wert der BufferHeight -Eigenschaft verringert, werden die obersten Zeilen entfernt. Wenn beispielsweise die Anzahl der Zeilen von 300 auf 250 reduziert wird, werden die Zeilen 0 bis 49 entfernt, und die vorhandenen Zeilen 50 bis 299 werden zu Zeilen 0 bis 249.