AmbientAttribute Třída

Definice

Určuje, že vlastnost nebo typ by měly být považovány za okolí.Specifies that a property or type should be treated as ambient. Ambientní pojem se vztahuje na to, jak procesory XAML určují typ vlastníci členů.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)]
public sealed class AmbientAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Property, Inherited=true)]
public sealed class AmbientAttribute : Attribute
type AmbientAttribute = class
    inherit Attribute
Public NotInheritable Class AmbientAttribute
Inherits Attribute
Dědičnost
AmbientAttribute
Atributy

Poznámky

Ambientní vlastnost je vlastnost, kde je očekávána hodnota v kontextu analyzátoru při vytváření grafu objektů, ale v případě, že je pro účely okamžité sady uzlů jazyka XAML pozastaveno vyhledávání členů typu.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. Pro okolí konceptu existují dva hlavní scénáře:There are two main scenarios for the ambient concept:

  • Některá jiná vlastnost stejného objektu ovlivňuje a je v tom, jak by mělo fungovat, jak by mělo hledání vlastností objektu fungovat.Some other property of the same object influences and qualifies how that object-property lookup should work.

  • Vlastnost představuje větší vyloučení mechanismu a okolní možnosti pro vyhledání hodnoty člena rozšířené na všechny objekty obsažené v aktuálním objektu.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.

Tento atribut lze použít na konkrétní vlastnosti, které mají očekávané kontejnery, které umožňují chování při vyhledávání ambientních vlastností, nebo lze použít na třídu a povolit chování okolí vlastností ve všech případech tohoto typu hodnoty pro vlastnost.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 lze použít také pro metodu CLR, aby bylo možné podporovat navázání vlastnosti s připojením XAML jako okolí.AmbientAttribute can also be applied to a CLR method, to support attributing a XAML attachable property as ambient. To je možné, protože v implementaci CLR je implementována vlastnost připojená k XAML nebo je představována k reflexi jako vzor přistupujícího objektu s metodami get a 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. Neexistuje žádná skutečná vlastnost CLR pro atribut, takže omezení použití AttributeTargets na Property by nepovolilo zadání připojeného člena jako okolí.No actual CLR property to attribute exists, so restricting usage for AttributeTargets to Property would not have enabled specifying an attachable member as ambient. Pro připojeného člena, který chcete ohlásit jako okolí, přiřaďte get přistupující objekt.For an attachable member that you want to report as ambient, attribute the get accessor. Neměli byste se pokoušet o metody atributů, které nepodporují zejména metody připojitelné členy.You should not attempt to attribute methods that are not specifically support methods of attachable members.

V předchozích verzích .NET Framework existovala tato třída v sestavení specifickém pro WPF WindowsBase.In previous versions of the .NET Framework, this class existed in the WPF-specific assembly WindowsBase. V .NET Framework 4.NET Framework 4je AmbientAttribute v sestavení System. XAML.In .NET Framework 4.NET Framework 4, AmbientAttribute is in the System.Xaml assembly. Další informace naleznete v tématu typy migrované z WPF do System. XAML.For more information, see Types Migrated from WPF to System.Xaml.

Typy okolí (typy, kde je AmbientAttribute použito na úrovni typu) lze použít pro určité případy zpracování XAML, kde je nutné přeložit typ vlastnosti mimo pořadí.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.

Scénáře zapisovače objektůObject Writer Scenarios

Pokud definujete modul pro zápis objektů XAML a narazíte na vlastnost, metodu nebo typ, kde se používá AmbientAttribute, je obvykle zapotřebí přistupovat ke službě a určit tak zamýšlené chování vyhledávání ambientních vlastností, které je potřeba pro vytváření objektů.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. Další informace najdete v tématu IAmbientProvider.For more information, see IAmbientProvider.

Převaděče hodnotValue Converters

Pro zpracování vlastností, které reprezentují nepřímá mapování typů, jako jsou například vlastnosti, které určují členy nebo typy pomocí názvů řetězců s kvalifikací nebo bez ní, může být nutné, aby převaděče typů nebo rozšíření značek mohly znát okolní informace.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. V tomto scénáři AmbientAttribute není určen pro použití přímo pro logiku kódu konvertoru hodnot.In this scenario, AmbientAttribute is not intended to be used directly for value converter code logic. Místo toho by měl převaděč hodnot spoléhat na chování zpracování zapisovače XAML, které při volání přejdou IAmbientProvider ve svých kontextech služby na metody převaděče hodnot.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.

Scénáře WPF pro AmbientAttributeWPF Scenarios for AmbientAttribute

  • Vlastnost Style (TargetType) může kvalifikovat potřebné vyhledávání názvů vlastností, které jsou potřebné k vyhledání záložních odkazů pro názvy vlastností v Setter.Property hodnotách.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.

  • Veškerý obsah v rámci Resources vlastnosti (položky ResourceDictionary) a také obsah šablony by měl mít přístup k ostatním partnerům jako k hodnotám.All content within a Resources property (items of a ResourceDictionary) as well as template content, should be able to access other peers as values. Deklarace celé Resources vlastnosti jako ambientní volání, která umožňuje tuto vlastnost v analyzátoru XAML WPF.Declaring the entire Resources property as ambient invokes logic that enables this in the WPF XAML parser.

Příklad scénáře pro nastavení AmbientAttribute na úrovni typu najdete v tématu ResourceDictionary.See ResourceDictionary for an example of a scenario for setting AmbientAttribute at type level.

Konstruktory

AmbientAttribute()

Inicializuje novou instanci třídy AmbientAttribute třídy.Initializes a new instance of the AmbientAttribute class.

Vlastnosti

TypeId

Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Zděděno od Attribute)

Metody

Equals(Object)

Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu.Returns a value that indicates whether this instance is equal to a specified object.

(Zděděno od Attribute)
GetHashCode()

Vrátí kód hash této instance.Returns the hash code for this instance.

(Zděděno od Attribute)
GetType()

Získá Type aktuální instance.Gets the Type of the current instance.

(Zděděno od Object)
IsDefaultAttribute()

Při přepsání v odvozené třídě označuje, zda je hodnota této instance výchozí hodnotou pro odvozenou třídu.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Zděděno od Attribute)
Match(Object)

Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda je tato instance rovna zadanému objektu.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Zděděno od Attribute)
MemberwiseClone()

Vytvoří kopii aktuálního Objectbez podstruktury.Creates a shallow copy of the current Object.

(Zděděno od Object)
ToString()

Vrací řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)

Explicitní implementace rozhraní

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

Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání.Maps a set of names to a corresponding set of dispatch identifiers.

(Zděděno od Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Načte informace o typu pro objekt, který lze použít k získání informací o typu pro rozhraní.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Zděděno od Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Zděděno od Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Poskytuje přístup k vlastnostem a metodám vystaveným objektem.Provides access to properties and methods exposed by an object.

(Zděděno od Attribute)

Platí pro

Viz také