DispatcherObject.CheckAccess メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
呼び出し元のスレッドがこの DispatcherObject にアクセスできるかどうかを確認します。
public:
bool CheckAccess();
public bool CheckAccess ();
member this.CheckAccess : unit -> bool
Public Function CheckAccess () As 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と同じです。
適用対象
.NET