x:Uid yönergesi

İşaretleme elemanları için benzersiz bir tanımlayıcı sağlar. Evrensel Windows Platformu (UWP) XAML için bu benzersiz tanımlayıcı, .resw kaynak dosyasındaki kaynakları kullanma gibi XAML yerelleştirme işlemleri ve araçları tarafından kullanılır.

XAML öznitelik kullanımı

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

XAML değerleri

Süre	Description
stringID	Bir uygulamadaki XAML öğesini benzersiz olarak tanımlayan ve kaynak dosyasındaki kaynak yolunun bir parçası haline gelen dize. Bkz. Açıklamalar.

Açıklamalar

XAML'nizdeki bir nesne öğesini tanımlamak için x:Uid kullanın. Bu nesne öğesi genellikle bir denetim sınıfının veya kullanıcı arabiriminde görüntülenen başka bir öğenin örneğidir. x:Uid içinde kullandığınız dize ile kaynak dosyasında kullandığınız dizeler arasındaki ilişki, kaynak dosya dizelerinin x:Uid ve ardından nokta (.) ve ardından yerelleştirilmekte olan öğenin belirli bir özelliğinin adı olmasıdır. Şu örneği göz önünde bulundurun:

<Button x:Uid="GoButton" Content="Go"/>

Go görünen metninin yerini alacak içeriği belirtmek için, kaynak dosyasından gelen yeni bir kaynak belirtmeniz gerekir. Kaynak dosyanız "GoButton.Content" adlı kaynak için bir girdi içermelidir. Bu durumda içerik, Button sınıfı tarafından devralınan belirli bir özelliktir. Ayrıca, bu düğmenin diğer özellikleri için yerelleştirilmiş değerler de sağlayabilirsiniz; örneğin, "GoButton.FlowDirection" için kaynak tabanlı bir değer sağlayabilirsiniz. x:Uid ve kaynak dosyalarını birlikte kullanma hakkında daha fazla bilgi için bkz. Kullanıcı arabiriminizde ve uygulama paketi bildiriminizde dizeleri yerelleştirme.

X:Uid değeri için hangi dizelerin kullanılabileceğinin geçerliliği, dizelerin bir kaynak dosyasında ve kaynak yolunda tanımlayıcı olarak yasal olduğu pratik bir anlamda denetlenmektedir.

x:Uid , hem belirtilen XAML yerelleştirme senaryosu nedeniyle hem de yerelleştirme için kullanılan tanımlayıcıların x:Name'in programlama modeli üzerinde hiçbir bağımlılığı olmaması için x:Name'den ayrıdır. Ayrıca , x:Name XAML ad kapsamı kavramına göre yönetilirken , x:Uid için benzersizlik paket kaynak dizini (PRI) sistemi tarafından denetlenir. Daha fazla bilgi için bkz. MRT Core ve Kaynak Yönetim Sistemiile kaynakları yönetme.

Windows Runtime XAML'nin x:Uid benzersizliği için kurallar, önceki XAML kullanan teknolojilerden biraz farklıdır. Window Runtime XAML için aynı x:Uid Kimliği değerinin birden çok XAML öğesinde bir yönerge olarak mevcut olması yasaldır. Ancak, bu tür öğelerin her birinin bir kaynak dosyasındaki kaynakları çözümlerken aynı çözümleme mantığını paylaşması gerekir. Ayrıca, bir projedeki tüm XAML dosyaları x:Uid çözümlemesi amacıyla tek bir kaynak kapsamını paylaşır, tek tek XAML dosyalarına hizalanan x:Uid kapsamları kavramı yoktur.

Bazı durumlarda paket kaynak dizini (PRI) sisteminin yerleşik işlevselliği yerine bir kaynak yolu kullanırsınız. x:Uid değeri olarak kullanılan herhangi bir dize, ms-resource:///Resources/ ile başlayan ve x:Uid dizesini içeren bir kaynak yolu tanımlar. Yol, bir kaynak dosyasında belirttiğiniz veya başka bir şekilde hedeflediğiniz özelliklerin adları ile tamamlanır.

Windows Çalışma Zamanı XAML'sinde izin verilmeyen özellik öğelerine x:Uid koymayın.