Process.CloseMainWindow Método

public:
 bool CloseMainWindow();

public bool CloseMainWindow();

member this.CloseMainWindow : unit -> bool

Public Function CloseMainWindow () As Boolean

Devoluções

true se a mensagem de encerramento fosse enviada com sucesso; false se o processo associado não tiver uma janela principal ou se a janela principal estiver desativada (por exemplo, se estiver a ser exibido um diálogo modal).

Exceções

Exemplos

O exemplo seguinte inicia uma instância de Notepad. Depois, recupera o uso físico da memória do processo associado a intervalos de 2 segundos durante um máximo de 10 segundos. O exemplo deteta se o processo sai antes de terem passado 10 segundos. O exemplo fecha o processo se este continuar a correr após 10 segundos.

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

Observações

Quando um processo está em execução, o seu ciclo de mensagens está em estado de espera. O ciclo de mensagens é executado sempre que uma mensagem do Windows é enviada ao processo pelo sistema operativo. A chamada CloseMainWindow envia um pedido para fechar a janela principal que, numa aplicação bem formada, fecha as janelas filhos e revoga todos os ciclos de mensagens em execução da aplicação. O pedido para sair do processo por chamada CloseMainWindow não obriga a aplicação a encerrar. A aplicação pode pedir a verificação do utilizador antes de sair, ou pode recusar-se a sair. Para forçar a aplicação a sair, use o Kill método. O comportamento de CloseMainWindow é idêntico ao de um utilizador a fechar a janela principal de uma aplicação usando o menu do sistema. Portanto, o pedido para sair do processo fechando a janela principal não obriga a aplicação a encerrar imediatamente.

Os dados editados pelo processo ou os recursos alocados ao processo podem ser perdidos se chamar Kill. Kill causa uma terminação anormal do processo e deve ser usada apenas quando necessário. CloseMainWindow permite uma terminação ordenada do processo e fecha todas as janelas, pelo que é preferível para aplicações com interface. Se CloseMainWindow falhar, podes usar Kill para terminar o processo. Kill é a única forma de terminar processos que não têm interfaces gráficas.

Podes ligar Kill e CloseMainWindow só para processos que estão a correr no computador local. Não pode fazer com que processos em computadores remotos saiam. Só pode visualizar a informação dos processos a correr em computadores remotos.