FrameworkContentElement.Name Egenskap

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

Egenskapsvärde

Namnet på elementet.

Implementeringar

Attribut

LocalizabilityAttribute

Kommentarer

Den vanligaste användningen av den här egenskapen är när du anger ett XAML-elementnamn i markering.

Den här egenskapen tillhandahåller i princip en WPF bekvämlighetsegenskap på ramverksnivå som anger XAML-x:Name Directive.

Det är inte vanligt att hämta en Name kod, för om du redan har rätt referens i koden kan du bara anropa metoder och egenskaper för elementreferensen och behöver Namevanligtvis inte . Ett undantag är om strängen har en överbelastad betydelse, till exempel om det är användbart att visa det namnet i användargränssnittet. Att ange en Name från kod om originalet Name angavs från markering rekommenderas inte heller, och om du ändrar egenskapen ändras inte objektreferensen. Sådana objektreferenser skapas bara när de underliggande namnskopen uttryckligen skapas under XAML-inläsning.

Du måste specifikt anropa RegisterName för att göra en effektiv ändring av egenskapen för Name ett redan inläst element.

Ett viktigt fall där inställningen Name från kod är viktig är för namngivning av element som storyboards körs mot. Innan du kan registrera ett namn kan du också behöva instansiera och tilldela en NameScope instans. Se avsnittet Exempel eller Översikt över Storyboards.

Inställningen Name från kod har begränsade program, men det är vanligare att leta upp ett element efter namn, särskilt om du använder en navigeringsmodell där sidor läses in igen i programmet och körningskoden inte nödvändigtvis är koden bakom respektive sida. Verktygsmetoden FindName, som är tillgänglig från valfri FrameworkContentElement, kan hitta alla element med Name i elementets logiska träd rekursivt. Eller så kan du använda den FindLogicalNode statiska metoden LogicalTreeHelperför , som också tar strängen Name som ett argument.

Vanliga rotelement (WindowPagetill exempel) implementerar gränssnittet INameScope. Implementeringar av det här gränssnittet förväntas framtvinga att namnen är entydiga inom deras omfång.

Information om beroendeegenskap

Se även

• NameScope