DispatcherObject.CheckAccess Método

Definição

Namespace:

System.Windows.Threading

Assembly:

WindowsBase.dll

Determina se o thread de chamada tem acesso a este DispatcherObject.

C#

public bool CheckAccess ();

Retornos

Boolean

true se o thread de chamada tiver acesso a esse objeto; caso contrário, false.

Exemplos

O exemplo a seguir usa CheckAccess para determinar se um thread tem acesso ao thread no qual um Button foi criado. O CheckAccess método no Button é chamado para verificar o acesso ao thread. Se o thread de chamada tiver acesso, ele Button será atualizado apenas acessando os membros do Button; caso contrário, um delegado, que aceita um Button como argumento, é postado no Dispatcher .Button

C#

// Uses the DispatcherObject.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.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
            // Pushing update method on the Dispatcher of the UI thread
            theButton.Dispatcher.BeginInvoke(DispatcherPriority.Normal,
                new UpdateUIDelegate(UpdateButtonUI), theButton);
        }
    }
}

Comentários

Somente o thread no qual foi Dispatcher criado pode acessar o DispatcherObject.

Qualquer thread pode verificar se ele tem acesso a isso DispatcherObject.

A diferença entre CheckAccess e VerifyAccess é que CheckAccess retorna um Boolean que especifica se o thread de chamada tem acesso a isso DispatcherObject e VerifyAccess gera uma exceção se o thread de chamada não tiver acesso a isso DispatcherObject.

Chamar esse método é idêntico à chamada CheckAccess no objeto associado Dispatcher .

Aplica-se a