FrameworkContentElement.Name Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows
Zestaw:
PresentationFramework.dll

Pobiera lub ustawia nazwę identyfikującą elementu. Nazwa zawiera odwołanie do wystąpienia, dzięki czemu kod programowy, taki jak kod procedury obsługi zdarzeń, może odwoływać się do elementu po utworzeniu podczas analizowania kodu 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

Wartość właściwości

String

Nazwa elementu.

Implementuje

Name
Atrybuty
LocalizabilityAttribute

Uwagi

Najczęstszym zastosowaniem tej właściwości jest określenie nazwy elementu XAML w znacznikach.

Ta właściwość zasadniczo udostępnia właściwość wygody na poziomie platformy WPF, aby ustawić dyrektywę XAML x:Name.

Pobieranie elementu Name z kodu nie jest powszechne, ponieważ jeśli masz już odpowiednie odwołanie w kodzie, możesz po prostu wywołać metody i właściwości w odwołaniu do elementu i zwykle nie potrzebują elementu Name. Wyjątek występuje, jeśli ciąg ma pewne przeciążone znaczenie, na przykład jeśli warto wyświetlić tę nazwę w interfejsie użytkownika. Name Ustawienie elementu z kodu, jeśli oryginalny Name został ustawiony z znaczników również nie jest zalecane, a zmiana właściwości nie spowoduje zmiany odwołania do obiektu. Takie odwołania do obiektów są tworzone tylko wtedy, gdy bazowe zakresy nazw są jawnie tworzone podczas ładowania kodu XAML.

Należy w szczególności wywołać RegisterName metodę , aby wprowadzić skuteczną zmianę Name we właściwości już załadowanego elementu.

Jednym z istotnych przypadków, w którym ustawienie Name z kodu jest ważne, jest dla elementów nazewnictwa, względem których będą uruchamiane scenorysy. Zanim będzie można zarejestrować nazwę, może być również konieczne utworzenie wystąpienia i przypisanie wystąpienia NameScope . Zobacz sekcję Przykład lub Omówienie scenorysów.

Ustawienie Name z kodu ma ograniczone aplikacje, ale wyszukiwanie elementu według nazwy jest bardziej powszechne, szczególnie w przypadku korzystania z modelu nawigacji, w którym strony są ponownie ładowane do aplikacji, a kod czasu wykonywania nie musi być kodem odpowiadającym tej stronie. Metoda FindNamenarzędzia , która jest dostępna z dowolnego FrameworkContentElementelementu , może znaleźć dowolny element Name w drzewie logicznym tego elementu rekursywnie. Możesz też użyć FindLogicalNode metody statycznej LogicalTreeHelper, która również przyjmuje Name ciąg jako argument.

Często używane elementy główne (WindowPagena przykład) implementują interfejs INameScope. Implementacje tego interfejsu powinny wymuszać, że nazwy są jednoznaczne w ich zakresie.

Informacje dotyczące właściwości zależności
Pole identyfikatora NameProperty
Właściwości metadanych ustawione na true IsAnimationProhibited

Dotyczy

Zobacz też