Compartir a través de

Introducción a la personalización mediante programación de un sitio web de SharePoint en Visual Studio

  • Artículo

El entorno de desarrollo integrado (IDE) de Microsoft Visual Studio 2005 ofrece el entorno idóneo para personalizar sitios web basados en Windows SharePoint Services. Puede crear, por ejemplo, aplicaciones de Windows, aplicaciones de consola o bibliotecas de clases, además de aplicaciones web basadas en explorador (denominadas "sitio web ASP.NET" o "aplicación web" en Visual Studio) y servicios web que implementen el modelo de objetos de Windows SharePoint Services. El usuario ejecuta el código que usa el espacio de nombres del ensamblado de Microsoft.SharePoint en el servidor donde se ejecuta la implementación, mientras que las aplicaciones que usan los servicios web de SharePoint se ejecutan de manera remota desde un equipo cliente. Para desarrollar las aplicaciones web y los servicios web, podrá ejecutar Visual Studio en el mismo servidor que ejecuta Windows SharePoint Services o en un equipo remoto, tal y como se describe en los siguientes procedimientos.

Nota

Para personalizar Windows SharePoint Services 3.0 a través de su modelo de objetos o de los servicios web, debe usar Visual Studio 2005, no una versión anterior.

Después de determinar el tipo de aplicación que va a crear para su tarea, debe especificar una ubicación adecuada en la que vaya a crear el proyecto. Una vez que haya creado el proyecto, debe establecer una referencia a Microsoft.SharePoint.dll.

Para crear un proyecto, un sitio web ASP.NET o un archivo

  1. Abra Visual Studio y en el menú Archivo, elija Nuevo. Verá una lista desplegable en la que aparecerán Proyecto, Sitio web y Archivo como opciones posibles.

  2. Elija el tipo de aplicación que desea crear:

    • Para crear una aplicación de Windows, una aplicación de consola o una biblioteca de clases, haga clic en Proyecto.

    • Para crear una aplicación web ASP.NET (sitio web) o un servicio web, haga clic en Sitio web.

    • Para crear un archivo individual, como un formulario web, un control de usuario o una página maestra, haga clic en Archivo.

  3. De acuerdo con su selección en el paso 2, realice uno de los siguientes procedimientos en el cuadro de diálogo que se abre.

    Para crear un proyecto en el cuadro de diálogo Proyecto nuevo

    1. En el cuadro Tipos de proyecto, seleccione el idioma y el tipo de proyecto.

    2. En el cuadro Plantillas, seleccione la plantilla adecuada de Visual Studio.

    3. Especifique un nombre y una ubicación para el proyecto, y haga clic en Aceptar.

    Para crear un sitio web en el cuadro de diálogo Nuevo sitio web

    1. En el cuadro Plantillas, elija la plantilla adecuada.

    2. En los cuadros Ubicación e Idioma, seleccione HTTP y el idioma de su elección.

    3. Si va a crear una aplicación web, escriba una ruta de acceso en uno de las siguientes formatos:

      http://MyServer/_layouts/MyApplicationName
http://MyAdminServer:Port#/MyApplicationName

      El primer formato crea la aplicación en \\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\LAYOUTS, y el segundo la crea en \\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\ADMIN. Cree aplicaciones en el directorio administrativo que usa el espacio de nombres Microsoft.Administration para trabajar con la configuración global.

      Si va a crear un servicio web personalizado en el servidor que implementa el modelo de objetos de Windows SharePoint Services, especifique una ruta de acceso de la siguiente forma:

      http://IISWebSiteName:Port#/MyApplicationName

      Para obtener más información acerca de cómo crear un servicio web personalizado que utilice el modelo de objetos de Windows SharePoint Services, consulte Tutorial: creación de un servicio web personalizado.

    4. Haga clic en Aceptar para crear la aplicación. Si recibe un mensaje que indica que la depuración no está habilitada, asegúrese de que la opción Agregue un nuevo archivo Web.config con la depuración habilitada esté seleccionada y haga clic en Aceptar.

    Para crear un archivo en el cuadro de diálogo Nuevo archivo

    1. En el cuadro Categorías, seleccione el idioma de su elección.

    2. En el cuadro Plantillas, seleccione la plantilla adecuada y haga clic en Aceptar.

    3. Si va a crear un control de usuario, copie el archivo .ascx en Local_Drive:\\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\CONTROLTEMPLATES. Si va a crear una página ASPX, copie el archivo .aspx en \\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\LAYOUTS, o en \\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\ADMIN si el código usa el espacio de nombres Microsoft.Administration para modificar la configuración global.

