x:Class Yönergesi

Biçimlendirme ve arka plan kodu arasında kısmi sınıflara katılması için XAML biçimlendirme derlemesini yapılandırır. Kod kısmi sınıfı, ortak dil belirtimi (CLS) dilindeki ayrı bir kod dosyasında tanımlanır, ancak biçimlendirme kısmi sınıfı genellikle XAML derlemesi sırasında kod oluşturma tarafından oluşturulur.

XAML Öznitelik Kullanımı

<object x:Class="namespace.classname"...>
  ...
</object>

XAML Değerleri

namespace İsteğe bağlı. Tarafından tanımlanan kısmi sınıfı içeren bir CLR ad alanı belirtir classname . namespaceBelirtilmişse, nokta (.) namespace ve ayırır classname . Bkz. açıklamalar.
classname Gereklidir. Yüklenen XAML 'yi ve bu XAML için arka plan kodunuzu bağlayan kısmi sınıfın CLR adını belirtir.

Bağımlılıklar

x:Class yalnızca bir XAML üretiminin kök öğesinde belirtilebilir. x:Class , XAML üretiminde üst öğesi olan herhangi bir nesne üzerinde geçersizdir. Daha fazla bilgi için bkz. [ MS-xaml ] section 4.3.1.6.

Açıklamalar

namespaceBu değer, .NET programlamada yaygın bir tekniktir, ilgili ad alanlarını ad Hiyerarşileriyle düzenlemek için ek noktalar içerebilir. Yalnızca bir değer dizesindeki son nokta ayrı olarak x:Class yorumlanır namespace ve classname. olarak kullanılan sınıf, x:Class iç içe geçmiş bir sınıf olamaz. İç içe geçmiş sınıflara izin veriliyorsa dizeler için noktaların anlamını belirlemek belirsiz olduğu için iç içe geçmiş sınıflara izin verilmez x:Class .

Kullanan mevcut programlama modellerinde x:Class , x:Class arka plan kodu olmayan xaml sayfasına sahip olmak için tamamen geçerli olduğunu anlamak için isteğe bağlıdır. Ancak, bu özellik XAML kullanan çerçeveler tarafından uygulanan yapı eylemleriyle etkileşime girer. x:Class özelliği Ayrıca XAML tarafından belirtilen içeriğin çeşitli sınıflandırmalarının bir uygulama modelinde ve ilgili derleme eylemlerindeki rollerle etkilenir. XAML 'niz olay işleme öznitelik değerleri bildiriyorsa veya tanımlama sınıflarının arka plan kod sınıfında olduğu özel öğeleri örnekliyorsa, x:Class arka plan kodu için uygun sınıfa yönerge başvurusunu (veya x:alt sınıfı) sağlamanız gerekir.

Yönergesinin değeri, x:Class bir sınıfın tam adını belirten bir dize olmalıdır, ancak hiçbir derleme bilgisi (ile eşdeğerdir Type.FullName ). Basit uygulamalar için, arka plan kod bu şekilde de (kod tanımı sınıf düzeyinde başlar) de yapılandırılmış olması halinde CLR ad alanı bilgilerini atlayabilirsiniz.

Bir sayfa veya uygulama tanımının arka plan kod dosyası, derlenmiş bir uygulama üreten ve biçimlendirme derlemesini içeren projenin bir parçası olarak dahil olan bir kod dosyası içinde olmalıdır. CLR sınıfları için ad kurallarını izlemeniz gerekir. Daha fazla bilgi için bkz. Framework tasarım yönergeleri. Varsayılan olarak, arka plan kod sınıfı olmalıdır public ; ancak, X:ClassModifier yönergesinikullanarak farklı bir erişim düzeyinde tanımlayabilirsiniz.

Bu x:Class özniteliğin yorumu yalnızca .net xaml HIZMETLERINDE clr tabanlı xaml uygulamaları için geçerlidir. CLR tabanlı olmayan ve .NET XAML Hizmetleri kullanmayan diğer XAML uygulamaları, XAML işaretlemesini bağlamak ve çalışma zamanı kodunu yedeklemek için farklı bir çözüm formülü kullanabilir. Daha genel yorumlamalar hakkında daha fazla bilgi için x:Class bkz. [ MS-xaml ] .

Belirli bir mimari düzeyinde, x:Class .NET XAML hizmetlerinde anlamı tanımsızdır. Bunun nedeni, .NET XAML Hizmetleri tarafından XAML işaretleme ve yedekleme kodunun bağlı olduğu programlama modelini belirtmemelidir. Yönergesinin ek kullanımları, x:Class XAML biçimlendirme ve clr tabanlı arka plan kodu bağlamayı tanımlamak için programlama modellerini veya uygulama modellerini kullanan belirli çerçeveler tarafından uygulanabilir. Her çerçeve, yapı ortamına dahil olması gereken bazı davranışı veya belirli bileşenleri etkinleştiren kendi derleme eylemlerine sahip olabilir. Bir çerçeve içinde, derleme eylemleri de arka plan kodu için kullanılan belirli CLR diline bağlı olarak farklılık gösterebilir.

WPF programlama modelinde x:Class

WPF uygulamalarında ve WPF uygulama modelinde, x:Class BIR xaml dosyasının kökü olan ve derlenebilecek (XAML, derleme eylemiyle BIR WPF uygulaması projesine dahil edilen Page ) veya Application derlenmiş bir WPF uygulamasının uygulama tanımındaki kök için bir öznitelik olarak bildirilemez. x:Classsayfa kökü veya uygulama kökü dışında bir öğe üzerinde veya derlenmemiş bir WPF xaml dosyasında bildirilmek için, .NET Framework 3,0 ve .NET Framework 3,5 wpf xaml derleyicisi altında derleme zamanı hatasına neden olur. WPF 'de işlemenin diğer yönleri hakkında daha fazla bilgi için x:Class bkz. WPF Içinde arka plan kod ve xaml.

Windows Workflow Foundation için x:class

Windows Workflow Foundation için, x:Class tamamen XAML 'de oluşturulan özel bir etkinliğin sınıfını adlandırır veya arka plan kod içeren bir etkinlik tasarımcısının XAML sayfasının kısmi sınıfını adlandırır.

Silverlight kullanım notları

x:Class Silverlight için ayrı olarak belgelenmiştir. Daha fazla bilgi için bkz. xaml ad alanı (x:) Dil özellikleri (Silverlight).

Ayrıca bkz.