ASP.NETコアシリーズ(2):最初のネットのコアを作成するプロジェクト

.NETのコアの紹介と開発環境のインストールを思い出して、完全なASP.NETコアシリーズのASP.NETコア2.0プロジェクトの構造についてお話します。この章:https://www.cnblogs.com/zhangweizhong/category/ 1477144.html

 

新プロジェクト

新規プロジェクトを選択し、.NETのコアのオプション、すなわちコンソール、ASP.NETコア空のプロジェクトのいくつかの種類があり、ウェブAPI

私たちは、MVCは、カミソリページプロジェクトを使用することであるとマークされていない、ASP.NET Webアプリケーションのコア(MVC)を選択しました。

 

プログラム構造。

実質的に類似し、以下に示す新しいプロジェクト構造、FrameworkとASP.NETのバージョン、コントローラ、モデル、ビューが導入されていません。

様々なファイルは、物品の後ろに行うために使用されている概要は、詳細な調査を行います。

launchSettings.json

名前が示すように、以下に示すように、これはJSONスタートアップコンフィギュレーションファイルの形式は、次のとおりです。

{
  "iisSettings": {
    "windowsAuthentication": false, 
    "anonymousAuthentication": true, 
    "iisExpress": {
      "applicationUrl": "http://localhost:9452",
      "sslPort": 44379
    }
  },
  "profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "MyFirstCore": {
      "commandName": "Project",
      "launchBrowser": true,
      "applicationUrl": "https://localhost:5001;http://localhost:5000",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

 图的上部分对应json中的profiles中定义的两种配置,分别以IIS Express。基本上都是Web服务器比如URL、身份认证以及SSL等配置。

 

wwwroot

wwwroot它包含了所有的"前端"的静态文件,  css、image、JS以及一个名为lib的文件夹。

lib中默认内容是bootstrap和jquery。

在Startup中,会调用UseStaticFiles()方法, 将此目录标记到网站根目录。

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    //.....        
    app.UseStaticFiles();
    //.....

}

具体静态文件的路径及相关自定义配置, 授权等后文详细研究。

 

依赖项

整个项目依赖引用的类库,这里主要分两部分, NuGet和SDK, 目前这两部分下面都只有一项.

Nuget:

包含Microsoft.AspNetCore.App, 展开它看一下, 里面MVC、Razor、EF以及SQLLite都要,

它包含了

  • ASP.NET Core 团队支持的所有包。
  • Entity Framework Core 支持的所有包。
  • ASP.NET Core 和 Entity Framework Core 使用的内部和第三方依赖关系。 

这里面是完整的AspNetCore的类库,其实这些程序集不会随着项目发布一起出现在部署包中, 不止没引用的, 包括引用的也不会. 这些已经存在于部署环境中了, 所以发布包不会变大反而会变小, 不必担心.

SDK:

SDk中包含了一项: Microsoft.NETCore.App, 它是.NET Core 的部分库。 也就是 .NETCoreApp 框架。 它依赖于更小的 NETStandard.Library

相对于上面的Microsoft.AspNetCore.App, 它同样是包含了一些程序集.但它似乎更"基础"一些.

二者异同

Microsoft.AspNetCore.App中大部分都是Microsoft.开头的一些程序集, 而Microsoft.NETCore.App中出现的大多数是我们熟悉的system.XXX的.

二者的关系就像ASP.NET相对于.NET, 此处是Asp.NetCore相对于.Net Core. 

SDK同样是一个大而全的集和, 在部署的时候, SDK中的引用依然不会出现在部署包中。

 

appsettings.json

这就是原来的framework版本的MVC的Web.config文件,里面会配置系统相关的所有的配置项,比如数据库连接等。

默认情况appsettings.json只有对于log日志的相关配置。这里就不一一说明了。

{
  "Logging": {
    "LogLevel": {
      "Default": "Warning"
    }
  },
  "AllowedHosts": "*"
}

 

Program.cs

public class Program
{
    public static void Main(string[] args)
    {
        BuildWebHost(args).Run();
    }

    public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>()
}

这里是简单的Main方法, 也就是应用的启动的入口, 启动后通过UseStartup<Startup>()指定下文的Startup启动文件进行启动。

 

Startup.cs

这是Mvc Core非常重要的地方, 包括加载配置, 通过依赖注入加载组件, 注册路由等都在此处进行。

默认的代码中:

public class Startup
    {
        public Startup(IConfiguration configuration)
        {
            Configuration = configuration;
        }

        public IConfiguration Configuration { get; }

        // This method gets called by the runtime. Use this method to add services to the container.
        public void ConfigureServices(IServiceCollection services)
        {
            services.Configure<CookiePolicyOptions>(options =>
            {
                // This lambda determines whether user consent for non-essential cookies is needed for a given request.
                options.CheckConsentNeeded = context => true;
                options.MinimumSameSitePolicy = SameSiteMode.None;
            });


            services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            else
            {
                app.UseExceptionHandler("/Home/Error");
                app.UseHsts();
            }

            app.UseHttpsRedirection();
            app.UseStaticFiles();
            app.UseCookiePolicy();

            app.UseMvc(routes =>
            {
                routes.MapRoute(
                    name: "default",
                    template: "{controller=Home}/{action=Index}/{id?}");
            });
        }
    }

如上图所示, 默认情况下设置了两种不同状态下的错误页, 指定静态文件并且设置了路由。

在这里, 我们可以向管道中通过中间件的方式插入我们需要的工作内容。

比如我们还可以用app.UseAuthentication()来做身份验证。

 

我们使用 UseRun 和 Map 来配置 HTTP 管道。 

Use 方法可使管道短路(即不调用 next 请求委托)。 

Run 是一种约定,并且某些中间件组件可公开在管道末尾运行的 Run[Middleware] 方法。

Map* 扩展用作约定来创建管道分支。

 

此处涉及内容非常多, 比如管道机制、路由注册、身份认证等都需要专题研究。

 

小结

项目的结构大体就是这样,主要功能介绍完了,后面会一个一个详细介绍各自的功能和作用。

 

おすすめ

転載: www.cnblogs.com/zhangweizhong/p/10978440.html