Leer en inglés

Compartir a través de


DispatcherObject.CheckAccess Método

Definición

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Determina si el subproceso de la llamada tiene acceso a DispatcherObject.

C#
public bool CheckAccess();

Devoluciones

true si el subproceso de la llamada tiene acceso a este objeto; en caso contrario, false.

Ejemplos

En el ejemplo siguiente se usa CheckAccess para determinar si un subproceso tiene acceso al subproceso en el que se creó un Button . Se CheckAccess llama al método en Button para comprobar el acceso al subproceso. Si el subproceso que realiza la llamada tiene acceso, Button se actualiza simplemente accediendo a los miembros de Button; de lo contrario, un delegado, que acepta un Button como argumento, se publica en de DispatcherButton.

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);
        }
    }
}

Comentarios

Solo el subproceso en el que Dispatcher se creó puede tener acceso a DispatcherObject.

Cualquier subproceso puede comprobar si tiene acceso a este DispatcherObject.

La diferencia entre CheckAccess y VerifyAccess es que CheckAccess devuelve un valor booleano que especifica si el subproceso que realiza la llamada tiene acceso a esto DispatcherObject y VerifyAccess produce una excepción si el subproceso que realiza la llamada no tiene acceso al objeto .DispatcherObject

Llamar a este método es idéntico a llamar CheckAccess a en el objeto asociado Dispatcher .

Se aplica a

Producto Versiones
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10