Aracılığıyla paylaş

StaticResource İşaretleme Uzantısı

Önceden tanımlanmış bir kaynağa başvuru arayarak herhangi bir XAML özellik özniteliği için bir değer sağlar. Yükleme zamanı aramasına benzer şekilde, bu kaynak için arama davranışı, geçerli XAML sayfasının ve diğer uygulama kaynaklarının işaretlemesinden daha önce yüklenmiş kaynakları arar ve çalışma zamanı nesnelerinde bu kaynak değerini bir özellik değeri olarak oluşturur.

XAML Öznitelik Kullanımı

<object property="{StaticResource key}" ... />

XAML Nesne Öğesi Kullanımı

<object>
  <object.property>
<StaticResource ResourceKey="key" ... />
  </object.property>
</object>

XAML Değerleri

Değer Açıklama
key İstenen kaynağın anahtarı. Bu anahtar, bir kaynak işaretlemede oluşturulmuşsa x:Key Yönergesi tarafından, kaynak kodda oluşturulmuşsa key çağrılırken ResourceDictionary.Add parametresi olarak atandı.

Açıklamalar

Önemli

bir StaticResource, XAML dosyası içinde sözcük temelli olarak daha ayrıntılı olarak tanımlanan bir kaynağa ileriye doğru başvuruda bulunmaya çalışmamalıdır. Bunu yapmaya çalışmak desteklenmez ve böyle bir başvuru başarısız olmasa bile, ResourceDictionary temsil eden iç karma tablolarda arama yapıldığında ileriye doğru başvurunun denenmesi yük süresi performans cezasına neden olur. En iyi sonuçlar için kaynak sözlüklerinizin bileşimini, ileriye doğru başvurulardan kaçınılacak şekilde ayarlayın. Eğer ileriye dönük bir referanstan kaçınamıyorsanız, bunun yerine DynamicResource Biçimlendirme Uzantısı kullanın.

Belirtilen ResourceKey, sayfanızda, uygulamanızda, kullanılabilir denetim temalarında ve dış kaynaklarda veya sistem kaynaklarında bir düzeyde x:Key Yönergesi ile tanımlanan mevcut bir kaynağa karşılık gelir. Kaynak araması bu sırada gerçekleşir. Statik ve dinamik kaynaklar için kaynak arama davranışı hakkında daha fazla bilgi için bkz. XAML Kaynakları.

Kaynak anahtarı, XamlName Grammariçinde tanımlanan herhangi bir dize olabilir. Kaynak anahtarı, Typegibi diğer nesne türleri de olabilir. Type anahtarı, örtük bir stil anahtarı aracılığıyla denetimlerin temalara göre nasıl stillendirilebileceğinin temelidir. Daha fazla bilgi için bkz. Denetim Oluşturmaya Genel Bakış.

Kaynağa başvurmanın alternatif bildirimsel yolu, DynamicResource Biçimlendirme Uzantısışeklindedir.

Öznitelik söz dizimi, bu işaretleme uzantısıyla kullanılan en yaygın söz dizimidir. StaticResource tanımlayıcı dizesinden sonra sağlanan dize belirteci, temel alınan ResourceKey uzantı sınıfının StaticResourceExtension değeri olarak atanır.

StaticResource nesne öğesi söz diziminde kullanılabilir. Bu durumda, ResourceKey özelliğinin değerini belirtmek gerekir.

StaticResource, ResourceKey özelliğini özellik=değer çifti olarak belirten ayrıntılı bir nitelik kullanımında da kullanılabilir.

<object property="{StaticResource ResourceKey=key}" ... />

Ayrıntılı kullanım, birden fazla ayarlanabilir özelliğe sahip uzantılarda veya bazı özellikler opsiyonel olduğunda genellikle yararlıdır. StaticResource'nin yalnızca bir zorunlu ayarlanabilir özelliği olduğundan, bu ayrıntılı kullanım tipik değildir.

WPF XAML işlemci uygulamasında, bu işaretleme uzantısının işlenmesi StaticResourceExtension sınıfı tarafından tanımlanır.

StaticResource bir işaretleme uzantısıdır. İşaretleme uzantıları, genellikle öznitelik değerlerinin sabit değerler ya da işleyici isimlerinden farklı olması gerektiğinde uygulanır ve bu gereksinim, belirli türlere veya özelliklere tür dönüştürücü yerleştirmekten daha geniş kapsamlıdır. XAML'deki tüm işaretleme uzantıları öznitelik söz diziminde { ve } karakterlerini kullanır. Bu, bir XAML işlemcisinin işaretleme uzantısının özniteliği işlemesi gerektiğini tanıdığı kuraldır. Daha fazla bilgi için bkz. biçimlendirme uzantıları ve WPF XAML.

Ayrıca bakınız

  • Last updated on