Compartilhar via


Process.CloseMainWindow Método

Definição

Fecha um processo que tem uma interface do usuário enviando uma mensagem de fechamento à janela principal.

public:
 bool CloseMainWindow();
public bool CloseMainWindow ();
member this.CloseMainWindow : unit -> bool
Public Function CloseMainWindow () As Boolean

Retornos

true se a mensagem de fechamento tiver sido enviada com êxito; false se o processo associado não tiver uma janela principal ou se a janela principal estiver desabilitada (por exemplo, se uma caixa de diálogo modal estiver sendo mostrada).

Exceções

O processo já terminou.

- ou -

Nenhum processo está associado a esse objeto Process.

Exemplos

O exemplo a seguir inicia uma instância do Bloco de Notas. Em seguida, ele recupera o uso de memória física do processo associado em intervalos de 2 segundos por um máximo de 10 segundos. O exemplo detecta se o processo é encerrado antes de 10 segundos. O exemplo fechará o processo se ele ainda estiver em execução após 10 segundos.

#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

Comentários

Quando um processo está em execução, seu loop de mensagem está em um estado de espera. O loop de mensagem é executado sempre que uma mensagem do Windows é enviada ao processo pelo sistema operacional. Chamar CloseMainWindow envia uma solicitação para fechar a janela main, que, em um aplicativo bem formado, fecha janelas filho e revoga todos os loops de mensagem em execução para o aplicativo. A solicitação para sair do processo chamando CloseMainWindow não força o aplicativo a sair. O aplicativo pode solicitar a verificação do usuário antes de sair ou pode se recusar a sair. Para forçar o aplicativo a sair, use o Kill método . O comportamento de CloseMainWindow é idêntico ao de um usuário fechando a janela main de um aplicativo usando o menu do sistema. Portanto, a solicitação para sair do processo fechando a janela main não força o aplicativo a sair imediatamente.

Os dados editados pelo processo ou pelos recursos alocados ao processo poderão ser perdidos se você chamar Kill. Kill causa um encerramento anormal do processo e deve ser usado somente quando necessário. CloseMainWindow permite um encerramento ordenado do processo e fecha todas as janelas, portanto, é preferível para aplicativos com uma interface . Se CloseMainWindow falhar, você poderá usar Kill para encerrar o processo. Kill é a única maneira de encerrar processos que não têm interfaces gráficas.

Você pode chamar Kill e CloseMainWindow somente para processos que estão em execução no computador local. Não é possível fazer com que os processos em computadores remotos sejam encerrados. Você só pode exibir informações para processos em execução em computadores remotos.

Aplica-se a