مشاركة عبر

تصحيح الأخطاء ملحقات لأدوات SharePoint في ‏‫Visual Studio

  • مقالة

يمكنك ملحقات أدوات يصحح SharePoint في مثيل تجريبية أو مثيل عادي من ‏‫Visual Studio. If you need إلى troubleshoot the سلوك of an ملحق, you can also تعديل قيم السجل إلى عرض إضافى خطأ معلومات و إلى تكوين how ‏‫Visual Studio executes SharePoint الأوامر.

ملحقات تصحيح الأخطاء في مثيل التجريبي من برنامج ‏‫Visual Studio

إلى حكومة لديك ‏‫Visual Studio يوفر بيئة التطوير من تلف مقصود بواسطة مختبر ملحقات ‏‫‏‫عدة تطوير البرامج لـ Visual Studio مثيل ‏‫Visual Studio بديل ، تسمى مثيل تجريبية ، التي يمكنك استخدامها إلى يثّبت ملحقات واختبارها. تطوير ملحقات الجديدة باستخدام مثيل ‏‫Visual Studio العادي ولكنك يصحح وقم تشغيلها في نسخة تجريبية. لمزيد من المعلومات، راجع Experimental Build.

في حالة استخدام مشروع VSIX لنشر الملحق الخاص بك هو مشروع VSIX مشروع بدء التشغيل في الحل ‏‫Visual Studio تلقائياً بتثبيت ويشغّل الملحق في تجريبية المثيل متى قمت يصحح الحل الخاص بك. المشروع الذي يبدأ متى كان المشروع بدء التشغيل الذي يصحح حل الذي يحتوي على مشاريع متعددة. للحصول على مزيد من المعلومات حول استخدام مشروع VSIX صواب نشر الملحق الخاص بك, راجع تصحيح الأخطاء ملحقات لأدوات SharePoint في ‏‫Visual Studio. للحصول على معلومات حول المشروعات المؤقتة ، راجع كيفية القيام بما يلي: قم باختيار مشروع بدء التشغيل.

للحصول على أكثر راجع المعلومات حول كيفية تصحيح ملحقات في نسخة تجريبية من ‏‫Visual Studio walkthroughs التالية:

ملحقات تصحيح الأخطاء في مثيل عادي من ‏‫Visual Studio

إذا كنت تريد يصحح المشروع ملحق في مثيل عادي من ‏‫Visual Studio في مثيل العادي أولاً يثّبت الملحق. ثم قم بيرفق المصحح إلى عملية ‏‫Visual Studio ثاني. بعد الانتهاء، يمكنك إزالة الملحق بحيث لم يعد بتحميل على الكمبيوتر التطوير.

إلى أزاله التثبيت الملحق

  1. قم بيغلق الكل مثيلات ‏‫Visual Studio.

  2. في مجلد الإخراج بناء المشروع ملحق ينقر مزودجا الملف .vsix.

  3. في مربع الحوار صواب ملحق Installer ، حدد الإصدار صواب رغبتك في تثبيت الملحق إلى ، ثم انقر فوق تثبيت.

    صواب بتثبيت ملفات ملحق إلى اسم الكاتب %UserProfile%\AppData\Local\Microsoft\VisualStudio\10.0\Extensions\ \ اسم ملحق \ الإصدار . يتم إنشاء المجلدات الثلاثة الأخيرة في هذا المسار صواب Author ، Name ، و Version العناصر في الملف extension.vsixmanifest ملحق.

  4. بعد تثبيت Visual Studio الملحق ، انقر فوق صواب .

إلى يصحح الملحق

  1. يبدأ ‏‫Visual Studio مع امتيازات المسؤول ثم فتح المشروع الملحق. الخطوات التالية تشير إلى هذا المثيل من صواب كـ المثيل الأول .

  2. قم بيبدأ مثيل آخر من ‏‫Visual Studio بامتيازات مسؤول. الخطوات التالية تشير إلى هذا المثيل من صواب كـ المثيل الأول .

  3. تحويل إلى المثيل الأول من ‏‫Visual Studio.

  4. تشغيل the يصحح قائمة انقر فوقيرفق العملية.

  5. في القائمة العمليات المتوفرة ، انقر فوق devenv.exe. يشير هذا الإدخال إلى المثيل الثاني من برنامج ‏‫Visual Studio التالي؛ وهذا المثيل الذي ترغب يصحح ملحق المشروع الخاص بك في.

  6. انقر فوق إرفاق.

    تشغيل ‏‫Visual Studio المشروع ملحق في يصحح الوضع.

  7. تحويل إلى المثيل الأول من ‏‫Visual Studio.

  8. إنشاء مشروع جديد لـ SharePoint تحميل الملحق الخاص بك. على سبيل المثال، إذا تقوم بتصحيحه صواب لعناصر القائمة تعريف المشروع, إنشاء مشروع تعريف قائمة.

  9. تنفيذ القيام بخطوات مهما إلى اختبار تعليمات برمجية الملحق.

  10. عند الانتهاء من التصحيح الملحق بيغلق المثيل الثاني من برنامج ‏‫Visual Studio.

إلى إزالة الملحق

  1. في صواب, في القائمة أدوات، انقر فوق إدارة ملحق.

    فتح مربع حوار ملحق إدارة.

  2. في قائمة ملحقات انقر فوق اسم الملحق ثم انقر فوق إلغاء التثبيت.

  3. في مربع حوار الذي يظهر، انقر فوق نعم إلى يؤكّد أنك تريد إلى تثبيت الملحق.

  4. انقر فوق إعادة التشغيل الآن إلى إكمال إلغاء التثبيت.

تصحيح الأخطاء SharePoint الأوامر

