ConsoleCancelEventArgs Classe
TOC
Réduire la table des matières
Développer la table des matières
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

ConsoleCancelEventArgs, classe

 

Fournit des données pour l'événement Console.CancelKeyPress.Cette classe ne peut pas être héritée.

Espace de noms:   System
Assembly:  mscorlib (dans mscorlib.dll)

System.Object
  System.EventArgs
    System.ConsoleCancelEventArgs

[SerializableAttribute]
public sealed class ConsoleCancelEventArgs : EventArgs

NomDescription
System_CAPS_pubpropertyCancel

Obtient ou définit une valeur qui indique si le fait d'appuyer simultanément sur la touche de modification Control et la touche de console (Ctrl+C) ou la touche Ctrl + Saut C met fin au processus actuel.La valeur par défaut est false, qui met fin au processus actuel.

System_CAPS_pubpropertySpecialKey

Obtient la combinaison de touches de modification et de clé de console qui a interrompu le processus en cours.

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut. (Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

Un utilisateur peut interrompre un processus d'application console en appuyant simultanément sur la touche de modification de Control et la clé de console d'C (Ctrl+C), ou la touche de modification de Control et la clé de console de saut (Ctrl+Break).. Le.NET Framework fournit par conséquent un objet ConsoleCancelEventArgs au gestionnaire d'événements pour l'événement d'Console.CancelKeyPress spécifie si le processus doit être annulé.

Si la propriété d'Cancel est définie au gestionnaire d'true en cas, le processus est repris ; sinon, le processus est terminé.Par défaut, la valeur de la propriété de ConsoleCancelEventArgs est false, et le processus se termine.

L'exemple suivant montre comment utiliser la classe d'ConsoleCancelEventArgs pour gérer un événement.

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

.NET Framework
Disponible depuis 2.0

Tous les membres statiques (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Retour au début
Afficher:
© 2016 Microsoft