FrameworkContentElement.Name Özellik

Tanım

Öğenin tanımlayıcı adını alır veya ayarlar.Gets or sets the identifying name of the element. Ad, bir örnek başvurusu sağlar, bu sayede olay işleyicisi kodu gibi programlı arka plan kodu, ayrıştırma sırasında oluşturulduktan sonra bir öğeye başvurabilir 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.

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

Özellik Değeri

String

Öğe adı.The name of the element.

Uygulamalar

Öznitelikler

Açıklamalar

Bu özelliğin en yaygın kullanımları, XAMLXAML biçimlendirme içinde bir öğe adı belirtmektir.The most common usage of this property is when specifying a XAMLXAML element name in markup.

Bu özellik temelde, XAMLXAML X:Name yönergesiniayarlamak için WPF çerçevesi düzeyi kullanışlı bir özellik sağlar.This property essentially provides a WPF framework-level convenience property to set the XAMLXAML x:Name Directive.

Kod Name içinde uygun bir başvuruya sahip olduğunuz için bir koddan alma yaygın değildir, ancak öğe başvurusunda yalnızca yöntemleri ve özellikleri çağırabilirsiniz ve genellikle bunu yapmanız gerekmez 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. Bir özel durum, örneğin, içinde bu adı göstermek için yararlı ise, dizenin aşırı yüklenmiş bir anlamı varsa Kullanıcı arabirimiUI .An exception is if the string has some overloaded meaning, for instance if it is useful to display that name in Kullanıcı arabirimiUI. Özgün bir Name işaretlemeden ayarlanmışsa koddan bir ayar Name yapılması önerilmez ve özelliğin değiştirilmesi nesne başvurusunu değiştirmez.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. Bu tür nesne başvuruları yalnızca, temel alınan ad kapsamları yükleme sırasında açıkça oluşturulduğunda oluşturulur XAMLXAML .Such object references are created only when the underlying namescopes are explicitly created during XAMLXAML loading.

RegisterName Name Zaten yüklü olan bir öğenin özelliğinde etkin bir değişiklik yapmak için özel olarak çağırmanız gerekir.You must specifically call RegisterName to make an effective change on the Name property of an already loaded element.

Koddan ayarların önemli olduğu bir önemli örneği Name , film şeritlerinin çalışacağı adlandırma öğelerine yöneliktir.One notable case where setting Name from code is important is for naming elements that storyboards will run against. Bir adı kaydedebilmeniz için önce bir örnek örneği oluşturma ve atama de gerekebilir NameScope .Before you can register a name, might also need to instantiate and assign a NameScope instance. Örnek bölümüne veya görsel taslaklara genel bakışkonusuna bakın.See the Example section, or Storyboards Overview.

NameKoddan Setting, sınırlı uygulamalara sahiptir, ancak özellikle sayfaların uygulamaya yeniden yüklendiği bir gezinti modeli kullandıysanız ve çalışma zamanı kodunun ilgili sayfanın arka plan kodu olmaması halinde, özellikle de bir öğeyi ada göre aramak daha yaygındır.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. FindNameHerhangi bir tarafından kullanılabilen yardımcı program yöntemi, FrameworkContentElement Name Bu öğenin mantıksal ağacındaki herhangi bir öğeyi yinelemeli olarak bulabilir.The utility method FindName, which is available from any FrameworkContentElement, can find any element by Name in that element's logical tree recursively. Ya FindLogicalNode LogicalTreeHelper da Name dize bağımsız değişken olarak da geçen statik yöntemini kullanabilirsiniz.Or you can use the FindLogicalNode static method of LogicalTreeHelper, which also takes the Name string as an argument.

Yaygın olarak kullanılan kök öğeler Window ( Page Örneğin,) arabirimini uygular INameScope .Commonly used root elements (Window, Page for example) implement the interface INameScope. Bu arabirimin uygulamalarının, bu adların kapsamları dahilinde benzersiz olmasını zorunlu kılmak için beklenmektedir.Implementations of this interface are expected to enforce that names be unambiguous within their scope.

Bağımlılık Özelliği BilgileriDependency Property Information

Tanımlayıcı alanıIdentifier field NameProperty
Meta veri özellikleri olarak ayarlandı trueMetadata properties set to true IsAnimationProhibited

Şunlara uygulanır

Ayrıca bkz.