Aracılığıyla paylaş


FrameworkContentElement.Name Özellik

Tanım

Öğesinin tanımlayıcı adını alır veya ayarlar. Ad, olay işleyicisi kodu gibi programlı kodun XAML ayrıştırma sırasında bir öğeye başvurabilmesi için bir örnek başvurusu sağlar.

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

Öğe adı.

Uygulamalar

Öznitelikler

Açıklamalar

Bu özelliğin en yaygın kullanımı, işaretlemede bir XAML öğesi adı belirtirken kullanılır.

Bu özellik temelde XAML x:Name Yönergesini ayarlamak için WPF çerçeve düzeyi kolaylık özelliği sağlar.

Koddan alma Name yaygın değildir, çünkü kodda zaten uygun başvuruya sahipseniz, öğe başvurusunda yöntemleri ve özellikleri çağırabilirsiniz ve genellikle öğesine ihtiyacınız Nameyoktur. Dizenin aşırı yüklenmiş bir anlamı olması, örneğin bu adın kullanıcı arabiriminde görüntülenmesinin yararlı olması bir özel durumdur. Name Özgün Name değer işaretlemeden ayarlandıysa koddan ayarının ayarlanması da önerilmez ve özelliğin değiştirilmesi nesne başvuruyu değiştirmez. Bu tür nesne başvuruları yalnızca XAML yüklemesi sırasında temel alınan ad kapsamları açıkça oluşturulduğunda oluşturulur.

Zaten yüklenmiş bir öğenin özelliğinde Name etkili bir değişiklik yapmak için özellikle çağrısı RegisterName yapmanız gerekir.

Koddan ayarlamanın Name önemli olduğu önemli bir durum, görsel taslakların çalıştırılacağı öğeleri adlandırmaktır. Bir adı kaydedebilmeniz için önce örnek oluşturup atamanız NameScope gerekebilir. Örnek bölümüne veya Görsel Taslaklara Genel Bakış'a bakın.

Koddan ayarlamanın Name sınırlı uygulamaları vardır, ancak özellikle sayfaların uygulamaya yeniden yüklendiği bir gezinti modeli kullanıyorsanız ve çalışma zamanı kodu ilgili sayfanın arka planında olmak zorunda değilse, ada göre öğe aramak daha yaygındır. Herhangi bir FrameworkContentElementöğesinden kullanılabilen yardımcı program yöntemiFindName, öğesinin mantıksal ağacındaki herhangi bir öğeyi Name yinelemeli olarak bulabilir. İsterseniz, dizeyi FindLogicalNode bağımsız değişken olarak da alan Name statik yöntemini LogicalTreeHelperkullanabilirsiniz.

Yaygın olarak kullanılan kök öğeler (WindowPageörneğin) arabirimini INameScopeuygular. Bu arabirimin uygulamalarının, adların kapsamları içinde belirsiz olmasını zorunlu kılması beklenir.

Bağımlılık Özelliği Bilgileri

Tanımlayıcı alanı NameProperty
Meta veri özellikleri olarak ayarlandı true IsAnimationProhibited

Şunlara uygulanır

Ayrıca bkz.