FrameworkElement.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 arka planda kod oluşturmanın bir XAML işlemcisi tarafından işlenirken oluşturulan bir işaretleme öğesine başvurabilmesi için bir başvuru 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ı. Varsayılan değer boş bir dizedir.

Uygulamalar

Name

Öznitelikler

LocalizabilityAttribute

Örnekler

Aşağıdaki örnek, kodda özelliğini ayarlar Name ve ardından çağırarak RegisterNameadı yeni oluşturulana NameScope kaydeder. Burada gösterilen teknik, görsel taslaklar tarafından hedefleme gerektirdiğinden ve nesne başvurusu tarafından Namehedeflenemediğinden görsel taslaklarla animasyon oluşturmak için bir gereksinimdir.

//  
// Create a Rectangle
//
Rectangle myRectangle = new Rectangle();
myRectangle.Width = 200;
myRectangle.Height = 200;
myRectangle.Name = "myRectangle";
this.RegisterName(myRectangle.Name, myRectangle);

'  
' Create a Rectangle
'
Dim myRectangle As New Rectangle()
myRectangle.Width = 200
myRectangle.Height = 200
myRectangle.Name = "myRectangle"
Me.RegisterName(myRectangle.Name, myRectangle)

Açıklamalar

Bu özelliğin en yaygın kullanımı, işaretlemede öznitelik olarak bir XAML öğesi adı belirtmektir.

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

Adlar, ad kapsamı içinde benzersiz olmalıdır. Daha fazla bilgi için bkz. WPF XAML Ad Kapsamları.

Name Kodda öğe oluşturuyorsanız almak yaygın değildir. Kodda zaten uygun başvurunuz varsa, yalnızca öğe başvurusunda yöntemleri ve özellikleri çağırabilirsiniz ve genel olarak gerekmeyecektir Name. Bunun bir istisnası, dizenin Name aşırı yüklenmiş bir anlamı olması, örneğin kullanıcı arabiriminde bu adın görüntülenmesinin yararlı olmasıdır. Özgün Name değer işaretlemeden ayarlandıysa arka planda koddan Name ayarlama da önerilmez ve XAML yüklendikten sonra özelliğin değiştirilmesi özgün nesne başvuruyu değiştirmez. Nesne başvuruları yalnızca temel ad kapsamları ayrıştırma sırasında 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 bir durum, görsel taslakların çalıştırılacağı öğelerin adlarını kaydederken çalışma zamanında bunlara başvurulabilmesidir. 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 öğesini Name alma işlemi daha yaygındır. Belirli bir senaryo, uygulamanızın sayfaların uygulamaya yeniden yüklendiği bir gezinti modelini desteklemesi ve çalışma zamanı kodunun söz konusu sayfa için mutlaka kod gerisinde tanımlanmamasıdır. Herhangi bir öğesinden kullanılabilen yardımcı program yöntemi FindName, herhangi bir FrameworkElementöğeyi ilgili öğenin Name mantıksal ağacından bulabilir ve gerektiğinde özyinelemeli olarak ağaçta arama yapabilir. Alternatif olarak, bir dizeyi FindLogicalNode bağımsız değişken olarak da alan Name statik yöntemini LogicalTreeHelperkullanabilirsiniz.

Genellikle 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. Bu arabirimi tanımlayan kök öğeler, tüm ilgili API'ler için ad kapsamı davranış sınırlarını da tanımlar.

Name özelliği, diğer işlemler için bir tanımlayıcı işlevi de görür. Örneğin, WPF otomasyon modeli istemciler ve sağlayıcılar için AutomationId olarak kullanır Name .

için Name kullanılan dize değerleri, XAML belirtimi tarafından tanımlanan temel x:Name Yönergesi tarafından uygulanan bazı kısıtlamalara sahiptir. En önemlisi, bir Name harf veya alt çizgi karakteriyle (_) başlamalıdır ve yalnızca harf, rakam veya alt çizgi içermelidir. Daha fazla bilgi için bkz. WPF XAML Ad Kapsamları.

Name adı bir animasyonu hedeflemek için çok önemli olduğundan animasyon yapılamayan (IsAnimationProhibited meta verilerde) true çok az bağımlılık özelliğinden biridir. a veri bağlaması Name teknik olarak mümkündür, ancak son derece nadir bir senaryodur çünkü veri bağlama Name özelliğin amaçlanan ana amacına hizmet edemez: arka planda kod için tanımlayıcı bağlantı noktası sağlamak.

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

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