FrameworkContentElement.Name Eigenschaft

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };

[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
public string Name { get; set; }

[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
member this.Name : string with get, set

Public Property Name As String

Eigenschaftswert

Der Name des Elements.

Implementiert

Attribute

LocalizabilityAttribute

Hinweise

Die häufigste Verwendung dieser Eigenschaft ist die Angabe eines XAML-Elementnamens im Markup.

Diese Eigenschaft stellt im Wesentlichen eine Komforteigenschaft auf WPF-Frameworkebene bereit, um die XAML x:Name-Direktive festzulegen.

Das Abrufen eines Name Code aus Code ist nicht üblich, da Sie, wenn Sie bereits über den entsprechenden Verweis im Code verfügen, nur Methoden und Eigenschaften für den Elementverweis aufrufen können und dies Nameim Allgemeinen nicht benötigen. Eine Ausnahme ist, wenn die Zeichenfolge eine überladene Bedeutung hat, z. B. wenn es nützlich ist, diesen Namen in der Benutzeroberfläche anzuzeigen. Das Festlegen eines Name Code vom Code, wenn das Original Name aus Markup festgelegt wurde, wird ebenfalls nicht empfohlen, und das Ändern der Eigenschaft ändert nicht den Objektverweis. Solche Objektverweise werden nur erstellt, wenn die zugrunde liegenden NameScopes während des XAML-Ladens explizit erstellt werden.

Sie müssen explizit aufrufen RegisterName , um eine effektive Änderung für die Name Eigenschaft eines bereits geladenen Elements vorzunehmen.

Ein wichtiger Fall, bei dem die Einstellung Name aus Code wichtig ist, ist das Benennen von Elementen, für die Storyboards ausgeführt werden. Bevor Sie einen Namen registrieren können, müssen Sie möglicherweise auch eine NameScope Instanz instanziieren und zuweisen. Weitere Informationen finden Sie im Abschnitt "Beispiel" oder "Storyboards Overview".

Das Festlegen Name von Code hat eingeschränkte Anwendungen, aber das Nachschlagen eines Elements anhand des Namens ist häufiger, insbesondere wenn Sie ein Navigationsmodell verwenden, bei dem Seiten in die Anwendung neu geladen werden und der Laufzeitcode nicht unbedingt der CodeBehind dieser jeweiligen Seite ist. Die Hilfsmethode FindName, die von jedem FrameworkContentElementverfügbar ist, kann jedes Element Name rekursiv in der logischen Struktur dieses Elements finden. Sie können auch die statische Methode verwenden, von LogicalTreeHelperder FindLogicalNode auch die Name Zeichenfolge als Argument verwendet wird.

Häufig verwendete Stammelemente (WindowPagez. B.) implementieren die SchnittstelleINameScope. Es wird erwartet, dass Implementierungen dieser Schnittstelle erzwingen, dass Namen innerhalb ihres Gültigkeitsbereichs eindeutig sind.

Informationen zur Abhängigkeitseigenschaft

Weitere Informationen

• NameScope