ملحق علامات StaticResource
يوفر قيمة لأي سمة خاصية XAML بواسطة البحث عن مرجع لمورد معرف مسبقاً. يماثل سلوك بحث ذلك المورد بحث وقت التحميل الذي يقوم بالبحث عن الموارد التي تم تحميلها مسبقاً من العلامات الخاصة بصفحة XAML الحالية بالإضافة إلى مصادر التطبيق الأخرى ثم سيقوم بإنشاء تلك القيمة للمورد كقيمة الخاصية في كائنات وقت التشغيل.
استخدام سمة XAML
<object property="{StaticResource key}" .../>
استخدام عنصر كائن XAML
<object>
<object.property>
<StaticResource ResourceKey="key" .../>
</object.property>
</object>
قيم XAML
key |
المفتاح للموارد المطلوبة. هذا المفتاح تم تعيينه أولاً بواسطة س: مفتاح سمة إذا كان مورد قد تم إنشاؤه في العلامات أو يتم توفيره كمعلمة key عند استدعاء ResourceDictionary.Add إذا تم إنشاء المورد في التعليمات البرمجية. |
ملاحظات
.gif "ملاحظة هامة") هام |
|---|
لا يجب على StaticResource المحاولة للقيام بإشارة إلى مورد تم تعريفه بشكل lexically إضافي داخل ملف XAML .محاولة القيام بذلك لا يتم دعمها و حتى إذا لم تفشل المرجعية ، محاولة الإشارة الأمامية سوف تتطلب جزاء أداء وقت تحميل عند تقديم جداول التجزئة الداخلية لــ ResourceDictionary يتم البحث فيها.للحصول على أفضل النتائج، قم بضبط تركيب قواميس المورد مثل المراجع الأمامية التي يمكن تجنبها .إذا كان يمكنك تجنب مرجع أمامي ،قم باستخدام ملحق علامات DynamicResource بدلاً من ذلك. |
ResourceKey المحدد يجب أن يتوافق مع المورد الموجود ، المعرف بــ س: مفتاح سمة عند مستوى معين في الصفحة الخاصة بك أو التطبيق, سمات عنصر التحكم المتوفرة و الموارد الخارجية أو موارد النظام. بحث المورد يحدث بهذا الترتيب. لمزيد من المعلومات حول سلوك بحث المورد بالنسبة للموارد الثابتة والحيوية ، راجع نظرة عامة حول الموارد.
مفتاح المورد قد يكون أي من السلسلة المعرفة في تدقيق نحوي XamlName. مفتاح المورد يمكنه أيضاً أن يكون أنواع كائنات أخرى مثل Type. مفتاح Type أساسي لكيفية تنميط عناصر التحكم بواسطة النسوق، خلال مفتاح النمط الضمني. لمزيد من المعلومات، راجع نظرة عامة على تأليف التحكم.
وسيلة التعريف البديلة من الرجوع إلى مورد هي ملحق علامات DynamicResource.
بناء جملة السمة هو بناء الجملة الأكثر شيوعاً المستخدم مع ملحق العلامات. رمز السلسلة الذي تم توفيره بعد StaticResource تعيين سلسلة معرّف كأحد ResourceKey القيمة الأساسية StaticResourceExtensionملحق فئة.
StaticResource يمكن استخدامه في بناء جملة عنصر الكائن. في هذه الحالة، تحديد قيمة ResourceKey خاصية مطلوبة.
StaticResource يمكن استخدامها أيضاً في سمة مطوّل الاستخدام التي تحددResourceKey الخاصية كخاصية = قيمة ازدواجًا:
<object property="{StaticResource ResourceKey=key}" .../>
استخدام مطوّل مفيد غالباً من أجل الملحقات التي تحتوي على أكثر من خاصية واحدة قابلة للتعيين ، أو إذا كانت بعض الخصائص اختيارية. لأن StaticResource يملك خاصية واحدة فقط قابلة للتعيين ، وهو مطلوب, هذا الاستخدام الغير معتاد للمطوّل.
فيWPF XAML تطبيق المعالج, معالجة ملحق العلامات هذا معرف بواسطة StaticResourceExtension فئة.
StaticResource هو علامات الملحق. يتم عادةً تطبيق ملحقات العلامات عند وجود متطلبات للهروب صواب القيم أن تكون غير قيم حرفية أو أسماء معالج أو المتطلبات أكثر عمومية من وضع محولات نوع فقط على بعض أنواع أو خصائص. كافة علامات الملحقات في XAML استخدام حرف{و} في سمة بناء الجملة, وهو الاصطلاح الخاص بهم XAML المعالج يتعرف على علامات الملحق الذي يجب معالجة السمة. لمزيد من المعلومات، راجع ملحقات ترميز و XAML WPF.