Process.CloseMainWindow Methode

public:
 bool CloseMainWindow();

public bool CloseMainWindow();

member this.CloseMainWindow : unit -> bool

Public Function CloseMainWindow () As Boolean

Gibt zurück

true wenn die Schließen-Nachricht erfolgreich gesendet wurde; false wenn der zugeordnete Prozess nicht über ein Hauptfenster verfügt oder das Hauptfenster deaktiviert ist (z. B. wenn ein modales Dialogfeld angezeigt wird).

Ausnahmen

Beispiele

Im folgenden Beispiel wird eine Instanz von Editor gestartet. Anschließend wird die physische Speicherauslastung des zugeordneten Prozesses in 2 Sekunden für maximal 10 Sekunden abgerufen. Im Beispiel wird ermittelt, ob der Vorgang vor ablaufen 10 Sekunden abgelaufen ist. Im Beispiel wird der Prozess geschlossen, wenn er nach 10 Sekunden noch ausgeführt wird.

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

Hinweise

Wenn ein Prozess ausgeführt wird, befindet sich seine Nachrichtenschleife in einem Wartezustand. Die Nachrichtenschleife wird jedes Mal ausgeführt, wenn eine Windows-Nachricht vom Betriebssystem an den Prozess gesendet wird. Das Aufrufen CloseMainWindow sendet eine Anforderung zum Schließen des Hauptfensters, das in einer wohlgeformten Anwendung untergeordnete Fenster schließt und alle ausgeführten Nachrichtenschleifen für die Anwendung widerruft. Die Anforderung zum Beenden des Prozesses durch Aufrufen CloseMainWindow erzwingt nicht, dass die Anwendung beendet wird. Die Anwendung kann vor dem Beenden nach der Benutzerüberprüfung fragen oder das Beenden ablehnen. Verwenden Sie die Methode, um zu erzwingen, dass die Kill Anwendung beendet wird. Das Verhalten ist identisch mit dem eines CloseMainWindow Benutzers, der das Hauptfenster einer Anwendung mithilfe des Systemmenüs schließt. Daher erzwingt die Anforderung, den Prozess zu beenden, indem das Hauptfenster geschlossen wird, dass die Anwendung nicht sofort beendet wird.

Daten, die vom Prozess oder den Ressourcen bearbeitet werden, die dem Prozess zugeordnet sind, können verloren gehen, wenn Sie aufrufen Kill. Kill verursacht eine abnorme Beendigung des Prozesses und sollte nur bei Bedarf verwendet werden. CloseMainWindow ermöglicht eine geordnete Beendigung des Prozesses und schließt alle Fenster, daher ist es für Anwendungen mit einer Schnittstelle vorzuziehen. Wenn CloseMainWindow ein Fehler auftritt, können Kill Sie den Prozess beenden. Kill ist die einzige Möglichkeit, Prozesse zu beenden, die nicht über grafische Schnittstellen verfügen.

Sie können nur Prozesse aufrufen Kill , CloseMainWindow die auf dem lokalen Computer ausgeführt werden. Prozesse auf Remotecomputern können nicht beendet werden. Sie können nur Informationen für Prozesse anzeigen, die auf Remotecomputern ausgeführt werden.