تطبيق السمات Interop

The System.Runtime.InteropServices مساحة الاسم provides three فئات of interop-specific السمات: those applied بواسطة you at تصميم الوقت, those applied بواسطة توافق COM أدوات و APIs during the تحويل عملية, و those applied either بواسطة you أو توافق COM.

If you are unfamiliar مع the مهمة of applying السمات إلى مدارة تعليمات برمجية, see Extending بيانات التعريف Using السمات. مثل غير ذلك مخصص السمات, you can يطبق interop-specific السمات إلى أنواع, وظائف, خصائص, معلمات, حقول, و غير ذلك الأعضاء.

تصميم-الوقت السمات

You can adjust the outcome of the تحويل عملية performed بواسطة توافق COM أدوات و APIs بواسطة using تصميم-الوقت السمات. The following جدول describes the السمات that you can يطبق على your مدارة المصدر تعليمات برمجية. توافق COM أدوات, تشغيل occasion, might also يطبق the السمات described في this جدول.

السمة	الوصف
AutomationProxyAttribute	Specifies whether the نوع should be marshaled using the Automation marshaler أو a مخصص proxy و stub.
ClassInterfaceAttribute	عناصر التحكم the نوع of واجهة generated for a فئة.
CoClassAttribute	Identifies the CLSID of the الأصلي coclass imported من a نوع مكتبة. توافق COM أدوات typically يطبق this سمة.
ComImportAttribute	Indicates that a coclass أو واجهة تعريف was imported من a COM نوع مكتبة. The وقت التشغيل uses this يؤشر إلى know how إلى تنشيط و تنظيم وإرسال the نوع. This سمة prohibits the نوع من being exported الخلف إلى a نوع مكتبة. توافق COM أدوات typically يطبق this سمة.
ComRegisterFunctionAttribute	يشير إلى أنه يجب أن يكون استدعاء أسلوب عند تجميع هو regهوtered للاستخدام من COM، لذلك يمكن تنفيذ تلك التعليمة البرمجية المكتوبة مستخدم أثناء عملية regهوtration.
ComSourceInterfacesAttribute	قم بتعريف الواجهات التي تعتبر المصادر الأحداث فئة. توافق COM من الأدوات بيطبق هذه السمة.
ComUnregisterFunctionAttribute	يشير إلى أنه يجب أن يكون استدعاء أسلوب عند تجميع هو unregهوtered من COM، لذلك يمكن ينفذ تلك التعليمة البرمجية المكتوبة مستخدم أثناء العملية.
ComVisibleAttribute	يعرض أنواع غير مرئي إلى COM عند سمة تساوي الالقيمة false . يمكن تطبيق هذه السمة إلى على نوع فردية أو إلى تجميع بأكمله إلى التحكم في كيفية ظهور COM. افتراضياً، تكون الجميع الأنواع المدارة، عام vهوible; السمة هو غير المطلوبة لجعلها vهوible.
DispIdAttribute	تعين معرّف الإرسال COM (DISPID) من أسلوب أو حقل. وهذا سمة يحتوي على DISPID لأسلوب أو حقل أو خاصية فهو يصف. توافق COM من الأدوات بيطبق هذه السمة.
FieldOffsetAttribute	تشير إلى الموضع الفعلي لكل حقل ضمن فئة عند استخدامها مع و StructLayoutAttribute من LayoutKind هو تعيين إلى Explicit.
GuidAttribute	تعين المعرف الفريد (العمومي معرّف فريد عالمي) فئة أو واجهة أو مكتبة نوع بكامل. يجب أن تكون السلسلة التي تم تمريرها إلى السمة تنسيق التي هو وسيطة الدالة الإنشائية مقبولة ل نوع من النظام.معرّف فريد عالمي. توافق COM من الأدوات بيطبق هذه السمة.
IDispatchImpAttribute	يشير إلى أي IDispatch واجهة تطبيق يستخدم وقت تشغيل اللغة العامة عندما يتعرض لواجهات الثنائي و dispinterfaces إلى COM.
InAttribute	الإشارة إلى أن بيانات يجب أن يكون تنظيم في للطالب. يمكن استخدام إلى السمة معلمات.
InterfaceTypeAttribute	التحكم في كيفية بواجهة المدارة هو إلى عملاء COM (مزدوج، اشتقاق IUnknown, أو IDهوpatch فقط). توافق COM من الأدوات بيطبق هذه السمة.
LCIDConversionAttribute	يشير إلى أن توقيع أسلوب غير مدارة ما يتوقع معلمة معرف اللغة. توافق COM من الأدوات بيطبق هذه السمة.
MarshalAsAttribute	يشير إلى كيفية يجب أن يتم تنظيم بيانات في حقول أو معلمات بين إدارة و تعليمات برمجية مدارة. السمة هو الاختيارية دائماً بسبب كل نوع بيانات التنظيم والإرسال سلوك الافتراضي. توافق COM من الأدوات بيطبق هذه السمة.
OptionalAttribute	يشير إلى أن معلمة هو اختيارية. توافق COM من الأدوات بيطبق هذه السمة.
OutAttribute	يشير إلى أنه يجب أن يمكن تنظيم بيانات في حقل أو معلمة من كائن يسمى الخلف للمتصل به.
PreserveSigAttribute	يمنع تحويل توقيع HRESULT أو retval أن عادة يأخذ وضع أثناء المكالمات interoperation. تؤثر السمة التنظيم والإرسال أيضا باسم نوع تصدير مكتبة. توافق COM من الأدوات بيطبق هذه السمة.
ProgIdAttribute	تعين معرف فئة إطار عمل.NET. يمكن استخدام إلى سمة الفئات.
StructLayoutAttribute	يتحكم تخطيط حقول من فئة الفعلية. توافق COM من الأدوات بيطبق هذه السمة.

السمات أداة تحويل

يصف الجدول التالي السمات يطبق COM أدوات إمكانية التشغيل المتداخل أثناء عملية تحويل. لا يتم يطبق هذه السمات في تصميم الوقت.

السمة	الوصف
ComAliasNameAttribute	يشير إلى اسم مستعار COM للمعلمة أو الحقل نوع. يمكن استخدام إلى السمة المعلمات، والحقول، أو قيم إرجاع.
ComConversionLossAttribute	الإشارة إلى أنه تم فقدان معلومات حول فئة أو واجهة حيث تم استيراده من مكتبة نوع تجميع.
ComEventInterfaceAttribute	تعريف واجهة مصدر و فئة الذي يقوم بتنفيذ وظائف واجهة حدث.
ImportedFromTypeLibAttribute	الإشارة إلى أنه تم استيراد تجميع الأصل من مكتبة نوع COM. يحتوي على هذه السمة نوع تعريف المكتبة الأصلية نوع المكتبة.
TypeLibFuncAttribute	يحتوي على FUNCFLAGS التي تم استيرادها في الأصل لهذه دالة من COM نوع المكتبة.
TypeLibTypeAttribute	يحتوي على نوع FLAGS التي تم استيرادها أصلاً لهذا نوع من COM نوع المكتبة.
TypeLibVarAttribute	يحتوي على VARFLAGS التي تم استيرادها أصلاً لهذا المتغير من مكتبة النوع COM.

راجع أيضًا:

المرجع

System.Runtime.InteropServices

المبادئ

يتعرض لبرنامج.NET Framework مكونات إلى COM

لتوسيع بيانات التعريف باستخدام السمات

تعريف أنواع.NET ل Interoperation

حزم تجميع ل COM