Volání do objektových modelů služby SharePoint
Pokud jste vytvořili rozšíření pro nástroje služby SharePoint v Visual Studio 2010, budete možná muset volat rozhraní API služby SharePoint pro provedení určitých úloh. Například pokud vytvoříte vlastní krok nasazení pro projekty SharePoint, budete muset volat rozhraní API služby SharePoint pro provádění některých úkolů pro nasazení řešení.
Microsoft SharePoint Foundation 2010 a Microsoft SharePoint Server 2010 poskytují dva rozdílné objektové modely, které lze použít v rozšíření nástroje SharePoint: objektový model serveru a objektový model klienta. Každý objektový model má své výhody a nevýhody v kontextu rozšíření nástrojů služby SharePoint.
Přehled objektových modelů SharePoint, viz Přehled programovací Model rozšíření nástroje služby SharePoint.
Použití objektového modelu klienta v rozšířených projektech
Při vyvíjení rozšíření pro nástroje služby SharePoint můžete použít klientský objektový model v projektu jako jinou sadu spravovaných rozhraní API. Můžete přidat odkazy na sestavení v objektovém modelu klienta do projektu a můžete volat rozhraní API v objektovém modelu klienta přímo z kódu.
Objektový model klient má však dva nedostatky v kontextu rozšíření nástroje služby SharePoint:
Objektový model klient poskytuje pouze podmnožinu modelu objektu serveru. Máte-li používat funkci služby SharePoint, která není vystavena v objektovém modelu klienta, musíte použít objektový model serveru.
Ačkoli ve většině případů by pracovat pomocí objektového modelu klient v rozšíření nástroje služby SharePoint, setkat některé scénáře, kde volání objektového modelu klient nemusí fungovat podle očekávání. Objektový model klient je určen k použití v klientských aplikacích volání do webů služby SharePoint na vzdálený server nebo hospodářství. Nástroje služby SharePoint v aplikaci Visual Studio pracují pouze s místní instalací služby SharePoint ve vývojovém počítači. Proto při použití objektového modelu klient v rozšíření nástroje SharePoint volání do webu SharePoint v místním počítači není jak objektový model klient nebyl určen.
Pro názorný postup, který demonstruje použití objektového modelu klient v rozšíření nástrojů SharePoint v Visual Studio 2010, viz Podrobné pokyny: Volání do modelu klientského objektu služby SharePoint v příponě aplikace Průzkumník serveru.
Použití objektového modelu serveru v rozšířených projektech
Objekt modelu serveru je nadmnožinou objektového modelu klienta. Při použití objektového modelu serveru můžete použít všechny funkce, které Microsoft SharePoint Foundation 2010 a Microsoft SharePoint Server 2010 vystavují programově.
Rozšíření nástrojů SharePoint mohou použít rozhraní API v objektovém modelu serveru, ale nemohou volat rozhraní API přímo. Objektový model serveru lze volat pouze z 64bitového procesu, který je určen pro .NET Framework 3.5. Avšak rozšíření nástrojů SharePoint vyžadují .NET Framework 4 a jsou spouštěny ve 32bitovém procesu Visual Studia. To zabrání rozšíření nástrojů SharePoint v odkazování sestavení v objektovém modelu serveru SharePoint přímo.
Pokud chcete používat model serverového objektu v nástrojích rozšíření SharePoint, musíte vytvořit vlastní Příkaz služby SharePoint pro volání rozhraní API. Příkaz SharePoint definujete v sekundárním sestavení, které může volat přímo do objektového modelu serveru. V rozšířeném projektu můžete volat příkaz SharePoint nepřímo pomocí metody ExecuteCommand objektu ISharePointConnection.
Další informace o vytváření a použití příkazů služby SharePoint naleznete v tématu Postupy: Vytvoření příkazu SharePoint a Postupy: Provedení příkazu SharePoint. Informace o způsobu nasazení příkazů SharePoint naleznete v tématu Nasazování rozšíření pro nástroje služby SharePoint v aplikaci Visual Studio.
Pro návody, které ukazují, jak vytvořit a použít příkazy služby SharePoint viz Podrobné pokyny: Vytvoření vlastního kroku nasazení pro SharePoint projekty a Podrobné pokyny: Rozšíření Průzkumníka serveru pro zobrazení webových částí.
Principy jak jsou příkazy SharePoint spouštěny.
Sestavení, které definují příkazy služby SharePoint jsou zavedeny v 64bitovém hostitelském procesu s názvem vssphost4.exe. Po volání příkazu SharePoint v rozšíření nástroje SharePoint spustit příkaz vssphost4.exe namísto proces 32bitové aplikace Visual Studio (devenv.exe). Můžete určit, jak jsou provedeny příkazy SharePoint pomocí nastavení hodnot v některých registrech. Další informace naleznete v tématu Ladění rozšíření pro nástroje služby SharePoint v aplikaci Visual Studio.
Viz také
Koncepty
Přehled programovací Model rozšíření nástroje služby SharePoint