XmlnsPrefixAttribute XmlnsPrefixAttribute XmlnsPrefixAttribute XmlnsPrefixAttribute Class

Definition

Gibt ein empfohlenes Präfix an, das einem XAML-Namespace für die XAML-Verwendung zugeordnet werden soll, wenn Elemente und Attribute in eine XAML-Datei geschrieben werden (Serialisierung) oder wenn mit einer Entwurfsumgebung interagiert wird, die XAML-Bearbeitungsfunktionen aufweist.Identifies a recommended prefix to associate with a XAML namespace for XAML usage, when writing elements and attributes in a XAML file (serialization) or when interacting with a design environment that has XAML editing features.

public ref class XmlnsPrefixAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true)]
public sealed class XmlnsPrefixAttribute : Attribute
type XmlnsPrefixAttribute = class
    inherit Attribute
Public NotInheritable Class XmlnsPrefixAttribute
Inherits Attribute
Vererbung
XmlnsPrefixAttributeXmlnsPrefixAttributeXmlnsPrefixAttributeXmlnsPrefixAttribute
Attribute

Hinweise

XAML-Prozessoren oder Frameworks, die XAML integrieren, oder ein beliebiger Prozess, der die XAML-Serialisierung ausführt, sollten im Allgemeinen das empfohlene Präfix berücksichtigen.XAML processors or frameworks that incorporate XAML, or any process that performs XAML serialization, should generally honor the recommended prefix. Das Präfix ist möglicherweise erforderlich, wenn Präfixe aus bestimmten Zuordnungen in der ursprünglichen XAML-Quelle nicht im Laufzeitobjekt Diagramm oder anderweitig von einem Framework oder einer Technologie gespeichert werden.The prefix might be necessary in any case where prefixes from specific mappings in the original XAML source are not somehow preserved in the runtime object graph or otherwise stored by a framework or technology. Ein Framework kann bestimmte Einstellungen für die Serialisierung seiner eigenen Typen aufweisen, die das empfohlene Präfix aus seinen eigenen Assemblys ignorieren. Dies kann dazu geführt werden, dass ein XAML-Standard Namespace einheitlich herauf gestuft wird.A framework might have specific preferences for how to serialize its own types that ignore the recommended prefix from its own assemblies; this might be done to consistently promote a default XAML namespace. Ein solches Framework sollte jedoch weiterhin Empfohlene Präfixe für mögliche Drittanbieter-und Tool Verwendungen der XAML-Typen bereitstellen.However, such a framework should still provide recommended prefixes for possible third-party and tool usages of its XAML types. Weitere Informationen finden Sie im Abschnitt "bewährte Methoden für XAML-Designer-Unterstützung oder allgemeine Serialisierung" weiter unten.See "Best Practice for XAML Designer Support or General Serialization" section below.

Eine allgemeine Empfehlung für Präfixe besteht darin, kurze Zeichen folgen zu verwenden, da das Präfix in der Regel auf alle serialisierten Elemente angewendet wird, die aus dem XAML-Namespace stammen.A general recommendation for prefixes is to use short strings, because the prefix is typically applied to all serialized elements that come from the XAML namespace. Die Länge der Präfix Zeichenfolge kann eine spürbare Auswirkung auf die Größe der serialisierten XAML-Ausgabe haben.The prefix string length can have a noticeable effect on the size of serialized XAML output.

Wenn ein angefordertes Präfix bereits von einem anderen zuvor gefundenen/serialisierten XAML-Namespace Bezeichner verwendet wird, ist das Verhalten nicht angegeben (das Verhalten ist für jede einzelne XAML-Prozessor Implementierung).If a prefix being requested is already in use by another previously encountered/serialized XAML namespace identifier, the behavior is unspecified (behavior is up to each individual XAML processor implementation).

In den meisten Fällen wenden XmlnsPrefixAttribute Sie nur an, wenn Sie für denselben XAML-Namespace auch mindestens eine XmlnsDefinitionAttribute in der Assembly angewendet haben.In most cases, you apply XmlnsPrefixAttribute only if you have also applied at least one XmlnsDefinitionAttribute in the assembly for that same XAML namespace.

In früheren Versionen des .NET Framework war diese Klasse in der WPF-spezifischen Assembly Windows Base vorhanden.In previous versions of the .NET Framework, this class existed in the WPF-specific assembly WindowsBase. In .NET Framework 4.NET Framework 4befindetsichin derSystem.XAML-Assembly.XmlnsPrefixAttributeIn .NET Framework 4.NET Framework 4, XmlnsPrefixAttribute is in the System.Xaml assembly. Weitere Informationen finden Sie unter Types Migrated from WPF to System.Xaml.For more information, see Types Migrated from WPF to System.Xaml.

