Process.CloseMainWindow Méthode

public:
 bool CloseMainWindow();

public bool CloseMainWindow();

member this.CloseMainWindow : unit -> bool

Public Function CloseMainWindow () As Boolean

Retours

true si le message de fermeture a été envoyé avec succès ; false si le processus associé n’a pas de fenêtre principale ou si la fenêtre principale est désactivée (par exemple, si une boîte de dialogue modale est affichée).

Exceptions

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é à 2 secondes pendant un maximum de 10 secondes. L’exemple détecte si le processus se termine avant 10 secondes. L’exemple ferme le processus s’il est toujours en cours d’exécution après 10 secondes.

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);
            }
        }
    }
}

open System.ComponentModel
open System.Diagnostics
open System.IO
open System.Threading


try
    use myProcess = Process.Start "Notepad.exe"
    // Display physical memory usage 5 times at intervals of 2 seconds.
    let mutable i = 0

    while i < 5 && not myProcess.HasExited do
        // Discard cached information about the process.
        myProcess.Refresh()
        // Print working set to console.
        printfn $"Physical Memory Usage: {myProcess.WorkingSet64}"
        // Wait 2 seconds.
        Thread.Sleep 2000
        i <- i + 1
    // Close process by sending a close message to its main window.
    myProcess.CloseMainWindow() |> ignore
    // Free resources associated with process.
    myProcess.Close()
with
| :? Win32Exception
| :? FileNotFoundException as e ->
    printfn "The following exception was raised: "
    printfn $"{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 s’exécute, 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 requête pour fermer la fenêtre principale, 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 sortie du processus en appelant CloseMainWindow ne force pas l’application à quitter. L’application peut demander la vérification de l’utilisateur avant de quitter, ou elle peut refuser de quitter. Pour forcer l’application à quitter, utilisez la Kill méthode. Le comportement est CloseMainWindow identique à celui d’un utilisateur fermant la fenêtre principale d’une application à l’aide du menu système. Par conséquent, la demande de fermeture du processus en fermant la fenêtre principale 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 doit être utilisé uniquement si nécessaire. CloseMainWindow active une terminaison ordonnée du processus et ferme toutes les fenêtres. Il est donc préférable pour les applications avec une interface. En CloseMainWindow cas d’échec, vous pouvez utiliser Kill pour arrêter le processus. Kill est le seul moyen d’arrêter les 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 ne pouvez afficher des informations que pour les processus s’exécutant sur des ordinateurs distants.