Creación de un sitio web o de un proyecto de manera remota

Si va a escribir código en una instalación de Visual Studio en un equipo remoto, cree un Proyecto o un Sitio web dentro del sistema de archivos del servidor en el que se está ejecutando Windows SharePoint Services. Abra los mismos cuadros de diálogo que se indicaron anteriormente, pero especifique una ruta de acceso en este formato: \\Computer_Name\Drive$\.... Si va a crear una aplicación web, por ejemplo, especifique Sistema de archivos en el cuadro Ubicación y use una ruta de acceso como la siguiente para crear una aplicación dentro del directorio /_layouts virtual: \\Computer_Name\Drive$\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\LAYOUTS\MyApplication.

Especificación de una referencia al ensamblado Microsoft.SharePoint

Después de crear un proyecto, agregue una referencia al ensamblado Microsoft.SharePoint para importar sus espacios de nombres e implementar las características de IntelliSense en el explorador de objetos y en el editor de código.

Para agregar una referencia al ensamblado Microsoft.SharePoint

  1. En el Explorador de soluciones, haga clic con el botón secundario del mouse en el proyecto y, a continuación, haga clic en Agregar referencia en el menú de acceso directo.

  2. En la ficha .NET del cuadro de diálogo Agregar referencia, seleccione Windows SharePoint Services de la lista de componentes y, a continuación, haga clic en Aceptar.

    Para ejecutar o depurar el código que usa el ensamblado Microsoft.SharePoint, debe ejecutar el código en el servidor en el que se ejecuta Windows SharePoint Services. Si está usando Visual Studio 2005 en un equipo remoto, no puede ejecutar o depurar el código que usa el modelo de objetos. Sin embargo, puede establecer una referencia remota al ensamblado para escribir el código y ver el ensamblado Microsoft.SharePoint representado en el editor de código. Para agregar una referencia remota de esta forma, haga lo siguiente:

    • Haga clic en la ficha Examinar del cuadro de diálogo Agregar referencia y vaya al archivo Microsoft.SharePoint.dll en la carpeta \\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\ISAPI en el servidor que está ejecutando Windows SharePoint Services. Copie el archivo Microsoft.SharePoint.dll desde esta carpeta en una unidad local del equipo remoto y, a continuación, abra la copia local del archivo DLL. Para ello, haga clic en Abrir.

IntelliSense

En el IDE de Visual Studio 2005, se proporcionan características de IntelliSense para los espacios de nombres del ensamblado Microsoft.SharePoint después de establecer una referencia a este ensamblado. El archivo que proporciona la información usada por IntelliSense para Windows SharePoint Services es Microsoft.SharePoint.xml, que se encuentra instalado en la ruta de acceso unidad_local:\\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\ISAP en cada servidor cliente web de la implementación. Para obtener las actualizaciones de este archivo, visite el Centro para programadores de Windows SharePoint Services .

Vea también

Otros recursos

Obtención de referencias a sitios, aplicaciones web y otros objetos clave
Determinación de la ubicación de creación de una aplicación personalizada
Temas de procedimientos de Windows SharePoint Services
Trabajar con objetos de listas y colecciones
Tareas de ejemplo con modelos de objetos