FrameworkContentElement.Name Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de identificatienaam van het element op of stelt u deze in. De naam geeft een exemplaarverwijzing, zodat programmatische code achter, zoals gebeurtenishandlercode, naar een element kan verwijzen zodra deze is samengesteld tijdens het parseren van 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, setPublic Property Name As StringWaarde van eigenschap
De naam van het element.
Implementeringen
- Kenmerken
Opmerkingen
Het meest voorkomende gebruik van deze eigenschap is bij het opgeven van een XAML-elementnaam in markeringen.
Deze eigenschap biedt in wezen een WPF eigenschap op frameworkniveau om de XAML-x:Name Directive in te stellen.
Het ophalen van een Name code is niet gebruikelijk, omdat als u al over de juiste verwijzing in code beschikt, u gewoon methoden en eigenschappen op de elementreferentie kunt aanroepen en het over het Namealgemeen niet nodig hebt. Een uitzondering is als de tekenreeks een overbelaste betekenis heeft, bijvoorbeeld als het handig is om die naam weer te geven in de gebruikersinterface. Het instellen van een Name from-code als het origineel Name is ingesteld vanuit markeringen wordt ook niet aanbevolen en als u de eigenschap wijzigt, wordt de objectverwijzing niet gewijzigd. Dergelijke objectverwijzingen worden alleen gemaakt wanneer de onderliggende naamscopen expliciet worden gemaakt tijdens het laden van XAML.
U moet specifiek aanroepen RegisterName om een effectieve wijziging aan te brengen in de Name eigenschap van een al geladen element.
Een belangrijk geval waarbij het instellen Name van code belangrijk is, is voor het benoemen van elementen waarop storyboards worden uitgevoerd. Voordat u een naam kunt registreren, moet u mogelijk ook een NameScope exemplaar instantiëren en toewijzen. Zie de sectie Voorbeeld of Overzicht van Storyboards.
Het instellen Name van code heeft beperkte toepassingen, maar het opzoeken van een element op naam is gebruikelijker, met name als u een navigatiemodel gebruikt waarbij pagina's opnieuw worden geladen in de toepassing en de runtimecode niet noodzakelijkerwijs de code achter die respectieve pagina is. De hulpprogrammamethode FindName, die beschikbaar is vanuit elke FrameworkContentElement, kan elk element Name in de logische structuur van dat element recursief vinden. U kunt ook de FindLogicalNode statische methode gebruiken, LogicalTreeHelperwaarbij ook de Name tekenreeks als argument wordt gebruikt.
Veelgebruikte hoofdelementen (WindowPagebijvoorbeeld) implementeren de interfaceINameScope. Implementaties van deze interface zullen naar verwachting afdwingen dat namen ondubbelzinnig zijn binnen hun bereik.
Informatie over afhankelijkheidseigenschappen
| Item | Waarde |
|---|---|
| Id-veld | NameProperty |
Eigenschappen van metagegevens ingesteld op true |
IsAnimationProhibited |
