FrameworkContentElement.Name Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows
Assembly:
PresentationFramework.dll

Ottiene o imposta il nome identificativo dell'elemento. Il nome fornisce un riferimento all'istanza in modo che il code-behind programmatico, ad esempio il codice del gestore eventi, possa fare riferimento a un elemento una volta costruito durante l'analisi di 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

Valore della proprietà

String

Nome dell'elemento.

Implementazioni

Name
Attributi
LocalizabilityAttribute

Commenti

L'uso più comune di questa proprietà è quando si specifica un nome di elemento XAML nel markup.

Questa proprietà fornisce essenzialmente una proprietà pratica a livello di framework WPF per impostare la direttiva x:Name XAML.

L'acquisizione di un Name oggetto dal codice non è comune, perché se si dispone già del riferimento appropriato nel codice, è possibile chiamare solo metodi e proprietà nel riferimento all'elemento e in genere non è necessario .Name Un'eccezione è se la stringa ha un significato di overload, ad esempio se è utile visualizzare tale nome nell'interfaccia utente. Non è consigliabile impostare un Name oggetto dal codice se l'originale Name è stato impostato dal markup e la modifica della proprietà non modificherà il riferimento all'oggetto. Tali riferimenti a oggetti vengono creati solo quando gli ambiti dei nomi sottostanti vengono creati in modo esplicito durante il caricamento XAML.

È necessario chiamare RegisterName in modo specifico per apportare una modifica efficace sulla Name proprietà di un elemento già caricato.

Un caso importante in cui l'impostazione Name dal codice è importante per la denominazione di elementi in cui verranno eseguiti gli storyboard. Prima di poter registrare un nome, potrebbe essere necessario creare un'istanza e assegnare un'istanza NameScope di . Vedere la sezione Esempio o Panoramica degli storyboard.

L'impostazione Name dal codice include applicazioni limitate, ma la ricerca di un elemento per nome è più comune, in particolare se si usa un modello di navigazione in cui le pagine vengono ricaricate nell'applicazione e il codice di runtime non è necessariamente il code-behind della rispettiva pagina. Il metodo FindNamedi utilità , disponibile da qualsiasi FrameworkContentElement, può trovare qualsiasi elemento in Name modo ricorsivo nell'albero logico di tale elemento. In alternativa, è possibile usare il FindLogicalNode metodo statico di LogicalTreeHelper, che accetta anche la Name stringa come argomento.

Gli elementi radice comunemente usati (WindowPagead esempio) implementano l'interfaccia INameScope. È previsto che le implementazioni di questa interfaccia applichino che i nomi non siano ambigui all'interno dell'ambito.

Informazioni proprietà di dipendenza
Campo Identificatore NameProperty
Proprietà dei metadati impostate su true IsAnimationProhibited

Si applica a

Vedi anche