x:Class Yönergesi

  • Makale

XAML işaretleme derlemesini, işaretleme ve arka planda kod arasında kısmi sınıfları birleştirmek için yapılandırılır. Kod kısmi sınıfı Ortak Dil Belirtimi (CLS) dilinde ayrı bir kod dosyasında tanımlanırken, işaretleme 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

Değer Tanım
namespace isteğe bağlı. tarafından classnametanımlanan kısmi sınıfı içeren bir CLR ad alanını belirtir. Belirtilirsenamespace, nokta (.) ve classnameöğesini ayırırnamespace. Bkz. Açıklamalar.
classname Gerekli. Yüklenen XAML'yi ve bu XAML için arka planınızı 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 öğeye sahip herhangi bir nesnede geçersizdir. Daha fazla bilgi için bkz . [MS-XAML] Bölüm 6.3.1.6.

Açıklamalar

Değer, namespace ilgili ad alanlarını .NET programlamada yaygın bir teknik olan ad hiyerarşileri halinde düzenlemek için ek noktalar içerebilir. Yalnızca bir değer dizesindeki x:Class son nokta ayrılacak namespace şekilde yorumlanır ve classname. olarak x:Class kullanılan sınıf iç içe geçmiş sınıf olamaz. İç içe sınıflara izin verilirse dizeler için x:Class noktaların anlamını belirlemek belirsiz olduğundan iç içe sınıflara izin verilmez.

kullanan x:Classx:Class mevcut programlama modellerinde, arka planda kod içermeyen bir XAML sayfasının olması tamamen geçerli olması nedeniyle isteğe bağlıdır. Ancak bu özellik, XAML kullanan çerçeveler tarafından uygulanan derleme eylemleriyle etkileşim kurar. x:Class özelliği, XAML tarafından belirtilen içeriğin çeşitli sınıflandırmalarının bir uygulama modelinde ve ilgili derleme eylemlerinde sahip olduğu rollerden de etkilenir. XAML'niz olay işleme öznitelik değerlerini bildirirse veya tanımlama sınıflarının arka planda olduğu özel öğelerin örneğini oluşturursa, arka planda kod için uygun sınıfa yönerge başvurusu (veya x:Subclass) sağlamanız x:Class gerekir.

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

Bir sayfa veya uygulama tanımı için arka planda kod dosyası, derlenmiş bir uygulama oluşturan ve işaretleme derlemesi içeren projenin bir parçası olarak dahil edilen bir kod dosyası içinde olmalıdır. CLR sınıfları için ad kurallarına uymalısınız. Daha fazla bilgi için bkz . Çerçeve Tasarım Yönergeleri. Varsayılan olarak arka planda kod sınıfı olmalıdırpublic; ancak x:ClassModifier Yönergesi'ni kullanarak bunu farklı bir erişim düzeyinde tanımlayabilirsiniz.

Özniteliğin x:Class bu yorumu yalnızca CLR tabanlı bir XAML uygulaması için, özellikle de .NET XAML Hizmetleri 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 desteklemek için farklı bir çözüm formülü kullanabilir. daha genel yorumları x:Classhakkında daha fazla bilgi için bkz . [MS-XAML].

Belirli bir mimari düzeyinde anlamı x:Class .NET XAML Hizmetleri'nde tanımlanmamıştır. Bunun nedeni, .NET XAML Hizmetleri'nin XAML işaretleme ve yedekleme kodunun bağlı olduğu programlama modelini belirtmemesidir. Yönergenin x:Class ek kullanımları, XAML işaretlemesi ve CLR tabanlı arka planda kod bağlamayı tanımlamak için programlama modellerini veya uygulama modellerini kullanan belirli çerçeveler tarafından uygulanabilir. Her çerçeve, bazı davranışları veya derleme ortamına eklenmesi gereken belirli bileşenleri etkinleştiren kendi derleme eylemlerine sahip olabilir. Bir çerçeve içinde, derleme eylemleri arka planda kod için kullanılan belirli CLR diline bağlı olarak da farklılık gösterebilir.

WPF Programlama Modelinde x:Sınıfı

WPF uygulamalarında ve WPF uygulama modelinde, x:Class bir XAML dosyasının kökü olan ve derlenen herhangi bir öğe için (derleme eylemiyle Page bir WPF uygulama projesine XAML dahil edilir) veya derlenmiş WPF uygulamasının uygulama tanımındaki kök için Application öznitelik olarak bildirilebilir. x:Class Sayfa kökü veya uygulama kökü dışındaki bir öğede veya derlenmemiş bir WPF XAML dosyasında bildirimde bulunarak .NET Framework 3.0 ve .NET Framework 3.5 WPF XAML derleyicisi altında derleme zamanı hatasına neden olur. WPF'de işlemenin x:Class diğer yönleri hakkında bilgi için bkz . WPF'de Arka Planda Kod ve XAML.

Windows Workflow Foundation için x:Class

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

Silverlight Kullanım Notları

x:Class için Silverlight ayrı olarak belgelenmiştir. Daha fazla bilgi için bkz . XAML Ad Alanı (x:) Dil Özellikleri (Silverlight).

Ayrıca bkz.