StaticResource Biçimlendirme Uzantısı

  • Makale

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

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 Tanım
key İstenen kaynağın anahtarı. Bu anahtar başlangıçta bir kaynak işaretlemede oluşturulduysa x:Key Yönergesi tarafından atandı veya kaynak kodda oluşturulduysa çağrılırken ResourceDictionary.Add parametre olarak key sağlandı.

Açıklamalar

Önemli

A StaticResource , XAML dosyası içinde sözcük temelli olarak daha fazla tanımlanmış bir kaynağa ileriye doğru başvuruda bulunmamalıdır. Bunu yapmaya çalışmak desteklenmez ve böyle bir başvuru başarısız olmasa bile, bir'i temsil eden ResourceDictionary 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. İleriye doğru başvurudan kaçınamıyorsanız bunun yerine DynamicResource İşaretleme Uzantısı'nı 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 Dilbilgisinde tanımlanan herhangi bir dize olabilir. Kaynak anahtarı, gibi Typediğ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 Yazmaya Genel Bakış.

Kaynağa başvurmanın alternatif bildirim temelli araçları, DynamicResource İşaretleme Uzantısıdır.

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

StaticResource nesne öğesi söz diziminde kullanılabilir. Bu durumda, özelliğin ResourceKey değerinin belirtilmesi gerekir.

StaticResource özelliği bir property=value çifti olarak belirten ResourceKey ayrıntılı bir öznitelik kullanımında da kullanılabilir:

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

Ayrıntılı kullanım, genellikle birden fazla ayarlanabilir özelliğe sahip uzantılar için veya bazı özellikler isteğe bağlıysa yararlıdır. Gerekli olan tek bir ayarlanabilir özelliği olduğundan StaticResource , bu ayrıntılı kullanım tipik değildir.

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

StaticResource bir işaretleme uzantısıdır. Biçimlendirme uzantıları, genellikle öznitelik değerlerinin değişmez değerler veya işleyici isimleri dışına çıkma gereksinimi olduğunda ve bu gereksinim, belirli türler veya özellikler üzerine tür dönüştürücülerini koymaktan daha genel olduğunda uygulanı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 bkz.