Process.WaitForInputIdle Methode

Definition

Bewirkt, dass die Process-Komponente wartet, bis der zugeordnete Prozess in den Leerlauf wechselt.

Überlädt

WaitForInputIdle()

Bewirkt, dass die Process-Komponente unbegrenzt wartet, bis der zugeordnete Prozess in den Leerlauf wechselt. Diese Überladung ist nur für Prozesse mit einer Benutzeroberfläche und einer Nachrichtenschleife gültig.

WaitForInputIdle(Int32)

Bewirkt, dass die Process-Komponente die Dauer von angegebenen Millisekunden wartet, bis der zugeordnete Prozess in den Leerlauf wechselt. Diese Überladung ist nur für Prozesse mit einer Benutzeroberfläche und einer Nachrichtenschleife gültig.

WaitForInputIdle(TimeSpan)

Bewirkt, dass die Process Komponente auf den angegebenen timeout wartet, bis der zugeordnete Prozess in einen Leerlaufzustand wechselt. Diese Überladung ist nur für Prozesse mit einer Benutzeroberfläche und einer Nachrichtenschleife gültig.

WaitForInputIdle()

Bewirkt, dass die Process-Komponente unbegrenzt wartet, bis der zugeordnete Prozess in den Leerlauf wechselt. Diese Überladung ist nur für Prozesse mit einer Benutzeroberfläche und einer Nachrichtenschleife gültig.

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

Gibt zurück

true, wenn der zugehörige Prozess in den Leerlauf wechselt.

Ausnahmen

Der Prozess verfügt nicht über eine grafische Benutzeroberfläche.

- oder -

Es ist ein unbekannter Fehler aufgetreten. Der Prozess konnte nicht in den Leerlauf wechseln.

- oder -

Der Prozess wurde bereits beendet.

- oder -

Diesem Process-Objekt ist kein Prozess zugeordnet.

Hinweise

Verwenden Sie WaitForInputIdle() , um zu erzwingen, dass die Verarbeitung Ihrer Anwendung wartet, bis die Nachrichtenschleife in den Leerlaufzustand zurückkehrt. Wenn ein Prozess mit einer Benutzeroberfläche ausgeführt wird, wird seine Meldungsschleife jedes Mal ausgeführt, wenn eine Windows-Nachricht vom Betriebssystem an den Prozess gesendet wird. Der Prozess kehrt dann zur Nachrichtenschleife zurück. Ein Prozess befindet sich in einem Leerlaufzustand, wenn er innerhalb einer Nachrichtenschleife auf Nachrichten wartet. Dieser Zustand ist z. B. nützlich, wenn Ihre Anwendung auf einen Startprozess warten muss, um das Standard Fenster zu erstellen, bevor die Anwendung mit diesem Fenster kommuniziert.

Wenn ein Prozess über keine Nachrichtenschleife verfügt, WaitForInputIdle() löst eine aus InvalidOperationException.

Die WaitForInputIdle() -Überladung weist die Process Komponente an, unbegrenzt zu warten, bis der Prozess in der Nachrichtenschleife in den Leerlauf wechselt. Diese Anweisung kann dazu führen, dass eine Anwendung nicht mehr reagiert. Wenn der Prozess beispielsweise so geschrieben wird, dass seine Nachrichtenschleife immer sofort beendet wird, wie im Codefragment while(true).

Weitere Informationen

Gilt für:

WaitForInputIdle(Int32)

Bewirkt, dass die Process-Komponente die Dauer von angegebenen Millisekunden wartet, bis der zugeordnete Prozess in den Leerlauf wechselt. Diese Überladung ist nur für Prozesse mit einer Benutzeroberfläche und einer Nachrichtenschleife gültig.

public:
 bool WaitForInputIdle(int milliseconds);
public bool WaitForInputIdle (int milliseconds);
member this.WaitForInputIdle : int -> bool
Public Function WaitForInputIdle (milliseconds As Integer) As Boolean

Parameter

milliseconds
Int32

Ein Wert von 1 bis Int32.MaxValue , der angibt, wie lange in Millisekunden auf den zugehörigen Prozess im Leerlauf gewartet werden soll. Der Wert 0 gibt eine sofortige Rückgabe an, der Wert -1 gibt eine unendliche Wartezeit an.

