Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

XmlnsPrefixAttribute-Klasse

 

Veröffentlicht: Oktober 2016

Identifiziert ein empfohlenes Präfix, das einem XAML-Namespace zur XAML-Verwendung zugeordnet werden soll, wenn Elemente und Attribute in eine XAML-Datei (Serialisierung) geschrieben werden oder wenn mit einer Entwurfsumgebung interagiert wird, die XAML-Bearbeitungsfunktionen hat.

Namespace:   System.Windows.Markup
Assembly:  System.Xaml (in System.Xaml.dll)

System.Object
  System.Attribute
    System.Windows.Markup.XmlnsPrefixAttribute

[AttributeUsageAttribute(AttributeTargets.Assembly, AllowMultiple = true)]
public sealed class XmlnsPrefixAttribute : Attribute

NameBeschreibung
System_CAPS_pubmethodXmlnsPrefixAttribute(String, String)

Initialisiert eine neue Instanz der XmlnsPrefixAttribute-Klasse.

NameBeschreibung
System_CAPS_pubpropertyPrefix

Ruft das diesem Attribut zugeordnete empfohlene Präfix ab.

System_CAPS_pubpropertyTypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.(Geerbt von „Attribute“.)

System_CAPS_pubpropertyXmlNamespace

Ruft den diesem Attribut zugeordneten XAML-Namespacebezeichner ab.

NameBeschreibung
System_CAPS_pubmethodEquals(Object)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.(Geerbt von „Attribute“.)

System_CAPS_pubmethodGetHashCode()

Gibt den Hashcode für diese Instanz zurück.(Geerbt von „Attribute“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodIsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.(Geerbt von „Attribute“.)

System_CAPS_pubmethodMatch(Object)

Ruft beim Überschreiben in einer abgeleiteten Klasse gibt einen Wert, der angibt, ob diese Instanz gleich ein angegebenen Objekt ist.(Geerbt von „Attribute“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_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.(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.(Geerbt von „Attribute“.)

XAML-Prozessoren oder Frameworks, die XAML integrieren, oder alle Prozesse, die XAML-Serialisierung ausführt, sollte im Allgemeinen das empfohlene Präfix berücksichtigt. Das Präfix ist möglicherweise erforderlich, in jedem Fall, in dem Präfixe aus bestimmten Zuordnungen in der ursprünglichen XAML-Quelle aus irgendeinem Grund nicht in der Common Language Runtime-Objektdiagramm beibehalten oder andernfalls gespeichert sind von einem Framework oder Technologie. Ein Framework möglicherweise bestimmte Vorgaben für das eigene Typen serialisieren, die das empfohlene Präfix aus den eigenen Assemblys zu ignorieren; Dies kann erfolgen, um einen standardmäßigen XAML-Namespace konsistent zu fördern. Solch ein Framework sollte jedoch weiterhin empfohlene Präfixe für möglichen Drittanbieter- und Tool Nutzung seiner XAML-Typen bereitstellen. Siehe Abschnitt "Bewährte Methoden für die Verwendung von XAML-Designer-Unterstützung oder allgemeine Serialisierung" weiter unten.

Eine allgemeine Empfehlung für Präfixe ist, kurze Zeichenfolgen zu verwenden, da das Präfix in der Regel auf alle serialisierten Elemente angewendet wird, die von der XAML-Namespace stammen. Die Länge der Zeichenfolge das Präfix haben merkliche Auswirkungen auf die Größe der serialisierten XAML-Ausgabe.

Wenn ein Präfix angefordert wird bereits von einem anderen zuvor gefunden/serialisierten XAML-Namespacebezeichner verwendet wird, ist das Verhalten undefiniert (Verhalten ist jede einzelne XAML-Prozessor-Implementierung).

In den meisten Fällen gelten Sie XmlnsPrefixAttribute nur, wenn Sie auch mindestens eine angewendet haben XmlnsDefinitionAttribute in der Assembly für diesen gleichen XAML-Namespace.

In früheren Versionen von .NET Framework war diese Klasse in der WPF-spezifischen Assembly WindowsBase vorhanden. In .NET Framework 4, XmlnsPrefixAttribute in der System.Xaml-Assembly ist. Weitere Informationen finden Sie unter Types Migrated from WPF to System.Xaml.

Auch wenn Sie beabsichtigen, dass der zugeordneten XAML-Namespace werden den standardmäßigen XAML-Namespace in den meisten Verwendungsfällen für das Framework oder die Bibliothek, sollten Sie immer noch eine nicht leere Zeichenfolge als das empfohlene Präfix für einen XAML-Namespace angeben. Standard-XAML-Namespaceinformationen erfolgt in einzelne XAML-Dateien und XAML-Knotenstreams. Der Standard-XAML-Namespace und wie es in einem bestimmten XAML-Quelle definiert ist können problemlos für die Serialisierung pro Fall ohne aufrechterhalten XmlnsPrefixAttribute. Allerdings die XmlnsPrefixAttribute eignet sich für Fälle, in denen der XAML-Autor Zuordnen der standardmäßigen XAML-Namespace in einen anderen ausgewählt wurde. In diesem Szenario ein XAML-Text-Editor in einem Entwurf eingebettet Umgebung können XmlnsPrefixAttribute als Hinweis für einen anfänglichen XAML-Namespace xmlns Zuordnung. Oder eine Design-Umgebung hinzufügen just-in-Time-Zuordnungen in die unterstützende XAML für Design Metaphern wie z. B. Objekte aus der Toolbox und in einer visuellen Entwurfsoberfläche ziehen. Außerdem ist es denkbar, dass ein Designer gleichzeitig mehrere XAML-Aktivierung Frameworks unterstützen kann und verfügt über eine allgemeine XAML-Serialisierungsprogramm, das auf .NET Framework-XAML-Dienste anstelle von Framework-spezifische Serialisierung basiert. Angeben einer XmlnsPrefixAttribute für diese Szenarien hilft stellen die XAML-Verwendung für die Typen portabler und robuster, wenn das XAML zwischen Entwurfstools getauscht wird, oder einen Roundtrip zwischen XAML-Editoren und andere Consumern, z. B. Markupcompiler oder andere Serialisierung vollzieht.

.NET Framework
Verfügbar seit 3.0
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: