构建C#类库项目 - 从Tim Corey的课程获得的见解

在Visual Studio中启动类库

Tim开始讲解说，他们在规划模式中停留了一段时间，但现在终于准备好开始编码。 他打开Visual Studio并选择"创建新项目"，然后选择"类库"。 Tim将其命名为TrackerLibrary，并将解决方案名称设置为TournamentTracker。

Tim的第一个动作是在新库中删除默认的Class1.cs，解释说他不希望在项目中出现任何默认或命名不当的文件。 他说重命名可能会导致问题，因此他完全删除它以避免以后出现问题。

将计划转化为代码 - 添加类

Tim解释说，计划的真正好处在于当您准备好编码时，您不会猜测需要什么数据。 相反，您只是将计划好的设计转化为实际代码。

他提到在这一点上，您不在思考需要什么数据，而是在验证名称、结构以及是否有遗漏的地方。 Tim说这就是计划显著加快编码过程的原因。

创建团队模型

Tim添加了第一个类：TeamModel。 他解释说，他可以只命名为Team，但他更喜欢在末尾加上Model以明确表示这是一个数据模型。

他使用了Visual Studio的prop代码片段来快速生成属性。 Tim创建了以下属性：

• List团队成员

• string 团队名称

Tim还解释了一个关键点：他希望TeamMembers被自动初始化，以确保列表永远不为空。 他演示了两种方法：

1. C# 6.0之前： 使用构造函数来初始化列表。

2. 自C# 6.0起： 直接在属性中初始化，使用：

   public List<PersonModel> 团队成员 { get; set; } = new List<PersonModel>();
   

Tim更喜欢现代方法，因为它简化了代码。

创建个人模型

接下来，Tim创建了PersonModel。 使用prop代码片段，他快速添加了属性：

• 字符串 FirstName

• 字符串 LastName

• string 电子邮件地址

• string 手机号码

Tim指出在计划已经完成的情况下，构建模型的速度。 他还提醒我们，现在的代码是直接基于规划文档。

创建锦标赛模型

Tim添加了TournamentModel，其中包括：

• string 锦标赛名称

• decimal 报名费

• List报名团队

• List奖品

• List<List> 回合

他强调了C#对复杂列表结构的理解，比如List<List>，甚至在使用new时自动填充类型。

添加奖品模型

Tim添加了PrizeModel，具有以下属性：

• int 名次编号

• string 名次名称

• decimal 奖金额

• double 奖金比例

他注意到这些值现在保留为默认值，稍后需要时可以进行修改。

创建比赛模型

Tim添加了MatchupModel，包括：

• List条目

• TeamModel 获胜者

• int 对战轮次

他还确保Entries列表自动初始化，就像之前一样。

然后Tim添加了MatchupEntryModel，其中包括：

• TeamModel 参赛队伍

• double 分数

• MatchupModel 上级对战

Tim 强调这些模型完成了类库的基础。

一旦规划好类库就很简单

Tim 说一旦规划完成，构建类库就会变得非常简单。 他强调，由于所有的设计工作已经完成，库的结构很简单。

他提醒我们，规划的关键好处是编码变得快速和清晰。

添加 XML 注释——为什么这很重要

Tim 指出，最后一步应该是记录代码，特别是使用 XML 注释。 他承认注释工作是乏味的，但警告如果现在不做，可能以后也不会做。

他展示了如何通过在属性上方输入三个斜杠 (///) 来创建 XML 注释。 Tim 演示了编写描述如：

• "代表比赛中的一支队伍"

• "代表这支队伍的分数"

• "代表这支队伍作为赢家来源于的比赛"

Tim 解释说，XML 注释不仅仅是格式化的注释——它们成为代码文档的一部分，帮助其他开发者理解您的类。

XML 注释提高代码可用性

Tim 演示了 XML 注释如何与 IntelliSense 一起工作。 他创建了一个构造函数并为参数添加了 XML 注释，显示这些注释会自动出现在 IntelliSense 中。

他将此与 Visual Studio 内置的 Console.WriteLine() 描述进行比较，该描述来自 Microsoft 自己的 XML 文档。 Tim 解释说，使用 XML 注释可以让您在自己的类库中提供同样清晰度和可用性。

最终鼓励

Tim 鼓励观众为其余模型添加 XML 注释，尽管因为重复性强，他没有展示完整过程。

他以预览下一个课程结尾：构建表单。 Tim 指出，计划期间设计的表单只是简单的草图，现在是时候让它们看起来更现代、更实用了。

结论——Tim 的课程概要

Tim Corey 的课程显示，创建 C# 类库是将计划转换成代码的过程。 步骤如下

1. 创建类库项目

2. 根据计划添加模型

3. 初始化列表以避免空值

4. 使用 XML 注释记录代码

5. 准备下一个步骤构建表单

通过遵循 Tim 的方法，您可以高效、专业地构建一个干净且结构良好的类库，准备好支持您的应用程序的其余部分。