DotNET框架

EF CodeFirst对数据库任何的操作，千万不要手工去修改。 解释：add-migration命令是code first migration中的关键命令之一。当您对领域域模型进行更改并需要将它们时添加到数据库中，您将创建一个新的迁移。这是通过Add-Migration命令完成的。用最简单的形式，你只需要提供迁移名称 展现形式：命令将您的更改构建到一个cs文件中。这个cs文件与配置文件放在同一个文件夹中，服务于您要瞄准的DbContext 1.常用的命令： Add-Migration 、 Update-DataBase 、 Script-Migration (1)vs的程序包管理控制台输入 get-help Add-Migration -detailed以查看详细信息 Add-Migration [-Name] ：指定自定义脚本 的名字 [-Force] [-ProjectName ] ：如果要重新构建现有迁移，必须使用-Force参数。然而，只有在迁移尚未应用到数据库时，才能重新构建框架。否则你 需要回复到要重新构建的迁移之前的迁移 [-StartUpProjectName ] ：是从 解决方案资源管理器中选择一个项目 作为启动项目。如果我们忽略的话，就会默认为解决方案资源管理器中的启动项目。 [-ConfigurationTypeName ] ：项目中有多个DbContext，那么您需要指出哪个数据库会更新。这可以用-ConfigurationTypeName做。ConfigurationTypeName方法是迁移文件夹中配置类的名称。 [-ConnectionStringName ] ：从应用程序的配置文件中指定要使用的连接字符串的名字。我们用两个参数-ConnectionString -ConnectionProviderName ，或者用这样一个参数代替 [-IgnoreChanges] ：假设目标数据库模式与当前的模型是一致的。构建一个空迁移和对应的空的迁移文件，忽略在当前模型中检测到的任何挂起的更改。可用于创建初始的空迁移，以支持对现有数据库的迁移。 [-AppDomainBaseDirectory ]：指定用于运行数据迁移代码的app-domain的路径，从而app-domain 可以找到所有需要的程序集。这是一个高级选项，只有当解决方案包含多个项目时才会需要。这样的话，context和configuration所需要的程序集就不仅仅从那些包含context和包含migrations的项目中获取 CommonParameters Add-Migration （你的迁移文件名称） 若在一个项目里，操作多个DbConext的方法则需要指定context名称 add-migration 迁移名称 -c ConfigurationDbContext update-database -c ConfigurationDbContext

MediatR is a low-ambition library trying to solve a simple problem — decoupling the in-process sending of messages from handling messages. Cross-platform, supporting netstandard2.0. Setup Install the package via NuGet first: Install-Package MediatR MediatR directly references Microsoft.Extensions.DependencyInjection.Abstractions leveraging IServiceProvider. Typical usage is to use IServiceCollection directly: services.AddMediatR(cfg => { cfg.RegisterServicesFromAssembly(typeof(Program).Assembly); }); This method registers the known MediatR types: IMediator as transient ISender as transient IPublisher as transient For each assembly registered, the AddMediatR method will scan those assemblies for MediatR types (excluding behaviors): ...

Microsoft 生成引擎是一个用于生成应用程序的平台。 此引擎（也称为 MSBuild）为项目文件提供了一个 XML 架构，用于控制生成平台处理和生成软件的方式。 Visual Studio 会使用 MSBuild，但 MSBuild 不依赖于 Visual Studio。 通过在项目或解决方案文件中调用 msbuild.exe 或 dotnet build，可以在未安装 Visual Studio 的环境中安排和生成产品。 Visual Studio 使用 MSBuild 来加载和生成托管项目。 Visual Studio 中的项目文件（.csproj、.vbproj、vcxproj 等）包含 MSBuild XML 代码，当你使用 IDE 来生成项目时，此代码就会运行。 Visual Studio 项目会导入所有必要的设置和生成过程来执行典型的开发工作，但你可以从 Visual Studio 内或通过使用 XML 编辑器对其进行扩展或修改。 若要在没有 Visual Studio 的 Windows 系统上安装 MSBuild，请转到下载页面上的 Visual Studio 生成工具。 通过此方法安装 MSBuild 可获得 MSBuild.exe。 对于 .NET Core 和 .NET 5 或更高版本，获取 MSBuild 等效项的另一种方法是安装 .NET SDK。 .NET 生成命令 dotnet build 可与 macOS、Windows 或 Linux 上的 .NET SDK 一起使用。 .NET 生成命令 dotnet build 是 .NET Core 版本 MSBuild.exe 的精简包装器。 可以使用 .NET Core 命令行接口 (CLI)（使用 MSBuild）来生成面向 .NET Core 和 .NET 5 及更高版本的项目。 ...

