doggy8088/多奇數位 C# 程式碼撰寫規範 (C# Coding Guideline).md Secret

## 338 changes: 316 additions & 22 deletions 多奇數位 C# 程式碼撰寫規範 (C# Coding Guideline).md
@@ -5,189 +5,475 @@

    ## 1. 通則
## 1. 通則


    * **縮排**：使用**空格**進行縮排，每個縮排層級為 **4 個空格**。
* **縮排**：使用**空格**進行縮排，每個縮排層級為 **4 個空格**。


      這表示每一層的程式碼區塊都應該向右縮進 4 個空格，以增加程式碼的可讀性。
  這表示每一層的程式碼區塊都應該向右縮進 4 個空格，以增加程式碼的可讀性。


    * **字元編碼**：所有檔案應使用 UTF-8-BOM 字元編碼。
* **字元編碼**：所有檔案應使用 UTF-8-BOM 字元編碼。


      這能確保所有檔案 (包含程式碼、文字檔、設定檔等) 都能正確顯示各種字元，特別是中文等非 ASCII 字元。另外，含有「中文命名」的專案，這條規範尤其重要。
  這能確保所有檔案 (包含程式碼、文字檔、設定檔等) 都能正確顯示各種字元，特別是中文等非 ASCII 字元。另外，含有「中文命名」的專案，這條規範尤其重要。


    * **檔案結尾換行**：檔案結尾**不**需要插入新的一行。
* **檔案結尾換行**：檔案結尾**不**需要插入新的一行。


      這是一種常見的程式碼規範，避免在檔案末尾出現多餘的空行。
  這是一種常見的程式碼規範，避免在檔案末尾出現多餘的空行。


    ## 2. 程式碼結構
## 2. 程式碼結構


    ### 2.1. using 指示詞
### 2.1. using 指示詞


    * `using` 指示詞應根據以下規則排序：
* `using` 指示詞應根據以下規則排序：

      * 系統命名空間 (例如 `System.*`) 應排在前面。
  * 系統命名空間 (例如 `System.*`) 應排在前面。


        這能幫助開發者快速識別程式碼使用的系統相關資源。
    這能幫助開發者快速識別程式碼使用的系統相關資源。


      * 不同的 `using` 指示詞群組應以空白行分隔。
  * 不同的 `using` 指示詞群組應以空白行分隔。


        透過分組和空白行區隔，可以更清晰地了解程式碼的依賴關係。
    透過分組和空白行區隔，可以更清晰地了解程式碼的依賴關係。


    * `using` 指示詞應放在命名空間之外。
* `using` 指示詞應放在命名空間之外。


      這確保了 `using` 指示詞的作用範圍涵蓋整個檔案，並且符合常見的程式碼風格。
  這確保了 `using` 指示詞的作用範圍涵蓋整個檔案，並且符合常見的程式碼風格。


    * `using` 宣告應使用簡化的 `using` 語句形式 (例如 `using var foo = ...;`)。
* `using` 宣告應使用簡化的 `using` 語句形式 (例如 `using var foo = ...;`)。


      這種簡化的語法能使程式碼更簡潔，並減少程式碼的冗餘。
  這種簡化的語法能使程式碼更簡潔，並減少程式碼的冗餘。


    ### 2.2. 命名空間
### 2.2. 命名空間


    * 命名空間應使用檔案範圍的命名空間宣告 (例如 `namespace MyNamespace;`)。
* 命名空間應使用檔案範圍的命名空間宣告 (例如 `namespace MyNamespace;`)。

    * 命名空間應使用檔案範圍的命名空間宣告 (file-scoped namespace) (例如 `namespace MyNamespace;`)。
* 命名空間應使用檔案範圍的命名空間宣告 (file-scoped namespace) (例如 `namespace MyNamespace;`)。


      這種宣告方式更簡潔，並且能更清楚地表明命名空間的作用範圍。
  這種宣告方式更簡潔，並且能更清楚地表明命名空間的作用範圍。


    * 命名空間名稱應與資料夾結構一致。
* 命名空間名稱應與資料夾結構一致。


      這能讓程式碼結構更清晰，並方便維護和管理專案。
  這能讓程式碼結構更清晰，並方便維護和管理專案。


    ## 3. 程式碼樣式
## 3. 程式碼樣式


    ### 3.1. 關鍵字與型別
### 3.1. 關鍵字與型別


    * 應使用 C# 語言關鍵字來表示內建型別 (例如，應使用 `int` 而不是 `System.Int32`)。
* 應使用 C# 語言關鍵字來表示內建型別 (例如，應使用 `int` 而不是 `System.Int32`)。


      使用關鍵字能使程式碼更簡潔，並符合 C# 的慣例。
  使用關鍵字能使程式碼更簡潔，並符合 C# 的慣例。


    * 在本地變數、參數和成員中使用預先定義的型別關鍵字。
* 在本地變數、參數和成員中使用預先定義的型別關鍵字。


      這能確保程式碼的一致性，並減少開發者在閱讀程式碼時的認知負擔。
  這能確保程式碼的一致性，並減少開發者在閱讀程式碼時的認知負擔。


    * 在成員存取中使用預先定義的型別關鍵字。
* 在成員存取中使用預先定義的型別關鍵字。


      同樣是為了確保程式碼風格一致，並減少不必要的冗餘。
  同樣是為了確保程式碼風格一致，並減少不必要的冗餘。


    ### 3.2. `this`
### 3.2. `this`


    * 在程式碼中，**不**應使用 `this.` 來存取事件、欄位、方法和屬性成員，除非有明確的語法衝突。
* 在程式碼中，**不**應使用 `this.` 來存取事件、欄位、方法和屬性成員，除非有明確的語法衝突。


      這能使程式碼更簡潔，並減少程式碼的噪音。
  這能使程式碼更簡潔，並減少程式碼的噪音。


    ### 3.3. 括號
### 3.3. 括號


    * 在算術二元運算子、其他二元運算子和關係二元運算子中，應**總是**使用括號以增加程式碼清晰度。
* 在算術二元運算子、其他二元運算子和關係二元運算子中，應**總是**使用括號以增加程式碼清晰度。


      括號能明確表達運算子的優先順序，避免程式碼出現意料之外的行為。
  括號能明確表達運算子的優先順序，避免程式碼出現意料之外的行為。


    * 在其他運算子中，只有在**必要時**才使用括號。
* 在其他運算子中，只有在**必要時**才使用括號。


      避免不必要的括號可以使程式碼更簡潔。
  避免不必要的括號可以使程式碼更簡潔。


    ### 3.4. 修飾詞
### 3.4. 修飾詞


    * 對於非介面成員，應**總是**指定存取修飾詞 (`public`、`private`、`protected`)。
* 對於非介面成員，應**總是**指定存取修飾詞 (`public`、`private`、`protected`)。

    * 建議使用以下修飾詞順序：`public`, `private`, `protected`, `internal`, `file`, `const`, `static`, `extern`, `new`, `virtual`, `abstract`, `sealed`, `override`, `readonly`, `unsafe`, `required`, `volatile`, `async`
* 建議使用以下修飾詞順序：`public`, `private`, `protected`, `internal`, `file`, `const`, `static`, `extern`, `new`, `virtual`, `abstract`, `sealed`, `override`, `readonly`, `unsafe`, `required`, `volatile`, `async`


      明確指定存取修飾詞能確保程式碼的可維護性，並避免出現不必要的安全隱患。
  明確指定存取修飾詞能確保程式碼的可維護性，並避免出現不必要的安全隱患。


    * 建議使用以下修飾詞順序：`public`, `private`, `protected`, `internal`, `file`, `const`, `static`, `extern`, `new`, `virtual`, `abstract`, `sealed`, `override`, `readonly`, `unsafe`, `required`, `volatile`, `async`。
* 建議使用以下修飾詞順序：`public`, `private`, `protected`, `internal`, `file`, `const`, `static`, `extern`, `new`, `virtual`, `abstract`, `sealed`, `override`, `readonly`, `unsafe`, `required`, `volatile`, `async`。


      統一的修飾詞順序可以使程式碼更一致，並方便閱讀。
  統一的修飾詞順序可以使程式碼更一致，並方便閱讀。


    ### 3.5. 表達式層級偏好
### 3.5. 表達式層級偏好


    * 應使用 `??` 空合併運算子 (Coalesce expression)。
* 應使用 `??` 空合併運算子 (Coalesce expression)。


      使用空合併運算子能使程式碼更簡潔，並避免處理空值時出現錯誤。
  使用空合併運算子能使程式碼更簡潔，並避免處理空值時出現錯誤。


    * 應使用集合初始器 (Collection initializer)。
* 應使用集合初始器 (Collection initializer)。


      使用集合初始器能使程式碼更簡潔，並方便初始化集合。
  使用集合初始器能使程式碼更簡潔，並方便初始化集合。


    * 應使用明確的元組名稱 (Explicit tuple names)。
* 應使用明確的元組名稱 (Explicit tuple names)。


      為元組明確指定名稱能使程式碼更易讀，並方便理解元組的含義。
  為元組明確指定名稱能使程式碼更易讀，並方便理解元組的含義。


    * 應使用空值傳播運算子 (Null propagation operator, `?.`)。
* 應使用空值傳播運算子 (Null propagation operator, `?.`)。


      使用空值傳播運算子能簡化空值檢查，並避免出現空值錯誤。
  使用空值傳播運算子能簡化空值檢查，並避免出現空值錯誤。


    * 應使用物件初始化器 (Object initializer)。
* 應使用物件初始化器 (Object initializer)。


      使用物件初始化器能使程式碼更簡潔，並方便初始化物件。
  使用物件初始化器能使程式碼更簡潔，並方便初始化物件。


    * 當換行時，運算子應放在行首。
* 當換行時，運算子應放在行首。


      這能讓程式碼更易讀，並清楚表達運算符的優先順序。
  這能讓程式碼更易讀，並清楚表達運算符的優先順序。


    * 應優先使用自動屬性 (Auto property)。
* 應優先使用自動屬性 (Auto property)。

    * 當類型鬆散匹配時，應使用集合表達式 (Collection expression)。
* 當類型鬆散匹配時，應使用集合表達式 (Collection expression)。


      自動屬性能減少程式碼的冗餘，並使程式碼更簡潔。
  自動屬性能減少程式碼的冗餘，並使程式碼更簡潔。


    * 當型別鬆散匹配時，應使用集合表達式 (Collection expression)。
* 當型別鬆散匹配時，應使用集合表達式 (Collection expression)。


      集合表達式能更簡潔地初始化集合，並適用於不同型別之間的轉換。
  集合表達式能更簡潔地初始化集合，並適用於不同型別之間的轉換。


    * 應使用複合賦值運算子 (例如 `+=`，`-=`)。
* 應使用複合賦值運算子 (例如 `+=`，`-=`)。


      複合賦值運算子能使程式碼更簡潔，並減少程式碼的冗餘。
  複合賦值運算子能使程式碼更簡潔，並減少程式碼的冗餘。


    * 在條件賦值和返回時，應使用條件表達式 (`?:`) 而非 `if/else` 語句。
* 在條件賦值和返回時，應使用條件表達式 (`?:`) 而非 `if/else` 語句。

    * 在 `foreach` 迴圈中，當有明確的型別宣告時，應優先使用明確的類型轉換。
* 在 `foreach` 迴圈中，當有明確的型別宣告時，應優先使用明確的類型轉換。


      條件表達式能更簡潔地表達條件邏輯，並使程式碼更易讀。
  條件表達式能更簡潔地表達條件邏輯，並使程式碼更易讀。


    * 在 `foreach` 迴圈中，當有明確的型別宣告時，應優先使用明確的型別轉換。
* 在 `foreach` 迴圈中，當有明確的型別宣告時，應優先使用明確的型別轉換。


      這能確保程式碼的型別安全，並減少運行時錯誤。
  這能確保程式碼的型別安全，並減少運行時錯誤。


    * 應推斷匿名型別成員名稱和元組名稱。
* 應推斷匿名型別成員名稱和元組名稱。


      自動推斷名稱能使程式碼更簡潔，並減少程式碼的冗餘。
  自動推斷名稱能使程式碼更簡潔，並減少程式碼的冗餘。


    * 應優先使用 `is null` 檢查，而不是使用 `== null` 或 `!= null` 的方式。
* 應優先使用 `is null` 檢查，而不是使用 `== null` 或 `!= null` 的方式。


      使用 `is null` 能更簡潔地檢查空值，並符合 C# 的語法慣例。
  使用 `is null` 能更簡潔地檢查空值，並符合 C# 的語法慣例。


    * 應使用簡化的布林表達式 (Boolean expression)。
* 應使用簡化的布林表達式 (Boolean expression)。


      在格式化 .NET 程式碼時，偏好簡化的布林表達式。這意味著在可能的情況下，編輯器會建議將複雜的布林邏輯簡化。例如，將 `if (x == true)` 簡化為 `if (x)`。這樣可以使程式碼更加簡潔和易讀。
  在格式化 .NET 程式碼時，偏好簡化的布林表達式。這意味著在可能的情況下，編輯器會建議將複雜的布林邏輯簡化。例如，將 `if (x == true)` 簡化為 `if (x)`。這樣可以使程式碼更加簡潔和易讀。

      在格式化 .NET 程式碼時，偏好簡化的布林表達式。這意味著在可能的情況下，編輯器會建議將複雜的布林邏輯簡化。例如，將 `if (x == true)` 簡化為 `if (x)`。這樣可以使程式碼更加簡潔和易讀，同時也避免了不必要的比較運算，並提高程式碼的執行效率。
  在格式化 .NET 程式碼時，偏好簡化的布林表達式。這意味著在可能的情況下，編輯器會建議將複雜的布林邏輯簡化。例如，將 `if (x == true)` 簡化為 `if (x)`。這樣可以使程式碼更加簡潔和易讀，同時也避免了不必要的比較運算，並提高程式碼的執行效率。


    * 應使用簡化的插值字串 (Interpolated string)。
* 應使用簡化的插值字串 (Interpolated string)。


      在格式化 .NET 程式碼時，偏好簡化的插值字串。插值字串是指在字串中嵌入變數或表達式的值。例如，將 `$"{x.ToString()}"` 簡化為 `$"{x}"`。這樣可以使程式碼更加簡潔，並減少不必要的呼叫。
  在格式化 .NET 程式碼時，偏好簡化的插值字串。插值字串是指在字串中嵌入變數或表達式的值。例如，將 `$"{x.ToString()}"` 簡化為 `$"{x}"`。這樣可以使程式碼更加簡潔，並減少不必要的呼叫。

      在格式化 .NET 程式碼時，偏好簡化的插值字串。插值字串是指在字串中嵌入變數或表達式的值。例如，將 `$"{x.ToString()}"` 簡化為 `$"{x}"`。這樣可以使程式碼更加簡潔，並減少不必要的呼叫，同時也能提升程式碼的可讀性。
  在格式化 .NET 程式碼時，偏好簡化的插值字串。插值字串是指在字串中嵌入變數或表達式的值。例如，將 `$"{x.ToString()}"` 簡化為 `$"{x}"`。這樣可以使程式碼更加簡潔，並減少不必要的呼叫，同時也能提升程式碼的可讀性。


    ### 3.6. 欄位
### 3.6. 欄位


    * 應將欄位宣告為 `readonly`，如可能。
* 應將欄位宣告為 `readonly`，如可能。

    * 如果可能，應將欄位宣告為 `readonly`。
* 如果可能，應將欄位宣告為 `readonly`。


      如果欄位的值在初始化之後不會被修改，則應宣告為 `readonly`，以確保程式碼的安全性，並防止程式碼意外修改欄位的值。
  如果欄位的值在初始化之後不會被修改，則應宣告為 `readonly`，以確保程式碼的安全性，並防止程式碼意外修改欄位的值。


    ### 3.7. 參數
### 3.7. 參數


    * 應檢查是否使用未使用的參數。
* 應檢查是否使用未使用的參數。


      如果參數在方法中沒有被使用，則應該移除該參數，以避免程式碼的混亂，並增加程式碼的可讀性。
  如果參數在方法中沒有被使用，則應該移除該參數，以避免程式碼的混亂，並增加程式碼的可讀性。


    ### 3.8. 變數宣告
### 3.8. 變數宣告


    * 不應在其他地方使用 `var` 關鍵字。
* 不應在其他地方使用 `var` 關鍵字。

    * 不應針對內建類型使用 `var`。
* 不應針對內建類型使用 `var`。

    * 只有在類型不明顯時才可以使用 `var`。
* 只有在類型不明顯時才可以使用 `var`。


       `var` 關鍵字只能用於區域變數宣告，以避免程式碼的混亂。
   `var` 關鍵字只能用於區域變數宣告，以避免程式碼的混亂。


    * 不應針對內建型別使用 `var`。
* 不應針對內建型別使用 `var`。


      針對內建型別 (如 `int`, `string`, `bool` 等)，應明確指定型別，以提高程式碼的可讀性。
  針對內建型別 (如 `int`, `string`, `bool` 等)，應明確指定型別，以提高程式碼的可讀性。


    * 在型別明顯可推斷時可以使用 `var`。
* 在型別明顯可推斷時可以使用 `var`。


       只有在型別可以明顯從等號右邊推斷出來時，才可以使用 `var`，以避免程式碼的可讀性降低。
   只有在型別可以明顯從等號右邊推斷出來時，才可以使用 `var`，以避免程式碼的可讀性降低。


    ### 3.9. 表達式主體成員
### 3.9. 表達式主體成員


    * 應使用表達式主體來定義存取子 (accessors)。
* 應使用表達式主體來定義存取子 (accessors)。


      對於簡單的存取子 (如 `get` 和 `set`)，應使用表達式主體，以使程式碼更簡潔。
  對於簡單的存取子 (如 `get` 和 `set`)，應使用表達式主體，以使程式碼更簡潔。


    * 不應使用表達式主體來定義建構子、局部函式、方法和運算子。
* 不應使用表達式主體來定義建構子、局部函式、方法和運算子。


      對於複雜的建構子、局部函式、方法和運算子，應使用區塊語法，以增加程式碼的可讀性。
  對於複雜的建構子、局部函式、方法和運算子，應使用區塊語法，以增加程式碼的可讀性。


    * 應使用表達式主體來定義索引子和 lambda。
* 應使用表達式主體來定義索引子和 lambda。


      對於簡單的索引子和 lambda，應使用表達式主體，以使程式碼更簡潔。
  對於簡單的索引子和 lambda，應使用表達式主體，以使程式碼更簡潔。


    * 應使用表達式主體來定義屬性。
* 應使用表達式主體來定義屬性。


       對於簡單的屬性，應使用表達式主體，以使程式碼更簡潔。
   對於簡單的屬性，應使用表達式主體，以使程式碼更簡潔。


    ### 3.10. 模式比對
### 3.10. 模式比對


    * 應優先使用模式比對而非使用 `as` 運算子並進行空值檢查。
* 應優先使用模式比對而非使用 `as` 運算子並進行空值檢查。

    * 應優先使用模式比對而非使用 `is` 運算子並進行類型轉換檢查。
* 應優先使用模式比對而非使用 `is` 運算子並進行類型轉換檢查。


       模式比對能更簡潔地檢查型別和空值，並減少程式碼的冗餘。
   模式比對能更簡潔地檢查型別和空值，並減少程式碼的冗餘。


    * 應優先使用模式比對而非使用 `is` 運算子並進行型別轉換檢查。
* 應優先使用模式比對而非使用 `is` 運算子並進行型別轉換檢查。


       模式比對能更簡潔地檢查型別和進行型別轉換，並減少程式碼的冗餘。
   模式比對能更簡潔地檢查型別和進行型別轉換，並減少程式碼的冗餘。


    * 應優先使用擴展屬性模式。
* 應優先使用擴展屬性模式。


      擴展屬性模式能更簡潔地存取嵌套屬性，並減少程式碼的冗餘。
  擴展屬性模式能更簡潔地存取嵌套屬性，並減少程式碼的冗餘。


    * 應優先使用 `not` 模式。
* 應優先使用 `not` 模式。


      `not` 模式能更簡潔地表達條件否定，並增加程式碼的可讀性。
  `not` 模式能更簡潔地表達條件否定，並增加程式碼的可讀性。


    * 應優先使用模式比對。
* 應優先使用模式比對。


      在可以使用模式比對的地方，應盡量使用模式比對，以增加程式碼的可讀性。
  在可以使用模式比對的地方，應盡量使用模式比對，以增加程式碼的可讀性。


    * 應優先使用 switch 表達式。
* 應優先使用 switch 表達式。


      當需要使用 `switch` 語句時，應優先使用 `switch` 表達式，以增加程式碼的簡潔性。
  當需要使用 `switch` 語句時，應優先使用 `switch` 表達式，以增加程式碼的簡潔性。


    ### 3.11. 空值檢查
### 3.11. 空值檢查


    * 應使用條件委派呼叫 (`?.Invoke`)。
* 應使用條件委派呼叫 (`?.Invoke`)。


      條件委派呼叫能更簡潔地檢查委派是否為空，並避免出現空值錯誤。
  條件委派呼叫能更簡潔地檢查委派是否為空，並避免出現空值錯誤。


    ### 3.12. 其他
### 3.12. 其他


    * 匿名函式應宣告為 `static`。
* 匿名函式應宣告為 `static`。


      如果匿名函式不需要訪問外部變數，則應宣告為 `static`，以提高程式碼的性能。
  如果匿名函式不需要訪問外部變數，則應宣告為 `static`，以提高程式碼的性能。


    * 局部函式應宣告為 `static`。
* 局部函式應宣告為 `static`。


      如果局部函式不需要訪問外部變數，則應宣告為 `static`，以提高程式碼的性能。
  如果局部函式不需要訪問外部變數，則應宣告為 `static`，以提高程式碼的性能。


    * 結構體應宣告為 `readonly`。
* 結構體應宣告為 `readonly`。


      如果結構體的值在初始化之後不會被修改，則應宣告為 `readonly`，以確保程式碼的安全性，並防止程式碼意外修改結構體的值。
  如果結構體的值在初始化之後不會被修改，則應宣告為 `readonly`，以確保程式碼的安全性，並防止程式碼意外修改結構體的值。


    * 結構體成員應宣告為 `readonly`。
* 結構體成員應宣告為 `readonly`。


      如果結構體的成員的值在初始化之後不會被修改，則應宣告為 `readonly`，以確保程式碼的安全性，並防止程式碼意外修改結構體成員的值。
  如果結構體的成員的值在初始化之後不會被修改，則應宣告為 `readonly`，以確保程式碼的安全性，並防止程式碼意外修改結構體成員的值。


    * 應使用大括號 (`{}`)。
* 應使用大括號 (`{}`)。


      在所有控制流程語句 (如 `if`、`for`、`while` 等) 中都應使用大括號，以提高程式碼的可讀性。
  在所有控制流程語句 (如 `if`、`for`、`while` 等) 中都應使用大括號，以提高程式碼的可讀性。


    * 應使用簡單的 `using` 語句。
* 應使用簡單的 `using` 語句。


      對於只需要釋放資源的 `using` 語句，應使用簡單的 `using` 語句，以減少程式碼的冗餘。
  對於只需要釋放資源的 `using` 語句，應使用簡單的 `using` 語句，以減少程式碼的冗餘。


    * 應優先使用主要建構子 (Primary Constructor)。
* 應優先使用主要建構子 (Primary Constructor)。


      如果類別或結構體只有主要的建構子，則應使用主要建構子，以減少程式碼的冗餘。
  如果類別或結構體只有主要的建構子，則應使用主要建構子，以減少程式碼的冗餘。


    * 應優先使用最上層語句 (Top-level statements)。
* 應優先使用最上層語句 (Top-level statements)。


       如果程式碼只包含簡單的程式碼邏輯，則應使用最上層語句，以減少程式碼的冗餘。
   如果程式碼只包含簡單的程式碼邏輯，則應使用最上層語句，以減少程式碼的冗餘。


    * 應優先使用簡單的 default 表達式。
* 應優先使用簡單的 default 表達式。


       當需要使用 `default` 值時，應使用簡單的 `default` 表達式，以增加程式碼的可讀性。
   當需要使用 `default` 值時，應使用簡單的 `default` 表達式，以增加程式碼的可讀性。


    * 應使用解構的變數宣告。
* 應使用解構的變數宣告。

    * 當類型明顯時，應使用隱式物件建立 (Implicit object creation)。
* 當類型明顯時，應使用隱式物件建立 (Implicit object creation)。


      在需要使用元組或其他可解構型別時，應使用解構的變數宣告，以增加程式碼的可讀性。
  在需要使用元組或其他可解構型別時，應使用解構的變數宣告，以增加程式碼的可讀性。


    * 當型別明顯時，應使用隱式物件建立 (Implicit object creation)。
* 當型別明顯時，應使用隱式物件建立 (Implicit object creation)。


      當型別可以明顯從等號右邊推斷出來時，應使用隱式物件建立，以增加程式碼的簡潔性。
  當型別可以明顯從等號右邊推斷出來時，應使用隱式物件建立，以增加程式碼的簡潔性。


    * 應使用內聯變數宣告 (Inlined variable declaration)。
* 應使用內聯變數宣告 (Inlined variable declaration)。


       如果變數只在一個地方被使用，則應使用內聯變數宣告，以減少程式碼的冗餘。
   如果變數只在一個地方被使用，則應使用內聯變數宣告，以減少程式碼的冗餘。


    * 應優先使用索引運算子。
* 應優先使用索引運算子。


      當需要使用索引存取集合時，應優先使用索引運算子，以增加程式碼的可讀性。
  當需要使用索引存取集合時，應優先使用索引運算子，以增加程式碼的可讀性。


    * 應優先使用局部函式而非匿名函式。
* 應優先使用局部函式而非匿名函式。

    * 應優先使用空值檢查而非類型檢查。
* 應優先使用空值檢查而非類型檢查。


      如果需要使用函式，且函式不需要訪問外部變數，則應優先使用局部函式，以提高程式碼的性能。
  如果需要使用函式，且函式不需要訪問外部變數，則應優先使用局部函式，以提高程式碼的性能。


    * 應優先使用空值檢查而非型別檢查。
* 應優先使用空值檢查而非型別檢查。


      在需要檢查物件是否為空時，應優先使用空值檢查，以避免出現不必要的型別錯誤。
  在需要檢查物件是否為空時，應優先使用空值檢查，以避免出現不必要的型別錯誤。


    * 應優先使用範圍運算子。
* 應優先使用範圍運算子。


      當需要使用範圍時，應優先使用範圍運算子，以增加程式碼的可讀性。
  當需要使用範圍時，應優先使用範圍運算子，以增加程式碼的可讀性。


    * 應優先使用元組交換。
* 應優先使用元組交換。


      當需要交換兩個變數的值時，應優先使用元組交換，以增加程式碼的簡潔性。
  當需要交換兩個變數的值時，應優先使用元組交換，以增加程式碼的簡潔性。


    * 應優先使用 UTF-8 字串文字。
* 應優先使用 UTF-8 字串文字。


      當需要使用 UTF-8 字串文字時，應使用 UTF-8 字串文字，以確保程式碼的字元編碼正確。
  當需要使用 UTF-8 字串文字時，應使用 UTF-8 字串文字，以確保程式碼的字元編碼正確。


    * 應使用 `throw` 表達式。
* 應使用 `throw` 表達式。


      當需要 `throw` 例外時，應使用 `throw` 表達式，以增加程式碼的簡潔性。
  當需要 `throw` 例外時，應使用 `throw` 表達式，以增加程式碼的簡潔性。


    * 應使用棄置字元 (discard, `_`) 變數來忽略未使用的賦值。
* 應使用棄置字元 (discard, `_`) 變數來忽略未使用的賦值。


      當程式碼中有未使用的變數賦值時，應使用棄置字元 (`_`) 忽略，以避免程式碼的警告。
  當程式碼中有未使用的變數賦值時，應使用棄置字元 (`_`) 忽略，以避免程式碼的警告。


    * 應使用棄置字元 (`_`) 來忽略表達式語句中未使用的值。
* 應使用棄置字元 (`_`) 來忽略表達式語句中未使用的值。


       當程式碼中有表達式語句，但其值不需要使用時，應使用棄置字元 (`_`) 忽略，以避免程式碼的警告。
   當程式碼中有表達式語句，但其值不需要使用時，應使用棄置字元 (`_`) 忽略，以避免程式碼的警告。


    ## 4. 格式化規則
## 4. 格式化規則


    ### 4.1. 換行
### 4.1. 換行


    * `catch` 前應有換行。
* `catch` 前應有換行。


      在 `try...catch` 語句中，`catch` 關鍵字之前應有一個新行，以增加程式碼的可讀性。
  在 `try...catch` 語句中，`catch` 關鍵字之前應有一個新行，以增加程式碼的可讀性。


    * `else` 前應有換行。
* `else` 前應有換行。


      在 `if...else` 語句中，`else` 關鍵字之前應有一個新行，以增加程式碼的可讀性。
  在 `if...else` 語句中，`else` 關鍵字之前應有一個新行，以增加程式碼的可讀性。


    * `finally` 前應有換行。
* `finally` 前應有換行。

    * 匿名類型中的成員前應有換行。
* 匿名類型中的成員前應有換行。


      在 `try...finally` 語句中，`finally` 關鍵字之前應有一個新行，以增加程式碼的可讀性。
  在 `try...finally` 語句中，`finally` 關鍵字之前應有一個新行，以增加程式碼的可讀性。


    * 匿名型別中的成員前應有換行。
* 匿名型別中的成員前應有換行。


      在匿名型別中，成員之間應有新行，以增加程式碼的可讀性。
  在匿名型別中，成員之間應有新行，以增加程式碼的可讀性。


    * 物件初始化器中的成員前應有換行。
* 物件初始化器中的成員前應有換行。


      在物件初始化器中，成員之間應有新行，以增加程式碼的可讀性。
  在物件初始化器中，成員之間應有新行，以增加程式碼的可讀性。


    * 在左大括號 `{` 之前，應有換行。
* 在左大括號 `{` 之前，應有換行。


      在所有程式碼區塊的左大括號之前，應有一個新行，以增加程式碼的可讀性。
  在所有程式碼區塊的左大括號之前，應有一個新行，以增加程式碼的可讀性。


    * 查詢表達式子句之間應有換行。
* 查詢表達式子句之間應有換行。


      在查詢表達式中，各個子句之間應有新行，以增加程式碼的可讀性。
  在查詢表達式中，各個子句之間應有新行，以增加程式碼的可讀性。


    ### 4.2. 縮排
### 4.2. 縮排


    * 區塊內容應縮排。
* 區塊內容應縮排。


      所有程式碼區塊的內容都應該向右縮排，以增加程式碼的可讀性。
  所有程式碼區塊的內容都應該向右縮排，以增加程式碼的可讀性。


    * 大括號 `{}` 不應縮排。
* 大括號 `{}` 不應縮排。


      程式碼區塊的左大括號和右大括號，應與對應的程式碼關鍵字對齊，而不是縮排，以增加程式碼的可讀性。
  程式碼區塊的左大括號和右大括號，應與對應的程式碼關鍵字對齊，而不是縮排，以增加程式碼的可讀性。


    * `case` 內容應縮排。
* `case` 內容應縮排。


      在 `switch` 語句中，`case` 關鍵字之後的內容應向右縮排，以增加程式碼的可讀性。
  在 `switch` 語句中，`case` 關鍵字之後的內容應向右縮排，以增加程式碼的可讀性。


    * 當 `case` 內容使用區塊 `{}` 時，應縮排。
* 當 `case` 內容使用區塊 `{}` 時，應縮排。


      當 `case` 關鍵字之後的內容使用大括號包圍時，應將內容向右縮排，以增加程式碼的可讀性。
  當 `case` 關鍵字之後的內容使用大括號包圍時，應將內容向右縮排，以增加程式碼的可讀性。


    * `label` 應比目前縮排少一層。
* `label` 應比目前縮排少一層。


      `label` 標籤應該比目前的程式碼區塊縮排少一層，以增加程式碼的可讀性。
  `label` 標籤應該比目前的程式碼區塊縮排少一層，以增加程式碼的可讀性。


    * `switch` 標籤應縮排。
* `switch` 標籤應縮排。


      在 `switch` 語句中，`case` 和 `default` 標籤都應該縮排，以增加程式碼的可讀性。
  在 `switch` 語句中，`case` 和 `default` 標籤都應該縮排，以增加程式碼的可讀性。


    ### 4.3. 空格
### 4.3. 空格


    * 轉換 (`cast`) 後不應有空格。
* 轉換 (`cast`) 後不應有空格。


      型別轉換運算子和變數之間不應有空格。
  型別轉換運算子和變數之間不應有空格。


    * 繼承子句中的冒號 `:` 後應有空格。
* 繼承子句中的冒號 `:` 後應有空格。


      在類別繼承或介面實作中，冒號之後應有一個空格。
  在類別繼承或介面實作中，冒號之後應有一個空格。


    * 逗號 `,` 後應有空格。
* 逗號 `,` 後應有空格。


      在變數宣告、方法參數和集合初始化器中，逗號之後應有一個空格。
  在變數宣告、方法參數和集合初始化器中，逗號之後應有一個空格。


    * 點號 `.` 前後不應有空格。
* 點號 `.` 前後不應有空格。


      在物件成員存取時，點號前後都不應有空格。
  在物件成員存取時，點號前後都不應有空格。


    * 控制流程語句中的關鍵字後應有空格。
* 控制流程語句中的關鍵字後應有空格。


      在 `if`、`for`、`while` 等控制流程語句中，關鍵字之後應有一個空格。
  在 `if`、`for`、`while` 等控制流程語句中，關鍵字之後應有一個空格。


    * `for` 語句中的分號 `;` 後應有空格。
* `for` 語句中的分號 `;` 後應有空格。


      在 `for` 迴圈中，分號之後應有一個空格。
  在 `for` 迴圈中，分號之後應有一個空格。


    * 二元運算子前後應有空格。
* 二元運算子前後應有空格。


      在二元運算子 (如 `+`、`-`、`*`、`/` 等) 前後都應有一個空格。
  在二元運算子 (如 `+`、`-`、`*`、`/` 等) 前後都應有一個空格。


    * 宣告語句周圍不應有空格。
* 宣告語句周圍不應有空格。


      在變數宣告語句前後不應有額外空格。
  在變數宣告語句前後不應有額外空格。


    * 繼承子句中的冒號 `:` 前應有空格。
* 繼承子句中的冒號 `:` 前應有空格。


      在類別繼承或介面實作中，冒號之前應有一個空格。
  在類別繼承或介面實作中，冒號之前應有一個空格。


    * 逗號 `,` 前不應有空格。
* 逗號 `,` 前不應有空格。


      在變數宣告、方法參數和集合初始化器中，逗號之前不應有空格。
  在變數宣告、方法參數和集合初始化器中，逗號之前不應有空格。


    * 開啟方括號 `[` 前不應有空格。
* 開啟方括號 `[` 前不應有空格。


      在集合或索引器存取中，開啟方括號之前不應有空格。
  在集合或索引器存取中，開啟方括號之前不應有空格。


    * `for` 語句中的分號 `;` 前不應有空格。
* `for` 語句中的分號 `;` 前不應有空格。


      在 `for` 迴圈中，分號之前不應有空格。
  在 `for` 迴圈中，分號之前不應有空格。


    * 空方括號 `[]` 之間不應有空格。
* 空方括號 `[]` 之間不應有空格。


      在宣告空陣列或空索引時，空方括號之間不應有空格。
  在宣告空陣列或空索引時，空方括號之間不應有空格。


    * 方法呼叫的空參數列表括號之間不應有空格。
* 方法呼叫的空參數列表括號之間不應有空格。


      在方法呼叫時，如果參數列表為空，則括號之間不應有空格。
  在方法呼叫時，如果參數列表為空，則括號之間不應有空格。


    * 方法呼叫的名稱與左括號之間不應有空格。
* 方法呼叫的名稱與左括號之間不應有空格。


      在方法呼叫時，方法名稱和左括號之間不應有空格。
  在方法呼叫時，方法名稱和左括號之間不應有空格。


    * 方法呼叫的參數列表括號之間不應有空格。
* 方法呼叫的參數列表括號之間不應有空格。


      在方法呼叫時，如果參數列表不為空，則參數列表的括號之間不應有空格。
  在方法呼叫時，如果參數列表不為空，則參數列表的括號之間不應有空格。


    * 方法宣告的空參數列表括號之間不應有空格。
* 方法宣告的空參數列表括號之間不應有空格。


      在方法宣告時，如果參數列表為空，則括號之間不應有空格。
  在方法宣告時，如果參數列表為空，則括號之間不應有空格。


    * 方法宣告的名稱與左括號之間不應有空格。
* 方法宣告的名稱與左括號之間不應有空格。


      在方法宣告時，方法名稱和左括號之間不應有空格。
  在方法宣告時，方法名稱和左括號之間不應有空格。


    * 方法宣告的參數列表括號之間不應有空格。
* 方法宣告的參數列表括號之間不應有空格。


      在方法宣告時，如果參數列表不為空，則參數列表的括號之間不應有空格。
  在方法宣告時，如果參數列表不為空，則參數列表的括號之間不應有空格。


    * 括號之間不應有空格。
* 括號之間不應有空格。


      在括號內不應有額外空格。
  在括號內不應有額外空格。


    * 方括號之間不應有空格。
* 方括號之間不應有空格。


      在方括號內不應有額外空格。
  在方括號內不應有額外空格。


    ### 4.4. 換行
### 4.4. 換行


    * 應保留單行程式碼區塊。
* 應保留單行程式碼區塊。


      在格式化 C# 程式碼時，應該保留單行的區塊。區塊通常是指用大括號 `{}` 包圍的程式碼片段，例如 `if` 語句或方法定義。如果這個區塊的內容可以放在同一行，編輯器將會保留這種單行格式，而不會自動將其展開成多行。
  在格式化 C# 程式碼時，應該保留單行的區塊。區塊通常是指用大括號 `{}` 包圍的程式碼片段，例如 `if` 語句或方法定義。如果這個區塊的內容可以放在同一行，編輯器將會保留這種單行格式，而不會自動將其展開成多行。

      在格式化 C# 程式碼時，應該保留單行的區塊。區塊通常是指用大括號 `{}` 包圍的程式碼片段，例如 `if` 語句或方法定義。如果這個區塊的內容可以放在同一行，編輯器將會保留這種單行格式，而不會自動將其展開成多行。例如，`if (x) { return true; }` 會被保留在一行內。
  在格式化 C# 程式碼時，應該保留單行的區塊。區塊通常是指用大括號 `{}` 包圍的程式碼片段，例如 `if` 語句或方法定義。如果這個區塊的內容可以放在同一行，編輯器將會保留這種單行格式，而不會自動將其展開成多行。例如，`if (x) { return true; }` 會被保留在一行內。


    * 應保留單行程式碼語句。
* 應保留單行程式碼語句。


      在格式化 C# 程式碼時，應該保留單行的語句。這意味著如果某個語句可以放在一行內，編輯器將會保留這種單行格式，而不會自動將其拆分成多行。
  在格式化 C# 程式碼時，應該保留單行的語句。這意味著如果某個語句可以放在一行內，編輯器將會保留這種單行格式，而不會自動將其拆分成多行。

      在格式化 C# 程式碼時，應該保留單行的語句。這意味著如果某個語句可以放在一行內，編輯器將會保留這種單行格式，而不會自動將其拆分成多行。例如，`int x = 10;` 會被保留在一行內。
  在格式化 C# 程式碼時，應該保留單行的語句。這意味著如果某個語句可以放在一行內，編輯器將會保留這種單行格式，而不會自動將其拆分成多行。例如，`int x = 10;` 會被保留在一行內。


    ## 5. 命名規則
## 5. 命名規則


    ### 5.1. 命名慣例
### 5.1. 命名慣例


    * **類型和命名空間** (Type and Namespace) 應使用 **PascalCase** (例如 `MyClass`, `MyNamespace`)。
* **類型和命名空間** (Type and Namespace) 應使用 **PascalCase** (例如 `MyClass`, `MyNamespace`)。

    * **型別和命名空間** (Type and Namespace) 應使用 **PascalCase** (例如 `MyClass`, `MyNamespace`)。
* **型別和命名空間** (Type and Namespace) 應使用 **PascalCase** (例如 `MyClass`, `MyNamespace`)。

    * **介面** (Interface) 應使用 **IPascalCase** (例如 `IMyInterface`)。
* **介面** (Interface) 應使用 **IPascalCase** (例如 `IMyInterface`)。

    * **類型參數** (Type Parameter) 應使用 **TPascalCase** (例如 `TMyType`)。
* **類型參數** (Type Parameter) 應使用 **TPascalCase** (例如 `TMyType`)。

    * **型別參數** (Type Parameter) 應使用 **TPascalCase** (例如 `TMyType`)。
* **型別參數** (Type Parameter) 應使用 **TPascalCase** (例如 `TMyType`)。

    * **方法** (Method) 應使用 **PascalCase** (例如 `MyMethod()`)。
* **方法** (Method) 應使用 **PascalCase** (例如 `MyMethod()`)。

    * **屬性** (Property) 應使用 **PascalCase** (例如 `MyProperty`)。
