Dispatcher.CheckAccess Метод

Определение

Определяет, связан ли вызывающий поток с данным Dispatcher.Determines whether the calling thread is the thread associated with this Dispatcher.

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

Возвращаемое значение

Boolean

Значение true, если вызывающий поток связан с данным Dispatcher; в противном случае — значение false.true if the calling thread is the thread associated with this Dispatcher; otherwise, false.

Примеры

В следующем примере используется CheckAccess для определения того, имеет ли поток доступ к Button .The following example uses CheckAccess to determine whether a thread has access to a Button. CheckAccessМетод, Dispatcher связанный с, Button вызывается для проверки доступа к потоку.The CheckAccess method on the Dispatcher associated with the Button is called to verify access to the thread. Если вызывающий поток имеет доступ к Dispatcher , Button компонент обновляется путем доступа к членам. Button в противном случае делегат, который принимает в Button качестве аргумента, помещается в Dispatcher .If the calling thread has access to the Dispatcher, the Button is updated by accessing the members of the Button; otherwise, a delegate, which accepts a Button as an argument, is placed onto the Dispatcher. DispatcherБудет делегировать работу по обновлению Button .The Dispatcher will delegate the work of updating the 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

Комментарии

Dispatcher DispatcherObject Доступ к объекту может получить только то, что создается для.Only the Dispatcher that a DispatcherObject is created on may access the object. Используйте Invoke или BeginInvoke для доступа к объекту из другого потока.Use Invoke or BeginInvoke to access the object from a different thread.

CheckAccess может вызываться из любого потока.CheckAccess can be called from any thread.

Разница между CheckAccess и VerifyAccess CheckAccess возвращает логическое значение, указывающее, имеет ли вызывающий поток доступ к Dispatcher и VerifyAccess создает исключение.The difference between CheckAccess and VerifyAccess is CheckAccess returns a Boolean indicating whether the calling thread has access to the Dispatcher and VerifyAccess throws an exception.

Применяется к

См. также раздел