Plantilla de Visual Studio

Instalación de la plantilla de Visual Studio para ArcGIS Viewer for Silverlight

La plantilla de Microsoft Visual Studio 2010 para ArcGIS Viewer for Silverlight está instalada como parte de ArcGIS Extensibility SDK for Silverlight. La plantilla le permite crear fácilmente add-ins y diseños para el Visor. A pesar de que los proyectos creados con la plantilla se pueden abrir en Microsoft Expression Blend 4, la plantilla solo aparecerá en el cuadro de diálogo de creación del proyecto de Visual Studio 2010. Las versiones anteriores de Visual Studio y Expression Blend no son compatibles.

Requisitos previos

Para utilizar la plantilla del Visor, se requiere lo siguiente:

• Microsoft Visual Studio 2010 o Microsoft Visual Web Developer 2010 Express.
• ArcGIS API for Microsoft Silverlight 2.4.
• Expression Blend 4 SDK.
• Microsoft Silverlight 4 Herramientas para Visual Studio 2010
• Kit de herramientas de Microsoft Silverlight

Contenido de la plantilla de Visual Studio

Las soluciones de Visual Studio creadas desde la plantilla del Visor incluirán tres proyectos. En la siguiente lista, <Nombre del proyecto> significa el nombre del proyecto tal y como se especifica en el cuadro de diálogo Nuevo proyecto. Los proyectos creados como parte de la plantilla son los siguientes:

• <Nombre del proyecto>—Este es un proyecto de sitio Web que contiene una aplicación de Visor totalmente funcional. Este contiene una copia de todos los archivos de configuración que se incluyen con el Visor. Cuando compila la solución, la salida del proyecto AddIns y los diseños en el proyecto Diseños se copian automáticamente a este sitio Web.
• <Nombre del proyecto>.AddIns—Contiene una herramienta simple y el comportamiento para comenzar a escribir su propio add-in. Consulte Crear una herramienta y Crear un comportamiento para obtener más detalles.
• <Nombre del proyecto>.Layouts—Contiene una copia de los diseños predeterminados que se implementan con el Visor. Puede abrirlos en Visual Studio o Expression Blend para modificar su diseño o crear nuevos diseños.
  Nota:

  Para ver los diseños en Blend, primero compile la solución.

Crear y cargar un add-in

Crear un add-in

Para crear un add-in usando la plantilla ArcGIS Viewer for Silverlight, complete los pasos siguientes:

1. Inicie Microsoft Visual Studio 2010.
2. Haga clic en Archivo > Nuevo > Proyecto. Aparece el cuadro de diálogo Nuevo proyecto.
3. En el cuadro de diálogo Nuevo proyecto, expanda Visual C# y, a continuación, expanda el nodo Silverlight.
4. Haga clic en Visor de Esri bajo el nodo Silverlight y seleccione ArcGIS Viewer for Silverlight Project.
5. Escriba un nombre para el proyecto en el cuadro de texto Nombre y haga clic en Aceptar. Consulte la siguiente captura de pantalla:

La solución del add-in se carga con tres proyectos: uno que contiene un código de add-in, uno que contiene los diseños y uno que contiene un sitio Web del Visor. Cada proyecto contiene código y ejemplos para ayudarlo a comenzar a crear herramientas personalizadas, comportamientos y los diseños.

Cargar un add-in

Los pasos siguientes detallan cómo cargar sus add-in en el Application Builder:

1. Una vez que haya creado el add-in en Visual Studio, construya la solución para generar el archivo .xap.
2. En el Application Builder, haga clic en Configuración y, a continuación, haga clic en la pestaña Add-Ins.
3. Haga clic en Cargar Add-Ins y navegue hasta el directorio en el que se encuentra almacenado el archivo .xap. No es necesario que coloque el archivo .xap en el directorio de Builder, ya que el Builder copiará automáticamente el .xap al directorio (por ejemplo, C: \inetpub\wwwroot\Builder\Extensions). Consulte la siguiente captura de pantalla:
   Nota:

   Es posible que obtenga un mensaje de error que indique que "El ensamblado 'xyz' ya está incluido en el tiempo de ejecución de la aplicación" . Esto es simplemente una advertencia, y el add-in aún se cargará correctamente. Para eliminar este error, vuelva a la solución de Visual Studio y asegúrese de que Copiar Local=Falso para esas referencias.

