Llamar a los modelos de objetos de SharePoint

Al crear extensiones para las herramientas de SharePoint en Visual Studio, puede tener que llamar a las API de SharePoint para realizar ciertas tareas.Por ejemplo, si crea un paso de implementación personalizado para los proyectos de SharePoint, tal vez tenga que llamar a las API de SharePoint para algunas de las tareas de la implementación de soluciones.

Microsoft SharePoint Foundation 2010 y Microsoft SharePoint Server 2010 proporcionan dos modelos de objetos diferentes que puede utilizar en las extensiones de herramientas de SharePoint: un modelo de objetos de servidor y un modelo de objetos de cliente.Cada uno presenta ventajas y desventajas en el contexto de las extensiones de herramientas de SharePoint.

Para ver una introducción a los modelos de objeto de SharePoint, vea Información general del modelo de programación de extensiones de SharePoint.

Uso del modelo de objetos de cliente en proyectos de extensión

Al desarrollar una extensión para las herramientas SharePoint, puede utilizar el modelo de objetos de cliente como cualquier otro conjunto de API administradas.Puede agregar las referencias a los ensamblados en el modelo de objetos del cliente a su proyecto y llamar directamente a las API en el modelo de objetos del cliente desde el código.

Sin embargo, el modelo de objetos de cliente tiene dos inconvenientes en el contexto de las extensiones de herramientas de SharePoint:

• El modelo de objetos de cliente proporciona solo un subconjunto del modelo de objetos de servidor.Si tiene que utilizar funcionalidad de SharePoint que no se expone en el modelo de objetos de cliente, debe usar el modelo de objetos de servidor.

• Aunque usar el modelo de objetos de cliente en las extensiones de herramientas de SharePoint serviría en la mayoría de los casos, puede haber escenarios en los que las llamadas al modelo de objetos de cliente no funcionen tal y como se espera.El modelo de objetos de cliente se ha diseñado para usarlo en las aplicaciones cliente para llamar a los sitios de SharePoint en un servidor remoto o en una granja de servidores.Las herramientas de SharePoint en Visual Studio solo funcionan con una instalación de SharePoint local en el equipo de desarrollo.Por consiguiente, cuando se usa el modelo de objetos de cliente en una extensión de herramientas de SharePoint, se llama a un sitio de SharePoint en el equipo local, que no es la forma en que se diseño el modelo de objetos de cliente para ser usado.

Para un tutorial que muestra cómo utilizar el modelo de objetos de cliente en una extensión de herramientas de SharePoint en Visual Studio, vea Tutorial: Llamar al modelo de objetos de cliente de SharePoint en una extensión del Explorador de servidores.

Uso del modelo de objetos de servidor en proyectos de extensión

El modelo de objetos de servidor es un supraconjunto del modelo de objetos de cliente.Con el modelo de objetos de servidor, puede usar todas las características que Microsoft SharePoint Foundation 2010 y Microsoft SharePoint Server 2010 exponen mediante programación.

Las extensiones de herramientas de SharePoint pueden usar las API del modelo de objetos de servidor, pero no pueden llamarlas directamente.Solo se puede llamar al modelo de objetos de servidor desde un proceso de 64 bits que tenga como destino .NET Framework 3.5.Sin embargo, las extensiones de herramientas de SharePoint requieren .NET Framework 4 y se ejecutan en el proceso de Visual Studio de 32 bits.Esto evita que las extensiones de herramientas de SharePoint hagan referencia directamente a los ensamblados del modelo de objetos de servidor de SharePoint.

Si desea utilizar el modelo de objetos de servidor en una extensión de herramientas de SharePoint, debe crear un comando de SharePoint personalizado para llamar a la API.Defina el comando de SharePoint en un ensamblado secundario que puede llamar directamente al modelo de objetos de servidor.En el proyecto de extensión, llame indirectamente al comando de SharePoint utilizando el método ExecuteCommand de un objeto ISharePointConnection.

Para obtener más información sobre cómo crear y utilizar los comandos de SharePoint, vea Cómo: Crear un comando de SharePoint y Cómo: Ejecutar un comando de SharePoint.Para obtener información sobre cómo implementar los comandos de SharePoint, vea Extensiones de implementación para las Herramientas de SharePoint en Visual Studio.

Para ver tutoriales que muestran cómo crear y utilizar los comandos de SharePoint, vea Tutorial: Crear un paso de implementación personalizado para proyectos de SharePoint y Tutorial: Extender el Explorador de servidores para mostrar elementos web.

Entender cómo se ejecutan los comandos de SharePoint

Los ensamblados que definen los comandos de SharePoint se cargan en un proceso de host de 64 bits denominado vssphost4.exe.Después de llamar a un comando de SharePoint en una extensión de herramientas de SharePoint, el comando lo ejecuta vssphost4.exe, no el proceso de Visual Studio de 32 bits (devenv.exe).Puede controlar algunos aspectos de cómo se ejecutan los comandos de SharePoint estableciendo valores en el Registro.Para obtener más información, vea Depurar las extensiones para las Herramientas de SharePoint en Visual Studio.

Vea también

Tareas

Cómo: Ejecutar un comando de SharePoint

Conceptos

Cómo: Crear un comando de SharePoint

Información general del modelo de programación de extensiones de SharePoint