DispatcherFrame DispatcherFrame DispatcherFrame DispatcherFrame Class

Определение

Представляет цикл выполнения в Dispatcher.Represents an execution loop in the 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
Наследование
DispatcherFrameDispatcherFrameDispatcherFrameDispatcherFrame

Примеры

В следующем примере показано, DispatcherFrame как использовать для достижения аналогичных результатов Windows FormsWindows Forms DoEvents в методе.The following example shows how to use a DispatcherFrame to achieve similar results as the Windows FormsWindows Forms DoEvents method.

[SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)]
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Обычно объекты делятся на две категории:DispatcherFrame objects typically fall into two categories:

  • Долгосрочные кадры общего назначения, которые завершают работу только при указании.Long running, general purpose frames that exit only when instructed to. При запросе эти кадры должны завершаться.These frames should exit when they are requested.

  • Короткие выполняемые, очень специфичные кадры, которые завершаются при соблюдении важных условий.Short running, very specific frames that exit when an important criteria is met. Эти кадры могут не выходить из, когда они запрашиваются в ожидании выполнения условий выхода.These frames may consider not to exit when they are requested in favor of waiting for their exit criteria to be met. С этими кадрами должно быть связано время ожидания.These frames should have a time-out associated with them.

Использование текста XAMLXAML Text Usage

Этот управляемый класс нельзя использовать в XAMLXAML.You cannot use this managed class in XAMLXAML.

Конструкторы

DispatcherFrame() DispatcherFrame() DispatcherFrame() DispatcherFrame()

Инициализирует новый экземпляр класса DispatcherFrame.Initializes a new instance of the DispatcherFrame class.

DispatcherFrame(Boolean) DispatcherFrame(Boolean) DispatcherFrame(Boolean) DispatcherFrame(Boolean)

Инициализирует новый экземпляр класса DispatcherFrame, используя заданный флаг запроса завершения работы.Initializes a new instance of the DispatcherFrame class, by using the specified exit request flag.

Свойства

Continue Continue Continue Continue

Получает или задает значение, указывающее, должен ли этот DispatcherFrame продолжить работу.Gets or sets a value that indicates whether this DispatcherFrame should continue.

Dispatcher Dispatcher Dispatcher Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)

Методы

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Применяется к

Дополнительно