NSwag 提供了下列功能： 能够使用 Swagger UI 和 Swagger 生成器。 灵活的代码生成功能。 借助 NSwag，无需使用现有 API。也就是说，可使用包含 Swagger 的第三方 API，并生成客户端实现。 使用 NSwag，可以加快开发周期，并轻松适应 API 更改。 包安装 将 NSwag 安装到： 生成已实现的 Web API 的 Swagger 规范。 为 Swagger UI 提供服务以浏览和测试 Web API。 为 Redoc 提供服务，以为 Web API 添加 API 文档。 若要使用 NSwag ASP.NET Core 中间件，请安装 NSwag.AspNetCore NuGet 包。 此包内的中间件可用于生成并提供Swagger 规范、Swagger UI（v2 和 v3）和 ReDoc UI。 NSwag 14 仅支持 v3 版的 Swagger UI 规范。 若要安装 NSwag NuGet 包，请使用以下方法之一： ...

Package: NSwag.MSBuild Important for .NET Core: Assembly loading#net-core After installing the NSwag.MSBuild NuGet package in your project, you can use the variable $(NSwagExe) in your .csproj file to run the NSwag command line tool in an MSBuild target. This way the tools can easily be updated via NuGet. The /controller parameter can be omitted to generate a Swagger specification for all controllers. For better testability and stable output (defaults may change), it is recommended to create an NSwag Configuration Document (e.g. with NSwagStudio) and use: ...

这段时间学习一个整洁架构的开源项目，这是一名澳大利亚的软件架构师在github上面分享的项目：https://github.com/jasontaylordev/CleanArchitecture 作者的架构根底扎实，而且能灵活运用各种最新最简洁的技术知识，这个项目就用到非常多，我把代码pull下来之后发现直接编译过程中出了不少错误，花了两天时间都解决了。其中很大一部分是关于前端项目的内容，作者直接使用MSBuild来完成打包和创建，这只是我第一次看到。 另外还通过NSwag.MSBuild完成Open API代码的生成和typescript代码生成（运用于Angular），其中一个让我很惊讶的是：他居然在项目编译的时候初始化了数据库，弄得我云里雾里。我修改连接字符串，从报错信息才知道是执行这部分脚本的时候，MSWage的内核里初始化了Core的项目，调用到了初始化数据库代码： Executing file ‘config.nswag’ with variables ‘Configuration=Debug’… C:\Users\csuma.nuget\packages\nswag.msbuild\14.0.7\tools\Net80 下面是报错信息： Error NSwag command line tool for .NET Core Net80, toolchain v14.0.7.0 (NJsonSchema v11.0.0.0 (Newtonsoft.Json v13.0.0.0));Visit http://NSwag.org for more information.;NSwag bin directory: C:\Users\csuma.nuget\packages\nswag.msbuild\14.0.7\tools\Net80;Executing file ‘config.nswag’ with variables ‘Configuration=Debug’…;Launcher directory: C:\Users\csuma.nuget\packages\nswag.msbuild\14.0.7\tools\Net80;fail: CleanArchitecture.Infrastructure.Data.ApplicationDbContextInitialiser[0];An error occurred while initialising the database.;Microsoft.EntityFrameworkCore.SqlServer.Storage.Internal.SqlServerDatabaseCreator.<>cDisplayClass20_0.<b0>d.MoveNext();— End of stack trace from previous location —;at Microsoft.EntityFrameworkCore.SqlServer.Storage.Internal.SqlServerDatabaseCreator.<>cDisplayClass20_0.<b0>d.MoveNext();— End of stack trace from previous location —;at Microsoft.EntityFrameworkCore.SqlServer.Storage.Internal.SqlServerExecutionStrategy.ExecuteAsync[TState,TResult](TState state, Func4 operation, Func4 verifySucceeded, CancellationToken cancellationToken);at Microsoft.EntityFrameworkCore.Migrations.HistoryRepository.ExistsAsync(CancellationToken cancellationToken);at Microsoft.EntityFrameworkCore.Migrations.Internal.Migrator.MigrateAsync(String targetMigration, CancellationToken cancellationToken);at CleanArchitecture.Infrastructure.Data.ApplicationDbContextInitialiser.InitialiseAsync() in D:\project\CleanArchitecture\CleanArchitecture-main\CleanArchitecture-main\src\Infrastructure\Data\ApplicationDbContextInitialiser.cs:line 46;at CleanArchitecture.Infrastructure.Data.InitialiserExtensions.InitialiseDatabaseAsync(WebApplication app) in D:\project\CleanArchitecture\CleanArchitecture-main\CleanArchitecture-main\src\Infrastructure\Data\ApplicationDbContextInitialiser.cs:line 21;at Program. ...

