CA2263: Prefira sobrecarga genérica quando o tipo é conhecido

	Value
ID da regra	CA2263
Título	Prefira sobrecarga genérica quando o tipo é conhecido
Categoria	Utilização
A correção está quebrando ou não quebrando	Sem quebra
Habilitado por padrão no .NET 9	Como sugestão

Motivo

Uma sobrecarga de método que aceita um System.Type argumento é chamada quando o tipo é conhecido em tempo de compilação e uma sobrecarga genérica adequada está disponível.

Descrição da regra

Sobrecargas genéricas são preferíveis a sobrecargas que aceitam um argumento de tipo System.Type quando o tipo é conhecido em tempo de compilação (usando o operador typeof em C# ou o operador GetType no Visual Basic). Sobrecargas genéricas promovem um código mais limpo e seguro para tipos com verificações aprimoradas em tempo de compilação.

Como corrigir violações

Para corrigir uma violação desta regra, use a sobrecarga genérica adequada.

Exemplo

O trecho de código a seguir mostra uma violação de CA2263:

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

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

O trecho de código a seguir corrige a violação:

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

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

Quando suprimir avisos

É seguro suprimir uma advertência desta regra; no entanto, recomendamos que você use uma sobrecarga genérica, se possível.

Suprimir um aviso

Se você quiser apenas suprimir uma única violação, adicione diretivas de pré-processador ao seu arquivo de origem para desativar e, em seguida, reativar a regra.

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

Para desabilitar a regra de um arquivo, pasta ou projeto, defina sua gravidade como none no arquivo de configuração.

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

Para obter mais informações, consulte Como suprimir avisos de análise de código.