* **屬性** (Property) 應使用 **PascalCase** (例如 `MyProperty`)。

    * **事件** (Event) 應使用 **PascalCase** (例如 `MyEvent`)。
* **事件** (Event) 應使用 **PascalCase** (例如 `MyEvent`)。
@@ -207,19 +493,19 @@


    ### 5.2. 命名規則定義
### 5.2. 命名規則定義


    此部分定義了不同符號類型的命名規則。
此部分定義了不同符號類型的命名規則。

    此部分定義了不同符號型別的命名規則。
此部分定義了不同符號型別的命名規則。


    * **介面** (Interface)：適用於介面類型，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **介面** (Interface)：適用於介面類型，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **列舉** (Enum)：適用於列舉類型，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **列舉** (Enum)：適用於列舉類型，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **介面** (Interface)：適用於介面型別，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **介面** (Interface)：適用於介面型別，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **列舉** (Enum)：適用於列舉型別，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **列舉** (Enum)：適用於列舉型別，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **事件** (Event)：適用於事件成員，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **事件** (Event)：適用於事件成員，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **方法** (Method)：適用於方法成員，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **方法** (Method)：適用於方法成員，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **屬性** (Property)：適用於屬性成員，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **屬性** (Property)：適用於屬性成員，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **公開欄位** (Public Field)：適用於 `public` 和 `internal` 的欄位成員，不需要修飾詞。
* **公開欄位** (Public Field)：適用於 `public` 和 `internal` 的欄位成員，不需要修飾詞。

    * **私有欄位** (Private Field)：適用於 `private`、`protected`、`protected_internal` 和 `private_protected` 的欄位成員，不需要修飾詞。
* **私有欄位** (Private Field)：適用於 `private`、`protected`、`protected_internal` 和 `private_protected` 的欄位成員，不需要修飾詞。

    * **私有靜態欄位** (Private Static Field)：適用於 `private`、`protected`、`protected_internal` 和 `private_protected` 的靜態欄位成員，需要 `static` 修飾詞。
* **私有靜態欄位** (Private Static Field)：適用於 `private`、`protected`、`protected_internal` 和 `private_protected` 的靜態欄位成員，需要 `static` 修飾詞。

    * **類型和命名空間** (Type and Namespace)：適用於命名空間、類別、結構、介面和列舉，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **類型和命名空間** (Type and Namespace)：適用於命名空間、類別、結構、介面和列舉，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **型別和命名空間** (Type and Namespace)：適用於命名空間、類別、結構、介面和列舉，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **型別和命名空間** (Type and Namespace)：適用於命名空間、類別、結構、介面和列舉，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **非欄位成員** (Non-Field Member)：適用於屬性、事件和方法成員，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **非欄位成員** (Non-Field Member)：適用於屬性、事件和方法成員，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **類型參數** (Type Parameter)：適用於命名空間，適用於任何可存取性，不需要修飾詞。
* **類型參數** (Type Parameter)：適用於命名空間，適用於任何可存取性，不需要修飾詞。

    * **型別參數** (Type Parameter)：適用於命名空間，適用於任何可存取性，不需要修飾詞。
* **型別參數** (Type Parameter)：適用於命名空間，適用於任何可存取性，不需要修飾詞。

    * **私有常數欄位** (Private Constant Field)：適用於 `private`、`protected`、`protected_internal` 和 `private_protected` 的常數欄位成員，需要 `const` 修飾詞。
* **私有常數欄位** (Private Constant Field)：適用於 `private`、`protected`、`protected_internal` 和 `private_protected` 的常數欄位成員，需要 `const` 修飾詞。

    * **本地變數** (Local Variable)：適用於本地變數，適用於任何可存取性，不需要修飾詞。
* **本地變數** (Local Variable)：適用於本地變數，適用於任何可存取性，不需要修飾詞。

    * **本地常數** (Local Constant)：適用於本地常數，適用於任何可存取性，需要 `const` 修飾詞。
* **本地常數** (Local Constant)：適用於本地常數，適用於任何可存取性，需要 `const` 修飾詞。
@@ -241,5 +527,13 @@

    ## 6. 其他
## 6. 其他


    * 本規範應適用於所有 C# 程式碼。
* 本規範應適用於所有 C# 程式碼。


      所有團隊成員都應遵循此規範來編寫 C# 程式碼。
  所有團隊成員都應遵循此規範來編寫 C# 程式碼。


    * 如有任何不清楚的地方，請諮詢團隊成員。
* 如有任何不清楚的地方，請諮詢團隊成員。


      當您對規範有任何疑問或不確定之處時，請及時諮詢團隊成員，以確保對規範的理解一致。
  當您對規範有任何疑問或不確定之處時，請及時諮詢團隊成員，以確保對規範的理解一致。


    * 本規範允許根據團隊需要進行更新和修改。
* 本規範允許根據團隊需要進行更新和修改。


      本規範不是一成不變的，可以根據團隊的需要進行調整和完善。
  本規範不是一成不變的，可以根據團隊的需要進行調整和完善。

## 9 changes: 7 additions & 2 deletions 多奇數位 C# 程式碼撰寫規範 (C# Coding Guideline).md
@@ -60,8 +60,13 @@

    * 在 `foreach` 迴圈中，當有明確的型別宣告時，應優先使用明確的類型轉換。
* 在 `foreach` 迴圈中，當有明確的型別宣告時，應優先使用明確的類型轉換。

    * 應推斷匿名型別成員名稱和元組名稱。
* 應推斷匿名型別成員名稱和元組名稱。

    * 應優先使用 `is null` 檢查，而不是使用 `== null` 或 `!= null` 的方式。
* 應優先使用 `is null` 檢查，而不是使用 `== null` 或 `!= null` 的方式。

    * 應簡化布林表達式 (Boolean expression)。
* 應簡化布林表達式 (Boolean expression)。

    * 應簡化插值字串。
* 應簡化插值字串。

    * 應使用簡化的布林表達式 (Boolean expression)。
* 應使用簡化的布林表達式 (Boolean expression)。


      在格式化 .NET 程式碼時，偏好簡化的布林表達式。這意味著在可能的情況下，編輯器會建議將複雜的布林邏輯簡化。例如，將 `if (x == true)` 簡化為 `if (x)`。這樣可以使程式碼更加簡潔和易讀。
  在格式化 .NET 程式碼時，偏好簡化的布林表達式。這意味著在可能的情況下，編輯器會建議將複雜的布林邏輯簡化。例如，將 `if (x == true)` 簡化為 `if (x)`。這樣可以使程式碼更加簡潔和易讀。


    * 應使用簡化的插值字串 (Interpolated string)。
* 應使用簡化的插值字串 (Interpolated string)。


      在格式化 .NET 程式碼時，偏好簡化的插值字串。插值字串是指在字串中嵌入變數或表達式的值。例如，將 `$"{x.ToString()}"` 簡化為 `$"{x}"`。這樣可以使程式碼更加簡潔，並減少不必要的呼叫。
  在格式化 .NET 程式碼時，偏好簡化的插值字串。插值字串是指在字串中嵌入變數或表達式的值。例如，將 `$"{x.ToString()}"` 簡化為 `$"{x}"`。這樣可以使程式碼更加簡潔，並減少不必要的呼叫。


    ### 3.6. 欄位
### 3.6. 欄位


## 4 changes: 2 additions & 2 deletions 多奇數位 C# 程式碼撰寫規範 (C# Coding Guideline).md
@@ -31,9 +31,9 @@

    * 在本地變數、參數和成員中使用預先定義的型別關鍵字。
* 在本地變數、參數和成員中使用預先定義的型別關鍵字。

    * 在成員存取中使用預先定義的型別關鍵字。
* 在成員存取中使用預先定義的型別關鍵字。


    ### 3.2. `this` 與 `Me`
### 3.2. `this` 與 `Me`

    ### 3.2. `this`
