Dispatcher.CheckAccess Metodo

Definizione

Spazio dei nomi:

System.Windows.Threading

Assembly:

WindowsBase.dll

Determina se il thread chiamante è il thread associato a questo oggetto Dispatcher.

public:
 bool CheckAccess();

public bool CheckAccess ();

member this.CheckAccess : unit -> bool

Public Function CheckAccess () As Boolean

Restituisce

Boolean

true se il thread chiamante è il thread associato a Dispatcher, in caso contrario false.

Esempio

Nell'esempio seguente viene usato CheckAccess per determinare se un thread ha accesso a un oggetto Button. Il CheckAccess metodo sull'oggetto Dispatcher associato Button a viene chiamato per verificare l'accesso al thread. Se il thread chiamante ha accesso a , l'oggetto viene aggiornato accedendo ai membri di Button; in caso contrario, un delegato che accetta come Button argomento viene inserito nell'oggetto Dispatcher.DispatcherButton L'oggetto Dispatcher delega il lavoro di aggiornamento dell'oggetto Button.

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

    if (theButton != null)
    {
        // Checking if this thread has access to the object.
        if (theButton.Dispatcher.CheckAccess())
        {
            // This thread has access so it can update the UI thread.
            UpdateButtonUI(theButton);
        }
        else
        {
            // This thread does not have access to the UI thread.
            // Place the update method on the Dispatcher of the UI thread.
            theButton.Dispatcher.BeginInvoke(DispatcherPriority.Normal,
                new UpdateUIDelegate(UpdateButtonUI), theButton);
        }
    }
}

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

    If theButton IsNot Nothing Then
        ' Checking if this thread has access to the object.
        If theButton.Dispatcher.CheckAccess() Then
            ' This thread has access so it can update the UI thread.
            UpdateButtonUI(theButton)
        Else
            ' This thread does not have access to the UI thread.
            ' Place the update method on the Dispatcher of the UI thread.
            theButton.Dispatcher.BeginInvoke(DispatcherPriority.Normal, New UpdateUIDelegate(AddressOf UpdateButtonUI), theButton)
        End If
    End If
End Sub

Commenti

Solo l'oggetto Dispatcher in cui viene creato un DispatcherObject oggetto può accedere all'oggetto . Usare Invoke o BeginInvoke per accedere all'oggetto da un thread diverso.

CheckAccess può essere chiamato da qualsiasi thread.

La differenza tra CheckAccess e VerifyAccess restituisce CheckAccess un valore booleano che indica se il thread chiamante ha accesso a Dispatcher e VerifyAccess genera un'eccezione.

Vedi anche

• VerifyAccess()