FrameworkContentElement.Name Özellik

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

PresentationFramework.dll

Öğ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

String

Öğe adı.

Uygulamalar

Name

Öznitelikler

LocalizabilityAttribute

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

Ayrıca bkz.

• NameScope