If you want إلى يصحح a SharePoint الأمر that هو part of a SharePoint أدوات ملحق, you must يرفق the debugger إلى the vssphost4.exe عملية. This هو the 64-بت مضيف عملية that executes SharePoint الأوامر. For المزيد معلومات حول SharePoint الأوامر و vssphost4.exe, see استدعاء في طرازات كائن SharePoint.

إلى يرفق the debugger إلى the vssphost4.exe عملية

  1. أبدأ التصحيح your ملحق في the مثيل تجريبي of ‏‫Visual Studio أو the عادي instance of ‏‫Visual Studio بواسطة following the instructions above.

  2. في the مثيل of ‏‫Visual Studio في which you are running the debugger, تشغيل the يصحح قائمة, انقر يرفق إلى عملية.

  3. في the معالجات المتاحة قائمة, انقر vssphost.exe.

    ملاحظة

    إذا لم يظهر في القائمة vssphost.exe، يجب عليك يبدأ عملية vssphost4.exe مثيل من برنامج ‏‫Visual Studio الذي تقوم بتشغيله الملحق. بشكل عام، يمكنك إجراء ذلك بتنفيذ إجراء تؤدي ‏‫Visual Studio إلى الاتصال إلى موقع SharePoint تشغيل الكمبيوتر التطوير. على سبيل المثال، يبدأ برنامج ‏‫Visual Studio vssphost4.exe توسيع موقع اتصال عقدة (عقدة تعرض محدد موقع معلومات موقع) ضمن العقدة SharePoint الاتصالات في الإطار مستكشف الالخادم ، أو عندما تقوم إضافة عناصر المشروع SharePoint محددة، مثل مثيل قائمة أو عناصر استقبال حدث إلى مشروع SharePoint.

  4. انقر فوق إرفاق.

  5. في المثيل ‏‫Visual Studio تم تم تصحيحه، قم بتنفيذ الخطوات المطلوبة لتنفيذ الأمر.

قم بتعديل "قيم تسجيل" التصحيح إلى تعليمات SharePoint إلى ols ملحقات

عند تصحيح ملحق SharePoint إلى ols في ‏‫Visual Studio، يمكنك تعديل قيم في السجل إلى تساعدك في استكشاف الأخطاء وإصلاحها الملحق. قيم الموجودة تحت المفتاح HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\SharePointTools. عدم وجود هذه قيم ب الافتراضي.

إلى تعليمات استكشاف أي ملحق من أدوات SharePoint، يمكنك تعيين القيمة EnableDiagnostics. يلي جدول وصف هذه القيمة.

Value

الوصف

EnableDiagnostics

REG_DWORD التي تحدد ما إذا كان يتم عرض رسائل التشخيص في النافذة إخراج.

لعرض الرسائل التشخيص تعيين هذه القيمة إلى 1. لإيقاف عرض رسائل، التعيين هذه القيمة إلى 0 أو قم بحذف هذه القيمة.

كتابة الرسائل إلى الإطار إخراج من ملحق أدوات SharePoint ، استخدام خدمة المشروع SharePoint. لمزيد من المعلومات، راجع باستخدام الخدمة SharePoint مشروع.

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

Value

الوصف

AttachDebuggerToHostProcess

REG_DWORD التي تحدد ما إذا كان يتم عرض صندوق حوار التي تمكنك من يرفق مصحح الأخطاء vssphost4.exe بمجرد بدء تشغيله. Th هو هو مفيداً إذا كان الأمر الذي تريد تصحيحه هو تنفيذه قبل vssphost.exe فور بدء تشغيله، ويوجد هو غير كافية الوقت يدوياً إرفاق مصحح الأخطاء قبل الأمر هو تنفيذها. إلى عرض صندوق الحوار، قم باستدعاء vssphost4.exe Debugger.Breakالأسلوب عند ذلك يبدأ.

لتمكين هذا سلوك، التعيين هذه القيمة إلى 1. لإيقاف تشغيل هذا سلوك، التعيين هذه القيمة إلى 0 أو قم بحذف هذه القيمة.

إذا قمت بتعيين هذه القيمة إلى 1، قد تحتاج أيضا إلى زيادة قيمة HostProcessStartupTimeout لإعطاء وقت كاف بإرفاق مصحح الأخطاء قبل أن يتوقع ‏‫Visual Studio vssphost4.exe للإشارة أن تشغيلها بنجاح لنفسك.

ChannelOperationTimeout

REG_DWORD تحدد الوقت بالثواني ‏‫Visual Studio ينتظر أمر SharePoint إلى الينفذ. إذا كان لا يتم ينفذ الأمر في الوقت يتم طرح .

الإعداد الافتراضي هو 120 ثانية.

HostProcessStartupTimeout

بدء تشغيل REG_DWORD تحديد الوقت، بالثواني، التي ‏‫Visual Studio ينتظر vssphost4.exe الإشارة التي عليها بنجاح. إذا vssphost4.exe لا إشارة بدء ناجحة في الوقت, يتم طرح .

الإعداد الافتراضي هو 60 ثانية.

MaxReceivedMessageSize

REG_DWORD تحديد الحجم الأقصى المسموح به السلاسل التي يتم تمريرها بين ‏‫Visual Studio vssphost4.exe بالبايت.

القيمة الافتراضية هو 1048576 وحدات البايت (1 ميغا وحدات البايت).

MaxStringContentLength

REG_DWORD تحديد الحجم الأقصى المسموح به السلاسل التي يتم تمريرها بين ‏‫Visual Studio vssphost4.exe بالبايت.

القيمة الافتراضية هو 1048576 وحدات البايت (1 ميغا وحدات البايت).

راجع أيضًا:

موارد أخرى

توسيع أدوات SharePoint في ‏‫Visual Studio

تصحيح الأخطاء ملحقات لأدوات SharePoint في ‏‫Visual Studio