Événements
31 mars, 23 h - 2 avr., 23 h
L’événement de la communauté Microsoft Fabric, Power BI, SQL et AI ultime. 31 mars au 2 avril 2025.
Inscrivez-vous aujourd’huiCe navigateur n’est plus pris en charge.
Effectuez une mise à niveau vers Microsoft Edge pour tirer parti des dernières fonctionnalités, des mises à jour de sécurité et du support technique.
Notes
Ceci n’est pas la dernière version de cet article. Pour la version actuelle, consultez la version .NET 9 de cet article.
Avertissement
Cette version d’ASP.NET Core n’est plus prise en charge. Pour plus d’informations, consultez la stratégie de support .NET et .NET Core. Pour la version actuelle, consultez la version .NET 9 de cet article.
Important
Ces informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft n’offre aucune garantie, expresse ou implicite, concernant les informations fournies ici.
Pour la version actuelle, consultez la version .NET 9 de cet article.
Cet article décrit la prise en charge de Visual Studio pour le débogage des applications ASP.NET Core s’exécutant avec IIS sur Windows Server. Cette rubrique présente ce scénario et la configuration d’un projet.
L’installation d’IIS peut nécessiter un redémarrage du système.
IIS doit avoir un site web configuré avec les éléments suivants :
localhost
. Toutefois, n’importe quel site web IIS valide avec un nom d’hôte unique fonctionnera.Lancez le programme d’installation de Visual Studio.
Sélectionnez Modifier pour l’installation de Visual Studio que vous souhaitez utiliser dans le cadre de la prise en charge IIS lors du développement.
Pour la charge de travail ASP.NET et développement web, recherchez et installez le composant Prise en charge IIS lors du développement.
Le composant se trouve dans la section Facultatif, sous Prise en charge IIS lors du développement, dans le volet Détails de l’installation à droite des charges de travail. Ce composant installe le module ASP.NET Core, qui est un module IIS natif nécessaire à l’exécution des applications ASP.NET Core avec IIS.
Pour un nouveau projet qui exige le protocole HTTPS, cochez la case Configurer pour HTTPS dans la fenêtre Créer une application web ASP.NET Core afin d’ajouter Redirection HTTPS et intergiciel HSTS à l’application lors de sa création.
Pour un projet existant qui exige le protocole HTTPS, utilisez Redirection HTTPS et middleware HSTS dans Startup.Configure
. Pour plus d’informations, consultez Appliquer HTTPS dans ASP.NET Core.
Pour un projet qui utilise le protocole HTTP, Redirection HTTPS et middleware HSTS ne sont pas ajoutés à l’application. Aucune configuration de l’application n’est nécessaire.
Créez un profil de lancement pour ajouter la prise en charge d’IIS pendant le développement :
Cliquez avec le bouton droit sur le projet dans l’Explorateur de solutions. Sélectionner Propriétés. Ouvrez l’onglet Déboguer.
Pour Profil, sélectionnez le bouton Nouveau. Nommez le profil « IIS » dans la fenêtre contextuelle. Sélectionnez OK pour créer le profil.
Pour le paramètre Lancer, sélectionnez IIS dans la liste.
Cochez la case Lancer le navigateur et indiquez l’URL du point de terminaison.
Lorsque le protocole HTTPS est requis par l’application, utilisez un point de terminaison HTTPS (https://
). Pour HTTP, utilisez un point de terminaison HTTP (http://
).
Indiquez le nom d’hôte et le port utilisés par la configuration IIS spécifiée précédemment, en général localhost
.
Indiquez le nom de l’application à la fin de l’URL.
Par exemple, https://localhost/WebApplication1
(HTTPS) ou http://localhost/WebApplication1
(HTTP) sont des URL de point de terminaison valide.
Dans la section Variables d’environnement, sélectionnez le bouton Ajouter. Indiquez une variable d’environnement ayant pour NomASPNETCORE_ENVIRONMENT
et pour ValeurDevelopment
.
Dans la zone Paramètres de serveur web, donnez à URL de l’application la valeur utilisée pour l’URL du point de terminaison Lancer le navigateur.
Pour le paramètre Modèle d’hébergement dans Visual Studio 2019 (ou version ultérieure), sélectionnez Par défaut afin d’utiliser le modèle d’hébergement du projet. C’est la valeur de la propriété <AspNetCoreHostingModel>
(InProcess
ou OutOfProcess
) qui est employée si elle est définie par le projet dans son fichier de projet. En l’absence de cette propriété, le modèle d’hébergement par défaut de l’application est utilisé in-process. Si l’application réclame un paramètre de modèle d’hébergement explicite autre que son modèle normal, définissez le Modèle d’hébergement sur In Process
ou Out Of Process
en fonction des besoins.
Enregistrez le profil.
Si vous n’utilisez pas Visual Studio, ajoutez manuellement un profil de lancement au fichier launchSettings.json dans le dossier Propriétés. L’exemple suivant configure le profil de façon à utiliser le protocole HTTPS :
{
"iisSettings": {
"windowsAuthentication": false,
"anonymousAuthentication": true,
"iis": {
"applicationUrl": "https://localhost/WebApplication1",
"sslPort": 0
}
},
"profiles": {
"IIS": {
"commandName": "IIS",
"launchBrowser": true,
"launchUrl": "https://localhost/WebApplication1",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
}
}
}
}
Vérifiez que les points de terminaison applicationUrl
et launchUrl
coïncident et utilisent le même protocole que la configuration de liaison IIS, c’est-à-dire HTTP ou HTTPS.
Exécutez Visual Studio en tant qu’administrateur :
Visual Studio peut demander un redémarrage si vous ne l’exécutez pas en tant qu’administrateur. Si vous y êtes invité, redémarrez Visual Studio.
Si vous utilisez un certificat de développement non approuvé, le navigateur peut vous amener à créer une exception pour ce certificat.
Notes
Le débogage d’une configuration de build de mise en production avec Uniquement mon code et des optimisations du compilateur entraîne une baisse des résultats. Par exemple, les points d’arrêt ne sont pas atteints.
Cet article décrit la prise en charge de Visual Studio pour le débogage des applications ASP.NET Core s’exécutant avec IIS sur Windows Server. Cette rubrique présente ce scénario et la configuration d’un projet.
L’installation d’IIS peut nécessiter un redémarrage du système.
IIS doit avoir un site web configuré avec les éléments suivants :
localhost
. Toutefois, n’importe quel site web IIS valide avec un nom d’hôte unique fonctionnera.Lancez le programme d’installation de Visual Studio.
Sélectionnez Modifier pour l’installation de Visual Studio que vous souhaitez utiliser dans le cadre de la prise en charge IIS lors du développement.
Pour la charge de travail ASP.NET et développement web, recherchez et installez le composant Prise en charge IIS lors du développement.
Le composant se trouve dans la section Facultatif, sous Prise en charge IIS lors du développement, dans le volet Détails de l’installation à droite des charges de travail. Ce composant installe le module ASP.NET Core, qui est un module IIS natif nécessaire à l’exécution des applications ASP.NET Core avec IIS.
Pour un nouveau projet qui exige le protocole HTTPS, cochez la case Configurer pour HTTPS dans la fenêtre Créer une application web ASP.NET Core afin d’ajouter Redirection HTTPS et intergiciel HSTS à l’application lors de sa création.
Pour un projet existant qui exige le protocole HTTPS, utilisez Redirection HTTPS et middleware HSTS dans Startup.Configure
. Pour plus d’informations, consultez Appliquer HTTPS dans ASP.NET Core.
Pour un projet qui utilise le protocole HTTP, Redirection HTTPS et middleware HSTS ne sont pas ajoutés à l’application. Aucune configuration de l’application n’est nécessaire.
Créez un profil de lancement pour ajouter la prise en charge d’IIS pendant le développement :
Cliquez avec le bouton droit sur le projet dans l’Explorateur de solutions. Sélectionner Propriétés. Ouvrez l’onglet Déboguer.
Pour Profil, sélectionnez le bouton Nouveau. Nommez le profil « IIS » dans la fenêtre contextuelle. Sélectionnez OK pour créer le profil.
Pour le paramètre Lancer, sélectionnez IIS dans la liste.
Cochez la case Lancer le navigateur et indiquez l’URL du point de terminaison.
Lorsque le protocole HTTPS est requis par l’application, utilisez un point de terminaison HTTPS (https://
). Pour HTTP, utilisez un point de terminaison HTTP (http://
).
Indiquez le nom d’hôte et le port utilisés par la configuration IIS spécifiée précédemment, en général localhost
.
Indiquez le nom de l’application à la fin de l’URL.
Par exemple, https://localhost/WebApplication1
(HTTPS) ou http://localhost/WebApplication1
(HTTP) sont des URL de point de terminaison valide.
Dans la section Variables d’environnement, sélectionnez le bouton Ajouter. Indiquez une variable d’environnement ayant pour NomASPNETCORE_ENVIRONMENT
et pour ValeurDevelopment
.
Dans la zone Paramètres de serveur web, donnez à URL de l’application la valeur utilisée pour l’URL du point de terminaison Lancer le navigateur.
Pour le paramètre Modèle d’hébergement dans Visual Studio 2019 (ou version ultérieure), sélectionnez Par défaut afin d’utiliser le modèle d’hébergement du projet. C’est la valeur de la propriété <AspNetCoreHostingModel>
(InProcess
ou OutOfProcess
) qui est employée si elle est définie par le projet dans son fichier de projet. En l’absence de cette propriété, le modèle d’hébergement par défaut de l’application est utilisé hors processus. Si l’application réclame un paramètre de modèle d’hébergement explicite autre que son modèle normal, définissez le Modèle d’hébergement sur In Process
ou Out Of Process
en fonction des besoins.
Enregistrez le profil.
Si vous n’utilisez pas Visual Studio, ajoutez manuellement un profil de lancement au fichier launchSettings.json dans le dossier Propriétés. L’exemple suivant configure le profil de façon à utiliser le protocole HTTPS :
{
"iisSettings": {
"windowsAuthentication": false,
"anonymousAuthentication": true,
"iis": {
"applicationUrl": "https://localhost/WebApplication1",
"sslPort": 0
}
},
"profiles": {
"IIS": {
"commandName": "IIS",
"launchBrowser": true,
"launchUrl": "https://localhost/WebApplication1",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
}
}
}
}
Vérifiez que les points de terminaison applicationUrl
et launchUrl
coïncident et utilisent le même protocole que la configuration de liaison IIS, c’est-à-dire HTTP ou HTTPS.
Exécutez Visual Studio en tant qu’administrateur :
Visual Studio peut demander un redémarrage si vous ne l’exécutez pas en tant qu’administrateur. Si vous y êtes invité, redémarrez Visual Studio.
Si vous utilisez un certificat de développement non approuvé, le navigateur peut vous amener à créer une exception pour ce certificat.
Notes
Le débogage d’une configuration de build de mise en production avec Uniquement mon code et des optimisations du compilateur entraîne une baisse des résultats. Par exemple, les points d’arrêt ne sont pas atteints.
Commentaires sur ASP.NET Core
ASP.NET Core est un projet open source. Sélectionnez un lien pour fournir des commentaires :
Événements
31 mars, 23 h - 2 avr., 23 h
L’événement de la communauté Microsoft Fabric, Power BI, SQL et AI ultime. 31 mars au 2 avril 2025.
Inscrivez-vous aujourd’hui