Dispatcher.DisableProcessing Methode

Definition

Deaktiviert Verarbeitung der Dispatcher-Warteschlange.Disables processing of the Dispatcher queue.

public:
 System::Windows::Threading::DispatcherProcessingDisabled DisableProcessing();
public System.Windows.Threading.DispatcherProcessingDisabled DisableProcessing ();
member this.DisableProcessing : unit -> System.Windows.Threading.DispatcherProcessingDisabled
Public Function DisableProcessing () As DispatcherProcessingDisabled

Gibt zurück

Eine Struktur, mit der die Dispatcherverarbeitung wieder aktiviert wird.A structure used to re-enable dispatcher processing.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Verteiler Verarbeitung deaktiviert und die Verteiler Verarbeitung erneut aktiviert wird.The following example shows how to disable dispatcher processing and re-enable dispatcher processing. DisableProcessing wird in einer using -Anweisung aufgerufen.DisableProcessing is called in a using statement. DisableProcessing gibt eine DispatcherProcessingDisabled Struktur zurück, die als Objekt verwendet wird, das verworfen wird, wenn der using -Block beendet wird.DisableProcessing returns a DispatcherProcessingDisabled structure that is used as the object to be disposed when the using block finishes. Wenn Dispose für die DispatcherProcessingDisabled Struktur aufgerufen wird, wird die Verteiler Verarbeitung wieder aktiviert.When Dispose is called on the DispatcherProcessingDisabled structure, dispatcher processing is re-enabled.

// The Dispose() method is called at the end of the using statement.
// Calling Dispose on the DispatcherProcessingDisabled structure, 
// which is returned from the call to DisableProcessing, will
// re-enalbe Dispatcher processing.
using (Dispatcher.DisableProcessing())
{
    // Do work while the dispatcher processing is disabled.
    Thread.Sleep(2000);
}
' The Dispose() method is called at the end of the using statement.
' Calling Dispose on the DispatcherProcessingDisabled structure, 
' which is returned from the call to DisableProcessing, will
' re-enable Dispatcher processing.
Using Dispatcher.DisableProcessing()
    ' Do work while the dispatcher processing is disabled.
    Thread.Sleep(2000)
End Using

Hinweise

Die Deaktivierung der Verteiler Verarbeitung ist eine erweiterte Methode, mit der die Wahrscheinlichkeit eines nicht verknüpften erneuten eintreten vermieden werden soll.Disabling dispatcher processing is an advanced method that is intended to eliminate the chance of unrelated reentrancy.

Die Deaktivierung der Verarbeitung hat folgende Auswirkungen:The effects of disabling processing are as follows:

  • CLR-Sperren leiten Nachrichten nicht intern.CLR locks will not pump messages internally.

  • DispatcherFrame Objekte dürfen nicht per pushübertragung übermittelt werden.DispatcherFrame objects are not allowed to be pushed.

  • Die Nachrichtenverarbeitung ist nicht zulässig.Message processing is not permitted.

Die DispatcherProcessingDisabled Struktur, die DisableProcessing zurückgibt, wenn Sie aufgerufen wird, kann verwendet werden, um die Dispatcherverarbeitung erneut zu aktivieren.The DispatcherProcessingDisabled structure that DisableProcessing returns when it is called can be used to re-enable dispatcher processing. Durch Aufrufen von Dispose für die DispatcherProcessingDisabled Struktur wird die Verarbeitung wieder aktiviert.Calling Dispose on the DispatcherProcessingDisabled structure re-enables processing.

DisableProcessing können nur für den Thread aufgerufen werden, dem die Dispatcher zugeordnet ist.DisableProcessing can only be called on the thread the Dispatcher is associated with.

Gilt für: