استدعاء في طرازات كائن SharePoint
عندما تقوم بإنشاء ملحقات لأدوات SharePoint في Visual Studio 2010، قد تحتاج إلى يتصل SharePoint APIs لتنفيذ مهام معينة. على سبيل المثال، إذا قمت بإنشاء خطوة نشر مخصص للمشاريع SharePoint قد تحتاج إلى يتصل SharePoint APIs لتنفيذ بعض المهام لتوزيع الحلول.
Microsoft SharePoint Foundation 2010وMicrosoft SharePoint Server 2010توفر أدوات النموذجين كائنات مختلفة يمكنك استخدامها في SharePoint ملحقات: الخادم كائن الطراز وطراز كائن عميل. يحتوي كل طراز الكائن فوائد وعلى عيوب في سياق ملحقات أدوات SharePoint.
للحصول على نظرة عامة حول طرازات كائن SharePoint ، راجع نظرة عامة حول برنامج Visual Studio وطرازات كائن SharePoint.
باستخدام نموذج كائن العميل في مشاريع ملحق
عند تطوير ملحق لأدوات SharePoint يمكنك استخدام طراز الكائن العميل في المشروع مثل مجموعة أخرى من واجهات برمجة التطبيقات المدارة. يمكنك إضافة مراجع التجميعات في طراز كائن العميل إلى المشروع ثم يمكنك يتصل APIs في طراز كائن عميل مباشرة من تعليمات برمجية الخاصة بك.
ومع ذلك، طراز الكائن العميل توفير مجموعة فرعية فقط من الخادم طراز الكائن. إذا كان لديك إلى استخدام وظائف SharePoint التي لا يتم عرضها في طراز كائن العميل ثم يجب عليك استخدام طراز كائن الخادم.
بالإضافة إلى ذلك، كن على علم باستخدام طراز كائن العميل في ملحقات أدوات SharePoint يجب أن تعمل في معظم الحالات ولكن قد تصادف بعض السيناريوهات أين استدعاءات طراز كائن العميل لا تعمل بالشكل المتوقع. طراز كائن العميل المقصود المستخدمة في يتصل في مواقع SharePoint تشغيل الخادم البعيد أو مزرعة. تعمل أدوات SharePoint في Visual Studio فقط مع تثبيت SharePoint محلية على الكمبيوتر التطوير. لذلك، عند استخدام واجهات برمجة تطبيقات SharePoint في ملحق أدوات SharePoint يمكنك استدعاء إلى موقع SharePoint محلية على كمبيوتر محلي بدلاً من موقع على التحكم عن بعد الخادم أو مزرعة.
للحصول على إرشادات تفصيلية توضح كيفية استخدام فئة بشكل برمجي, راجع الإرشادات التفصيلية: استدعاء إلى نموذج كائن عميل SharePoint في الخادم Explorer ملحق.
باستخدام نموذج كائن العميل في مشاريع ملحق
طراز كائن الخادم مجموعة شاملة من طراز كائن العميل. عند استخدام طراز كائن الخادم يمكنك استخدام كافة ميزات ذلك Microsoft SharePoint Foundation 2010و Microsoft SharePoint Server 2010كشف برمجياً.
يمكن استخدام ملحقات أدوات SharePoint واجهات برمجة التطبيقات (APIs) في طراز كائن الخادم ولكن فإنها لا يتصل APIs مباشرة. يمكن استدعاء طراز كائن الخادم فقط من عملية 64-بت أهداف 3.5 .NET Framework. ومع ذلك، تتطلب ملحقات أدوات SharePoint .NET Framework 4وإعادة تشغيلها في عملية 32-بت Visual Studio. هذا يمنع ملحقات أدوات SharePoint من الرجوع إلى التجميعات في طراز كائن ملقم SharePoint مباشرةً.
إذا كنت تريد استخدام طراز كائن الخادم في ملحق أدوات SharePoint يجب عليك إنشاء الأمر SharePoint مخصصة إلى يتصل واجهة برمجة التطبيقات (API). تحديد الأمر SharePoint في تجميع ثانوي يمكن يتصل إلى طراز كائن الخادم مباشرة. في المشروع، الملحق الذي يتصل الأمر SharePoint بشكل غير مباشر باستخدام ExecuteCommandأسلوب ISharePointConnectionالكائن.
لمزيد من المعلومات حول إنشاء الأوامر SharePoint واستخدامها راجع كيفية القيام بما يلي: إنشاء أمر SharePointو كيفية القيام بما يلي: ينفذ الأوامر SharePoint. لمزيد من المعلومات حول كيفية إلى نشر SharePoint الالأوامر, راجع تصحيح الأخطاء ملحقات لأدوات SharePoint في Visual Studio.
للحصول على walkthroughs شرح كيفية إنشاء الأوامر SharePoint راجع الإرشادات التفصيلية: إنشاء مخصص توزيع الخطوة لمشاريع SharePointو الإرشادات التفصيلية: توسيع الخادم مستكشف إلى عرض أجزاء ويب.
يتم تنفيذ فهم "كيف SharePoint الأوامر"
تم تحميلها في عملية مضيف 64-بت المسمى vssphost4.exe التجميعات التي تعرّف الأوامر SharePoint. بعد الاتصال أمر SharePoint في ملحق أدوات SharePoint يتم تنفيذ الأمر بواسطة vssphost4.exe بدلاً من عملية Visual Studio 32-بت (devenv.exe). يمكنك التحكم في بعض أوجه كيف يتم تنفيذ الأوامر SharePoint وذلك بتعيين القيم في السجل. لمزيد من المعلومات، راجع تصحيح الأخطاء ملحقات لأدوات SharePoint في Visual Studio.
راجع أيضًا:
المبادئ
نظرة عامة حول برنامج Visual Studio وطرازات كائن SharePoint