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

Öğenin 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, yalnızca öğe başvurusundaki yöntemleri ve özellikleri çağırabilir ve genel olarak öğesine ihtiyacınız Nameyoktur. Dizenin aşırı yüklenmiş bir anlamı olması, örneğin kullanıcı arabiriminde bu adın görüntülenmesinin yararlı olması bir özel durumdur. Name Özgün Name değer işaretlemeden ayarlandıysa koddan ayarlama 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ğırmalısınızRegisterName.

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

Koddan ayarlamanın Name uygulamaları sınırlıdır, ancak özellikle sayfaların uygulamaya yeniden yüklendiği bir gezinti modeli kullanıyorsanız ve çalışma zamanı kodunun ilgili sayfanın arka planında olması gerekmeyen bir gezinti modeli kullanıyorsanız, 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ında yinelemeli olarak herhangi bir öğeyi bulabilirName. Ya da dizeyi FindLogicalNode bağımsız değişken olarak 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

Öğe	Değer
Tanımlayıcı alanı	NameProperty
Meta veri özellikleri olarak ayarlandı true	IsAnimationProhibited

Ayrıca bkz.

• NameScope