Infraestructura de elementos web en SharePoint Foundation

Artículo
09/24/2014

Última modificación: miércoles, 14 de abril de 2010

Hace referencia a: SharePoint Foundation 2010

Los elementos web son controles de servidor que se ejecutan dentro del contexto de las páginas del sitio de Microsoft SharePoint Foundation. Puede usarlos para personalizar la interfaz de usuario (UI) y para editar el contenido de una página del sitio. SharePoint Foundation incluye elementos web predeterminados, así como también la posibilidad de crear elementos web personalizados. Son dos los tipos de elementos web admitidos en SharePoint Foundation. Se hace referencia a ellos como elementos web de SharePoint y de ASP.NET. Los elementos web de ASP.NET usan la clase base System.Web.UI.WebControls.WebParts.WebPart, mientras que los elementos web de SharePoint usan la clase base Microsoft.SharePoint.WebPartPages.WebPart. Se admiten ambos tipos, pero se recomienda usar el elemento web de ASP.NET para todos los proyectos nuevos.

Modelo de objetos para elementos web

Los elementos web de SharePoint Foundation se basan en la infraestructura de elementos web de Microsoft ASP.NET. Para crear elementos web para aplicaciones orientadas a SharePoint Foundation, se deben crear elementos web personalizados en la parte superior de la infraestructura de elementos web de ASP.NET. Sin embargo, en algunos casos, puede que tenga que crear elementos web que admitan características de SharePoint Foundation que no están disponibles en la infraestructura de elementos web de ASP.NET.

Elementos web de ASP.NET

La infraestructura de elementos web de ASP.NET se basa en una clase WebPartManager que administra la duración de las instancias de elementos web en tiempo de ejecución.

Cada página de ASP.NET que usa controles de elemento web debe contener los siguientes objetos para admitir la personalización:

Exactamente un objeto WebPartManager que realice el seguimiento de los elementos web que se agregaron a cada zona en particular, y que almacene y recupere datos sobre el modo en que se ha personalizado cada elemento web.
Uno o varios objetos WebPartZone, en los que se colocan los elementos web.

Para ejecutar elementos web de SharePoint Foundation en una aplicación ASP.NET, debe crear una página .aspx que contenga exactamente una instancia del control WebPartManager y uno o varios controles WebPartZone. El control WebPartManager es responsable de serializar los datos relacionados con el elemento web, así como de almacenar y recuperarlos de la base de datos.

Los controles SPWebPartManager y WebPartZone administran la serialización de los datos asociados con elementos web en la base de datos de contenido de SharePoint Foundation adecuada. Para poder guardar los datos, los elementos web de ASP.NET deben colocarse en una página con estos dos controles.

Dado que estos controles específicos de SharePoint Foundation son necesarios en las páginas que contienen elementos web, no basta con copiar la página ASP.NET en un sitio de SharePoint Foundation. Para mover elementos web de ASP.NET de una aplicación ASP.NET a una aplicación de SharePoint Foundation, expórtelos de ASP.NET como archivos .werbparts e impórtelos en un sitio de SharePoint Foundation.

Elementos web de SharePoint

La infraestructura de elementos web de SharePoint Foundation usa varios de los controles del conjunto de controles de elementos web de ASP.NET e introduce diversos controles propios que hereda de las clases base proporcionadas por el conjunto de controles de elementos web de ASP.NET.

Por ejemplo, las páginas del sitio de un sitio de SharePoint Foundation no usan la clase WebPartManager estándar de ASP.NET, sino que usan la clase SPWebPartManager específica de SharePoint Foundation que hereda del WebPartManager de ASP.NET.

Nota

La página principal predeterminada proporcionada con SharePoint Foundation incluye una instancia de la clase SPWebPartManager, por lo que este control se incluye automáticamente con todas las páginas de contenido de SharePoint Foundation.

De la misma manera, un página de elementos web de un sitio web de SharePoint Foundation también usa la clase SharePoint Foundation-specific WebPartZone que hereda de la clase WebPartZone de ASP.NET.

Cuándo se debe derivar de la clase WebPart de SharePoint

En muy pocos casos, es posible que deba crear elementos web que admitan características de SharePoint Foundation que no están disponibles en la infraestructura de elementos web de ASP.NET. En estos casos, puede crear una clase que herede de la clase base WebPart de SharePoint. Estos elementos web se denominan elementos web basados en SharePoint y solo pueden usarse en los sitios de SharePoint Foundation.

A continuación, se muestra la lista de características que ofrece exclusivamente la clase WebPart de SharePoint:

Conexiones entre páginas
Conexiones entre elementos web fuera de una zona de elementos web
Conexiones de cliente (Componente de servicios de páginas de elementos web)
Una infraestructura de almacenamiento en caché de datos que permite almacenar datos en la caché de la base de datos de contenido

Otro motivo por el que puede considerar la posibilidad de derivar de la clase WebPart está relacionado con la creación de nuevas versiones de los elementos web. Si el elemento web original se derivaba de la clase WebPart y desea actualizar las instancias de ese elemento web a una nueva versión, la nueva versión también debe derivar de la clase WebPart de SharePoint.