Crear elementos web para SharePoint

Mediante elementos web, los usuarios pueden modificar directamente el contenido, el aspecto, y el comportamiento de las páginas del sitio de SharePoint mediante un explorador.Los elementos web son controles de Servidor- lado que se ejecutan dentro de un tipo especial de página denominado una página de elementos web: son los bloques de creación de las páginas que aparecen en un sitio de SharePoint.Para obtener más información sobre los elementos web de SharePoint, vea Bloque de creación: Elementos web.

Visual Studio proporciona plantillas que puede utilizar para crear y depurar partes web en un sitio de SharePoint.

Crear un elemento web en Visual Studio

Cree un elemento web agregando un elemento Elemento web a cualquier proyecto de SharePoint.Puede utilizar un elemento elemento web en una solución en espacio aislado o en una solución de granja de servidores.

Si desea diseñar un elemento web utilizando un diseñador, cree un proyecto Elemento web visual o agregue el elemento Elemento web visual a cualquier proyecto de SharePoint.Solo puede utilizar un elemento elemento web visual en una solución de granja de servidores.

Elemento de elemento web

Un elemento Elemento web proporciona archivos que puede utilizar para diseñar un elemento web para un sitio de SharePoint.Cuando se agrega un elemento Elemento web , Visual Studio crea una carpeta en el proyecto y después agrega varios archivos.En la tabla siguiente se describe cada archivo.

Archivo	Descripción
Elements.xml	Contiene información que el archivo de definición de la característica del proyecto utiliza para implementar el elemento web.
Archivo .webpart	Proporciona información que SharePoint necesita para mostrar el elemento web en una galería de elementos web.
Archivo de código	Contiene métodos que agregan controles al elemento web y que genera el contenido personalizado dentro del elemento web.

Para obtener más información, vea Cómo: Crear un elemento web de SharePoint.

Elemento de elemento web visual

Un elemento web visual es un elemento web que se crea utilizando el diseñador de Visual Web developer en Visual Studio.Para obtener más información sobre cómo utilizar este diseñador, vea Visual Studio 11 Beta para el mapa de contenido web.

Funcionalmente, un elemento web visual no es diferente de una parte web.Un elemento web visual incluye un elemento elemento web y un elemento control de usuario.

Puede diseñar la apariencia del elemento web arrastrando o copiando los controles de Visual Studio Cuadro de herramientas a la superficie del control de usuario.Para obtener más información, vea Cómo: Crear un elemento web de SharePoint con un diseñador.

Controles de SharePoint

Visual Studio proporciona algunos controles para crear páginas de SharePoint, como páginas de aplicación.Estos controles aparecen en el cuadro de herramientas en Controles de SharePoint.La funcionalidad para estos controles se deriva Microsoft.SharePoint.WebControls del espacio de nombres, que contiene controles de servidor ASP.NET que se utilizan en el sitio de SharePoint y muestran las páginas.

Nombre del control	Descripción
AspMenu	Inserta un menú de ASP.Para obtener más información, vea Información general del control menu.
CssLink	Inserta un elemento LINK en la página .aspx y aplica una o varias hojas de estilos externas definido por CssRegistration.
DateTimeControl	Inserte un control DateTime en la página .aspx.
FormDigest	Inserta una validación de la seguridad en la página .aspx
ListProperty	Devuelve una propiedad de una lista especificada.
ProjectProperty	Devuelve una propiedad global del sitio Web actual.
RssLink	Inserta un vínculo a una fuente RSS en la página .aspx.
ScriptLink	Proporciona propiedades y métodos para registrar recursos, como scripts, en una página para poder aplicar cuando se representa la página.
Tema	Aplica un tema a la página .aspx.

Depurar un elemento web

Puede depurar un proyecto de SharePoint que contiene un elemento web igual que otros proyectos de Visual Studio.Al iniciar el depurador de Visual Studio, Visual Studio abre el sitio de SharePoint.

Para empezar a depurar el código, agregue el elemento web a una página de elementos web en SharePoint.

Para obtener más información sobre la depuración de proyectos de SharePoint, vea Solucionar problemas de soluciones de SharePoint.

Limitaciones visuales del elemento web

A partir de Visual Studio, puede agregar elementos web visuales a las soluciones en espacio aislado de SharePoint y las soluciones de granja.Sin embargo, los elementos web visuales tienen las siguientes limitaciones:

