FrameworkContentElement.Name FrameworkContentElement.Name FrameworkContentElement.Name FrameworkContentElement.Name Property


要素の識別名を取得または設定します。Gets or sets the identifying name of the element. この名前はインスタンス参照を提供するため、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.

 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };
public string Name { get; set; }
member this.Name : string with get, set
Public Property Name As String


要素の名前。The name of the element.



このプロパティの最も一般的な使用方法は、指定するときに、XAMLXAMLマークアップ内の要素名。The most common usage of this property is when specifying a XAMLXAML element name in markup.

このプロパティでは、WPF フレームワーク レベルの便利なプロパティを設定する基本的にでは、 XAMLXAML X:name ディレクティブします。This property essentially provides a WPF framework-level convenience property to set the XAMLXAML x:Name Directive.

取得、Nameコードからです。 一般的な、既に適切な参照をコードである場合のメソッドを呼び出すだけで済みます、要素のプロパティを参照し、一般的に必要ではありません、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. 例外は、文字列がオーバー ロードされたに意味では、その名前を表示すると便利な場合UIUIします。An exception is if the string has some overloaded meaning, for instance if it is useful to display that name in UIUI. 設定、Nameコードから場合元Nameがマークアップから設定はしないでも、およびプロパティを変更しても、オブジェクト参照は変更されません。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. 基になる名前スコープが中に明示的に作成された場合にのみ、このようなオブジェクト参照が作成されたXAMLXAML読み込み。Such object references are created only when the underlying namescopes are explicitly created during XAMLXAML loading.

具体的には呼び出す必要があるRegisterName、効果的な変更で、Name既に読み込まれた要素のプロパティ。You must specifically call RegisterName to make an effective change on the Name property of an already loaded element.

1 つの重要な設定がの場合Nameコードからは重要なはに対してはストーリー ボードの名前付けの要素を実行します。One notable case where setting Name from code is important is for naming elements that storyboards will run against. 名前を登録する前にインスタンス化を割り当てる必要がありますも、NameScopeインスタンス。Before you can register a name, might also need to instantiate and assign a NameScope instance. 例のセクションを参照またはストーリー ボードの概要します。See the Example section, or Storyboards Overview.

設定Nameからコードには、アプリケーションが制限されていますが、特に、アプリケーションにページが再読み込みして、必ずしもその分離コードが実行時のコードではありません場所は、ナビゲーション モデルを採用している場合より一般的には名前で要素を検索それぞれのページ。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. ユーティリティ メソッドFindName、いずれかから利用できるFrameworkContentElementで要素を検索できますNameその要素の論理ツリーを再帰的にします。The utility method FindName, which is available from any FrameworkContentElement, can find any element by Name in that element's logical tree recursively. 使用することができます、FindLogicalNodeの静的メソッドLogicalTreeHelper、により、Nameを引数として文字列。Or you can use the FindLogicalNode static method of LogicalTreeHelper, which also takes the Name string as an argument.

よく使用されるルート要素 (WindowPageなど)、インターフェイスを実装してINameScopeします。Commonly used root elements (Window, Page for example) implement the interface INameScope. このインターフェイスの実装は、名は、スコープ内で明確であることを強制する必要があります。Implementations of this interface are expected to enforce that names be unambiguous within their scope.

依存プロパティ情報Dependency Property Information

識別子フィールドです。Identifier field NameProperty
メタデータのプロパティを設定するには trueMetadata properties set to true IsAnimationProhibited