DispatcherObject.CheckAccess メソッド

定義

名前空間:

System.Windows.Threading

アセンブリ:

WindowsBase.dll

呼び出し元のスレッドがこの DispatcherObject にアクセスできるかどうかを確認します。

public:
 bool CheckAccess();

public bool CheckAccess ();

member this.CheckAccess : unit -> bool

Public Function CheckAccess () As Boolean

戻り値

Boolean

呼び出し元のスレッドがこのオブジェクトにアクセスできる場合は true。それ以外の場合は false。

例

次の例では、 を使用 CheckAccess して、 が作成されたスレッドにスレッドが Button アクセスできるかどうかを判断します。 の メソッドButtonはCheckAccess、スレッドへのアクセスを確認するために呼び出されます。 呼び出し元のスレッドにアクセス権がある場合は、 Button のButtonメンバーにアクセスするだけで が更新されます。それ以外の場合は、 を引数として受け入れるButtonデリゲートが の ButtonにDispatcherポストされます。

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

' Uses the DispatcherObject.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.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
            ' Pushing 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

注釈

にアクセスDispatcherObjectできるのは、 Dispatcher が作成されたスレッドだけです。

どのスレッドでも、この DispatcherObjectにアクセスできるかどうかを確認できます。

と VerifyAccess の違いCheckAccessは、CheckAccess呼び出し元のスレッドがこれにDispatcherObjectアクセスできるかどうかを指定するブール値を返し、呼び出しVerifyAccess元のスレッドがこの DispatcherObjectにアクセスできない場合に例外をスローすることです。

このメソッドの呼び出しは、関連付けられているDispatcherオブジェクトでの 呼び出しCheckAccessと同じです。