Páginas de formularios de elementos de lista

Última modificación: viernes, 09 de abril de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
Formularios de elementos de lista y página maestra
Representación de los formularios de presentación
Especificación de páginas personalizadas para crear o modificar listas

Las páginas de formulario de elementos de lista (DisplayForm.aspx, EditForm.aspx y NewForm.aspx) de la mayoría de las listas de Microsoft SharePoint Foundation se basan en el mismo archivo Form.aspx que se encuentra en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\Pages. Este archivo implementa el archivo default.master de SharePoint Foundation que se encuentra en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\GLOBAL.

De manera predeterminada, las páginas de formulario de lista se ejecutan en modo de no compilación para una mejor escalabilidad. SharePoint Foundation no permite código en páginas de formulario, a menos que dicho permiso se haya habilitado a través de la interfaz de usuario.

Formularios de elementos de lista y página maestra

Las páginas de formulario de lista predeterminadas están diseñadas de acuerdo con la página maestra predeterminada y cada área para el control está representada por un marcador de posición en la página. Una página de formulario de lista contiene marcadores de posición para la barra de herramientas, el encabezado, el cuerpo y el pie de página. Cada página de formulario específica determina los controles que se deben usar en los marcadores de posición en cuestión, lo cual requiere el diseño general de la página maestra con sus páginas maestras anidadas (derivadas).

La página maestra define los bordes y áreas de navegación que se muestran en los formularios de elementos de lista. Para obtener información acerca de las páginas maestras en SharePoint Foundation, vea Páginas maestras

El archivo Form.aspx contiene un control Microsoft.SharePoint.WebPartPages.WebPartZone que inserta un objeto ListFormWebPart en el cuerpo de la página. Para mostrar el contenido de la página, este elemento web crea una instancia de un control ListForm cuya plantilla está definida en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\CONTROLTEMPLATES\DefaultTemplates.ascx. El control ListForm contiene marcado HTML y plantillas de control para presentar la barra de herramientas, los campos y otras partes del formulario. Puede especificar un control ListForm personalizado a través de las propiedades de plantilla de la clase ListFormWebPart.

Importante
No se admite la edición de los archivos que SharePoint Foundation instala en los servidores front-end web. Los cambios que se realicen a los archivos instalados originalmente podrían sobrescribirse al instalar las actualizaciones o Service Pack para SharePoint Foundation, o cuando se actualiza una instalación a la siguiente versión del producto.

Representación de los formularios de presentación

La representación de los formularios de presentación de SharePoint Foundation es algo diferente de la de los formularios de edición y de creación, ya que aunque los formularios de presentación tienen el mismo diseño que estos últimos y comparten la mayoría de los controles, los campos de los formularios de presentación se definen en código no administrado y tienen la misma representación de campos que se usa en las vistas de lista. En modo de presentación, los controles de campo de SharePoint usan las definiciones de Esquemas Core del Lenguaje de marcado de la aplicación de colaboración (CAML) para representar los campos.

Importante
Aunque se pueden agregar elementos web a los formularios de presentación, edición y creación para elementos de lista (DispForm.aspx, EditForm.aspx y NewForm.aspx), no se recomienda hacerlo ni se admite en SharePoint Foundation. Por el contrario, sí se admite agregar elementos web a las páginas de vista de lista (AllItems.aspx).

Especificación de páginas personalizadas para crear o modificar listas

Se puede especificar una página personalizada para crear listas o para editar las propiedades de las listas especificando los atributos NewPage y EditPage en el elemento ListTemplate de una definición de lista de características.

En el siguiente ejemplo, se especifican páginas personalizadas para listas creadas mediante la definición de lista.

<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <ListTemplate
    Name="MyTemplate"
    Type="2100"
    BaseType="1"
    OnQuickLaunch="TRUE"
    SecurityBits="11"
    DisplayName="My Custom List Type"
    NewPage="MyCreateList.aspx"
    EditPage="MyEditList.aspx"
    Description="My description..."
    Image="/_layouts/images/itsl.gif"
    DocumentTemplate="100">
  </ListTemplate>
</Elements>