Dispatcher.VerifyAccess Méthode

Définition

Espace de noms:

System.Windows.Threading

Assembly:

WindowsBase.dll

Détermine si le thread appelant a accès à ce Dispatcher.

public:
 void VerifyAccess();

public void VerifyAccess ();

member this.VerifyAccess : unit -> unit

Public Sub VerifyAccess ()

Exceptions

InvalidOperationException

Le thread appelant n'a pas accès à ce Dispatcher.

Exemples

L’exemple suivant utilise VerifyAccess pour déterminer si un thread a accès au thread sur lequel un Button a été créé. La méthode prend un objet comme argument, qui est converti en un Button. La VerifyAccess méthode sur l’objet Button Dispatcher est appelée pour vérifier l’accès au thread.

Si le thread appelant a accès au Dispatcherthread, il Button est mis à jour en accédant uniquement aux membres du Button.

Si le thread appelant n’a pas accès, un InvalidOperationException élément est levée. Cet exemple intercepte l’exception et envoie un délégué, qui accepte un Button argument, sur le Dispatcher .Button Cela Dispatcher fera le travail de mise à jour du 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

Remarques

Seul le thread sur lequel il Dispatcher est créé peut accéder.Dispatcher

Cette méthode est publique ; par conséquent, n’importe quel thread peut vérifier s’il a accès au Dispatcher.

La différence entre CheckAccess et renvoie CheckAccess une valeur booléenne si le thread appelant n’a pas accès au Dispatcher thread VerifyAccess et VerifyAccess lève une exception.

Voir aussi

• CheckAccess()