ContextItem - класс

Статья
11/05/2008

Обновлен: Ноябрь 2007

Представляет одну часть состояния конструктора.

Пространство имен: Microsoft.Windows.Design
Сборка: Microsoft.Windows.Design (в Microsoft.Windows.Design.dll)

Синтаксис

'Декларация
Public MustInherit Class ContextItem
'Применение
Dim instance As ContextItem

public abstract class ContextItem

public ref class ContextItem abstract

public abstract class ContextItem

Заметки

Элементы контекста являются неизменяемыми объектами, содержащими состояние. Некоторые элементы контекста определяют также методы, которые могут выполнять операции с состоянием, которое они содержат. ContextItem — базовый класс, по отношению к которому все элементы контекста должны быть производными объектами.

Элемент контекста может добавляться в контекст редактирования и удаляться из него. Элементы контекста являются временными, но они всегда имеют значение. Даже если конкретный элемент контекста отсутствует в контексте, всегда предоставляется его значение по умолчанию. Поэтому контекст никогда не возвращает значение nullссылка null (Nothing в Visual Basic).

В отличие от службы значение элемента контекста может измениться в любой момент. Это означает, что не следует кэшировать элементы контекста. Код, который использует контекст, может подписаться на SubscribeContextCallback<ContextItemType>, которая вызывается при изменении определенного типа элемента контекста.

Класс, производный от ContextItem, должен определить пустой конструктор. В этой версии пустого конструктора для элемента контекста используется его значение по умолчанию. Значение элемента контекста по умолчанию — это значение, возвращаемое из GetValue, если ContextItemManager не содержит элемент контекста запрашиваемого типа.

Иерархия наследования

System.Object
  Microsoft.Windows.Design.ContextItem
    Microsoft.Windows.Design.AssemblyReferences
    Microsoft.Windows.Design.Interaction.CurrentDesignerView
    Microsoft.Windows.Design.Interaction.FocusedTask
    Microsoft.Windows.Design.Interaction.Selection
    Microsoft.Windows.Design.Interaction.Tool

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.