Tutorial: Implementar un documento y un ensamblado en una carpeta local (2003 System)

Artículo
04/28/2010

Actualización: noviembre 2007

Se aplica a
La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office. Tipo de proyecto Proyectos de nivel de documento Versión de Microsoft Office Microsoft Office 2003 Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office.

Tipo de proyecto

Proyectos de nivel de documento

Versión de Microsoft Office

Microsoft Office 2003

Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

Este tutorial muestra cómo implementar una personalización de nivel de documento en una nueva carpeta del equipo de desarrollo, de modo que el documento y el ensamblado estén almacenados en la misma carpeta. Este tipo de implementación se conoce como modelo de implementación de equipo local y equipo local.

Para obtener más información sobre las opciones para implementar la solución, vea Modelos de implementación (2003 System). Para obtener más información sobre las personalizaciones de nivel de documento, vea Arquitectura de las personalizaciones de nivel de documento.

En este tutorial se muestran las siguientes tareas:

Conceder plena confianza a un ensamblado de solución de Visual Studio Tools para Office que está ubicado en una carpeta local.

Requisitos previos

Necesita los componentes siguientes para completar este tutorial:

Visual Studio Tools para Office (componente opcional de Visual Studio 2008 Professional y Visual Studio Team System).

Microsoft Office Word 2003 o Microsoft Office Excel 2003.

Nota:
Este tutorial da por hecho que está implementando una solución de Word. Si desea realizar el tutorial con una solución de Excel, reemplace el nombre del proyecto de Word por el nombre de un proyecto de Excel en todos los ejemplos de código.

Privilegios de administrador en el equipo de desarrollo, con el fin de que pueda establecer la directiva de seguridad.

Crear una solución para implementarla

Como primer paso, cree una solución de Visual Studio Tools para Office básica para su implementación. Si ya tiene una solución que desea implementar, puede omitir esta sección y continuar con "Implementar la solución".

Para crear una solución para implementarla

Cree un proyecto de documento de Word con el nombre WordDeployment, mediante la plantilla de proyecto de Office 2003.

En el asistente, seleccione Crear un nuevo documento. Para obtener más información, vea Cómo: Crear proyectos de Visual Studio para Office.
En el Explorador de soluciones, haga clic con el botón secundario en el archivo de código ThisDocument y, a continuación, haga clic en Ver código.
Agregue el código siguiente al controlador de eventos ThisDocument_Startup. Este código muestra un mensaje cuando se abre el documento, lo cual simplifica la comprobación de si la solución se ha implementado correctamente.
```
MessageBox.Show("The deployment is successful")
```
```
MessageBox.Show("The deployment is successful");
```
Para obtener más información sobre el evento Startup, vea Eventos de proyectos de Visual Studio Tools para Office.
Presione F5 para generar y ejecutar el proyecto. Compruebe que aparece el mensaje.

Implementar la solución

Ahora puede implementar el documento y el ensamblado en una nueva carpeta del equipo de desarrollo.

Para implementar la solución

Cree una carpeta denominada TestDeploy en el directorio raíz de la unidad de sistema de Windows (%SystemDrive%). Por ejemplo, si su unidad de sistema es C, el directorio sería C:\TestDeploy.
Copie el documento y el ensamblado de la carpeta de resultados de la compilación (normalmente carpeta del proyecto\bin\debug o carpeta del proyecto\bin\release) en la carpeta %SystemDrive%\TestDeploy.
Abra el documento en la carpeta %SystemDrive%\TestDeploy. Aparecerá un mensaje de error que indica que la directiva de seguridad actual de .NET no permite que se ejecute la personalización. Esto se debe a que todavía no ha concedido plena confianza al ensamblado.
Haga clic en Aceptar y, a continuación, cierre el documento.

Establecer una directiva de seguridad

Para poder ejecutar la solución, debe otorgar plena confianza al ensamblado en la directiva de seguridad de .NET Framework 2.0. Este tutorial utiliza la herramienta de la directiva de seguridad de acceso a código (Caspol.exe) para conceder plena confianza al ensamblado.

Para obtener más información sobre el uso de Caspol.exe, vea Herramienta de la directiva de seguridad de acceso a código (Caspol.exe) y Configurar directivas de seguridad mediante la herramienta Directiva de seguridad de acceso a código (Caspol.exe).

Nota de seguridad:
Éstos son los pasos básicos para establecer una directiva de seguridad basada en la evidencia de dirección URL con el fin de completar el tutorial. No utilice estos pasos para conceder confianza a los ensamblados en una solución real si no está seguro de que la ubicación es segura. Además, en una solución real debe basar la seguridad en más evidencias que la dirección URL del ensamblado. Para obtener más información, vea Requisitos de seguridad para ejecutar las soluciones de Office (2003 System).

Éstos son los pasos básicos para establecer una directiva de seguridad basada en la evidencia de dirección URL con el fin de completar el tutorial. No utilice estos pasos para conceder confianza a los ensamblados en una solución real si no está seguro de que la ubicación es segura. Además, en una solución real debe basar la seguridad en más evidencias que la dirección URL del ensamblado. Para obtener más información, vea Requisitos de seguridad para ejecutar las soluciones de Office (2003 System).

Para conceder plena confianza al ensamblado

En el símbolo del sistema, escriba el comando siguiente para crear un nuevo grupo de código que otorgue plena confianza al ensamblado. Reemplace ruta de acceso completa al ensamblado por la ruta de acceso completa del ensamblado en el equipo de desarrollo, por ejemplo, C:\TestDeploy\WordDeployment.dll.
```
%windir%\Microsoft.NET\Framework\v2.0.50727\caspol -u -ag All_Code -url "full assembly path" FullTrust -n "Test_Deployment"
```
El parámetro -n especifica un nombre para el nuevo grupo de código. Este parámetro no es necesario, pero al especificar una etiqueta resulta más fácil identificar y quitar posteriormente el nuevo grupo de código después de completar el tutorial.
Escriba sí cuando se le pregunte si confirma que desea realizar la operación y presione ENTRAR.
Abra el documento en la carpeta %SystemDrive%\TestDeploy y compruebe que aparece el mensaje.
Haga clic en Aceptar y, a continuación, cierre el documento.

Pasos siguientes

También puede implementar el documento y el ensamblado en carpetas diferentes del mismo equipo, o implementar el documento y el ensamblado en una carpeta de red. Para obtener más información, vea los tutoriales siguientes: