Share via


Introducción a los elementos web

Los elementos web son controles del lado servidor que se ejecutan dentro del contexto de páginas de sitio en Microsoft SharePoint Foundation. Los usuarios pueden editarlos y configurarlos. Los elementos web ofrecen a los usuarios la posibilidad de agregar funcionalidad a una página de sitio al simplemente colocarlos en la página. SharePoint Foundation incluye gran cantidad de elementos web predeterminados. Además, puede crear elementos web propios.

Tipos de elementos web

Hay dos tipos diferentes de elementos web en SharePoint Foundation. Ambos se admiten, pero se recomienda usar elementos web de ASP.NET en los proyectos.

  • Elementos web de ASP.NET: estos elementos web se basan en la infraestructura de elementos web de ASP.NET. Los elementos web de estilo ASP.NET dependen de System.Web.dll y deben heredar de la clase base WebPart del espacio de nombres System.Web.UI.WebControls.WebParts. Pueden usarse en aplicaciones de ASP.NET y en SharePoint Foundation, lo que los hace sumamente reutilizables.

    Nota

    Si se va a crear el elemento web específicamente para un sitio de SharePoint y se va a usar el modelo de objetos de SharePoint Foundation, se puede derivar de la clase base System.Web.UI.WebControls.WebParts.WebPart de ASP.NET y agregar una referencia al modelo de objetos de SharePoint en el proyecto.

  • Elementos web basados en SharePoint: estos elementos web dependen de Microsoft.SharePoint.dll y deben heredar de la clase base WebPart del espacio de nombres Microsoft.SharePoint.WebPartPages. Pueden usarse únicamente en sitios web de SharePoint.

    Nota

    Para obtener más información acerca de cuándo derivar de la clase WebPart de SharePoint Foundation, vea el tema Infraestructura de elementos web en SharePoint Foundation.

Infraestructura de elementos web de SharePoint

La infraestructura de elementos web de SharePoint Foundation se crea sobre un control denominado SPWebPartManager, derivado del control WebPartManager de ASP.NET. El control SPWebPartManager invalida el comportamiento estándar del control WebPartManager para persistir los datos del elemento web dentro de la base de datos de contenido de SharePoint Foundation, en lugar de en la base de datos de servicios de ASP.NET. En la mayoría de los casos, no tiene que preocuparse de tratar directamente con el control SPWebPartManager porque la instancia requerida ya está definida en v4.master. Cuando se crea una página de sitio vinculada a v4.master, el control SPWebPartManager ya está presente. Si crea sus propias páginas ASPX personalizadas que no hacen referencia a v4.master y desea admitir la adición de elementos web a zonas de elementos web, debe añadir un control SPWebPartManager a la página.

Nota

Las zonas de elementos web de una página de elementos web de SharePoint Foundation deben crearse mediante el control WebPartZone definido en el espacio de nombres Microsoft.SharePoint.WebPartPages y no mediante el control WebPartZone estándar de ASP.NET.

Cuando se crea una página de elementos web para una aplicación de ASP.NET estándar, debe agregar lógica que interactúe con el control WebPartManager para administrar el modo de presentación de elementos web y, por lo general, también deberá agregar explícitamente elementos EditorPart y elementos de catálogo a la página junto con el diseño HTML para darles cabida. Afortunadamente, no es necesario realizar estos cambios durante la creación de páginas de sitio para un sitio de SharePoint Foundation. En su lugar, se hereda de la clase WebPartPage definida en el espacio de nombres Microsoft.SharePoint.WebPartPages y se realiza todo el trabajo automáticamente en segundo plano.

Para obtener más información acerca de la creación de elementos web de ASP.NET, vea Desarrollo de elementos web en SharePoint Foundation y el tema de información general sobre el conjunto de controles de elementos web en la documentación de ASP.NET.

Elementos web personalizados

Los elementos web personalizados proporcionan a los programadores un método para crear elementos de interfaz de usuario que admitan tanto la personalización como la personalización de usuario. El término personalización implica que ven los cambios todos los miembros del sitio. Los usuarios individuales pueden personalizar todavía más una página de elementos web mediante la adición, reconfiguración y eliminación de elementos web. El término personalización de usuario implica que estos cambios solo los verá el usuario que los haya realizado. Un propietario o miembro del sitio con los permisos adecuados puede personalizar una página de elementos web mediante un explorador o con Microsoft SharePoint Designer para agregar, volver a configurar o quitar un elemento web.

La infraestructura de elementos web de SharePoint Foundation ahora se basa en el conjunto de controles de elementos web de ASP.NET, por lo que puede volver a usar sus conocimientos de programación en ASP.NET para crear elementos web eficaces y personalizados rápidamente. Los programadores pueden ampliar los sitios de SharePoint mediante la creación de elementos web personalizados para agregar las dimensiones adicionales de personalización y personalización de usuario. El desarrollo de elementos web personalizados ofrece un modo sencillo y eficaz de ampliar los sitios de SharePoint Foundation.

A continuación se indican algunas maneras en las que puede beneficiarse del uso de elementos web personalizados. Puede:

  • Crear propiedades personalizadas que se pueden mostrar y modificar en la interfaz de usuario.

  • Mejorar el rendimiento y la escalabilidad. Un elemento web personalizado compilado se ejecuta de un modo más rápido que un script.

  • Implementar código propietario sin divulgar el código fuente.

  • Proteger y controlar el acceso al contenido dentro del elemento web. Los elementos web integrados permiten a cualquier usuario que disponga de los permisos adecuados cambiar el contenido y modificar la funcionalidad del elemento web. Un elemento web personalizado permite determinar el contenido o las propiedades que se han de mostrar a los usuarios, independientemente de sus permisos.

  • Hacer que el elemento web sea conectable, lo que le permite proporcionar u obtener acceso a datos desde otros elementos web conectables.

  • Interactuar con los modelos de objetos que se exponen en SharePoint Foundation. Por ejemplo, puede crear un elemento web personalizado para guardar documentos en una biblioteca de documentos de SharePoint Foundation.

  • Controlar la memoria caché del elemento web mediante herramientas integradas de la memoria caché. Por ejemplo, puede usar estas herramientas para especificar cuándo se debe leer, escribir o invalidar la memoria caché de elementos web.

  • Beneficiarse de un entorno de desarrollo amplio con características de depuración proporcionadas por herramientas como Microsoft Visual Studio 2010.

  • Crear una clase base para ampliar otros elementos web. Por ejemplo, para crear una colección de elementos web con funcionalidad y características similares o para crear una clase base personalizada desde la que pueden heredar varios elementos web. Esto reduce el costo general del desarrollo y prueba de elementos web posteriores.

  • Controlar la implementación del elemento web. Por ejemplo, puede escribir un elemento web de servidor personalizado que se conecte a una base de datos back-end, o puede crear un elemento web que sea compatible con una gama más amplia de exploradores web.

Vea también

Tareas

Procedimiento para exportar un elemento web de ASP.NET e importarlo a un sitio de SharePoint Foundation

Referencia

Microsoft.SharePoint.WebPartPages

Conceptos

Infraestructura de elementos web en SharePoint Foundation

Otros recursos

Desarrollo de elementos web en SharePoint Foundation

Historial de cambios

Fecha

Descripción

Mayo de 2010

Publicación inicial