Modèle Visual Studio
Installation du modèle Visual Studio pour ArcGIS Viewer for Silverlight
Le modèle Microsoft Visual Studio 2010 pour ArcGIS Viewer for Silverlight est installé dans le cadre du SDK d'extensibilité ArcGIS for Silverlight. Il vous permet de créer facilement des compléments et des mises en page pour la visionneuse. Bien que les projets créés avec le modèle puissent s'ouvrir dans Microsoft Expression Blend 4, le modèle n'apparaît que dans la boîte de dialogue de création d'un projet de Visual Studio 2010. Les versions antérieures de Visual Studio et d'Expression Blend ne sont pas prises en charge.
Conditions requises
Pour utiliser le modèle de visionneuse, les composants suivants sont nécessaires :
Contenu du modèle Visual Studio
Les solutions Visual Studio créées à partir du modèle de visionneuse comprennent trois projets. Dans la liste ci-dessous, <Project Name> indique le nom du projet tel qu'il a été spécifié dans la boîte de dialogue Nouveau projet. Les projets créés dans le cadre du modèle sont les suivants :
- <Project Name> : il s'agit d'un projet de site Web contenant une application de visionneuse entièrement fonctionnelle. Il contient une copie de tous les fichiers de configuration qui sont inclus avec la visionneuse. Lorsque vous compilez la solution, la sortie du projet AddIns et les mises en page du projet Layouts sont automatiquement copiées sur ce site Web.
- <Project Name>.AddIns : contient un outil simple et un comportement pour vous aider à écrire votre propre complément. Reportez-vous aux rubriques Création d'un outil et Création d'un comportement pour en savoir plus.
- <Project Name>.Layouts : contient une copie des mises en page par défaut qui sont déployées avec la visionneuse. Vous pouvez les ouvrir dans Visual Studio ou dans Microsoft Expression Blend pour modifier leur conception ou créer de nouvelles mises en page.
Remarque :Pour consulter les mises en page dans Blend, compilez d'abord la solution.
Création et chargement d'un complément
Création d'un complément
Pour créer un complément avec le modèle d'ArcGIS Viewer for Silverlight, procédez comme suit :
- Démarrez Microsoft Visual Studio 2010.
- Cliquez sur Fichier > Nouveau > Projet. La boîte de dialogue Nouveau projet s'affiche.
- Dans la boîte de dialogue Nouveau projet, développez Visual C#, puis le nœud Silverlight.
- Cliquez sur ESRI Viewer sous le nœud Silverlight et sélectionnez Projet ArcGIS Viewer for Silverlight.
- Saisissez un nom pour le projet dans la zone de texte Nom, puis cliquez sur OK. Reportez-vous à la capture d'écran suivante :
La solution du complément se charge avec trois projets : un projet contenant le code du complément, un autre contenant les mises en page et le dernier contenant le site Web d'une visionneuse. Chaque projet renferme du code et des exemples pour vous aider à créer des outils, des mises en page et des comportements personnalisés.
Chargement d'un complément
Pour charger votre complément dans Application Builder, procédez comme suit :
- Une fois que vous avez créé votre complément dans Visual Studio, créez la solution pour générer le fichier .xap.
- Dans Application Builder, cliquez sur Paramètres, puis sélectionnez l'onglet Compléments.
- Cliquez sur Charger des compléments et accédez au répertoire dans lequel se trouve votre fichier .xap. Vous n'avez pas besoin de placer le fichier .xap dans le répertoire Builder, car ce dernier copiera automatiquement le fichier .xap dans le répertoire (par exemple, C:\inetpub\wwwroot\Builder\Extensions). Reportez-vous à la capture d'écran suivante :
Remarque :Un message d'erreur indiquant "L'assembly 'xyz' est déjà incluse dans l'exécution de l'application" peut apparaître. Ce n'est qu'un simple avertissement qui n'empêchera pas le complément de se charger. Pour supprimer ce message d'erreur, retournez dans votre solution Visual Studio et assurez-vous que Copy Local=False pour ces références.
- Cliquez sur le bouton Détails pour afficher d'autres informations sur le paquetage de compléments. La boîte de dialogue Détails du complément s'ouvre comme illustrée par la capture d'écran suivante :
- Quittez la page Paramètres et revenez dans la page principale d'Application Builder.
- Cliquez sur l'onglet Outils, puis sur le bouton Gérer. La boîte de dialogue Gérer les barres d'outils apparaît.
- Dans la liste Outils disponibles de la boîte de dialogue Gérer les barres d'outils, localisez votre outil et cliquez sur le bouton Ajouter pour l'ajouter à une barre d'outils en particulier.
- Pour modifier les propriétés de l'outil, par exemple l'info-bulle ou l'étiquette, cliquez sur le bouton Modifier. Sinon, cliquez sur Fermer. Votre outil est maintenant ajouté à la barre d'outils spécifiée. En outre, lorsque vous déployez votre application, le fichier .xap est copié automatiquement dans le répertoire Apps\<ViewerName>\Extensions (par exemple, C:\inetpub\wwwroot\Apps\MyTestViewer\Extensions).
Débogage d'un complément
Vous pouvez facilement déboguer un complément avec Visual Studio. Le débogage d'un complément dans la visionneuse est plus efficace avec le projet du site Web de la visionneuse. Pour déboguer le complément dans Application Builder, vous devez utiliser la méthode Attacher au processus d'Application Builder depuis Visual Studio.
Débogage avec le projet du site Web de la visionneuse
Pour déboguer avec le projet du site Web de la visionneuse, procédez comme suit :
- Définissez le projet <Project Name> comme projet de démarrage. Si vous utilisez le modèle fourni, cette étape a été effectuée pour vous.
- Cliquez avec le bouton droit sur index.htm dans le projet <Project Name> et sélectionnez Définir comme page de démarrage. Visual Studio utilisera votre navigateur par défaut lors du débogage. Si vous le souhaitez, cliquez avec le bouton droit sur index.htm, puis sélectionnez Naviguer avec pour effectuer le débogage avec un autre navigateur.
- Cliquez avec le bouton droit sur le projet <Project Name> et sélectionnez Propriétés.
- Cliquez sur l'onglet Web, puis dans la section Débogueurs, vérifiez que la case Silverlight est cochée.
- Enregistrez les changements et fermez la fenêtre Propriétés.
- Créez votre solution et vérifiez que la conception a réussi.
- Ajoutez un point d'arrêt à l'emplacement souhaité et cliquez sur Déboguer > Démarrer le débogage. La visionneuse se lance dans une nouvelle fenêtre de navigateur.
Débogage dans Application Builder avec la méthode Attacher au processus
Pour déboguer le complément dans Application Builder à l'aide de la méthode Attacher au processus, procédez comme suit :
- Créez votre solution et vérifiez que la conception a réussi.
- Ajoutez un point d'arrêt à l'emplacement souhaité.
- Ouvrez Application Builder dans le navigateur voulu.
- Chargez le paquetage de compléments dans Application Builder.
- Dans Visual Studio, cliquez sur Déboguer > Attacher au processus. La boîte de dialogue Attacher au processus s'ouvre comme l'illustre la capture d'écran suivante :
- Cliquez sur le bouton Sélectionner pour indiquer la propriété Attacher à. La boîte de dialogue Sélectionner le type de code s'ouvre comme l'illustre la capture d'écran suivante :
- Dans la boîte de dialogue Sélectionner le type de code, cochez la case Silverlight et cliquez sur OK.
- Dans la boîte de dialogue principale Attacher au processus, sélectionnez le processus du navigateur (par exemple, iexplore.exe si vous utilisez Internet Explorer) dont le type est Silverlight, puis cliquez sur Attacher.