AmbientAttribute AmbientAttribute AmbientAttribute AmbientAttribute Class

Определение

Указывает, что свойство или тип должны обрабатываться как свойство или тип окружения.Specifies that a property or type should be treated as ambient. Концепция окружения относится к тому, как обработчики XAML определяют владельцев типов членов.The ambient concept relates to how XAML processors determine type owners of members.

public ref class AmbientAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method | System.AttributeTargets.Property, Inherited=true)]
[System.AttributeUsage(System.AttributeTargets.Property, Inherited=true)]
public sealed class AmbientAttribute : Attribute
type AmbientAttribute = class
    inherit Attribute
Public NotInheritable Class AmbientAttribute
Inherits Attribute
Наследование
AmbientAttributeAmbientAttributeAmbientAttributeAmbientAttribute
Атрибуты

Комментарии

Внешнее свойство является свойством, где значение должно быть доступным в контексте средства синтаксического анализа при создании графа объекта, но поиск типичного члена типа откладывается в целях немедленного создания набора узлов XAML.An ambient property is a property where the value is expected to be available in the parser context when creating an object graph, but where typical type-member lookup is suspended for purposes of the immediate XAML node set being created. Существует два основных сценария Концепция окружения:There are two main scenarios for the ambient concept:

  • Некоторые другие свойства одного объекта влияет и определяет, как должна работать которые ищут свойство объекта.Some other property of the same object influences and qualifies how that object-property lookup should work.

  • Свойство представляет механизм большей задержки и возможности окружающей среды для поиска значения элемента распространяется на все объекты, содержащиеся в текущем объекте.The property represents a larger deferral mechanism and the ambient capabilities for looking up a member value extend to all objects contained within the current object.

Этот атрибут может применяться к определенным свойствам, которые содержат контейнеры, которые позволяют поведение подстановки внешнее свойство или могут применяться к классу, чтобы разрешить внешнее свойство поведение во всех случаях этого типа значения для свойства.This attribute can be applied to specific properties that have expected containers that enable an ambient property lookup behavior, or can be applied to a class to enable the ambient property behavior in all cases of that value type for a property.

AmbientAttribute могут также применяться к методу среды CLR, для поддержки с атрибутами присоединяемое свойство XAML как внешнего.AmbientAttribute can also be applied to a CLR method, to support attributing a XAML attachable property as ambient. Это потенциально необходимо, так как в реализации CLR XAML присоединенное свойство реализовано/представлен для отражения, как шаблон методов доступа с get и set методы.This is potentially necessary because in a CLR implementation a XAML attached property is implemented/represented to reflection as an accessor pattern with get and set methods. Существует Фактическое свойство CLR к атрибуту, поэтому ограничение использования для AttributeTargets для Property не позволило бы указания присоединяемого члена как внешнего.No actual CLR property to attribute exists, so restricting usage for AttributeTargets to Property would not have enabled specifying an attachable member as ambient. Присоединяемого члена, который вы хотите получать отчеты как свойство окружения, атрибут get метода доступа.For an attachable member that you want to report as ambient, attribute the get accessor. Не следует пытаться методы атрибутов, которые не являются специальными методами поддержки присоединяемых членов.You should not attempt to attribute methods that are not specifically support methods of attachable members.

В предыдущих версиях .NET Framework этот класс существовали в сборке WindowsBase относящихся к WPF.In previous versions of the .NET Framework, this class existed in the WPF-specific assembly WindowsBase. В .NET Framework 4.NET Framework 4, AmbientAttribute находится в сборке System.Xaml.In .NET Framework 4.NET Framework 4, AmbientAttribute is in the System.Xaml assembly. Для получения дополнительной информации см. Types Migrated from WPF to System.Xaml.For more information, see Types Migrated from WPF to System.Xaml.

Внешних типов (типов where AmbientAttribute применяется на уровне типа) может использоваться для обработки определенных XAML ситуаций, в которых тип свойства должен разрешаться не по порядку.Ambient types (types where AmbientAttribute is applied at type level) can be used for certain XAML processing situations where the type of a property needs to be resolved out of order.

Сценариев средства записи объектовObject Writer Scenarios

Если вы определяете средство записи объектов XAML, и возникают свойства, метода или типа где AmbientAttribute — применяется, обычно следует подключиться к службе, чтобы определить поведение подстановки предполагаемого свойства окружения, необходимое для записи объектов.If you are defining a XAML object writer, and you encounter a property, method or type where AmbientAttribute is applied, you typically must access a service to determine the intended ambient property lookup behavior that is needed for writing out objects. Дополнительные сведения см. в разделе IAmbientProvider.For more information, see IAmbientProvider.

Преобразователи значенийValue Converters

Преобразователи типов или расширения разметки следует знать внешние сведения для обработки свойств, представляющих сопоставления косвенных типов, таких как свойства, определяющие элементы или типы по именам строк с или без уточнения.Type converters or markup extensions might need to know the ambient information in order to process properties that represent indirect type mappings, such as properties that specify members or types by string names with or without qualification. В этом случае AmbientAttribute не предназначен для использования непосредственно для логики кода преобразователь значения.In this scenario, AmbientAttribute is not intended to be used directly for value converter code logic. Вместо этого преобразователя значений следует полагаться на поведение обработки модуля записи XAML, который передает IAmbientProvider в его служебные контексты, в методы преобразователя значения при вызове.Rather, the value converter should rely on the XAML writer processing behavior, which will pass IAmbientProvider in its service contexts to your value converter methods when called.

Сценарии WPF для AmbientAttributeWPF Scenarios for AmbientAttribute

  • Свойство Style (TargetType) можно уточнить имя необходимое свойство результатов поиска, которые необходимы для поиска ссылок резервного для имен свойств в Setter.Property значения.A property of a Style (TargetType) can qualify the necessary property name lookups that are needed to find the backing references for property names in Setter.Property values.

  • Все содержимое внутри Resources свойства (элементы ResourceDictionary) а также содержимое шаблона, должен иметь возможность доступа к другие одноранговые узлы как значения.All content within a Resources property (items of a ResourceDictionary) as well as template content, should be able to access other peers as values. Объявление всего Resources свойство как внешнего вызывает логику, которая позволяет это в средстве синтаксического анализа XAML WPF.Declaring the entire Resources property as ambient invokes logic that enables this in the WPF XAML parser.

См. в разделе ResourceDictionary пример сценария для параметра AmbientAttribute на уровне типа.See ResourceDictionary for an example of a scenario for setting AmbientAttribute at type level.

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

AmbientAttribute() AmbientAttribute() AmbientAttribute() AmbientAttribute()

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

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Возвращает хэш-код для данного экземпляра.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

При переопределении в производном классе показывает, является ли значение данного экземпляра значением по умолчанию для производного класса.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
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)

Явные реализации интерфейса

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые могут использоваться для получения сведений о типе интерфейса.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Свойства

TypeId TypeId TypeId TypeId

При реализации в производном классе возвращает уникальный идентификатор для этого Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

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

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