4. Haga clic en el botón Detalles para ver detalles adicionales sobre el paquete del add-in. El cuadro de diálogo Detalles del add-in aparece como se muestra en la siguiente captura de pantalla:
5. Salga de la página Configuración y regrese a la página principal del Application Builder.
6. Haga clic en la pestaña Herramientas y, a continuación, haga clic en el botón Administrar. Aparece el cuadro de diálogo Administrar barras de herramientas.
7. En la lista de Herramientas disponibles en el cuadro de diálogo Administrar barras de herramientas, busque la herramienta y haga clic en el botón Agregar para agregarla a una barra de herramientas específica.
8. Para editar las propiedades de la herramienta, como por ejemplo la información sobre la herramienta o etiqueta, haga clic en el botón Editar; de lo contrario, haga clic en Cerrar. La herramienta se agrega ahora a la barra de herramientas especificada. Además, una vez que implementa la aplicación, se copia el archivo .xap al directorio <Apps\<ViewerName>\Extensions automáticamente (por ejemplo, C: \inetpub\wwwroot\Apps\MyTestViewer\Extensions).

Depurar una add-in

Puede depurar fácilmente un add-in mediante Visual Studio. Depurar un add-in en el Visor se hace mejor al utilizar el proyecto del sitio Web del Visor. Para depurar el add-in en el Application Builder, deberá asociarse al proceso del Application Builder desde Visual Studio.

Depuración utilizando el proyecto del sitio Web del Visor

Completar los pasos siguientes para depurar utilizando el proyecto del sitio Web del Visor:

1. Establezca el proyecto <Nombre del proyecto> como el inicial. Si está utilizando la plantilla que se proporciona, esto se ha hecho para usted.
2. Haga clic en index.htm en el proyecto <Nombre del proyecto> y seleccione Establecer como página de inicio. Visual Studio hará uso de su navegador predeterminado al depurar. Si lo desea, haga clic con el botón derecho en index.htm y haga clic en el botón Examinar con para seleccionar un navegador diferente para la depuración.
3. Haga clic con el botón derecho en el proyecto <Nombre del proyecto> y haga clic en Propiedades.
4. Haga clic en la pestaña Web , y en la sección Depuradores, asegúrese de que la casilla de verificación Silverlight está marcada.
5. Guarde los cambios y cierre la ventana Propiedades.
6. Cree su solución y verifique que la creación tenga éxito.
7. Agregue un punto de corte en la ubicación deseada, y haga clic en Depurar > Empezar a depurar. El Visor inicia en una nueva ventana del navegador.

Depurar en el Application Builder al adjuntar para el proceso

Completar los pasos siguientes para depurar el add-in en el Application Builder de adjuntar a proceso:

1. Cree su solución y verifique que la creación tenga éxito.
2. Añadir un punto de corte en la ubicación deseada.
3. Abrir el Application Builder en el navegador deseado.
4. Cargue el paquete de add-in al Application Builder.
5. En Visual Studio, haga clic en Depurar > Adjuntar a proceso. El cuadro de diálogo Adjuntar a proceso aparece como se muestra en la siguiente captura de pantalla:
6. Haga clic en el botón Seleccionar para especificar la propiedad Adjuntar a. El cuadro de diálogo Seleccionar tipo de código aparece como se muestra en la siguiente captura de pantalla:
7. En el cuadro de diálogo Seleccionar tipo de código, marque la casilla para Silverlight, y haga clic en Aceptar.
8. En el cuadro de diálogo principal Adjuntar a proceso, seleccione el proceso del navegador (por ejemplo, iexplore.exe si utiliza Internet Explorer) que es de tipo Silverlight, y haga clic en Adjuntar.