### 3.2. `this`


    * 在程式碼中，**不**應使用 `this.` (C#) 或 `Me.` (VB) 來存取事件、欄位、方法和屬性成員，除非有明確的語法衝突。
* 在程式碼中，**不**應使用 `this.` (C#) 或 `Me.` (VB) 來存取事件、欄位、方法和屬性成員，除非有明確的語法衝突。

    * 在程式碼中，**不**應使用 `this.` 來存取事件、欄位、方法和屬性成員，除非有明確的語法衝突。
* 在程式碼中，**不**應使用 `this.` 來存取事件、欄位、方法和屬性成員，除非有明確的語法衝突。


    ### 3.3. 括號
### 3.3. 括號


## 2 changes: 1 addition & 1 deletion 多奇數位 C# 程式碼撰寫規範 (C# Coding Guideline).md
@@ -199,7 +199,7 @@

    * **列舉** (Enum) 應使用 **PascalCase** (例如 `MyEnum`)。
* **列舉** (Enum) 應使用 **PascalCase** (例如 `MyEnum`)。

    * **局部函式** (Local Function) 應使用 **PascalCase** (例如 `MyLocalFunction()`)。
* **局部函式** (Local Function) 應使用 **PascalCase** (例如 `MyLocalFunction()`)。

    * **非欄位成員** (Non-Field Member) 應使用 **PascalCase** (例如 `MyMember`)。
* **非欄位成員** (Non-Field Member) 應使用 **PascalCase** (例如 `MyMember`)。

    *
*


    ### 5.2. 命名規則定義
### 5.2. 命名規則定義


    此部分定義了不同符號類型的命名規則。
此部分定義了不同符號類型的命名規則。


## 12 changes: 6 additions & 6 deletions 多奇數位 C# 程式碼撰寫規範 (C# Coding Guideline).md
@@ -13,7 +13,7 @@

    ### 2.1. using 指示詞
### 2.1. using 指示詞


    * `using` 指示詞應根據以下規則排序：
* `using` 指示詞應根據以下規則排序：

      * 系統命名空間（例如 `System.*`）應排在前面。
  * 系統命名空間（例如 `System.*`）應排在前面。

      * 系統命名空間 (例如 `System.*`) 應排在前面。
  * 系統命名空間 (例如 `System.*`) 應排在前面。

      * 不同的 `using` 指示詞群組應以空白行分隔。
  * 不同的 `using` 指示詞群組應以空白行分隔。

    * `using` 指示詞應放在命名空間之外。
* `using` 指示詞應放在命名空間之外。

    * `using` 宣告應使用簡化的 `using` 語句形式 (例如 `using var foo = ...;`)。
* `using` 宣告應使用簡化的 `using` 語句形式 (例如 `using var foo = ...;`)。
@@ -27,13 +27,13 @@


    ### 3.1. 關鍵字與型別
### 3.1. 關鍵字與型別


    * 應使用 C# 語言關鍵字來表示內建型別（例如，應使用 `int` 而不是 `System.Int32`）。
* 應使用 C# 語言關鍵字來表示內建型別（例如，應使用 `int` 而不是 `System.Int32`）。

    * 應使用 C# 語言關鍵字來表示內建型別 (例如，應使用 `int` 而不是 `System.Int32`)。
* 應使用 C# 語言關鍵字來表示內建型別 (例如，應使用 `int` 而不是 `System.Int32`)。

    * 在本地變數、參數和成員中使用預先定義的型別關鍵字。
* 在本地變數、參數和成員中使用預先定義的型別關鍵字。

    * 在成員存取中使用預先定義的型別關鍵字。
* 在成員存取中使用預先定義的型別關鍵字。


    ### 3.2. `this` 與 `Me`
### 3.2. `this` 與 `Me`


    * 在程式碼中，**不**應使用 `this.`（C#）或 `Me.`（VB）來存取事件、欄位、方法和屬性成員，除非有明確的語法衝突。
* 在程式碼中，**不**應使用 `this.`（C#）或 `Me.`（VB）來存取事件、欄位、方法和屬性成員，除非有明確的語法衝突。

    * 在程式碼中，**不**應使用 `this.` (C#) 或 `Me.` (VB) 來存取事件、欄位、方法和屬性成員，除非有明確的語法衝突。
* 在程式碼中，**不**應使用 `this.` (C#) 或 `Me.` (VB) 來存取事件、欄位、方法和屬性成員，除非有明確的語法衝突。


    ### 3.3. 括號
### 3.3. 括號


@@ -42,7 +42,7 @@


    ### 3.4. 修飾詞
### 3.4. 修飾詞


    * 對於非介面成員，應**總是**指定存取修飾詞（`public`、`private`、`protected` 等）。
* 對於非介面成員，應**總是**指定存取修飾詞（`public`、`private`、`protected` 等）。

    * 對於非介面成員，應**總是**指定存取修飾詞 (`public`、`private`、`protected`)。
* 對於非介面成員，應**總是**指定存取修飾詞 (`public`、`private`、`protected`)。

    * 建議使用以下修飾詞順序：`public`, `private`, `protected`, `internal`, `file`, `const`, `static`, `extern`, `new`, `virtual`, `abstract`, `sealed`, `override`, `readonly`, `unsafe`, `required`, `volatile`, `async`
* 建議使用以下修飾詞順序：`public`, `private`, `protected`, `internal`, `file`, `const`, `static`, `extern`, `new`, `virtual`, `abstract`, `sealed`, `override`, `readonly`, `unsafe`, `required`, `volatile`, `async`


    ### 3.5. 表達式層級偏好
### 3.5. 表達式層級偏好
@@ -55,8 +55,8 @@

    * 當換行時，運算子應放在行首。
* 當換行時，運算子應放在行首。

    * 應優先使用自動屬性 (Auto property)。
* 應優先使用自動屬性 (Auto property)。

    * 當類型鬆散匹配時，應使用集合表達式 (Collection expression)。
* 當類型鬆散匹配時，應使用集合表達式 (Collection expression)。

    * 應使用複合賦值運算子（例如 `+=`，`-=`）。
* 應使用複合賦值運算子（例如 `+=`，`-=`）。

    * 在條件賦值和返回時，應使用條件表達式（`?:`）而非 `if/else` 語句。
* 在條件賦值和返回時，應使用條件表達式（`?:`）而非 `if/else` 語句。

    * 應使用複合賦值運算子 (例如 `+=`，`-=`)。
* 應使用複合賦值運算子 (例如 `+=`，`-=`)。

    * 在條件賦值和返回時，應使用條件表達式 (`?:`) 而非 `if/else` 語句。
* 在條件賦值和返回時，應使用條件表達式 (`?:`) 而非 `if/else` 語句。

    * 在 `foreach` 迴圈中，當有明確的型別宣告時，應優先使用明確的類型轉換。
* 在 `foreach` 迴圈中，當有明確的型別宣告時，應優先使用明確的類型轉換。

    * 應推斷匿名型別成員名稱和元組名稱。
* 應推斷匿名型別成員名稱和元組名稱。

    * 應優先使用 `is null` 檢查，而不是使用 `== null` 或 `!= null` 的方式。
* 應優先使用 `is null` 檢查，而不是使用 `== null` 或 `!= null` 的方式。


## 240 changes: 240 additions & 0 deletions 多奇數位 C# 程式碼撰寫規範 (C# Coding Guideline).md
@@ -0,0 +1,240 @@

    # 多奇數位 C# 程式碼撰寫規範 (C# Coding Guideline)
# 多奇數位 C# 程式碼撰寫規範 (C# Coding Guideline)


    本文件旨在提供一個全面的 C# 程式碼撰寫指南，以便開發團隊能夠編寫出一致且易於維護的程式碼。遵循這些準則將有助於提高程式碼的品質，並確保整個專案的協作效率。
本文件旨在提供一個全面的 C# 程式碼撰寫指南，以便開發團隊能夠編寫出一致且易於維護的程式碼。遵循這些準則將有助於提高程式碼的品質，並確保整個專案的協作效率。


    ## 1. 通則
## 1. 通則


    * **縮排**：使用**空格**進行縮排，每個縮排層級為 **4 個空格**。
* **縮排**：使用**空格**進行縮排，每個縮排層級為 **4 個空格**。

    * **字元編碼**：所有檔案應使用 UTF-8-BOM 字元編碼。
* **字元編碼**：所有檔案應使用 UTF-8-BOM 字元編碼。

    * **檔案結尾換行**：檔案結尾**不**需要插入新的一行。
* **檔案結尾換行**：檔案結尾**不**需要插入新的一行。


    ## 2. 程式碼結構
## 2. 程式碼結構


    ### 2.1. using 指示詞
### 2.1. using 指示詞


    * `using` 指示詞應根據以下規則排序：
* `using` 指示詞應根據以下規則排序：

      * 系統命名空間（例如 `System.*`）應排在前面。
  * 系統命名空間（例如 `System.*`）應排在前面。

      * 不同的 `using` 指示詞群組應以空白行分隔。
  * 不同的 `using` 指示詞群組應以空白行分隔。

    * `using` 指示詞應放在命名空間之外。
* `using` 指示詞應放在命名空間之外。

    * `using` 宣告應使用簡化的 `using` 語句形式 (例如 `using var foo = ...;`)。
* `using` 宣告應使用簡化的 `using` 語句形式 (例如 `using var foo = ...;`)。


    ### 2.2. 命名空間
### 2.2. 命名空間


    * 命名空間應使用檔案範圍的命名空間宣告 (例如 `namespace MyNamespace;`)。
* 命名空間應使用檔案範圍的命名空間宣告 (例如 `namespace MyNamespace;`)。

    * 命名空間名稱應與資料夾結構一致。
* 命名空間名稱應與資料夾結構一致。


    ## 3. 程式碼樣式
## 3. 程式碼樣式


    ### 3.1. 關鍵字與型別
### 3.1. 關鍵字與型別


    * 應使用 C# 語言關鍵字來表示內建型別（例如，應使用 `int` 而不是 `System.Int32`）。
* 應使用 C# 語言關鍵字來表示內建型別（例如，應使用 `int` 而不是 `System.Int32`）。

    * 在本地變數、參數和成員中使用預先定義的型別關鍵字。
* 在本地變數、參數和成員中使用預先定義的型別關鍵字。

    * 在成員存取中使用預先定義的型別關鍵字。
* 在成員存取中使用預先定義的型別關鍵字。


    ### 3.2. `this` 與 `Me`
### 3.2. `this` 與 `Me`


    * 在程式碼中，**不**應使用 `this.`（C#）或 `Me.`（VB）來存取事件、欄位、方法和屬性成員，除非有明確的語法衝突。
* 在程式碼中，**不**應使用 `this.`（C#）或 `Me.`（VB）來存取事件、欄位、方法和屬性成員，除非有明確的語法衝突。


    ### 3.3. 括號
### 3.3. 括號


    * 在算術二元運算子、其他二元運算子和關係二元運算子中，應**總是**使用括號以增加程式碼清晰度。
* 在算術二元運算子、其他二元運算子和關係二元運算子中，應**總是**使用括號以增加程式碼清晰度。

    * 在其他運算子中，只有在**必要時**才使用括號。
* 在其他運算子中，只有在**必要時**才使用括號。


    ### 3.4. 修飾詞
### 3.4. 修飾詞


    * 對於非介面成員，應**總是**指定存取修飾詞（`public`、`private`、`protected` 等）。
* 對於非介面成員，應**總是**指定存取修飾詞（`public`、`private`、`protected` 等）。

    * 建議使用以下修飾詞順序：`public`, `private`, `protected`, `internal`, `file`, `const`, `static`, `extern`, `new`, `virtual`, `abstract`, `sealed`, `override`, `readonly`, `unsafe`, `required`, `volatile`, `async`
* 建議使用以下修飾詞順序：`public`, `private`, `protected`, `internal`, `file`, `const`, `static`, `extern`, `new`, `virtual`, `abstract`, `sealed`, `override`, `readonly`, `unsafe`, `required`, `volatile`, `async`


    ### 3.5. 表達式層級偏好
### 3.5. 表達式層級偏好


    * 應使用 `??` 空合併運算子 (Coalesce expression)。
* 應使用 `??` 空合併運算子 (Coalesce expression)。

    * 應使用集合初始器 (Collection initializer)。
* 應使用集合初始器 (Collection initializer)。

    * 應使用明確的元組名稱 (Explicit tuple names)。
* 應使用明確的元組名稱 (Explicit tuple names)。

    * 應使用空值傳播運算子 (Null propagation operator, `?.`)。
* 應使用空值傳播運算子 (Null propagation operator, `?.`)。

    * 應使用物件初始化器 (Object initializer)。
* 應使用物件初始化器 (Object initializer)。

    * 當換行時，運算子應放在行首。
* 當換行時，運算子應放在行首。

    * 應優先使用自動屬性 (Auto property)。
* 應優先使用自動屬性 (Auto property)。

    * 當類型鬆散匹配時，應使用集合表達式 (Collection expression)。
* 當類型鬆散匹配時，應使用集合表達式 (Collection expression)。

    * 應使用複合賦值運算子（例如 `+=`，`-=`）。
* 應使用複合賦值運算子（例如 `+=`，`-=`）。

    * 在條件賦值和返回時，應使用條件表達式（`?:`）而非 `if/else` 語句。
* 在條件賦值和返回時，應使用條件表達式（`?:`）而非 `if/else` 語句。

    * 在 `foreach` 迴圈中，當有明確的型別宣告時，應優先使用明確的類型轉換。
* 在 `foreach` 迴圈中，當有明確的型別宣告時，應優先使用明確的類型轉換。

    * 應推斷匿名型別成員名稱和元組名稱。
* 應推斷匿名型別成員名稱和元組名稱。

    * 應優先使用 `is null` 檢查，而不是使用 `== null` 或 `!= null` 的方式。
* 應優先使用 `is null` 檢查，而不是使用 `== null` 或 `!= null` 的方式。

    * 應簡化布林表達式 (Boolean expression)。
* 應簡化布林表達式 (Boolean expression)。

    * 應簡化插值字串。
* 應簡化插值字串。


    ### 3.6. 欄位
### 3.6. 欄位


    * 應將欄位宣告為 `readonly`，如可能。
* 應將欄位宣告為 `readonly`，如可能。


    ### 3.7. 參數
### 3.7. 參數


    * 應檢查是否使用未使用的參數。
* 應檢查是否使用未使用的參數。


    ### 3.8. 變數宣告
### 3.8. 變數宣告


    * 不應在其他地方使用 `var` 關鍵字。
* 不應在其他地方使用 `var` 關鍵字。

    * 不應針對內建類型使用 `var`。
* 不應針對內建類型使用 `var`。

    * 只有在類型不明顯時才可以使用 `var`。
* 只有在類型不明顯時才可以使用 `var`。


    ### 3.9. 表達式主體成員
### 3.9. 表達式主體成員


    * 應使用表達式主體來定義存取子 (accessors)。
* 應使用表達式主體來定義存取子 (accessors)。

    * 不應使用表達式主體來定義建構子、局部函式、方法和運算子。
* 不應使用表達式主體來定義建構子、局部函式、方法和運算子。

    * 應使用表達式主體來定義索引子和 lambda。
* 應使用表達式主體來定義索引子和 lambda。

    * 應使用表達式主體來定義屬性。
* 應使用表達式主體來定義屬性。


    ### 3.10. 模式比對
### 3.10. 模式比對


    * 應優先使用模式比對而非使用 `as` 運算子並進行空值檢查。
* 應優先使用模式比對而非使用 `as` 運算子並進行空值檢查。

    * 應優先使用模式比對而非使用 `is` 運算子並進行類型轉換檢查。
* 應優先使用模式比對而非使用 `is` 運算子並進行類型轉換檢查。

    * 應優先使用擴展屬性模式。
* 應優先使用擴展屬性模式。

    * 應優先使用 `not` 模式。
* 應優先使用 `not` 模式。

    * 應優先使用模式比對。
* 應優先使用模式比對。

    * 應優先使用 switch 表達式。
* 應優先使用 switch 表達式。


    ### 3.11. 空值檢查
### 3.11. 空值檢查


    * 應使用條件委派呼叫 (`?.Invoke`)。
* 應使用條件委派呼叫 (`?.Invoke`)。


    ### 3.12. 其他
### 3.12. 其他


    * 匿名函式應宣告為 `static`。
* 匿名函式應宣告為 `static`。

    * 局部函式應宣告為 `static`。
* 局部函式應宣告為 `static`。

    * 結構體應宣告為 `readonly`。
* 結構體應宣告為 `readonly`。

    * 結構體成員應宣告為 `readonly`。
* 結構體成員應宣告為 `readonly`。

    * 應使用大括號 (`{}`)。
* 應使用大括號 (`{}`)。

    * 應使用簡單的 `using` 語句。
* 應使用簡單的 `using` 語句。

    * 應優先使用主要建構子 (Primary Constructor)。
* 應優先使用主要建構子 (Primary Constructor)。

    * 應優先使用最上層語句 (Top-level statements)。
* 應優先使用最上層語句 (Top-level statements)。

    * 應優先使用簡單的 default 表達式。
* 應優先使用簡單的 default 表達式。

    * 應使用解構的變數宣告。
* 應使用解構的變數宣告。

    * 當類型明顯時，應使用隱式物件建立 (Implicit object creation)。
* 當類型明顯時，應使用隱式物件建立 (Implicit object creation)。

    * 應使用內聯變數宣告 (Inlined variable declaration)。
* 應使用內聯變數宣告 (Inlined variable declaration)。

    * 應優先使用索引運算子。
* 應優先使用索引運算子。

    * 應優先使用局部函式而非匿名函式。
* 應優先使用局部函式而非匿名函式。

    * 應優先使用空值檢查而非類型檢查。
* 應優先使用空值檢查而非類型檢查。

    * 應優先使用範圍運算子。
* 應優先使用範圍運算子。

    * 應優先使用元組交換。
* 應優先使用元組交換。

    * 應優先使用 UTF-8 字串文字。
* 應優先使用 UTF-8 字串文字。

    * 應使用 `throw` 表達式。
* 應使用 `throw` 表達式。

    * 應使用棄置字元 (discard, `_`) 變數來忽略未使用的賦值。
* 應使用棄置字元 (discard, `_`) 變數來忽略未使用的賦值。

    * 應使用棄置字元 (`_`) 來忽略表達式語句中未使用的值。
* 應使用棄置字元 (`_`) 來忽略表達式語句中未使用的值。


    ## 4. 格式化規則
## 4. 格式化規則


    ### 4.1. 換行
### 4.1. 換行


    * `catch` 前應有換行。
* `catch` 前應有換行。

    * `else` 前應有換行。
* `else` 前應有換行。

    * `finally` 前應有換行。
* `finally` 前應有換行。

    * 匿名類型中的成員前應有換行。
* 匿名類型中的成員前應有換行。

    * 物件初始化器中的成員前應有換行。
* 物件初始化器中的成員前應有換行。

    * 在左大括號 `{` 之前，應有換行。
* 在左大括號 `{` 之前，應有換行。

    * 查詢表達式子句之間應有換行。
* 查詢表達式子句之間應有換行。


    ### 4.2. 縮排
### 4.2. 縮排


    * 區塊內容應縮排。
* 區塊內容應縮排。

    * 大括號 `{}` 不應縮排。
* 大括號 `{}` 不應縮排。

    * `case` 內容應縮排。
* `case` 內容應縮排。

    * 當 `case` 內容使用區塊 `{}` 時，應縮排。
* 當 `case` 內容使用區塊 `{}` 時，應縮排。

    * `label` 應比目前縮排少一層。
* `label` 應比目前縮排少一層。

    * `switch` 標籤應縮排。
* `switch` 標籤應縮排。


    ### 4.3. 空格
### 4.3. 空格


    * 轉換 (`cast`) 後不應有空格。
* 轉換 (`cast`) 後不應有空格。

    * 繼承子句中的冒號 `:` 後應有空格。
* 繼承子句中的冒號 `:` 後應有空格。

    * 逗號 `,` 後應有空格。
* 逗號 `,` 後應有空格。

    * 點號 `.` 前後不應有空格。
* 點號 `.` 前後不應有空格。

    * 控制流程語句中的關鍵字後應有空格。
* 控制流程語句中的關鍵字後應有空格。

    * `for` 語句中的分號 `;` 後應有空格。
* `for` 語句中的分號 `;` 後應有空格。

    * 二元運算子前後應有空格。
* 二元運算子前後應有空格。

    * 宣告語句周圍不應有空格。
* 宣告語句周圍不應有空格。

    * 繼承子句中的冒號 `:` 前應有空格。
* 繼承子句中的冒號 `:` 前應有空格。

    * 逗號 `,` 前不應有空格。
* 逗號 `,` 前不應有空格。

    * 開啟方括號 `[` 前不應有空格。
* 開啟方括號 `[` 前不應有空格。

    * `for` 語句中的分號 `;` 前不應有空格。
* `for` 語句中的分號 `;` 前不應有空格。

    * 空方括號 `[]` 之間不應有空格。
* 空方括號 `[]` 之間不應有空格。

    * 方法呼叫的空參數列表括號之間不應有空格。
* 方法呼叫的空參數列表括號之間不應有空格。

    * 方法呼叫的名稱與左括號之間不應有空格。
* 方法呼叫的名稱與左括號之間不應有空格。

    * 方法呼叫的參數列表括號之間不應有空格。
* 方法呼叫的參數列表括號之間不應有空格。

    * 方法宣告的空參數列表括號之間不應有空格。
* 方法宣告的空參數列表括號之間不應有空格。

    * 方法宣告的名稱與左括號之間不應有空格。
* 方法宣告的名稱與左括號之間不應有空格。

    * 方法宣告的參數列表括號之間不應有空格。
* 方法宣告的參數列表括號之間不應有空格。

    * 括號之間不應有空格。
* 括號之間不應有空格。

    * 方括號之間不應有空格。
* 方括號之間不應有空格。


    ### 4.4. 換行
### 4.4. 換行


    * 應保留單行程式碼區塊。
* 應保留單行程式碼區塊。


      在格式化 C# 程式碼時，應該保留單行的區塊。區塊通常是指用大括號 `{}` 包圍的程式碼片段，例如 `if` 語句或方法定義。如果這個區塊的內容可以放在同一行，編輯器將會保留這種單行格式，而不會自動將其展開成多行。
  在格式化 C# 程式碼時，應該保留單行的區塊。區塊通常是指用大括號 `{}` 包圍的程式碼片段，例如 `if` 語句或方法定義。如果這個區塊的內容可以放在同一行，編輯器將會保留這種單行格式，而不會自動將其展開成多行。


    * 應保留單行程式碼語句。
* 應保留單行程式碼語句。


      在格式化 C# 程式碼時，應該保留單行的語句。這意味著如果某個語句可以放在一行內，編輯器將會保留這種單行格式，而不會自動將其拆分成多行。
  在格式化 C# 程式碼時，應該保留單行的語句。這意味著如果某個語句可以放在一行內，編輯器將會保留這種單行格式，而不會自動將其拆分成多行。


    ## 5. 命名規則
## 5. 命名規則


    ### 5.1. 命名慣例
### 5.1. 命名慣例


    * **類型和命名空間** (Type and Namespace) 應使用 **PascalCase** (例如 `MyClass`, `MyNamespace`)。
* **類型和命名空間** (Type and Namespace) 應使用 **PascalCase** (例如 `MyClass`, `MyNamespace`)。

    * **介面** (Interface) 應使用 **IPascalCase** (例如 `IMyInterface`)。
* **介面** (Interface) 應使用 **IPascalCase** (例如 `IMyInterface`)。

    * **類型參數** (Type Parameter) 應使用 **TPascalCase** (例如 `TMyType`)。
* **類型參數** (Type Parameter) 應使用 **TPascalCase** (例如 `TMyType`)。

    * **方法** (Method) 應使用 **PascalCase** (例如 `MyMethod()`)。
* **方法** (Method) 應使用 **PascalCase** (例如 `MyMethod()`)。

    * **屬性** (Property) 應使用 **PascalCase** (例如 `MyProperty`)。
* **屬性** (Property) 應使用 **PascalCase** (例如 `MyProperty`)。

    * **事件** (Event) 應使用 **PascalCase** (例如 `MyEvent`)。
* **事件** (Event) 應使用 **PascalCase** (例如 `MyEvent`)。

    * **本地變數** (Local Variable) 應使用 **camelCase** (例如 `myVariable`)。
* **本地變數** (Local Variable) 應使用 **camelCase** (例如 `myVariable`)。

    * **本地常數** (Local Constant) 應使用 **camelCase** (例如 `myConstant`)。
* **本地常數** (Local Constant) 應使用 **camelCase** (例如 `myConstant`)。

    * **參數** (Parameter) 應使用 **camelCase** (例如 `myParameter`)。
* **參數** (Parameter) 應使用 **camelCase** (例如 `myParameter`)。

    * **公開欄位** (Public Field) 應使用 **PascalCase** (例如 `MyField`)。
* **公開欄位** (Public Field) 應使用 **PascalCase** (例如 `MyField`)。

    * **私有欄位** (Private Field) 應使用 **\_camelCase** (例如 `_myField`)。
* **私有欄位** (Private Field) 應使用 **\_camelCase** (例如 `_myField`)。

    * **私有靜態欄位** (Private Static Field) 應使用 **s\_camelCase** (例如 `s_myStaticField`)。
* **私有靜態欄位** (Private Static Field) 應使用 **s\_camelCase** (例如 `s_myStaticField`)。

    * **公開常數欄位** (Public Constant Field) 應使用 **PascalCase** (例如 `MyConstant`)。
* **公開常數欄位** (Public Constant Field) 應使用 **PascalCase** (例如 `MyConstant`)。

    * **私有常數欄位** (Private Constant Field) 應使用 **PascalCase** (例如 `MyPrivateConstant`)。
* **私有常數欄位** (Private Constant Field) 應使用 **PascalCase** (例如 `MyPrivateConstant`)。

    * **公開靜態 `readonly` 欄位** (Public Static `readonly` Field) 應使用 **PascalCase** (例如 `MyStaticReadonlyField`)。
* **公開靜態 `readonly` 欄位** (Public Static `readonly` Field) 應使用 **PascalCase** (例如 `MyStaticReadonlyField`)。

    * **私有靜態 `readonly` 欄位** (Private Static `readonly` Field) 應使用 **PascalCase** (例如 `MyPrivateStaticReadonlyField`)。
* **私有靜態 `readonly` 欄位** (Private Static `readonly` Field) 應使用 **PascalCase** (例如 `MyPrivateStaticReadonlyField`)。

    * **列舉** (Enum) 應使用 **PascalCase** (例如 `MyEnum`)。
* **列舉** (Enum) 應使用 **PascalCase** (例如 `MyEnum`)。

    * **局部函式** (Local Function) 應使用 **PascalCase** (例如 `MyLocalFunction()`)。
* **局部函式** (Local Function) 應使用 **PascalCase** (例如 `MyLocalFunction()`)。

    * **非欄位成員** (Non-Field Member) 應使用 **PascalCase** (例如 `MyMember`)。
* **非欄位成員** (Non-Field Member) 應使用 **PascalCase** (例如 `MyMember`)。

    *
*

    ### 5.2. 命名規則定義
### 5.2. 命名規則定義


    此部分定義了不同符號類型的命名規則。
此部分定義了不同符號類型的命名規則。


    * **介面** (Interface)：適用於介面類型，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **介面** (Interface)：適用於介面類型，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **列舉** (Enum)：適用於列舉類型，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **列舉** (Enum)：適用於列舉類型，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **事件** (Event)：適用於事件成員，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **事件** (Event)：適用於事件成員，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **方法** (Method)：適用於方法成員，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **方法** (Method)：適用於方法成員，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **屬性** (Property)：適用於屬性成員，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **屬性** (Property)：適用於屬性成員，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **公開欄位** (Public Field)：適用於 `public` 和 `internal` 的欄位成員，不需要修飾詞。
* **公開欄位** (Public Field)：適用於 `public` 和 `internal` 的欄位成員，不需要修飾詞。

    * **私有欄位** (Private Field)：適用於 `private`、`protected`、`protected_internal` 和 `private_protected` 的欄位成員，不需要修飾詞。
* **私有欄位** (Private Field)：適用於 `private`、`protected`、`protected_internal` 和 `private_protected` 的欄位成員，不需要修飾詞。

    * **私有靜態欄位** (Private Static Field)：適用於 `private`、`protected`、`protected_internal` 和 `private_protected` 的靜態欄位成員，需要 `static` 修飾詞。
* **私有靜態欄位** (Private Static Field)：適用於 `private`、`protected`、`protected_internal` 和 `private_protected` 的靜態欄位成員，需要 `static` 修飾詞。

    * **類型和命名空間** (Type and Namespace)：適用於命名空間、類別、結構、介面和列舉，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **類型和命名空間** (Type and Namespace)：適用於命名空間、類別、結構、介面和列舉，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **非欄位成員** (Non-Field Member)：適用於屬性、事件和方法成員，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。
* **非欄位成員** (Non-Field Member)：適用於屬性、事件和方法成員，包含 `public`、`internal`、`private`、`protected`、`protected_internal` 和 `private_protected` 的可存取性，不需要修飾詞。

    * **類型參數** (Type Parameter)：適用於命名空間，適用於任何可存取性，不需要修飾詞。
* **類型參數** (Type Parameter)：適用於命名空間，適用於任何可存取性，不需要修飾詞。

    * **私有常數欄位** (Private Constant Field)：適用於 `private`、`protected`、`protected_internal` 和 `private_protected` 的常數欄位成員，需要 `const` 修飾詞。
* **私有常數欄位** (Private Constant Field)：適用於 `private`、`protected`、`protected_internal` 和 `private_protected` 的常數欄位成員，需要 `const` 修飾詞。

    * **本地變數** (Local Variable)：適用於本地變數，適用於任何可存取性，不需要修飾詞。
* **本地變數** (Local Variable)：適用於本地變數，適用於任何可存取性，不需要修飾詞。

    * **本地常數** (Local Constant)：適用於本地常數，適用於任何可存取性，需要 `const` 修飾詞。
* **本地常數** (Local Constant)：適用於本地常數，適用於任何可存取性，需要 `const` 修飾詞。

    * **參數** (Parameter)：適用於參數，適用於任何可存取性，不需要修飾詞。
* **參數** (Parameter)：適用於參數，適用於任何可存取性，不需要修飾詞。

    * **公開常數欄位** (Public Constant Field)：適用於 `public` 和 `internal` 的常數欄位成員，需要 `const` 修飾詞。
* **公開常數欄位** (Public Constant Field)：適用於 `public` 和 `internal` 的常數欄位成員，需要 `const` 修飾詞。

    * **公開靜態 `readonly` 欄位** (Public Static `readonly` Field)：適用於 `public` 和 `internal` 的靜態 `readonly` 欄位成員，需要 `static` 和 `readonly` 修飾詞。
* **公開靜態 `readonly` 欄位** (Public Static `readonly` Field)：適用於 `public` 和 `internal` 的靜態 `readonly` 欄位成員，需要 `static` 和 `readonly` 修飾詞。

    * **私有靜態 `readonly` 欄位** (Private Static `readonly` Field)：適用於 `private`、`protected`、`protected_internal` 和 `private_protected` 的靜態 `readonly` 欄位成員，需要 `static` 和 `readonly` 修飾詞。
* **私有靜態 `readonly` 欄位** (Private Static `readonly` Field)：適用於 `private`、`protected`、`protected_internal` 和 `private_protected` 的靜態 `readonly` 欄位成員，需要 `static` 和 `readonly` 修飾詞。

    * **局部函式** (Local Function)：適用於局部函式，適用於任何可存取性，不需要修飾詞。
* **局部函式** (Local Function)：適用於局部函式，適用於任何可存取性，不需要修飾詞。


    ### 5.3. 命名風格
### 5.3. 命名風格


    * **PascalCase**：首字母大寫，單字之間無分隔符號，例如 `MyClassName`。
* **PascalCase**：首字母大寫，單字之間無分隔符號，例如 `MyClassName`。

    * **IPascalCase**：首字母為 `I` 的 PascalCase，例如 `IMyInterface`。
* **IPascalCase**：首字母為 `I` 的 PascalCase，例如 `IMyInterface`。

    * **TPascalCase**：首字母為 `T` 的 PascalCase，例如 `TMyType`。
* **TPascalCase**：首字母為 `T` 的 PascalCase，例如 `TMyType`。

    * **\_camelCase**：首字母小寫，單字之間無分隔符號，並以底線 `_` 開頭，例如 `_myVariable`。
* **\_camelCase**：首字母小寫，單字之間無分隔符號，並以底線 `_` 開頭，例如 `_myVariable`。

    * **camelCase**：首字母小寫，單字之間無分隔符號，例如 `myVariable`。
* **camelCase**：首字母小寫，單字之間無分隔符號，例如 `myVariable`。

    * **s\_camelCase**：首字母為 `s_` 的 camelCase，例如 `s_myStaticVariable`。
* **s\_camelCase**：首字母為 `s_` 的 camelCase，例如 `s_myStaticVariable`。


    ## 6. 其他
## 6. 其他


    * 本規範應適用於所有 C# 程式碼。
* 本規範應適用於所有 C# 程式碼。

    * 如有任何不清楚的地方，請諮詢團隊成員。
* 如有任何不清楚的地方，請諮詢團隊成員。

    * 本規範允許根據團隊需要進行更新和修改。
* 本規範允許根據團隊需要進行更新和修改。