Condividi tramite


CA2263: Preferire l'overload generico quando il tipo è noto

Valore
ID regola CA2263
Title Preferire l'overload generico quando il tipo è noto
Categoria Utilizzo
La correzione causa un'interruzione o meno Non causa un'interruzione
Abilitato per impostazione predefinita in .NET 9 Come suggerimento

Causa

Un overload del metodo che accetta un System.Type argomento viene chiamato quando il tipo è noto in fase di compilazione e è disponibile un overload generico appropriato.

Descrizione regola

Gli overload generici sono preferibili agli overload che accettano un argomento di tipo System.Type quando il tipo è noto in fase di compilazione (usando l'operatoretypeof in C# o l'operatore GetType in Visual Basic). Gli overload generici promuovono codice più pulito e più indipendente dai tipi con controlli in fase di compilazione migliorati.

Come correggere le violazioni

Per correggere una violazione di questa regola, usare l'overload generico appropriato.

Esempio

Il frammento di codice seguente mostra una violazione di CA2263:

int size = Marshal.SizeOf(typeof(bool));
Dim size As Integer = Marshal.SizeOf(GetType(Boolean))

Il frammento di codice seguente corregge la violazione:

int size = Marshal.SizeOf<bool>();
Dim size As Integer = Marshal.SizeOf(Of Boolean)()

Quando eliminare gli avvisi

È sicuro eliminare un avviso da questa regola; Tuttavia, è consigliabile usare un overload generico, se possibile.

Eliminare un avviso

Se si vuole eliminare una singola violazione, aggiungere direttive del preprocessore al file di origine per disabilitare e quindi riabilitare la regola.

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

Per disabilitare la regola per un file, una cartella o un progetto, impostarne la gravità none su nel file di configurazione.

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

Per altre informazioni, vedere Come eliminare gli avvisi di analisi del codice.