Bloque de creación: bibliotecas de listas y documentos

Artículo
09/24/2014

Última modificación: jueves, 08 de abril de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
Modelo de objetos para listas y bibliotecas de documentos
XML usado para listas y bibliotecas de documentos
Áreas relacionadas con las listas y bibliotecas de documentos
Más información acerca de las listas y bibliotecas de documentos

Microsoft SharePoint Foundation 2010 ofrece varias API que pueden usarse para trabajar con listas. Los siguientes modelos de objetos administrados proporcionan tipos y miembros que permiten modificar las propiedades de lista y crear y administrar plantillas de lista y elementos de lista:

Para el código que opera en el servidor, el espacio de nombres Microsoft.SharePoint proporciona las clases principales que representan una lista. El espacio de nombres Microsoft.SharePoint.Deployment proporciona una API para migrar contenido entre colecciones de sitios.
Para el código administrado que opera en el contexto de aplicaciones del lado cliente de Microsoft .NET 3.5 o aplicaciones de Silverlight, el espacio de nombres Microsoft.SharePoint.Client proporciona un subconjunto de los tipos y miembros disponibles en el modelo de objetos de servidor.
Para el script que opera en el explorador, el modelo de objetos de ECMAScript (JavaScript, JScript) del espacio de nombres SP proporciona un subconjunto de los tipos y miembros disponibles en el modelo de objetos de servidor.
El servicio web Lists proporciona métodos para trabajar con listas de forma remota.

Puede usar el método SaveAsTemplate(String, String, String, Boolean) en el modelo de objetos del lado servidor para guardar una lista de SharePoint Foundation como una plantilla de lista, o bien puede usar la clase SPListTemplate y su clase de colección para administrar las plantillas de lista. La clase SPListTemplate representa plantillas de lista personalizadas creadas mediante el método SaveAsTemplate(String, String, String, Boolean) o guardadas mediante la interfaz de usuario, y definiciones de lista que se instalan y activan como una característica en el directorio %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES.

Un esquema de lista tiene un tipo base y un tipo de plantilla de lista. La enumeración SPBaseType identifica los siguientes tipos base de lista:

Tipo de lista genérico para la mayoría de las listas
Biblioteca de documentos
Panel de discusión
Encuesta
Problema
Tipo base no especificado.

La enumeración SPListTemplateType identifica los tipos de plantilla de lista predeterminados de SharePoint Foundation, cada uno de los cuales se asocia con una sola definición de tipo base de lista. La clase SPList proporciona acceso a las propiedades de lista comunes a todas las listas, pero también es posible que los tipos de plantilla de lista deriven de un tipo base de lista. Por ejemplo, se puede convertir un objeto de lista que representa una biblioteca de documentos en un objeto SPDocumentLibrary para tener acceso a propiedades específicas de las bibliotecas de documentos.

Microsoft Servicios de conectividad empresarial (BCS) de Microsoft proporciona varias API para trabajar con listas externas. Para obtener información acerca de Servicios de conectividad empresarial, vea Bloque de creación: Tipos de contenido externos y listas externas.

Modelo de objetos para listas y bibliotecas de documentos

Las siguientes clases de los modelos de objetos de cliente y de servidor pueden usarse para trabajar con listas, plantillas de lista y elementos de lista:

SPList – Representa una lista en un sitio web de SharePoint. Un modo eficaz de devolver una lista específica es mediante el método GetList de SPWeb o SPListCollection.

Modelo de objetos de cliente: List (JavaScript: List)
SPListDataSource – Proporciona información sobre una lista externa.

Modelo de objetos de cliente ListDataSource (JavaScript: ListDataSource)
SPListEventProperties – Proporciona propiedades para eventos de listas de SharePoint.
SPListEventReceiver – Proporciona métodos para interceptar los eventos que se producen para las listas.
SPListItem – Representa un elemento o fila de una lista. Un modo eficaz de devolver un elemento de lista o SPListItemCollection es mediante un método GetItem* de SPList o SPWeb.

Modelo de objetos de cliente: ListItem (JavaScript: ListItem)
SPListItemVersion – Representa una versión de un elemento de lista.
SPListTemplate – Representa una definición de lista o una plantilla de lista, que define los campos y vistas de una lista. Las definiciones de lista se incluyen en archivos del directorio %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES, pero las plantillas de lista se crean mediante la interfaz de usuario o el modelo de objetos cuando se guarda una lista como una plantilla.

Modelo de objetos de cliente: ListTemplate (JavaScript: ListTemplate)
SPListTemplateType – Una enumeración que especifica el tipo de una definición de lista o una plantilla de lista.

Modelo de objetos de cliente: ListTemplateType (JavaScript: ListTemplateType)
SPBaseType – Una enumeración que especifica el tipo base de una lista.

Modelo de objetos de cliente: BaseType (JavaScript: BaseType)
SPDocTemplate – Representa una plantilla de documento usada en una biblioteca de documentos.
SPDocumentLibrary – Representa una biblioteca de documentos de SharePoint Foundation.

Para obtener información acerca de cómo trabajar con listas en el modelo de objetos de servidor, vea Trabajar con objetos de listas y colecciones y las tareas de programación incluidas en Tareas básicas del modelo de objetos. Para obtener información acerca de cómo trabajar con listas en los modelos de objetos de cliente, vea Introducción a la recuperación de datos y las tareas de programación de Tareas comunes de programación.

XML usado para listas y bibliotecas de documentos

Una definición de lista se activa como una característica de SharePoint Foundation y tiene un archivo Schema.xml que contiene el esquema, aunque gran parte de la definición de vista se proporciona mediante XSLT en el directorio %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS\XSL. List es el elemento de nivel superior del esquema de lista, pero el elemento Configuration de un esquema de definición de sitio también contiene un elemento List para incluir una lista específica como parte de los sitios web creados mediante la definición de sitio. La característica de instancia de lista le permite especificar los datos predeterminados con los que se aprovisionará un tipo de lista. Para obtener información acerca de cómo usar las características, vea Uso de características. Para obtener un ejemplo que muestre cómo crear una característica de definición de lista, vea Procedimiento para crear una definición de lista personalizada.