DispatcherFrame 類別

定義

命名空間:

System.Windows.Threading

組件:

WindowsBase.dll

表示 Dispatcher 中的例外狀況迴圈。

public ref class DispatcherFrame : System::Windows::Threading::DispatcherObject

public class DispatcherFrame : System.Windows.Threading.DispatcherObject

type DispatcherFrame = class
    inherit DispatcherObject

Public Class DispatcherFrame
Inherits DispatcherObject

繼承

Object

DispatcherObject

DispatcherFrame

範例

下列範例示範如何使用 DispatcherFrame 來達成類似Windows Forms DoEvents 方法的結果。

public void DoEvents()
{
    DispatcherFrame frame = new DispatcherFrame();
    Dispatcher.CurrentDispatcher.BeginInvoke(DispatcherPriority.Background,
        new DispatcherOperationCallback(ExitFrame), frame);
    Dispatcher.PushFrame(frame);
}

public object ExitFrame(object f)
{
    ((DispatcherFrame)f).Continue = false;
   
    return null;
}

<SecurityPermissionAttribute(SecurityAction.Demand, Flags := SecurityPermissionFlag.UnmanagedCode)>
Public Sub DoEvents()
    Dim frame As New DispatcherFrame()
    Dispatcher.CurrentDispatcher.BeginInvoke(DispatcherPriority.Background, New DispatcherOperationCallback(AddressOf ExitFrame), frame)
    Dispatcher.PushFrame(frame)
End Sub

Public Function ExitFrame(ByVal f As Object) As Object
    CType(f, DispatcherFrame).Continue = False

    Return Nothing
End Function

備註

DispatcherFrame 物件通常分為兩個類別：

• 長時間執行的一般用途畫面格只有在指示時才會結束。 這些畫面格應該會在要求時結束。

• 簡短執行，非常特定的畫面格會在符合重要準則時結束。 當要求這些畫面時，這些畫面格可能會考慮不要結束，以等候符合其結束準則。 這些畫面格應該有與其相關聯的逾時。

XAML 文字使用方式

您無法在 XAML 中使用這個 Managed 類別。

建構函式

DispatcherFrame()	初始化 DispatcherFrame 類別的新執行個體。
DispatcherFrame(Boolean)	使用指定的結束要求旗標，初始化 DispatcherFrame 類別的新執行個體。

屬性

Continue	取得或設定值，這個值表示這個 DispatcherFrame 是否應繼續。
Dispatcher	取得與這個 Dispatcher 關聯的 DispatcherObject。 (繼承來源 DispatcherObject)

方法

CheckAccess()	判斷呼叫的執行是否可以存取這個 DispatcherObject。 (繼承來源 DispatcherObject)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
VerifyAccess()	請強制執行可以存取這個 DispatcherObject 的呼叫執行緒。 (繼承來源 DispatcherObject)

另請參閱

• PushFrame(DispatcherFrame)