FrameworkContentElement.Name Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
Nome dell'elemento.
Implementazioni
- Attributi
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 |