FrameworkContentElement.Name Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Dient zum Abrufen oder Festlegen des Elementnamens. Der Name stellt einen Instanzverweis bereit, damit programmgesteuerter Codebehind, z. B. Ereignishandlercode, nach dem Erstellen eines Elements während der Analyse von XAML auf ein Element verwiesen wird.

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

String

Der Name des Elements.

Implementiert

Name

Attribute

LocalizabilityAttribute

Hinweise

Die häufigste Verwendung dieser Eigenschaft ist beim Angeben eines XAML-Elementnamens im Markup.

Diese Eigenschaft bietet im Wesentlichen eine WPF-Framework-Level-Komforteigenschaft, um die XAML x:Name-Richtlinie festzulegen.

Das Abrufen von Name Code ist nicht häufig, da Sie bereits über die entsprechende Referenz im Code verfügen, können Sie nur Methoden und Eigenschaften auf dem Elementverweis aufrufen und nicht allgemein benötigen Name. Eine Ausnahme besteht darin, dass die Zeichenfolge eine überladene Bedeutung aufweist, z. B. wenn es nützlich ist, diesen Namen in der Benutzeroberfläche anzuzeigen. Name Wenn das Original Name aus Markup festgelegt wurde, wird auch kein Code festgelegt, und das Ändern der Eigenschaft ändert den Objektverweis nicht. Solche Objektbezüge werden nur erstellt, wenn die zugrunde liegenden Namescopes während des XAML-Ladens explizit erstellt werden.

Sie müssen insbesondere aufrufen RegisterName , um eine effektive Änderung der Name Eigenschaft eines bereits geladenen Elements vorzunehmen.

Ein bemerkenswerter Fall, bei dem die Einstellung Name von Code wichtig ist, um Elemente zu benennen, 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".

Die Einstellung Name von Code hat begrenzte Anwendungen, aber das Nachschlagen eines Elements nach Dem Namen 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 nach dem logischen Baum dieses Elements Name rekursiv finden. Oder Sie können die statische Methode LogicalTreeHelpervon , die auch die FindLogicalNode Name Zeichenfolge als Argument verwendet.

Häufig verwendete Stammelemente (WindowPagez. B. implementieren die SchnittstelleINameScope). Implementierungen dieser Schnittstelle werden erwartet, dass Namen innerhalb ihres Bereichs eindeutig sind.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	NameProperty
Metadateneigenschaften auf true festgelegt	IsAnimationProhibited

Siehe auch

• NameScope