x:Uid Yönergesi

  • Makale

İşaretlemeyi öğeleri için benzersiz bir tanımlayıcı sağlar. Birçok senaryoda, bu benzersiz tanımlayıcı XAML yerelleştirme işlemleri ve araçları tarafından kullanılır.

XAML Öznitelik Kullanımı

<object x:Uid="identifier"... />

XAML Değerleri

Değer Tanım
identifier Bir tüketici tarafından yorumlandığında dosyada benzersiz olması gereken, el ile oluşturulmuş veya otomatik olarak oluşturulmuş bir x:Uid dize.

Açıklamalar

[MS-XAML] x:Uid içinde bir yönerge olarak tanımlanır. Daha fazla bilgi için bkz . [MS-XAML] Bölüm 7.3.6.

x:Uidx:Name, hem belirtilen XAML yerelleştirme senaryosu nedeniyle hem de yerelleştirme için kullanılan tanımlayıcıların programlama modeli etkileri x:Nameüzerinde bağımlılıkları olmaması için ayrıdır. Ayrıca, x:Name XAML ad kapsamı tarafından yönetilir; ancak, x:Uid XAML dili tanımlı benzersizlik zorlama kavramı tarafından yönetilmiyor. Geniş anlamda XAML işlemcilerinin (yerelleştirme işleminin parçası olmayan işlemciler) değerlerin benzersizliğini zorlaması x:Uid beklenmemektedir. Bu sorumluluk kavramsal olarak değerlerin kaynağındadır. Tek bir XAML kaynağındaki değerlerin x:Uid benzersizliği beklentisi, ayrılmış genelleştirme işlemleri veya araçları gibi değerlerin tüketicileri için makuldür. Tipik benzersizlik modeli, değerlerin x:Uid XAML'yi temsil eden XML kodlu bir dosya içinde benzersiz olmasıdır.

Belirli bir XAML şeması hakkında önemli bilgi sahibi olan araçlar, işaretlemede bir metin dizesi değeriyle karşılaşıldığı tüm durumlar yerine yalnızca gerçek yerelleştirilebilir dizeler için uygulamayı x:Uid seçebilir.

Çerçeveler, özniteliğini UidPropertyAttribute tanımlama türüne uygulayarak nesne modellerinde diğer ad x:Uid olacak belirli bir özelliği belirtebilir. Çerçeve belirli bir özelliği belirtiyorsa, aynı nesnede hem hem de x:Uid diğer ad kullanılan üyeyi belirtmek geçerli değildir. Hem hem de x:Uid diğer ad kullanılan üye belirtilirse, .NET XAML Hizmetleri API'si genellikle bu durum için oluşturur XamlDuplicateMemberException .

WPF Kullanım Notları

WPF yerelleştirme işleminde ve XAML'nin BAML biçimindeki rolü x:Uid hakkında daha fazla bilgi için bkz. WPF için Genelleştirme veya Uid

Ayrıca bkz.