EssentialCSharp - C#本质论

本项目包含《C# 12.0本质论》的源代码，2024年清华大学出版社出版。

中文版主页请访问周靖的博客

.NET - 该项目当前经过.NET 8.0、7.0和6.0的测试。
Visual Studio - 已集成.NET Core，这是我们主推的IDE，它使入门变得很简单。
Git - 虽然不是必需的，但它是一个可以快速下载此代码仓库的好工具。如果不喜欢使用命令行，建议使用Visual Studio自带的Git功能，或者使用第三方工具，例如GitKraken 。

EssentialCSharp.sln 是项目的主解决方案，请使用Visual Studio打开。
打开解决方案文件后，选择生成->生成解决方案，使用Visual Studio编译代码。
- 注意：在执行源代码之前，需要将和当前章对应的项目设为启动项目来执行的项目。例如，要执行第1章的示例，那么应该右键单击Chapter01项目，然后选择“设为启动项目”。如果选择一个目标章作为启动项目，但输入其他章的代码清单编号，那么会导致异常，并显示消息：“不存在和代码清单...对应的章”，“不存在代码清单...”或者“异常”。
要运行代码，请按F5或选择调试->开始调试。
运行后，程序将提示输入要执行的代码清单编号（例如，18.33）。
- 注意：如前所述，只能输入本书合法的代码清单编号。

从本地终端导航到EssentialCSharp的根目录（根目录是包含EssentialCSharp.sln文件的目录）。
从该根目录运行以下命令以还原和构建所有项目：
```
dotnet restore
dotnet build
```
要运行代码，请首先导航到希望执行的那个章节所在的项目目录。例如，要执行第1章的示例，需要先导航到Chapter01目录（例如：cd src/Chapter01）。
然后使用dotnet run命令启动程序，并按照提示输入要执行的代码清单编号。
- 注意：只能输入在当前运行的项目（本例是Chapter01）中存在的代码清单编号。
还可以使用dotnet run -p <projectfile>命令，其中project file是要执行的项目文件的路径（例如，dotnet run -p .\src\Chapter01\Chapter01.csproj）。执行时，程序将提示要执行哪个代码清单。

注：中文版请忽略。

许多代码清单都有相应的单元测试。

在Visual Studio中，要执行测试，请打开测试项目

并导航到与您要执行的代码清单对应的测试。然后，在测试方法上右键单击，选择运行测试（Ctrl+R，T）或调试测试（Ctrl+R，Ctrl+T）。或者，打开Test Explorer窗口，并从那里运行一些或所有测试（更多信息）。

在dotnet test中，要在所有项目中运行所有测试，请在根EssentialCSharp目录中的命令提示符上运行dotnet test。要运行单个项目的测试，请在要执行的测试的测试项目的测试目录中使用dotnet test命令。

在源代码中，有一些可能与在书中查看源代码时看起来不同的地方。这是因为即使书中的示例直接来自这个存储库，但并非所有代码都在书中原样显示。

一些注意事项：

当代码中有匹配的#region INCLUDE和#endregion INCLUDE标签时，在这两个标签之间的是在本书中能够看到的源代码。

当代码中有匹配的#region EXCLUDE和#endregion EXCLUDE标签时，即使这些标签在两个INCLUDE标签之间，此部分也会在书中省略，并用// ...替换，目的是让您将重点放在当前讲解的主题上。

此外，任何以// EXCLUDE结尾的行都在书中省略了。

如果有任何问题或发现任何错误，请随时打开本书中文版Git、Pull Request或Issue。

另外，请访问本书中文版主页，获取最新资讯、下载和勘误。