Process.CloseMainWindow Метод

public:
 bool CloseMainWindow();

public bool CloseMainWindow();

member this.CloseMainWindow : unit -> bool

Public Function CloseMainWindow () As Boolean

Возвращаемое значение

true Значение , если сообщение закрытия успешно отправлено; false Значение , если связанный процесс не имеет основного окна или если основное окно отключено (например, если отображается модальное диалоговое окно).

Исключения

Примеры

В следующем примере запускается экземпляр Блокнота. Затем он извлекает использование физической памяти связанного процесса через 2 секунды в течение не более 10 секунд. В этом примере определяется, завершается ли процесс до 10 секунд. Пример закрывает процесс, если он по-прежнему выполняется через 10 секунд.

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

Комментарии

При выполнении процесса цикл сообщений находится в состоянии ожидания. Цикл сообщений выполняется каждый раз, когда сообщение Windows отправляется в процесс операционной системой. Вызов CloseMainWindow отправляет запрос на закрытие главного окна, которое в хорошо сформированном приложении закрывает дочерние окна и отменяет все выполняемые циклы сообщений для приложения. Запрос на выход из процесса путем вызова CloseMainWindow не принудительно завершает работу приложения. Приложение может запросить проверку подлинности пользователя перед выходом или отказаться от выхода. Чтобы принудительно завершить работу приложения, используйте Kill метод. Поведение идентично поведению CloseMainWindow пользователя, закрывающего главное окно приложения с помощью системного меню. Таким образом, запрос на выход из процесса путем закрытия главного окна не принудительно завершает работу приложения немедленно.

Данные, редактируемые процессом или ресурсами, выделенными для процесса, могут быть потеряны при вызове Kill. Kill вызывает ненормальное завершение процесса и должно использоваться только при необходимости. CloseMainWindow включает упорядоченное завершение процесса и закрывает все окна, поэтому предпочтительнее для приложений с интерфейсом. При CloseMainWindow сбое можно использовать Kill для завершения процесса. Kill — единственный способ завершения процессов, которые не имеют графических интерфейсов.

Можно вызывать Kill и CloseMainWindow только для процессов, выполняемых на локальном компьютере. Вы не можете привести к выходу процессов на удаленных компьютерах. Вы можете просматривать только сведения о процессах, выполняемых на удаленных компьютерах.