• Elementos web visuales no admiten parámetros reemplazables.Para obtener más información, vea Parámetros reemplazables.

• Los controles de usuario o elementos web visuales no se pueden arrastrar y quitar o copiar sobre elementos web visuales.Esta acción provocará un error de compilación.

• Elementos web visuales no admiten directamente tokens del servidor de SharePoint como $SPUrl.Para obtener más información, vea “Restricciones del token en elementos web en espacio aislado de Visual” en el tema Solucionar problemas de soluciones de SharePoint.

• Elementos web visuales en una solución en espacio aislado obtienen de vez en cuando el error, “la solicitud en espacio aislado de la ejecución del código se rechazó porque el host en espacio aislado Service de código está demasiado ocupado para administrar la solicitud.” Para obtener más información sobre este error, vea el envío en Blog del equipo del desarrollador de SharePoint.

• La depuración de JavaScript de servidor no se admite en Visual Studio, pero se admite la depuración del lado cliente JavaScript.

  Aunque puede agregar JavaScript insertada en un archivo de marcado de Servidor- lado, depuración no se admite para los puntos de interrupción agregados al marcado.Para depurar JavaScript, haga referencia a un archivo externo de JavaScript en el archivo de marcado, y establezca puntos de interrupción en el archivo JavaScript.

• Depuración de código alineado ASP.NET se debe hacer en el archivo generado de código en lugar de en el archivo de marcado.

• Elementos web visuales no admiten el uso de la directiva <@ Assembly Src= .

• Los controles web de SharePoint y algunos controles ASP.NET no se admiten en el entorno de SharePoint en espacio aislado.Si los controles no compatibles se utilizan en un elemento web visual en una solución en espacio aislado, “tema” el error “, del tipo de El o el nombre del espacio de nombres no existe en el espacio de nombres “Microsoft.SharePoint.WebControls”” aparece.

Para obtener más información sobre las soluciones en espacio aislado, vea Diferencias entre soluciones en espacio aislado y soluciones de granja.

Crear elementos web basados en el estilo anterior de SharePoint

Puede utilizar las plantillas de Visual Studio para crear elementos web personalizados ASP.NET 2.0 para SharePoint.Los elementos web deASP.NET 2.0 se compilan sobre la infraestructura web de la parte ASP.NET y son el tipo recomendado para los nuevos proyectos.

En muy pocos casos, puede que tenga que crear un elemento web utilizando la partición SharePoint- basada en web anterior de estilo.Puede utilizar Visual Studio para crear estos tipos de elementos web, pero Visual Studio no proporciona plantillas diseñado específicamente para ayudarle a crearlos.

Para obtener más información sobre cuándo se puede crear un elemento web SharePoint- basada en el estilo anterior de sharepoint, vea Elemento web Infrastructure en Windows SharePoint services.Para obtener más información sobre cómo crear un elemento web utilizando el elemento web SharePoint- basada en el estilo anterior de sharepoint, vea Tutorial que crea un elemento web básico de SharePoint.

Temas relacionados

Título	Descripción
Cómo: Crear un elemento web de SharePoint	Muestra cómo crear partes web para las páginas de SharePoint.
Cómo: Crear un elemento web de SharePoint con un diseñador	Muestra cómo crear los elementos web de SharePoint utilizando una superficie de diseño visual.
Cómo: Crear un control de usuario para una página de aplicación o elemento web de SharePoint	Muestra cómo se crean controles personalizados, los controles reutilizables que pueden usar las páginas de aplicación y los elementos web que se ejecutan en SharePoint.
Tutorial: Crear un elemento web para SharePoint	Describe cómo diseñar un elemento web de SharePoint.
Tutorial: Crear un elemento web para SharePoint mediante un diseñador	Describe cómo diseñar un elemento web de SharePoint arrastrando controles a una superficie de diseño visual.
Tutorial: Crear un elemento web de Silverlight que muestre OData para SharePoint	Describe cómo diseñar un elemento web de SharePoint que hospeda una aplicación Silverlight y muestran datos de listas de SharePoint.
Trabajar con Visual Web Developer	Describe cómo utilizar el diseñador que aparece al abrir una página Web en el proyecto.