共用方式為

CA2263：類型已知時偏好泛型多載

價值觀
規則識別碼 CA2263
標題 在類型已知時偏好泛型多載
類別 使用方式
修正是破壞性或非破壞性 Non-breaking
在 .NET 10 中預設啟用 建議

原因

當類型在編譯階段已知且有適當的泛型多載可用時，會呼叫接受引數的方法 System.Type 多載。

規則描述

泛型多載比在編譯階段已知類型時接受類型 System.Type 引數的多載更可取 （使用 C# 中的 typeof 運算子 或 Visual Basic 中的 GetType 運算子 ）。 泛型多載會透過改善編譯時間檢查來促進更乾淨且類型安全的程式碼。

如何修正違規

若要修正違反此規則的問題，請使用適當的泛型多載。

Example

下列程式碼片段顯示 CA2263 違規：

int size = Marshal.SizeOf(typeof(bool));

Dim size As Integer = Marshal.SizeOf(GetType(Boolean))

下列程式碼片段可修正違規：

int size = Marshal.SizeOf<bool>();

Dim size As Integer = Marshal.SizeOf(Of Boolean)()

隱藏警告的時機

從此規則中隱藏警告是安全的;不過，建議您可能盡可能使用泛型多載。

隱藏警告

如果您只想要隱藏單一違規，請將預處理器指示詞新增至原始程式檔以停用，然後重新啟用規則。

#pragma warning disable CA2263
// The code that's violating the rule is on this line.
#pragma warning restore CA2263

若要停用檔案、資料夾或項目的規則，請在組態檔中將其嚴重性設為。

[*.{cs,vb}]
dotnet_diagnostic.CA2263.severity = none

如需詳細資訊，請參閱 如何隱藏程式碼分析警告。

  • Last updated on