FrameworkContentElement.Name Vlastnost

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Získá nebo nastaví identifikační název prvku. Tento 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 prvku.

Implementuje

Name

Atributy

LocalizabilityAttribute

Poznámky

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

Tato vlastnost v podstatě poskytuje vlastnost pohodlí 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 odkazu na element 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, pokud byl původní Name nastaven z revizí, se také nedoporučuje a změna vlastnosti nezmění odkaz na objekt. Tyto odkazy na objekty jsou vytvořeny pouze tehdy, když jsou podkladové názvové rozsahy explicitně vytvořeny během načítání XAML.

Je třeba konkrétně volat RegisterName , aby provést efektivní změnu Name vlastnosti již načteného elementu.

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. Viz část Příklad nebo Přehled scénářů.

Nastavení Name z kódu má omezené aplikace, ale vyhledání prvku 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. Utility metoda FindName, která je k dispozici z libovolného FrameworkContentElement, může najít libovolný prvek v Name logickém stromu tohoto prvku rekurzivně. Nebo můžete použít statickou metodu FindLogicalNodeLogicalTreeHelper, 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

Položka	Hodnota
Pole Identifikátor	NameProperty
Vlastnosti metadat nastavené na true	IsAnimationProhibited

Viz také

• NameScope