جدول المحتويات:
التعريف - ماذا تعني السمات الاتجاهية؟
سمات الاتجاه ، في C # ، هي علامات تُستخدم لتحديد معلمات طريقة الكائن مع معلومات تتعلق بتدفق اتجاه البيانات بين المتصل والمرح.
تتحكم سمات الاتجاه في تنظيم - حيث يتم تحضير كائن للنقل عبر حدود تطبيق أو عملية - لقيم اتجاه المعلمة وإرجاعها. يتم تطبيق السمات الاتجاهية لتعديل تنظيم وقت التشغيل أثناء الاتصال بالكود المدار ، والذي يتم تنفيذه بواسطة وقت تشغيل اللغة العامة (CLR) ، والتعليمات البرمجية غير المُدارة ، والتي يتم تنفيذها خارج سيطرة CLR.
تشرح Techopedia السمات الاتجاهية
InAttribute و OutAttribute هما السمتان C # directional المستخدمة في التعيين إلى سمات لغة تعريف واجهة (COM) طراز كائن المكون (COM). يخطط InAttribute إلى ، ويخطط OutAttribute إلى. إرجاع قيمة توقيع الأسلوب المُدار إلى مكتبة الأنواع. من الضروري تحديد سمة الاتجاه الصحيحة لمعلمات الطريقة ، بحيث تقوم مكتبة الأنواع المصدرة بتعيين بتات الدخول / الخروج بشكل صحيح.
من خلال تطبيق InAttribute و OutAttribute في المصفوفات والأنواع غير القابلة للتلف المنسقة (التي لا تحتوي على تمثيل شائع للذاكرة تتم إدارته وغير مُدارة) ، يشاهد المتصل تغييرات باهظة. تعمل السمات الاتجاهية المطبقة على هذه الأنواع على تقليل النسخ غير الضرورية أثناء التنظيم.
في C # ، تُستخدم InAttribute و OutAttribute في ثلاثة أشكال مع كلمتين أساسيتين أثناء الاتصال المتصل والمرن ، كما يلي:
- "خارج" - يعني
- "المرجع" - يعني ،
- (بلا تحديد) - (افتراضيا)
يتم استخدام الكلمات الأساسية الخارجة والمرجع لأنواع القيم وأنواع المراجع القابلة للتسلسل. تشير الكلمة الأساسية ref إلى أن المعلمة يتم تنظيمها في كلا الاتجاهين ، كما أن الخروج يشير إلى نقل البيانات بشكل كبير. عندما لا يتم استخدام المرجع أو الخروج ، فهذا يعني أن البيانات يتم نقلها إلى المستكشف.
على سبيل المثال ، يرسل تطبيق عميل .NET قيمة إدخال إلى طريقة مكون COM ، والتي تقوم بحساب نتيجة قيمة الإدخال وإرجاع النتيجة إلى العميل. يمكن تطبيق سمات الاتجاه على معلمات الطريقة التي تخدم الطلب من خلال الإشارة إلى نوع التنظيم المطلوب لقيمة الإدخال والنتيجة.
سمات الاتجاه لها الخصائص التالية:
- اختياري وتطبيقه على معلمات الطريقة في وقت التصميم
- المدعومة ل COM interop واستدعاء منصة فقط
- لا يمكن تطبيق InAttribute على معلمة بكلمة رئيسية خارجية
يوفر منظم CLR interop خدمة التنظيم في وقت التشغيل من خلال معالجة وسائط استدعاء الأسلوب وقيم الإرجاع بين الذاكرة المدارة والذاكرة غير المُدارة. إذا لم يتم تحديد سمات الاتجاه ، يحدد المنظم تدفق الاتجاه بناءً على نوع المعلمة والمعدل (إن وجد). يعمل المنظم على النحو التالي:
- لا يقوم بالكتابة فوق البيانات التي تم تمريرها كمعلمة "في" من التعليمات البرمجية غير المُدارة. وبالتالي ، قد يتم تمرير البيانات للقراءة فقط ، مثل البيانات التي يتم الوصول إليها بشكل متزامن.
- أثناء تمرير الكائنات - مثل السلاسل الأساسية أو الثنائية (BSTR) - مع تخصيص ذاكرة ثابت ، يتم اتباع تسلسل التخصيص / إلغاء التخصيص المناسب وفقًا لإعدادات In / Out.
