ملحق علامات DynamicResource

مقالة
11/01/2010

يوفر قيمة لأي سمة خاصية XAML بواسطة تأجيل تلك القيمة عن أن نكون مرجعاً إلى مورد معرّف. يماثل سلوك البحث عن ذلك المورد بحث وقت التشغيل.

استخدام سمة XAML

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

استخدام عنصر خاصية XAML

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

قيم XAML

key	المفتاح للموارد المطلوبة. هذا المفتاح تم تعيينه أولاً بواسطة س: مفتاح سمة إذا كان مورد قد تم إنشاؤه في العلامات أو يتم توفيره كمعلمة key عند استدعاء ResourceDictionary.Add إذا تم إنشاء المورد في التعليمات البرمجية.

ملاحظات

DynamicResource سيقوم بإنشاء تعبير مؤقت أثناء التحويل البرمجي الأول و تأجيل البحث عن الموارد بالتالي حتى يتم الطلب الفعلي لقيمة المورد المطلوبة لبناء الكائن. قد يكون هذا بعد تحميل صفحة XAML . قيمة المورد سوف يتم العثور عليها استناداً إلى مفتاح البحث ضد كافة قواميس المورد النشطة ابتداءاً من نطاق الصفحة الحالية و يتم استبدالها بتعبير النائب من التحويل البرمجي .

هام
من حيث أولوية خاصية التبعية ، تعبير DynamicResource مكافئ إلى الموضع حيث يتم تطبيق مرجع المورد الحيوي.إذا قمت بالتعيين المحلي لقيمة الخاصية التي لديها مسبقاً تعبير DynamicResource كقيمة محلية ، تتم إزالة DynamicResource بشكل كامل.للمزيد من التفاصيل ، راجع أسبقية قيمة خاصية التبعية.

من حيث أولوية خاصية التبعية ، تعبير DynamicResource مكافئ إلى الموضع حيث يتم تطبيق مرجع المورد الحيوي.إذا قمت بالتعيين المحلي لقيمة الخاصية التي لديها مسبقاً تعبير DynamicResource كقيمة محلية ، تتم إزالة DynamicResource بشكل كامل.للمزيد من التفاصيل ، راجع أسبقية قيمة خاصية التبعية.

بعض وحدات سيناريو الوصول إلى الموارد معينة بشكل خاص يناسب DynamicResource كما تقابل ملحق علامات StaticResource. راجع نظرة عامة حول الموارد للحصول على مناقشة حول merits نسبية و ضمانات الأداء لــ DynamicResource و StaticResource.

ResourceKey المحدد يجب أن يُطابق المورد الموجود بواسطة س: مفتاح سمة على مستوى معين في الصفحة الخاصة بك ، سمات عنصر التحكم المتوفرة و الموارد الخارجية و موارد النظام و البحث في المورد سيحدث في هذا الترتيب. لمزيد من المعلومات حول البحث في المورد بالنسبة للموارد الثابتة والحيوية ، راجع نظرة عامة حول الموارد.

مفتاح المورد قد يكون أي من السلسلة المعرفة في تدقيق نحوي XamlName. مفتاح المورد يمكنه أيضاً أن يكون أنواع كائنات أخرى مثل Type. مفتاح Type هو أساسي لكيفية تنميط عناصر التحكم بواسطة السمات. لمزيد من المعلومات، راجع نظرة عامة على تأليف التحكم.

واجهات API للبحث عن قيم المورد مثلFindResource اتبع نفس منطق البحث في المورد كما يستخدم من قبلDynamicResource.

وسيلة التعريف البديلة من الرجوع إلى مورد هي ملحق علامات StaticResource.

بناء جملة السمة هو بناء الجملة الأكثر شيوعاً المستخدم مع ملحق العلامات. رمز السلسلة الذي تم توفيره بعد DynamicResource تعيين سلسلة معرّف كأحد ResourceKey القيمة الأساسية DynamicResourceExtensionملحق فئة.

DynamicResource يمكن استخدامه في بناء جملة عنصر الكائن. في هذه الحالة، تحديد قيمة ResourceKey خاصية مطلوبة.

DynamicResource يمكن استخدامها أيضاً في سمة مطوّل الاستخدام التي تحددResourceKey الخاصية كخاصية = قيمة ازدواجًا:

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

استخدام مطوّل مفيد غالباً من أجل الملحقات التي تحتوي على أكثر من خاصية واحدة قابلة للتعيين ، أو إذا كانت بعض الخصائص اختيارية. لأن DynamicResource يملك خاصية واحدة فقط قابلة للتعيين ، وهو مطلوب, هذا الاستخدام الغير معتاد للمطوّل.

فيWPF XAML تطبيق المعالج, معالجة ملحق العلامات هذا معرف بواسطة DynamicResourceExtension فئة.

DynamicResource هو علامات الملحق. يتم عادةً تطبيق ملحقات العلامات عند وجود متطلبات للهروب صواب القيم أن تكون غير قيم حرفية أو أسماء معالج أو المتطلبات أكثر عمومية من وضع محولات نوع فقط على بعض أنواع أو خصائص. كافة علامات الملحقات في XAML استخدام حرف{و} في سمة بناء الجملة, وهو الاصطلاح الخاص بهم XAML المعالج يتعرف على علامات الملحق الذي يجب معالجة السمة. لمزيد من المعلومات، راجع ملحقات ترميز و XAML WPF.