ملحق علامات ComponentResourceKey
يعرّف و يحدد مراجع مفاتيح للموارد التي تم تحميلها من التجميعات الخارجية. بما يمكن من بحث مورد إلى تعيين نوع هدف في تجميع، بدلاً من قاموس مورد صريح في تجميع أو فئة.
XAML استخدام السمة (إعداد المفتاح, مضغوط)
<object x:Key="{ComponentResourceKey {x:Type targetTypeName}, targetID}" .../>
XAML استخدام السمة (إعداد المفتاح ، مطوّل)
<object x:Key="{ComponentResourceKey TypeInTargetAssembly={x:Type targetTypeName}, ResourceID=targetID}" .../>
XAML استخدام السمة (طلب مورد, مضغوط)
<object property="{DynamicResource {ComponentResourceKey {x:Type targetTypeName}, targetID}}" .../>
XAML استخدام السمة (طلب مورد, مطوّل)
<object property="{DynamicResource {ComponentResourceKey TypeInTargetAssembly={x:Type targetTypeName}, ResourceID=targetID}}" .../>
قيم XAML
targetTypeName |
اسم العام وقت تشغيل اللغة العامة (CLR) النوع الذي يتم تعريفه في تجميع المورد. |
targetID |
مفتاح المورد. عند البحث عن موارد targetID سيكون مشابه س: مفتاح سمة من المورد. |
ملاحظات
كما هو موضح في الاستخدامات المذكورة أعلاه، { ComponentResourceKey} استخدام ملحق ترميز هو في مكانين:
تعريف مفتاح في قاموس مورد سمة كـ الموفرة من قبل كاتب عنصر تحكم.
الوصول إلى مورد سمة من تجميع، عندما تكون retemplating عنصر تحكم ولكنك تريد استخدام قيم خاصية التي تأتي من موارد المتوفرة من قبل السمات عنصر تحكم's.
للرجوع إلى موارد مكوّن الذي يأتي من السمات، هو عموما المستحسن استخدام {DynamicResource}بدلاً من {StaticResource}. Th هو هو من الاستخدامات. {DynamicResource}هو مستحسن لأنه يمكن تم تغييره السمة نفسها من قبل مستخدم. إذا كنت تريد مورد مكوّن الذي يتوافق مع هدف المؤلف عنصر التحكم لدعم سمة، يجب عليك تمكين مرجع مورد مكوّن الخاص بك إلى أن ديناميكي أيضا.
TypeInTargetAssembly يعرّف النوع الموجود في تجميع الهدف حيث يتم تعريف المورد بالفعل. ComponentResourceKey يمكن تعريفه و استخدامه بشكل مستقل عن معرفة تماماً أين TypeInTargetAssembly تم تعريفه ولكن يجب أن يحل النوع من خلال التجميعات المشار إليها.
استخدام شائع ComponentResourceKey هي تعريف مفاتيح التي ثم تعرض كأعضاء من فئة. لهذا الاستخدام, يمكنك استخدام ComponentResourceKey الدالة الإنشائية لفئة، ليس ملحق العلامات. للحصول على مزيد من المعلومات، راجع ComponentResourceKey، أو "تعريف و الرجوع إلى مفاتيح لسمة" مقطع موارد الموضوع نظرة عامة على تأليف التحكم.
لكل من مفاتيح establهوhing والرجوع إلى المفتاحية الموارد، السمة بناء جملة هو استخداماً ل ComponentResourceKeyملحق ترميز.
يعتمد مضغوط بناء الجملة المبين تشغيل ComponentResourceKey.ComponentResourceKeyتوقيع الدالة الإنشائية و الموضعية معلمة من استخدام ملحق ترميز. الترتيب targetTypeNameو targetIDالمعطاة هو الهامة. بناء الجملة المطوّل يعتمد على ComponentResourceKey.ComponentResourceKey الدالة الإنشائية الافتراضية, ثم يقوم بتعيين TypeInTargetAssembly و ResourceId بطريقة تماثل بناء جملة سمة صحيحة على عنصر الكائن. في بناء جملة المطول، والترتيب الذي يتم تعيين الخصائص هو غير هامة. يتم وصف العلاقة و تقنيات هذه البدائل الإثنين (مضغوط و مطوّل) بمزيد من التفاصيل في الموضوع ملحقات ترميز و XAML WPF.
الالقيمة تقنيا، targetIDيمكن أن تكون أي كائن، لم يكن إلى أن سلسلة. ومع ذلك، الاستخدام الأكثر شيوعاً في WPF هو لمحاذاة targetIDالقيمة باستخدام نماذج سلاسل بحيث تكون صالحة في هذه السلاسل تدقيق نحوي XamlName.
ComponentResourceKey يمكن استخدامه في بناء جملة عنصر الكائن. في هذه الحالة، تحديد قيمة كلا TypeInTargetAssembly و ResourceId خصائص مطلوبة لتهيئة الملحق بشكل صحيح.
في تطبيق القارئ WPF XAML , معالجة ملحق العلامات مُعرّف بواسطة فئة ComponentResourceKey.
ComponentResourceKey هو علامات الملحق. يتم عادةً تطبيق ملحقات العلامات عند وجود متطلبات للهروب صواب القيم أن تكون غير قيم حرفية أو أسماء معالج أو المتطلبات أكثر عمومية من وضع محولات نوع فقط على بعض أنواع أو خصائص. كافة علامات الملحقات في XAML استخدام حرف{و} في سمة بناء الجملة, وهو الاصطلاح الخاص بهم XAML المعالج يتعرف على علامات الملحق الذي يجب معالجة السمة. لمزيد من المعلومات، راجع ملحقات ترميز و XAML WPF.