AmbientPropertyValue Класс

Определение

Пространство имен:

System.Xaml

Сборка:

System.Xaml.dll

Сообщает сведения о внешнем свойстве как части реализации объекта IAmbientProvider.

public ref class AmbientPropertyValue

public class AmbientPropertyValue

type AmbientPropertyValue = class

Public Class AmbientPropertyValue

Наследование

Object

AmbientPropertyValue

Комментарии

AmbientPropertyValue представляет информационный элемент, который возвращается путем вызова IAmbientProvider метода службы. Методы GetAll возвращают перечисления или массивы AmbientPropertyValue элементов; GetFirst методы возвращают один .AmbientPropertyValue

Сведения о свойствах окружения

Свойство окружения — это свойство, значение свойства которого должно быть доступно для использования преобразователя значений в структуре узла XAML и для графа объектов под ним. Концепция окружения актуальна для обработчика XAML на этапе записи объекта пути загрузки или на этапе сериализации пути сохранения.

Тип также может быть отнесен к типу ambient. В этом случае все свойства, использующие атрибутивный тип, передаются как окружающие.

В случае с путем загрузки значение свойства окружения может влиять на значение графа объекта для других свойств, которые существуют под ним в структуре узла XAML. При обработке в виде потока узлов XAML концепция окружения подразумевает, что значение свойства окружения должно быть доступно для преобразователей типов и расширений разметки от StartObject до EndObject. Аналогичным образом преобразователь типов или расширение разметки, используемое для пути сохранения, может искать свойство окружения и его значение. Таким образом, создаваемый КОД XAML является лучшим представлением кругового пути.

По определению языка XAML не указывает порядок обработки элементов объекта. Однако любое значение свойства окружения должно быть сначала обработано средством чтения XAML, чтобы преобразователь типов и использование расширения разметки, содержащиеся в других свойствах, могли получить к нему доступ через IAmbientProvider службу.

DependsOn — это аналогичная концепция, которая также влияет на порядок обработки узлов XAML. DependsOn Однако может использоваться только для связей одноранговых элементов и узлов; он не может влиять на всех потомков. Кроме того, DependsOn напрямую влияет на настройку свойства графа объекта, тогда как метод окружения зависит от преобразователей типов или расширений разметки. В методе окружения также должно быть определенное определение преобразователя типов или расширения разметки. Каждый преобразователь типов или расширение разметки определяет, как значение внешнего свойства должно интерпретироваться и применяться к расположению графа объекта, где используется преобразователь типов или расширение разметки.

Примечания об использовании WPF

Сценарий внешнего свойства, показанный в наборе функций WPF, — это Style.TargetType, который может указать необходимые поиски имени свойства для других значений. В этом случае Style.TargetType значение определяет Setter.Property значения в узлах XAML под ним. Setter.Property использует поведение преобразователя типов для DependencyProperty. Это поведение обращается к внешнему Style.TargetType значению, запрашивая GetFirstAmbientValue из контекста службы, который доступен для преобразователей типов и расширений разметки.

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

AmbientPropertyValue(XamlMember, Object)

Инициализирует новый экземпляр класса AmbientPropertyValue.

Свойства

RetrievedProperty	Получает системный идентификатор типов XAML (XamlMember), представляющий внешнее свойство.
Value	Получает значение внешнего свойства.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• IAmbientProvider