Process.CloseMainWindow Méthode

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.Process.dll

Source:

Process.cs

Ferme un processus possédant une interface utilisateur en envoyant un message de fermeture à sa fenêtre principale.

public:
 bool CloseMainWindow();

public bool CloseMainWindow ();

member this.CloseMainWindow : unit -> bool

Public Function CloseMainWindow () As Boolean

Retours

Boolean

true si le message de fermeture a été correctement envoyé ; false si le processus associé ne possède pas de fenêtre principale ou si celle-ci est désactivée (par exemple si une boîte de dialogue modale est affichée).

Exceptions

InvalidOperationException

Le processus est déjà terminé.

- ou -

Aucun processus n’est associé à cet objet Process.

Exemples

L’exemple suivant démarre une instance du Bloc-notes. Il récupère ensuite l’utilisation de la mémoire physique du processus associé à intervalles de 2 secondes pendant un maximum de 10 secondes. L’exemple détecte si le processus se termine avant l’expiration de 10 secondes. L’exemple ferme le processus s’il est toujours en cours d’exécution après 10 secondes.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   try
   {
      Process^ myProcess;
      myProcess = Process::Start(  "Notepad.exe" );
      
      // Display physical memory usage 5 times at intervals of 2 seconds.
      for ( int i = 0; i < 5; i++ )
      {
         if (  !myProcess->HasExited )
         {
            
            // Discard cached information about the process.
            myProcess->Refresh();
            
            // Print working set to console.
            Console::WriteLine( "Physical Memory Usage : {0}", myProcess->WorkingSet.ToString() );
            
            // Wait 2 seconds.
            Thread::Sleep( 2000 );
         }
         else
         {
            break;
         }

      }
      myProcess->CloseMainWindow();
      
      // Free resources associated with process.
      myProcess->Close();
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The following exception was raised: " );
      Console::WriteLine( e->Message );
   }

}

using System;
using System.ComponentModel;
using System.Diagnostics;
using System.IO;
using System.Threading;

namespace ProcessSample
{
    class MyProcessClass
    {
        public static void Main()
        {
            try
            {
                using (Process myProcess = Process.Start("Notepad.exe"))
                {
                    // Display physical memory usage 5 times at intervals of 2 seconds.
                    for (int i = 0; i < 5; i++)
                    {
                        if (!myProcess.HasExited)
                        {
                            // Discard cached information about the process.
                            myProcess.Refresh();
                            // Print working set to console.
                            Console.WriteLine($"Physical Memory Usage: {myProcess.WorkingSet}");
                            // Wait 2 seconds.
                            Thread.Sleep(2000);
                        }
                        else
                        {
                            break;
                        }
                    }

                    // Close process by sending a close message to its main window.
                    myProcess.CloseMainWindow();
                    // Free resources associated with process.
                    myProcess.Close();
                }
            }
            catch (Exception e) when (e is Win32Exception || e is FileNotFoundException)
            {
                Console.WriteLine("The following exception was raised: ");
                Console.WriteLine(e.Message);
            }
        }
    }
}

Imports System.ComponentModel
Imports System.Diagnostics
Imports System.IO
Imports System.Threading

Namespace Process_Sample
    Class MyProcessClass

        Public Shared Sub Main()
            Try
                Using myProcess = Process.Start("Notepad.exe")
                    ' Display physical memory usage 5 times at intervals of 2 seconds.
                    Dim i As Integer
                    For i = 0 To 4
                        If Not myProcess.HasExited Then

                            ' Discard cached information about the process.
                            myProcess.Refresh()
                            ' Print working set to console.
                            Console.WriteLine($"Physical Memory Usage: {myProcess.WorkingSet}")
                            ' Wait 2 seconds.
                            Thread.Sleep(2000)
                        Else
                            Exit For
                        End If

                    Next i

                    ' Close process by sending a close message to its main window.
                    myProcess.CloseMainWindow()
                    ' Free resources associated with process.
                    myProcess.Close()
                End Using
            Catch e As Exception When TypeOf e Is Win32Exception Or TypeOf e Is FileNotFoundException
                Console.WriteLine("The following exception was raised: ")
                Console.WriteLine(e.Message)
            End Try
        End Sub
    End Class
End Namespace 'Process_Sample

Remarques

Lorsqu’un processus est en cours d’exécution, sa boucle de message est dans un état d’attente. La boucle de message s’exécute chaque fois qu’un message Windows est envoyé au processus par le système d’exploitation. L’appel CloseMainWindow envoie une demande de fermeture de la fenêtre main, qui, dans une application bien formée, ferme les fenêtres enfants et révoque toutes les boucles de message en cours d’exécution pour l’application. La demande de quitter le processus en appelant CloseMainWindow ne force pas l’application à quitter. L’application peut demander la vérification de l’utilisateur avant de quitter ou refuser de quitter. Pour forcer la fermeture de l’application, utilisez la Kill méthode . Le comportement de CloseMainWindow est identique à celui d’un utilisateur fermant la fenêtre main d’une application à l’aide du menu système. Par conséquent, la demande de quitter le processus en fermant la fenêtre main ne force pas l’application à quitter immédiatement.

Les données modifiées par le processus ou les ressources allouées au processus peuvent être perdues si vous appelez Kill. Kill provoque un arrêt anormal du processus et ne doit être utilisé que si nécessaire. CloseMainWindow permet une arrêt ordonné du processus et ferme toutes les fenêtres, ce qui est préférable pour les applications avec une interface. En cas CloseMainWindow d’échec, vous pouvez utiliser Kill pour arrêter le processus. Kill est le seul moyen d’arrêter des processus qui n’ont pas d’interfaces graphiques.

Vous pouvez appeler Kill et CloseMainWindow uniquement pour les processus qui s’exécutent sur l’ordinateur local. Vous ne pouvez pas provoquer la fermeture des processus sur les ordinateurs distants. Vous pouvez uniquement afficher les informations relatives aux processus exécutés sur des ordinateurs distants.