Orchar Core 创建一个模块化的ASP.NET Core应用程序

您将构建什么？
您将构建一个模块化的ASP.NET Core MVC Web应用程序，类似于Orchard Core附带的示例“Hello World”应用程序。它包括一个Web应用程序和一个模块。Web应用程序提供布局，而模块注册路线并响应主页请求。您可以参考Orchard Core中的以下项目了解更多信息。

• src/OrchardCore.Mvc.Web
• src/OrchardCore.Modules/OrchardCore.Mvc.HelloWorld

您需要什么？
当前版本的.NET SDK。你可以从这里下载https://dotnet.microsoft.com/download.。
一个文本编辑器和一个终端，您可以在其中运行DotNet CLI命令。

创建Orchard Core站点和模块。
有不同的方式可以为Orchard Core创建站点和模块。你可以在这里了解更多关于它们的信息。
在本指南中，我们将使用我们的代码生成模板。您可以使用以下命令安装模板的最新稳定版本：

dotnet new -i OrchardCore.ProjectTemplates::1.0.0-*

创建一个名为OrchardCore.Mvc的空文件夹，该文件夹将包含我们的项目。打开一个终端，导航到该文件夹，然后运行以下命令来创建Web应用程序：

dotnet new ocmvc -n OrchardCore.Mvc.Web

接下来创建Hello World 模块

dotnet new ocmodulemvc -n OrchardCore.Mvc.HelloWorld

提交项目引用

dotnet add OrchardCore.Mvc.Web reference OrchardCore.Mvc.HelloWorld

（可选）如果要在Visual Studio中打开解决方案，可以添加同时引用web应用程序和模块的解决方案文件。

dotnet new sln -n OrchardCore.Mvc
dotnet sln add OrchardCore.Mvc.Web\OrchardCore.Mvc.Web.csproj
dotnet sln add OrchardCore.Mvc.HelloWorld\OrchardCore.Mvc.HelloWorld.csproj

测试这个程序

从包含两个项目的OrchardCore.Mvc根文件夹中，运行以下命令以启动web应用程序：

dotnet run --project .\OrchardCore.Mvc.Web\OrchardCore.Mvc.Web.csproj

您的应用程序现在应该在以下端口上运行和侦听：

Now listening on: https://localhost:5001
Now listening on: http://localhost:5000
Application started. Press Ctrl+C to shut down.

打开链接 https://localhost:5001/OrchardCore.Mvc.HelloWorld/Home/Index 可以看见Hello from OrchardCore.Mvc.HelloWorld.

布局来自主web应用程序项目，而控制器、操作和视图来自模块项目。

注册一个自定义的路由

默认情况下，模块中的所有路由都遵循模式{area}/{controller}/{action}，其中{area}是模块的名称。我们将在模块中更改视图的路径以响应主页请求。

在OrchardCore.Mvc.HelloWorld的Startup.cs文件中，在Configure方法中添加自定义路由。

    routes.MapAreaControllerRoute(
        name: "Home",
        areaName: "OrchardCore.Mvc.HelloWorld",
        pattern: "",
        defaults: new { controller = "Home", action = "Index" }
    );

您还可以在模块的“视图->主”文件夹中更改Index.cshtml文件，使其显示Hello World，类似于Orchard Core中的项目。

<h1>Hello World</h1>

重新启动应用程序并导航到主页（位于https://localhost:5001 显示Hello World消息。）

总结

您刚刚使用Orchard Core创建了一个模块化ASP.NET Core MVC web应用程序。它包括一个提供布局的web应用程序和一个响应主页请求的自定义模块