Important for .NET Core: Assembly loading#net-core To use the command line tool nswag.exe (.NET 4.6+) / dotnet-nswag.dll (.NET Core), choose one of the following methods: NSwag NPM Module: Bindings for the .NET 4.6+ and .NET Core command line tools (depending on installed framework/OS platform) Download latest NSwagStudio MSI installer or install package NSwagStudio via Chocolatey: After installing the application, the path to the nswag.exe binary is registered in the PATH variable so that the tool can be used in the Windows command line. Download the latest command line tools: Extract the ZIP archive and use the nswag.exe binary in the Windows command line. NSwag.MSBuild NuGet package To see all available commands and parameters, run the command line application “nswag.exe” without parameters and enter “help” as command. All “input” parameters accept file paths, URLs and JSON data. ...

Visual Studio 2022.http 文件编辑器提供了一种便捷的方式来测试 ASP.NET Core项目，尤其是 API 应用。 编辑器提供一个 UI，用于： 创建和更新 .http 文件。 发送 .http 文件中指定的 HTTP 请求。 显示响应。 本文包含以下文档： .http 文件语法。 如何创建 .http 文件。 如何从 .http 文件发送请求。 在何处查找可配置的 .http 文件选项。 如何使用 Visual Studio 2022 终结点资源管理器在 .http 文件中创建请求。 .http 文件格式和编辑器受 Visual Studio Code REST 客户端扩展的启发。 Visual Studio 2022 .http 编辑器将 .rest 识别为相同文件格式的替代文件扩展名。 先决条件 安装了“ASP.NET 和 Web 部署”工作负载的 Visual Studio 2022 版本 17.8 或更高版本。 .http 文件语法 以下部分介绍 .http 文件语法。 请求 HTTP 请求的格式为 HTTPMethod URL HTTPVersion，全部在一行上，其中： ...

Orchard Core 是基于 Orchard CMS 使用 ASP.NET Core 重新构建的。 Orchard Core 由两个不同的目标组成: Orchard Core Framework: 一个应用程序框架，用于构建模块化、多租户 的ASP.NET Core应用程序。 Orchard Core CMS: 一个建立在Orchard Core Framework之上的网络内容管理系统（CMS)。 需要注意框架和 CMS 之间的差异非常重要。一些想要开发 SaaS 应用程序的开发人员只会对模块化框架感兴趣。其他想要构建可管理网站的用户将专注于 CMS 并构建模块来增强其网站或整个生态系统。 Building Software as a Service (SaaS) solutions with the Orchard Core Framework 了解Orchard Core Framework是独立于nuget.org上的CMS分发的，这一点非常重要。我们在 https://github.com/OrchardCMS/OrchardCore.Samples 提供了一些示例程序，它将指导您如何仅使用Orchard Core Framework来构建模块化 和 多租户 的应用程序，而无需任何 CMS 特定功能。 我们的目标之一是启用托管应用程序的基于社区的生态系统，这些生态系统可以通过模块（如电子商务系统、博客引擎等）进行扩展。Orchard Core Framework支持模块化环境，允许不同的团队处理应用程序的不同部分，并使组件跨项目可重用。 B站演示视频：https://www.bilibili.com/video/BV17T4y177fW/ 使用Orchard Core CMS 构建网站 Orchard Core CMS 是基于Orchard CMS 使用ASP.NET Core 重写的。它不仅仅是一个端口，因为我们希望大幅提高性能，并尽可能与的ASP.NET Core 的开发模型一致。 ...

若改造项目，也因历史遗留问题，数据库表设计也可能存在不合理，此时从头开始再搭建如此庞大的架子，感觉会有点虚空，同时也要考虑团队内部情况，不是那么容易上手，反而可能会违背初心，花更多时间和精力在各种模型理解上 我们完全可以为后续做铺垫，先搭建出底层基本设施，再基于此做灵活扩展即可，每个公司项目具体情况都不一样，比如仓储模式可能需要结合项目进行对应 改造，仓储只是提供了一种基本思想，若真将网上普遍流传的模式照搬可能并不是那么好用，可能会认为仓储莫不是一种反模式 .NET Core模块化插件 .NET Core内置提供了AssemblyLoadContext加载dll插件方式实现模块化，然后将其进行注册 var mvcBuilder = services.AddMvc(); foreach (var module in modules) { // Register controller from modules mvcBuilder.AddApplicationPart(module.Assembly); } 这种方式虽可行，在我看来只能作为一种临时解决方案并不利于长期，因为需额外创建一个新的项目，然后加载所生成dll，由于没有底层设施做支撑，所以极易引起版本不一致问题，而且手动被迫性质太强，实现模块化方案最终的目标则只需关注业务逻辑实现，我们来看看OrchardCore如何实现模块化。 OrchardCore模块化思想 这里我们并不讨论和ABP vNext二者谁更强大，没有任何意义，比如需结合现有项目情况、项目大小、是否为多租户、实施难度等等多方面考虑才能得出基本结论，而不是一味追求当前主流 比如我们只是想实现模块化方案，建议选择OrchardCore来实施，因为很简单，我们可将其剥离为我所用，而后结合项目情况是否考虑利用ABP vNext来进行分层处理。借鉴核心思想、才能保证一切可在控制范围内 首先我们先从整体上对OrchardCore做个认识，细枝末节暂不考虑：基于ASP.NET Core多租户模块化应用框架。 版本管理：无论是底层设施、基本框架、模块都通过包管理，同时框架和包版本基本（包管理走框架包版本）可以统一管理（对于版本升级很重要） 核心思想：模块实现模块特性，通过MSBuild构建主程序所添加实现模块特性的模块包，底层设施扫描模块特性将其注册到容器中，当然模块和模块特性都可进行基本信息描述 OrchardCore模块化原理 整个项目架构如下图所示 OrchardCore：底层设施以及可能需要添加的组件（比如本地化、日志、文件存储、缓存、Lucene等） OrchardCore.Frameworks：MVC框架 OrchardCore.Modules：模块化包（比如邮件服务、后台作业服务、第三方集成等等） OrchardCore.Modules.Cms：Cms模块包 OrchardCore.Themes：主题管理 OrchardCore.Cms.Web：主程序 我以内置所提供示例程序给大家讲解整个详细流程，而后有需要更细致了解的童鞋就可以很快上手了，如下示例主程序加载示例模块，主程序直接采用引用该示例模块（实际则是通过nuget下载该模块） 正常情况下我们通过nuget直接下载的是程序包，而OrchardCore对于入口则是利用MSBuild加载targets文件（其他组件则直接下载对应包），而targets引用对应包，通过这种中转方式根据我的理解主要解决了两个问题，其一则是可以屏蔽底层设施包（一次性下载），最重要的是通过targets文件可自动添加主程序程序集所加载模块包特性 是不是感觉有点懵，那到底是如何加载模块包特性的呢？来，请看如下图，我们以实际操作从头再来做一个完整梳理（注意：为排版美观，如下都将省略OrchardCore前缀） 【1】创建Mvc.Web程序，在nuget上下载Application.Mvc.Targets包 【2】创建Mvc.HelloWorld模块，在nuget上下载引用Module.Targets包 【3】Mvc.Web主程序引用我们所使用的Mvc.HelloWorld模块 【4】Application.Mvc.Targets包引用Application.Targets（引入底层设施）和MVC.Core（引入MVC框架） 【5】示例模块引入模块包，该包中存在模块特性（Module类） 【6】Application.Targets包下存在Application.Targets.targets文件，由于主程序引用了该包，添加所引用实现模块特性的包程序集信息到主程序集 到这里我们已经研究完主程序如何识别模块包，接下来则是如何加载模块包以及对应注册服务信息 OrcharCore核心在于OrchardCore和OrchardCore.Abstractions这两个底层设施包 归根到底，其底层设施源码一部分可能从官方源码拷贝过来（自我猜测），为实现多租户模式，势必要构建租户的容器和路由中间件，这中间就涉及在容器中需要维护每一个租户上下文（ShellContext），并且也要跟踪每个租户的状态。 ModularTenantContainerMiddleware作为创建租户容器中间件 ModularTenantRouterMiddleware作为租户路由中间件