Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Console.CancelKeyPress-Ereignis

 

Veröffentlicht: Oktober 2016

Tritt ein, wenn die Control-Modifizierertaste (STRG) und entweder die ConsoleKey.C-Konsolentaste (c) oder die UNTBR-TASTE gleichzeitig gedrückt werden (STRG+C oder STRG+UNTBR).

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public static event ConsoleCancelEventHandler CancelKeyPress

Dieses Ereignis dient in Verbindung mit System.ConsoleCancelEventHandler und System.ConsoleCancelEventArgs. Die CancelKeyPress -Ereignis können Sie eine Konsolenanwendung, die das STRG + C-Signal abfangen, damit der Ereignishandler können Sie entscheiden, ob fortgesetzt oder beendet. Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Wenn der Benutzer STRG + C oder STRG + UNTBR, drückt die CancelKeyPress Ereignis wird ausgelöst, und die Anwendung ConsoleCancelEventHandler -Ereignishandler ausgeführt wird. Der Ereignishandler übergeben wird ein ConsoleCancelEventArgs Objekt, das zwei nützliche Eigenschaften verfügt:

  • SpecialKey, womit Sie bestimmen, ob der Handler aufgerufen wurde, als Ergebnis der Benutzer durch Drücken von STRG + C (der Eigenschaftswert ist ConsoleSpecialKey.ControlC) oder STRG + UNTBR (der Eigenschaftswert ist ConsoleSpecialKey.ControlBreak).

  • Cancel, womit Sie bestimmen, wie für Ihre Anwendung sollte auf die Benutzer reagieren drücken STRG + C oder STRG + UNTBR. Wird standardmäßig die Cancel Eigenschaft ist false, die Ursachen programmausführung zu beenden, wenn der Ereignishandler beendet wird. Ändern die Eigenschaft auf true gibt an, dass die Anwendung weiterhin ausgeführt werden soll.

System_CAPS_tipTipp

Wenn Ihre Anwendung einfache Anforderungen hat, können Sie mithilfe der TreatControlCAsInput Eigenschaft anstelle dieses Ereignis. Durch Festlegen dieser Eigenschaft auf false, können Sie sicherstellen, dass Ihre Anwendung immer beendet, wenn der Benutzer STRG + C drückt. Durch Festlegen auf true, können Sie sicherstellen, dass die Anwendung nicht durch Drücken von STRG + C beendet wird.

Der Ereignishandler für dieses Ereignis wird über einen Threadpoolthread ausgeführt.

Im folgende Beispiel wird veranschaulicht, wie die CancelKeyPress Ereignis verwendet wird. Der Lesevorgang wird unterbrochen, wenn Sie STRG + C drücken, und die myHandler -Ereignishandler wird aufgerufen. Bei der Eingabe an den Ereignishandler der ConsoleCancelEventArgs.Cancel Eigenschaft ist false, d. h., die der aktuelle Vorgang beendet wird, wenn der Ereignishandler beendet wird. Der Ereignishandler wird jedoch die ConsoleCancelEventArgs.Cancel Eigenschaft true, welche bedeutet, dass der Prozess nicht beendet, und der Lesevorgang wird fortgesetzt.

using System;

class Sample 
{
    public static void Main()
    {
        ConsoleKeyInfo cki;

        Console.Clear();

        // Establish an event handler to process key press events.
        Console.CancelKeyPress += new ConsoleCancelEventHandler(myHandler);
        while (true) {
            Console.Write("Press any key, or 'X' to quit, or ");
            Console.WriteLine("CTRL+C to interrupt the read operation:");

            // Start a console read operation. Do not display the input.
            cki = Console.ReadKey(true);

            // Announce the name of the key that was pressed .
            Console.WriteLine("  Key pressed: {0}\n", cki.Key);

            // Exit if the user pressed the 'X' key.
            if (cki.Key == ConsoleKey.X) break;
        }
    }

    protected static void myHandler(object sender, ConsoleCancelEventArgs args)
    {
        Console.WriteLine("\nThe read operation has been interrupted.");

        Console.WriteLine("  Key pressed: {0}", args.SpecialKey);

        Console.WriteLine("  Cancel property: {0}", args.Cancel);

        // Set the Cancel property to true to prevent the process from terminating.
        Console.WriteLine("Setting the Cancel property to true...");
        args.Cancel = true;

        // Announce the new value of the Cancel property.
        Console.WriteLine("  Cancel property: {0}", args.Cancel);
        Console.WriteLine("The read operation will resume...\n");
    }
}
// The example displays output similar to the follwoing:
//    Press any key, or 'X' to quit, or CTRL+C to interrupt the read operation:
//      Key pressed: J
//    
//    Press any key, or 'X' to quit, or CTRL+C to interrupt the read operation:
//      Key pressed: Enter
//    
//    Press any key, or 'X' to quit, or CTRL+C to interrupt the read operation:
//    
//    The read operation has been interrupted.
//      Key pressed: ControlC
//      Cancel property: False
//    Setting the Cancel property to true...
//      Cancel property: True
//    The read operation will resume...
//    
//      Key pressed: Q
//    
//    Press any key, or 'X' to quit, or CTRL+C to interrupt the read operation:
//      Key pressed: X

UIPermission

for modifying safe top-level windows and subwindows. Associated enumeration: F:System.Security.Permissions.UIPermissionWindow.SafeTopLevelWindows

.NET Framework
Verfügbar seit 2.0
Zurück zum Anfang
Anzeigen: