Process.HasExited Propriedade

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.Process.dll

Origem:

Process.cs

Obtém um valor que indica se o processo associado foi encerrado.

public:
 property bool HasExited { bool get(); };

public bool HasExited { get; }

member this.HasExited : bool

Public ReadOnly Property HasExited As Boolean

Valor da propriedade

Boolean

true se o processo do sistema operacional referenciado pelo componente Process tiver sido terminado; caso contrário, false.

Exceções

InvalidOperationException

Não há nenhum processo associado ao objeto.

Win32Exception

O código de saída do processo não pôde ser recuperado.

NotSupportedException

Você está tentando acessar a propriedade HasExited para um processo que está sendo executado em um computador remoto. Essa propriedade está disponível somente para processos em execução no computador local.

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

Um valor de true para HasExited indica que o processo associado foi encerrado, normalmente ou de forma anormal. Você pode solicitar ou forçar o processo associado a sair chamando CloseMainWindow ou Kill. Se um identificador estiver aberto ao processo, o sistema operacional liberará a memória do processo quando o processo for encerrado, mas manterá informações administrativas sobre o processo, como o identificador, o código de saída e a hora de saída. Para obter essas informações, você pode usar as ExitCode propriedades e ExitTime . Essas propriedades são preenchidas automaticamente para processos iniciados por esse componente. As informações administrativas são divulgadas quando todos os Process componentes associados ao processo do sistema são destruídos e não contêm mais identificadores para o processo encerrado.

Um processo pode ser encerrado independentemente do código. Se você iniciou o processo usando esse componente, o sistema atualiza o valor de HasExited automaticamente, mesmo que o processo associado seja encerrado de forma independente.

Observação

Quando a saída padrão tiver sido redirecionada para manipuladores de eventos assíncronos, é possível que o processamento de saída não tenha sido concluído quando essa propriedade retornar true. Para garantir que o tratamento de eventos assíncronos tenha sido concluído, chame a WaitForExit() sobrecarga que não usa nenhum parâmetro antes de verificar HasExited.

Confira também

• ExitCode
• ExitTime
• WaitForExit(Int32)
• EnableRaisingEvents
• OnExited()