مراجع المشروع

مقالة
11/01/2010

لكتابة تعليمات برمجية مقابل مكون خارجي, يجب أولاً أن يحتوي المشروع على مرجع لهذا المكوّن. يمكنك إنشاء مرجع إلى أنواع المكونات التالية:

فئة .NET Framework مكتبات أو التجميعات
COM [مكونات]
التجميعات الأخرى وفئة المكتبات للمشاريع في نفس الحل
خدمات ويب لـ XML

للحصول على أكثر المعلومات حول المراجع الخدمة ويب XML ، راجع مراجع ويب في Visual Studio.

إضافة مراجع في وقت التصميم

استخدم مربع حوار "إضافة المرجع" إلى إضافة مراجع إلى مكونات وقت التصميم.

يمكنك استخدام مربع حوار إضافة مرجع لاستعراض التجميعات غير موجود. لا يمكنك إضافة مراجع من العمومية التجميع ذاكرة تخزين مؤقت (GAC) ، كما التام جزءًا من بيئة وقت التشغيل ".

عند إنشاء مرجع إلى تجميع في المشروع، Visual Studioيبحث عن التجميع في المواقع التالية:

دليل المشروع الحالي. (يمكنك العثور على هذه التجميعات باستخدام استعراض علامة تبويب.)
الدلائل للمشاريع الأخرى في نفس الحل. (يمكنك البحث عن هذه التجميعات في مشاريععلامة تبويب.)

للحصول على معلومات أكثر حول كيفية إضافة مرجع في وقت التصميم، راجع كيفية القيام بما يلي: إضافة أو إزالة المراجع في ‏‫Visual Studio.

ملاحظة

كل المشاريع تحتوي على مرجع ضمنية إلى mscorlib. مشاريع Visual Basic يحتوي على مرجع ضمنية إلى Microsoft.VisualBasic.

كل المشاريع في 2010 ‏‫Visual Studio ، تحتوي مرجع ضمنية إلى System.Core، حتى لو System.Coreإزالتها من قائمة مراجع.

مراجع إلى مكونات المشتركة في وقت التشغيل

وقت التشغيل المكونات يجب إما في طريق المخرجات المشروع أو في ذاكرة التخزين المؤقتة للتجميع العمومي(GAC). إذا كان المشروع يحتوي على مرجع إلى كائن غير موجود في أحد هذه المواقع، إذاً عندما يتم إنشاء المشروع, يجب نسخ المرجع إلى مسار إخراج المشروع. تشير خاصية CopyLocal إلى ما إذا كانت هذه النسخة يجب صنعها. إذا كانت القيمة صواب "، يتم نسخ المرجع إلى المشروع الدليل بنية المشروع. إذا كانت القيمة خطأ لم يتم نسخ المرجع.

إذا قمت بنشر أو نسخ تطبيق الذي يحتوي على مرجع إلى مكون مخصص مسجلة في GAC مكوّن لن يتم نشر أو نسخ مع التطبيق بغض النظر Copy Localالإعداد. في الإصدارات السابقة من Visual Studio, يمكنك تعيين CopyLocalالخاصية على مرجع إلى التأكد من أنه قد تم نشر التجميع. والآن، يجب إضافة التجميع يدوياً إلى المجلد \Bin. هذا يضع كل التعليمات البرمجية المخصصة ضمن scrutiny، تقليل مخاطر النشر تعليمات برمجية مخصصة مع والتي لم تكن على دراية.

بواسطة الافتراضي, الـ CopyLocalتعيين الخاصية إلى خطأ إذا تجميع أو مكون موجود في ذاكرة تخزين "مؤقتة للتجميع العمومي" أو هو أحد مكونات Framework. وإلا، يتم تعيين القيمة إلى صواب. يتم تعيين مشروع إلى مشروع مراجع دوماً إلى صواب.

الرجوع إلى مشروع أو التجميع التي تستهدف مختلفة الإصدار من برنامج .NET Framework

يمكنك إنشاء التطبيقات التي تشير إلى المشاريع أو التجميعات استهداف إصدار مختلف من برنامج .NET Framework. على سبيل المثال، يمكنك إنشاء أحد تطبيقات التي تستهدف .NET Framework 4 Client Profileالتي مراجع تجميع التي تستهدف NET Framework. الإصدار 2.0. إذا قمت بإنشاء مشروع تستهدف إصدار سابق من .NET Framework, لا يمكنك تعيين مرجع في ذلك المشروع إلى المشروع أو التجميع بهذا الأهداف .NET Framework 4 Client Profileأو .NET Framework الإصدار 4.

لمزيد من المعلومات، راجع استهداف محدد لـ.NET Framework الإصدار أو ملف تعريف.

مراجع مشروع-إلى-مشروع ومراجع ملف

تكون المراجع ملف مباشر مراجع التجميعات; إنشائها باستخدام استعراض التبويب من مربع حوار إضافة مرجع. تكون المراجع مشروع إلى مشروع مراجع إلى المشاريع التي تتضمن التجميعات; إنشاءها باستخدام علامة تبويب Project في مربع حوار إضافة مرجع.

ميزة مرجع مشروع إلى مشروع أن يقوم ببنية تبعية بين المشاريع في النظام البنية. لذلك، سوف يكون بناء المشروع التابعة إذا تغير منذ آخر مرة تم إنشاء مشروع المرجعي. لا يقوم مرجع ملف بإنشاء تبعية بناء لذا فمن الممكن إلى إنشاء مشروع المرجعي بدون إنشاء مشروع تابع ومن أن يصبح المرجع قديمة. (أي ، المشروع الرجوع مسبقًا المضمنة الإصدار المشروع.) يمكن أن يؤدي هذا إلى عدة إصدارات من DLL مفرد طلب في دليل bin غير ممكنة. عندما يحدث هذا التعارض سترى رسالة مثل تحذير: يتعذر نسخ تبعية 'ملف' في مشروع 'المشروع' إلى دليل التشغيل بسبب الكتابة فوق المرجع 'ملف'..

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

ملاحظة

في 2010 ‏‫Visual Studio, يتم إنشاء مرجع ملف بدلاً من مرجع مشروع إذا كان إصدار .NET Framework مشروع واحد الهدف هو الإصدار 4 و الإصدار الهدف من المشروع الآخر هو الإصدار 2 أو 3 أو 3.5.