* Mis à jour en avril 2016
L'attribut customErrors est utilisé lorsque le code .net lève une exception (404, 403, 500, etc.) et l'attribut httpErrors est utilisé lorsque IIS lui-même lève une exception.
- / myfakeextensionslessurl -> httpErrors 404
- /myfakeaspsx.aspx -> customErrors 404
- /myfakeimage.jpg -> httpErrors 404
- /throw500.apx -> customErrors 500
- / throw500 -> customErrors 500
Il y a de nombreux pièges à essayer de configurer cela correctement. Donc, si vous cherchez un exemple rapide, les 2 meilleures options que vous avez sont:
Exemple 1: Utilisation de pages html
<system.web>
<customErrors mode="RemoteOnly" defaultRedirect="/Error500.html" redirectMode="ResponseRewrite">
<error statusCode="403" redirect="/Error403.html" />
<error statusCode="404" redirect="/Error404.html" />
<error statusCode="500" redirect="/Error500.html" />
</customErrors>
</system.web>
<system.webServer>
<httpErrors errorMode="DetailedLocalOnly" existingResponse="Auto">
<remove statusCode="403" />
<remove statusCode="404" />
<remove statusCode="500" />
<error statusCode="403" responseMode="File" path="Error403.html" />
<error statusCode="404" responseMode="File" path="Error404.html" />
<error statusCode="500" responseMode="File" path="Error500.html" />
</httpErrors>
</system.webServer>
Exemple 2: utilisation de pages aspx
<system.web>
<customErrors mode="RemoteOnly" defaultRedirect="/Error500.html" redirectMode="ResponseRewrite">
<error statusCode="403" redirect="/Error403.aspx" />
<error statusCode="404" redirect="/Error404.aspx" />
<error statusCode="500" redirect="/Error500.aspx" />
</customErrors>
</system.web>
<system.webServer>
<httpErrors errorMode="DetailedLocalOnly" existingResponse="Auto">
<remove statusCode="403" />
<remove statusCode="404" />
<remove statusCode="500" />
<error statusCode="403" responseMode="ExecuteURL" path="Error403.aspx" />
<error statusCode="404" responseMode="ExecuteURL" path="Error404.aspx" />
<error statusCode="500" responseMode="ExecuteURL" path="Error500.aspx" />
</httpErrors>
</system.webServer>
Et dans les pages d'erreur aspx, vous devez faire quelque chose comme ceci (exemple de la page 404):
<%
Response.StatusCode = 404;
Response.TrySkipIisCustomErrors = true;
%>
Remarque: il n'est pas possible d' utiliser l'extension sans URL dans la section customErrors ! . (sans hacks)
Une solution consiste à désactiver les erreurs personnalisées et à laisser les erreurs http gérer la page personnalisée. Un ami a créé une telle configuration, quand je trouverai du temps, je partagerai le code.
Contexte
Une bonne page d'erreur personnalisée:
- Afficher la vraie exception lorsque vous visitez la page du problème localement
- Afficher une page personnalisée lorsque vous visitez la page du problème à distance
- Ne redirigera pas, mais affichera simplement le contenu de la page d'erreur (pour des raisons de référencement)
- Affiche le code d'état correct
Donc, pour clarifier certaines options de notre config:
<customErrors mode="RemoteOnly". Vous pouvez spécifier ici: On, Off, RemoteOnly.
On = Toujours afficher les pages d'erreur personnaliséesOff = Toujours afficher la vraie erreurRemoteOnly= Afficher l'erreur localement, mais afficher la page d'erreur personnalisée à distance. Nous voulons donc RemoteOnlypour la déclaration 1
<customErrors redirectMode="ResponseRewrite". Vous pouvez spécifier ici: ResponseRedirectou ResponseRewrite. Le ResponseRedirectmode redirigera la page d'erreur vers la page d'erreur personnalisée. Pour un robot d'exploration de liens (SEO), cela entraînera 302 -> 500, mais vous voulez que le robot d'exploration de liens obtienne une erreur 500.
<httpErrors errorMode="DetailedLocalOnly". C'est l'équivalent du customErrorsmode. Options que vous avez: Custom, Detailed, DetailedLocalOnly.
Un bon article de blog qui m'a beaucoup aidé est: http://benfoster.io/blog/aspnet-mvc-custom-error-pages