Volání do objektových modelů služby SharePoint
Při vytváření rozšíření pro nástroje služby SharePoint v aplikaci Visual Studio pravděpodobně volání rozhraní API služby SharePoint k provedení určitých úkolů.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 2010a Microsoft SharePoint Server 2010 poskytují nástroje pro rozšíření dva modely jiný objekt, které můžete použít ve službě SharePoint: objektového modelu serveru a klienta objektu modelu.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 modelu programování rozšíření nástrojů 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 pomocí objektového modelu klient v rozšíření služby SharePoint nástroje by měly fungovat ve většině případů, setkat se některé scénáře, kde volání objektového modelu klient nemusí pracovat podle očekávání.Objektový model klient je určen pro použití v klientských aplikacích volání weby 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 aplikace SharePoint volání do webu SharePoint v místním počítači, který není jak objektového modelu klient byl určen.
Názorný postup ukazuje, jak použít objektový model klient v rozšíření nástroje služby SharePoint v aplikaci Visual Studio, viz Návod: Volání do modelu klientského objektu služby SharePoint v rozšíření průzkumníka 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 Návod: Vytvoření vlastního kroku nasazení pro projekty SharePoint a Návod: Rozšíření průzkumníka serveru pro zobrazení částí webu.
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 ve příponou nástroje služby SharePoint je příkaz spuštěn pomocí 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é
Úkoly
Postupy: Provedení příkazu SharePoint
Koncepty
Postupy: Vytvoření příkazu SharePoint
Přehled modelu programování rozšíření nástrojů služby SharePoint