FrameworkContentElement.Name Właściwość

Definicja

Pobiera lub ustawia nazwę identyfikującą elementu.Gets or sets the identifying name of the element. Nazwa zawiera odwołanie do wystąpienia, dzięki czemu kod programistyczny, taki jak kod procedury obsługi zdarzeń, może odwoływać się do elementu, gdy jest konstruowany podczas analizowania XAMLXAML.The name provides an instance reference so that programmatic code-behind, such as event handler code, can refer to an element once it is constructed during parsing of XAMLXAML.

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; }
member this.Name : string with get, set
Public Property Name As String

Wartość właściwości

Nazwa elementu.The name of the element.

Implementuje

Atrybuty

Uwagi

Najbardziej typowym użyciem tej właściwości jest określenie nazwy elementu XAMLXAML w znaczniku.The most common usage of this property is when specifying a XAMLXAML element name in markup.

Ta właściwość zasadniczo zapewnia wygodną właściwość na poziomie platformy WPF, aby ustawić XAMLXAML dyrektywę x:Name.This property essentially provides a WPF framework-level convenience property to set the XAMLXAML x:Name Directive.

Pobieranie Name z kodu nie jest typowe, ponieważ jeśli istnieje odpowiednie odwołanie w kodzie, można tylko wywołać metody i właściwości w odwołaniu do elementu i nie ma na ogół potrzeby Name.Getting a Name from code is not common, because if you have the appropriate reference in code already, you can just call methods and properties on the element reference and do not generally need the Name. Wyjątek polega na tym, że ciąg ma pewne przeciążone znaczenie, na przykład, jeśli jest przydatne do wyświetlania tej nazwy w Interfejs użytkownikaUI.An exception is if the string has some overloaded meaning, for instance if it is useful to display that name in Interfejs użytkownikaUI. Ustawienie Name z kodu, jeśli oryginalny Name został ustawiony z znaczników nie jest również zalecany i zmiana właściwości nie spowoduje zmiany odwołania do obiektu.Setting a Name from code if the original Name was set from markup is also not recommended, and changing the property will not change the object reference. Odwołania do obiektów są tworzone tylko wtedy, gdy bazowe Zakresy nazw WPF są tworzone jawnie podczas ładowania XAMLXAML.Such object references are created only when the underlying namescopes are explicitly created during XAMLXAML loading.

Należy jawnie wywołać RegisterName, aby wprowadzić skuteczną zmianę właściwości Name już załadowanego elementu.You must specifically call RegisterName to make an effective change on the Name property of an already loaded element.

W przypadku, gdy ustawienie Name z kodu jest ważne dla elementów nazewnictwa, względem których będą uruchamiane Scenorysy.One notable case where setting Name from code is important is for naming elements that storyboards will run against. Przed zarejestrowaniem nazwy może być również konieczne utworzenie wystąpienia NameScope i przypisanie go do wystąpienia.Before you can register a name, might also need to instantiate and assign a NameScope instance. Zapoznaj się z sekcją przykładu lub scenorysami.See the Example section, or Storyboards Overview.

Ustawienie Name z kodu ma ograniczone aplikacje, ale wyszukiwanie elementu według nazwy jest bardziej popularne, szczególnie w przypadku korzystania z modelu nawigacji, w którym strony ładują się ponownie do aplikacji, a kod czasu wykonywania nie musi być kodem związanym z odpowiednią stroną.Setting Name from code has limited applications, but looking up an element by name is more common, particularly if you are employing a navigation model where pages reload into the application and the run-time code is not necessarily the code-behind of that respective page. Metoda narzędziowa FindName, która jest dostępna z dowolnego FrameworkContentElement, może znaleźć każdy element, Name w drzewie logicznym tego elementu cyklicznie.The utility method FindName, which is available from any FrameworkContentElement, can find any element by Name in that element's logical tree recursively. Można też użyć FindLogicalNode statycznej metody LogicalTreeHelper, która również przyjmuje ciąg Name jako argument.Or you can use the FindLogicalNode static method of LogicalTreeHelper, which also takes the Name string as an argument.

Najczęściej używane elementy główne (na przykładWindow, Page) implementują interfejs INameScope.Commonly used root elements (Window, Page for example) implement the interface INameScope. Implementacje tego interfejsu powinny wymusić niejednoznaczność nazw w zakresie.Implementations of this interface are expected to enforce that names be unambiguous within their scope.

Informacje dotyczące właściwości zależnościDependency Property Information

Pole identyfikatoraIdentifier field NameProperty
Właściwości metadanych ustawione na trueMetadata properties set to true IsAnimationProhibited

Dotyczy

Zobacz też