Process.HasExited Eigenschaft

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.Process.dll

Quelle:

Process.cs

Ruft einen Wert ab, der angibt, ob der zugehörige Prozess beendet wurde.

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

public bool HasExited { get; }

member this.HasExited : bool

Public ReadOnly Property HasExited As Boolean

Eigenschaftswert

Boolean

true, wenn der Betriebssystemprozess, auf den die Process-Komponente verweist, beendet wurde; andernfalls false.

Ausnahmen

InvalidOperationException

Diesem Objekt ist kein Prozess zugeordnet.

Win32Exception

Der Exitcode für den Prozess konnte nicht abgerufen werden.

NotSupportedException

Sie versuchen, auf die HasExited-Eigenschaft für einen Prozess zuzugreifen, der auf einem Remotecomputer ausgeführt wird. Diese Eigenschaft ist nur für Prozesse verfügbar, die auf dem lokalen Computer ausgeführt werden.

Beispiele

Im folgenden Beispiel wird eine instance von Editor gestartet. Anschließend wird die physische Speicherauslastung des zugeordneten Prozesses in Intervallen von 2 Sekunden für maximal 10 Sekunden abgerufen. Das Beispiel erkennt, ob der Prozess beendet wird, bevor 10 Sekunden verstrichen sind. Das Beispiel schließt den Prozess, wenn er nach 10 Sekunden noch ausgeführt wird.

#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

Hinweise

Der Wert von true für HasExited gibt an, dass der zugeordnete Prozess entweder normal oder ungewöhnlich beendet wurde. Sie können das Beenden des zugeordneten Prozesses anfordern oder erzwingen, indem Sie oder KillaufrufenCloseMainWindow. Wenn ein Handle für den Prozess geöffnet ist, gibt das Betriebssystem den Prozessspeicher frei, wenn der Prozess beendet wurde, behält jedoch administrative Informationen zum Prozess bei, z. B. das Handle, den Exitcode und die Beendigungszeit. Um diese Informationen abzurufen, können Sie die ExitCode Eigenschaften und ExitTime verwenden. Diese Eigenschaften werden automatisch für Prozesse aufgefüllt, die von dieser Komponente gestartet wurden. Die administrativen Informationen werden freigegeben, wenn alle Komponenten, die Process dem Systemprozess zugeordnet sind, zerstört werden und keine weiteren Handles für den beendeten Prozess enthalten.

Ein Prozess kann unabhängig von Ihrem Code beendet werden. Wenn Sie den Prozess mit dieser Komponente gestartet haben, aktualisiert das System den Wert von HasExited automatisch, auch wenn der zugeordnete Prozess unabhängig beendet wird.

Hinweis

Wenn die Standardausgabe an asynchrone Ereignishandler umgeleitet wurde, ist es möglich, dass die Ausgabeverarbeitung nicht abgeschlossen ist, wenn diese Eigenschaft zurückgibt true. Um sicherzustellen, dass die asynchrone Ereignisbehandlung abgeschlossen wurde, rufen Sie die Überladung auf, die WaitForExit() keinen Parameter benötigt, bevor Sie überprüfen HasExited.

Weitere Informationen

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