Bewährte Methoden für XAML-Designer Unterstützung oder allgemeine SerialisierungBest Practice for XAML Designer Support or General Serialization

Auch wenn Sie beabsichtigen, dass der zugeordnete XAML-Namespace in den meisten Verwendungs Fällen für das Framework oder die Bibliothek der Standard-XAML-Namespace sein soll, sollten Sie immer noch eine nicht leere Zeichenfolge als das empfohlene Präfix für einen XAML-Namespace angeben.Even if you intend the associated XAML namespace to be the default XAML namespace in most usage cases for your framework or library, you should still specify a non-empty string as the recommended prefix for a XAML namespace. Standard-XAML-Namespace Informationen werden in einzelne XAML-Dateien und XAML-knotenstreams übertragen.Default XAML namespace information is carried in individual XAML files and XAML node streams. Der standardmäßige XAML-Namespace und die Definition in einer bestimmten XAML-Quelle können ohne Verwendung XmlnsPrefixAttributevon für die Serialisierung pro Fall fortgeführt werden.The default XAML namespace and how it is defined in a given XAML source can easily be perpetuated for per-case serialization without using XmlnsPrefixAttribute. Das XmlnsPrefixAttribute ist jedoch nützlich für Fälle, in denen der XAML-Autor festgelegt hat, dass der XAML-Standard Namespace einem anderen zugeordnet werden soll.However, the XmlnsPrefixAttribute is useful for cases where the XAML author has chosen to map the default XAML namespace to something else. In diesem Szenario kann ein XAML-Text-Editor, der in eine XmlnsPrefixAttribute Entwurfs Umgebung eingebettet ist, als Hinweis für eine anfängliche XAML-Namespace xmlns Zuordnung verwendet werden.In this scenario a XAML text editor embedded in a design environment can use XmlnsPrefixAttribute as a hint for an initial XAML namespace xmlns mapping. Oder eine Entwurfs Umgebung kann dem Unterstützungs-XAML Just-in-Time-Zuordnungen für Entwurfs Metaphern hinzufügen, z. b. das Ziehen von Objekten aus einer Toolbox und in eine visuelle Entwurfs Oberfläche.Or a design environment can add just-in-time mappings to the backing XAML for design metaphors such as dragging objects out of a toolbox and into a visual design surface. Es ist auch denkbar, dass ein Designer gleichzeitig mehrere XAML-aktivierbare Frameworks unterstützen kann und über ein gängiges XAML-Serialisierungsprogramm verfügt, das .NET Framework XAML-Diensten anstelle der frameworkspezifischen Serialisierung basiert.Also, it is conceivable that a designer could simultaneously support multiple XAML-enabling frameworks, and has a common XAML serializer that relies on .NET Framework XAML Services rather than framework-specific serialization. Durch die XmlnsPrefixAttribute Angabe eines für diese Szenarien wird die XAML-Verwendung für Ihre Typen portabler und stabiler, wenn der XAML-Code zwischen den Entwurfs Tools ausgetauscht wird, oder es wird ein Roundtrip zwischen XAML-Editoren und anderen Consumern wie Markup Compiler oder anderen Benutzern durchgeführt. Serialisierung.Specifying a XmlnsPrefixAttribute for these scenarios helps make the XAML usage for your types more portable and robust if the XAML is exchanged between design tools, or undergoes a round trip between XAML editors and other consumers such as markup compilers or other serialization.

Konstruktoren

XmlnsPrefixAttribute(String, String) XmlnsPrefixAttribute(String, String) XmlnsPrefixAttribute(String, String) XmlnsPrefixAttribute(String, String)

Initialisiert eine neue Instanz der XmlnsPrefixAttribute-Klasse.Initializes a new instance of the XmlnsPrefixAttribute class.

Eigenschaften

Prefix Prefix Prefix Prefix

Ruft das diesem Attribut zugeordnete empfohlene Präfix ab.Gets the recommended prefix associated with this attribute.

TypeId TypeId TypeId TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)
XmlNamespace XmlNamespace XmlNamespace XmlNamespace

Ruft den XAML-Namespacebezeichner ab, der diesem Attribut zugeordnet ist.Gets the XAML namespace identifier associated with this attribute.

Methoden

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

Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.Returns a value that indicates whether this instance is equal to a specified object.

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

Gibt den Hashcode für diese Instanz zurück.Returns the hash code for this instance.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.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)

Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht.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()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

_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)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.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)

Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können.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)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 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)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Gilt für:

Siehe auch