FrameworkContentElement.Name Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur nama identifikasi elemen. Nama ini menyediakan referensi instans sehingga kode terprogram di belakang, seperti kode penanganan aktivitas, dapat merujuk ke elemen setelah dibangun selama penguraian XAML.

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

Nilai Properti

String

Nama elemen.

Penerapan

Name

Atribut

LocalizabilityAttribute

Keterangan

Penggunaan paling umum dari properti ini adalah ketika menentukan nama elemen XAML dalam markup.

Properti ini pada dasarnya menyediakan properti kenyamanan tingkat kerangka kerja WPF untuk mengatur XAML x:Name Directive.

Name Mendapatkan dari kode tidak umum, karena jika Anda sudah memiliki referensi yang sesuai dalam kode, Anda hanya dapat memanggil metode dan properti pada referensi elemen dan umumnya tidak memerlukan Name. Pengecualiannya adalah jika string memiliki beberapa arti yang kelebihan beban, misalnya jika berguna untuk menampilkan nama tersebut di UI. Name Mengatur dari kode jika aslinya Name diatur dari markup juga tidak disarankan, dan mengubah properti tidak akan mengubah referensi objek. Referensi objek tersebut dibuat hanya ketika namescope yang mendasar dibuat secara eksplisit selama pemuatan XAML.

Anda harus secara khusus memanggil RegisterName untuk membuat perubahan efektif pada Name properti elemen yang sudah dimuat.

Satu kasus penting di mana pengaturan Name dari kode penting adalah untuk penamaan elemen yang akan dijalankan oleh papan cerita. Sebelum Anda dapat mendaftarkan nama, mungkin juga perlu membuat instans dan menetapkan NameScope instans. Lihat bagian Contoh, atau Ringkasan Papan Cerita.

Pengaturan Name dari kode memiliki aplikasi terbatas, tetapi mencari elemen berdasarkan nama lebih umum, terutama jika Anda menggunakan model navigasi di mana halaman dimuat ulang ke dalam aplikasi dan kode run-time belum tentu merupakan kode di belakang halaman masing-masing. Metode FindNameutilitas , yang tersedia dari apa pun FrameworkContentElement, dapat menemukan elemen apa pun dengan Name di pohon logis elemen tersebut secara rekursif. Atau Anda dapat menggunakan FindLogicalNode metode statis , LogicalTreeHelperyang juga mengambil Name string sebagai argumen.

Elemen akar yang umum digunakan (Window, Page misalnya) mengimplementasikan antarmuka INameScope. Implementasi antarmuka ini diharapkan untuk menegakkan bahwa nama tidak ambigu dalam cakupannya.

Informasi Properti Dependensi

Item	Nilai
Bidang pengidentifikasi	NameProperty
Properti metadata diatur ke true	IsAnimationProhibited

Lihat juga

• NameScope