Dispatcher.VerifyAccess Methode

Definition

Namespace:

System.Windows.Threading

Assembly:

WindowsBase.dll

Bestimmt, ob der aufrufende Thread auf dieses Dispatcher zugreifen kann.

public:
 void VerifyAccess();

public void VerifyAccess ();

member this.VerifyAccess : unit -> unit

Public Sub VerifyAccess ()

Ausnahmen

InvalidOperationException

Der aufrufende Thread kann nicht auf diesen Dispatcher zugreifen.

Beispiele

Im folgenden Beispiel wird ermittelt VerifyAccess , ob ein Thread Zugriff auf den Thread hat, auf den ein Thread Button erstellt wurde. Die Methode verwendet ein Objekt als Argument, das in eine Button. Die VerifyAccess Methode für die Dispatcher Button Methode wird aufgerufen, um den Zugriff auf den Thread zu überprüfen.

Wenn der aufrufende Thread Zugriff auf den DispatcherThread hat, wird dies Button aktualisiert, indem sie nur auf die Member der .Button

Wenn der aufrufende Thread keinen Zugriff hat, wird ein InvalidOperationException Fehler ausgelöst. In diesem Beispiel wird die Ausnahme abgefangen und eine Stellvertretung verschoben, die ein Button Argument akzeptiert, auf die Dispatcher des Button. Dadurch Dispatcher wird die Aktualisierung der Button.

// Uses the Dispatcher.VerifyAccess method to determine if 
// the calling thread has access to the thread the UI object is on.
private void TryToUpdateButtonVerifyAccess(object uiObject)
{
    Button theButton = uiObject as Button;

    if (theButton != null)
    {
        try
        {   
            // Check if this thread has access to this object.
            theButton.Dispatcher.VerifyAccess();

            // The thread has access to the object, so update the UI.
            UpdateButtonUI(theButton);
        }

        // Cannot access objects on the thread.
        catch (InvalidOperationException e)
        {
            // Exception Error Message.
            MessageBox.Show("Exception ToString: \n\n" + e.ToString(), 
                "Execption Caught! Thrown During AccessVerify().");

            MessageBox.Show("Pushing job onto UI Thread Dispatcher");

            // Placing job onto the Dispatcher of the UI Thread.
            theButton.Dispatcher.BeginInvoke(DispatcherPriority.Normal,
                new UpdateUIDelegate(UpdateButtonUI), theButton);
        }
    }
}

' Uses the Dispatcher.VerifyAccess method to determine if 
' the calling thread has access to the thread the UI object is on.
Private Sub TryToUpdateButtonVerifyAccess(ByVal uiObject As Object)
    Dim theButton As Button = TryCast(uiObject, Button)

    If theButton IsNot Nothing Then
        Try
            ' Check if this thread has access to this object.
            theButton.Dispatcher.VerifyAccess()

            ' The thread has access to the object, so update the UI.
            UpdateButtonUI(theButton)

            ' Cannot access objects on the thread.
        Catch e As InvalidOperationException
            ' Exception Error Message.
            MessageBox.Show("Exception ToString: " & vbLf & vbLf & e.ToString(), "Execption Caught! Thrown During AccessVerify().")

            MessageBox.Show("Pushing job onto UI Thread Dispatcher")

            ' Placing job onto the Dispatcher of the UI Thread.
            theButton.Dispatcher.BeginInvoke(DispatcherPriority.Normal, New UpdateUIDelegate(AddressOf UpdateButtonUI), theButton)
        End Try
    End If
End Sub

Hinweise

Nur der Thread, auf dem er Dispatcher erstellt wird, kann auf die Dispatcher.

Diese Methode ist öffentlich; Daher kann jeder Thread überprüfen, ob er Zugriff auf die Dispatcher.

Der Unterschied zwischen CheckAccess und VerifyAccess wird CheckAccess vom Typ Boolean zurückgegeben, wenn der aufrufende Thread keinen Zugriff auf die Dispatcher und VerifyAccess löst eine Ausnahme aus.

Siehe auch

• CheckAccess()