• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    公众号

ASP.NETCore1.0基础之诊断

原作者: [db:作者] 来自: [db:来源] 收藏 邀请

来源https://docs.asp.net/en/latest/fundamentals/diagnostics.html

ASP.NET Core 1.0包含了一些新的特性来辅助诊断问题。可以在Startup类中轻易地配置不同的handler来处理应用程序错误,显示额外信息。

配置错误处理页面##

ASP.NET Core 1.0中可以在Startup类的Configure方法中为每个Request请求配置处理管道。在开发中,你可以非常方便地配置一个简单的错误处理页面。你只需要添加项目对Microsoft.AspNet.Diagnostics的依赖,然后在Configure方法中添加一行代码。

using Microsoft.AspNet.Builder;
using Microsoft.AspNet.Diagnostics;
using Microsoft.AspNet.Hosting;
using Microsoft.AspNet.Http;
using System;
using Microsoft.Extensions.DependencyInjection;

namespace DiagDemo
{
    public class Startup
    {
        // For more information on how to configure your application, visit http://go.microsoft.com/fwlink/?LinkID=398940
        public void ConfigureServices(IServiceCollection services)
        {
        }

        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (string.Equals(env.EnvironmentName, "Development", StringComparison.OrdinalIgnoreCase))
            {
                app.UseDeveloperExceptionPage();

                app.UseRuntimeInfoPage(); // default path is /runtimeinfo
            }
            else
            {
                // specify production behavior for error handling, for example:
                // app.UseExceptionHandler("/Home/Error");
                // if nothing is set here, exception will not be handled.
            }

            app.UseWelcomePage("/welcome");

            app.Run(async (context) =>
            {
                if(context.Request.Query.ContainsKey("throw")) throw new Exception("Exception triggered!");
                context.Response.ContentType = "text/html";
                await context.Response.WriteAsync("<html><body>Hello World!");
                await context.Response.WriteAsync("<ul>");
                await context.Response.WriteAsync("<li><a href=\"/welcome\">Welcome Page</a></li>");
                await context.Response.WriteAsync("<li><a href=\"/?throw=true\">Throw Exception</a></li>");
                await context.Response.WriteAsync("</ul>");
                await context.Response.WriteAsync("</body></html>");
            });
        }
    }
}

如上代码是在ASP.NET Core 1.0中的空模板中创建的,只包含了简单异常处理产生机制(在36行)。如果querystring的“throw” key的值不为空,就会抛出异常。然后会调用21行的UseDeveloperExceptionPage方法,来调用中间件。

注意到调用UseDeveloperExceptionPage在包含在if代码块中间的,会先检查当前环境。这是很好的实践方式,因为你可能不愿意在生产环境中公开展示程序诊断信息。if语句会使用ASPNET_ENV环境变量,如果你使用的VS2015,你可以在web项目属性中自定义环境变量。如下

将ASPNET_ENV 设置任何非Development的值,应用都不会调用UseDeveloperExceptionPage方法,而是返回500错误(没有任何详细信息,除非你配置了UseExceptionHandler())。
在下面我们会看到error page所提供的特性(确保ASPNET_ENV被设置回Development)。

在开发中使用error page##

在web处理管道中发生未处理异常时,默认error page会显示一些有用的诊断信息。error page有几个tab来显示请求中异常相关的信息。第一个tab显示stack trace

第二tab显示Querystring 相关的信息

如上,你可以看到请求中传递的throw参数的值。本次请求没有cookie,如果有的话,会在Cookies tab中。你可以看到传递的headers的值,如下。

Note: 当前pre-release版本,ErrorPage的Cookies部分还不可用。详见ErrorPage Source

Azure上的Http 500错误##

运行时info page##

除了配置和显示错误页面外,你也可以通过调用扩展方法UseRuntimeInfoPage来添加运行时信息页面。如下代码,就可以开启该功能。

app.UseRuntimeInfoPage();

一旦添加了如上代码,你就可以输入/runtimeinfo来查看运行时信息、包信息等。如下。

当然这个请求路径是可以更改的,你可以在调用UseRuntimeInfoPage()方法时指定。这个方法接收一个 RuntimeInfoPageOptions实例作为参数,它有一个Path属性。例如,指定/info路径,你可以像如下调用UseRuntimeInfoPage。

app.UseRuntimeInfoPage("/info")

同UseDeveloperExceptionPage()扩展方法一样,限制公共对诊断信息的获取。因此本例中,值在开发环境中调用UseRuntimeInfoPage()方法。
Note:记住Startup类中的Configure方法定义的管道对所有的请求都是有效的,因此管道配置顺序是很重要的。例如,如果你把UseRuntimeInfoPage()的调用放在app.Run()之后,则该方法是不会被调用的。因为app.Run会在调用UseRuntimeInfoPage之前处理请求。

welcome页面##

另一个有用的扩展方法是UseWelcome(),尤其是你在第一次运行ASP.NET Core 1.0程序时。配置如下。

app.UseWelcome()

一旦调用该方法,它会处理所有请求,并返回很cool的hello页面(默认情况下)。如下。

你也可以配置欢迎页面只响应某些路径(和UseRuntimeInfoPage类似)。如下代码配置了欢迎页面只响应/welcome路径(别的请求路径将会忽略,转交给下个管道handler)。

app.UseWelcomePage("/welcome");

按照本文如上配置Configure方法,将会按如下方式响应请求。

Path Result
/runtimeinfo UseRuntimeInfoPage will handle and display runtime info page
/welcome UseWelcomePage will handle and display welcome page
paths without ?throw= app.Run() will respond with “Hello World!”
paths with ?throw= app.Run() throws an exception; UseErrorPage handles, displays an error page

Summary##

在ASP.NET Core 1.0中,你可以很简单的添加error page,查看diagnostic信息,或者简单的响应一个欢迎页面。


鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
上一篇:
关于ASP.Net的导入导出的(2)发布时间:2022-07-10
下一篇:
ASP.NET状态管理发布时间:2022-07-10
热门推荐
热门话题
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap