建設 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 TeamMembers

• string TeamName

Tim 還解釋了一個關鍵點：他希望 TeamMembers 被自動初始化，以確保列表永不為 null。 他展示了兩種方法：

1. 在 C# 6.0 之前： 使用構造函數初始化列表。

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

   public List<PersonModel> TeamMembers { get; set; } = new List<PersonModel>();
   

Tim 偏好現代方法，因為它簡化了代碼。

創建個人模型

接下來，Tim 創建了 PersonModel。 使用 prop 程式碼片段，他快速添加了屬性：

• string FirstName

• string LastName

• string EmailAddress

• string CellPhoneNumber

Tim 指出計劃完成後建立模型有多快。 他還提醒我們，代碼現在直接基於計劃文件。

創建比賽模型

Tim 添加了 TournamentModel，其中包括：

• string TournamentName

• decimal EntryFee

• List EnteredTeams

• List Prizes

• List<List> Rounds

他強調 C# 能理解如 List<List> 般複雜的列表結構，甚至在使用 new 時自動填充類型。

添加獎品模型

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

• int PlaceNumber

• string PlaceName

• decimal PrizeAmount

• double PrizePercentage

他指出這些值目前保留為預設值，可在需要時稍後進行修改。

創建比賽模型

Tim 添加了 MatchupModel，包括：

• List Entries

• TeamModel Winner

• int MatchupRound

他還確保像之前一樣自動初始化 Entries 列表。

然後 Tim 添加了 MatchupEntryModel，包括：

• TeamModel TeamCompeting

• double Score

• MatchupModel ParentMatchup

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. 初始化列表以避免 null

4. 使用 XML 註釋記錄代碼

5. 為下次建構表單做準備

按照 Tim 的方法，您可以高效且專業地構建一個乾淨且結構良好的類別庫，準備好支援您應用程式的其餘部分。