Sdílet prostřednictvím


FrameworkContentElement.Name Vlastnost

Definice

Získá nebo nastaví identifikační název elementu. Název poskytuje odkaz na instanci, aby programový kód za kódem, jako je kód obslužné rutiny události, mohl odkazovat na prvek, jakmile je vytvořen během analýzy XAML.

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

Hodnota vlastnosti

String

Název elementu.

Implementuje

Atributy

Poznámky

Nejběžnějším použitím této vlastnosti je zadání názvu elementu XAML v revizích.

Tato vlastnost v podstatě poskytuje vlastnost usnadnění na úrovni architektury WPF pro nastavení direktivy XAML x:Name.

Name Získání kódu z kódu není běžné, protože pokud již máte odpovídající odkaz v kódu, můžete pouze volat metody a vlastnosti v odkazu prvku a obecně nepotřebujete Name. Výjimkou je, pokud má řetězec nějaký přetížený význam, například pokud je užitečné zobrazit tento název v uživatelském rozhraní. Name Nastavení kódu v případě, že původní Name byl nastaven z revizí, se také nedoporučuje a změna vlastnosti nezmění odkaz na objekt. Tyto odkazy na objekty jsou vytvořeny pouze v případě, že podkladové názvové rozsahy jsou explicitně vytvořeny během načítání XAML.

Je třeba konkrétně volat RegisterName , aby se účinná změna vlastnosti Name již načteného prvku.

Jedním z důležitých případů, kdy je nastavení Name z kódu důležité, je pro pojmenování prvků, se kterými se scénáře spustí. Před registrací názvu může být také potřeba vytvořit instanci a přiřadit NameScope instanci. Podívejte se na část Příklad nebo Přehled scénářů.

Nastavení Name z kódu má omezené aplikace, ale vyhledání elementu podle názvu je častější, zejména pokud používáte navigační model, ve kterém se stránky znovu načtou do aplikace a kód za běhu nemusí nutně odpovídat kódu příslušné stránky. Metoda FindNamenástroje , která je k dispozici z libovolného FrameworkContentElement, může najít libovolný prvek v Name logické stromu tohoto prvku rekurzivně. Nebo můžete použít statickou metodu FindLogicalNode LogicalTreeHelper, která také přebírá Name řetězec jako argument.

Běžně používané kořenové prvky (WindowPagenapříklad) implementují rozhraní INameScope. Očekává se, že implementace tohoto rozhraní budou vynucovat, aby názvy byly v rámci jejich oboru jednoznačné.

Informace o vlastnosti závislosti

Pole identifikátoru NameProperty
Vlastnosti metadat nastavené na true IsAnimationProhibited

Platí pro

Viz také