Gibt zurück

true, wenn der zugeordnete Prozess in den Leerlauf wechselt, andernfalls false.

Ausnahmen

Der Prozess verfügt nicht über eine grafische Benutzeroberfläche.

- oder -

Es ist ein unbekannter Fehler aufgetreten. Der Prozess konnte nicht in den Leerlauf wechseln.

- oder -

Der Prozess wurde bereits beendet.

- oder -

Diesem Process-Objekt ist kein Prozess zugeordnet.

Hinweise

Verwenden Sie WaitForInputIdle(Int32) , um zu erzwingen, dass die Verarbeitung Ihrer Anwendung wartet, bis die Nachrichtenschleife in den Leerlaufzustand zurückkehrt. Wenn ein Prozess mit einer Benutzeroberfläche ausgeführt wird, wird seine Meldungsschleife jedes Mal ausgeführt, wenn eine Windows-Nachricht vom Betriebssystem an den Prozess gesendet wird. Der Prozess kehrt dann zur Nachrichtenschleife zurück. Ein Prozess befindet sich in einem Leerlaufzustand, wenn er innerhalb einer Nachrichtenschleife auf Nachrichten wartet. Dieser Zustand ist z. B. nützlich, wenn Ihre Anwendung auf einen Startprozess warten muss, um das Standard Fenster zu erstellen, bevor die Anwendung mit diesem Fenster kommuniziert.

Wenn ein Prozess über keine Nachrichtenschleife verfügt, WaitForInputIdle(Int32) löst eine aus InvalidOperationException.

Die WaitForInputIdle(Int32) Überladung weist die Process Komponente an, eine begrenzte Zeit zu warten, bis der Prozess in der Nachrichtenschleife im Leerlauf liegt. Wenn der zugeordnete Prozess am Ende des Intervalls nicht in den Leerlauf geraten ist, weil die Schleife noch Nachrichten verarbeitet, false wird an die aufrufende Prozedur zurückgegeben.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Weitere Informationen

Gilt für:

WaitForInputIdle(TimeSpan)

Bewirkt, dass die Process Komponente auf den angegebenen timeout wartet, bis der zugeordnete Prozess in einen Leerlaufzustand wechselt. Diese Überladung ist nur für Prozesse mit einer Benutzeroberfläche und einer Nachrichtenschleife gültig.

public:
 bool WaitForInputIdle(TimeSpan timeout);
public bool WaitForInputIdle (TimeSpan timeout);
member this.WaitForInputIdle : TimeSpan -> bool
Public Function WaitForInputIdle (timeout As TimeSpan) As Boolean

Parameter

timeout
TimeSpan

Die Zeitspanne in Millisekunden, während der gewartet werden soll, dass der zugeordnete Prozess in den Leerlauf wechselt.

Gibt zurück

true, wenn der zugeordnete Prozess in den Leerlauf wechselt, andernfalls false.

Ausnahmen

Der Prozess verfügt nicht über eine grafische Benutzeroberfläche.

- oder -

Es ist ein unbekannter Fehler aufgetreten. Der Prozess konnte nicht in den Leerlauf wechseln.

- oder -

Der Prozess wurde bereits beendet.

- oder -

Diesem Process-Objekt ist kein Prozess zugeordnet.

Hinweise

Verwenden Sie WaitForInputIdle(TimeSpan) , um zu erzwingen, dass die Verarbeitung Ihrer Anwendung wartet, bis die Nachrichtenschleife in den Leerlaufzustand zurückkehrt.

Wenn ein Prozess mit einer Benutzeroberfläche ausgeführt wird, wird seine Meldungsschleife jedes Mal ausgeführt, wenn eine Windows-Nachricht vom Betriebssystem an den Prozess gesendet wird.

Der Prozess kehrt dann zur Nachrichtenschleife zurück. Ein Prozess befindet sich in einem Leerlaufzustand, wenn er innerhalb einer Nachrichtenschleife auf Nachrichten wartet.

Dieser Zustand ist z. B. nützlich, wenn Ihre Anwendung auf einen Startprozess warten muss, um das Standard Fenster zu erstellen, bevor die Anwendung mit diesem Fenster kommuniziert.

Gilt für: