Compartilhar via

Exigir cabeçalho de arquivo (IDE0073)

  • Artigo
Propriedade Valor
ID da regra IDE0073
Título Exigir cabeçalho de arquivo
Categoria Estilo
Subcategoria Regras de idioma (preferências da diretiva using)
Linguagens aplicáveis C# e Visual Basic
Opções file_header_template

Visão geral

Essa regra de estilo diz respeito ao fornecimento de um cabeçalho de arquivo na parte superior dos arquivos de código-fonte.

Opções

Especifique o texto do cabeçalho necessário definindo a opção file_header_template.

  • Quando o valor da opção for uma cadeia de caracteres não vazia, exige o cabeçalho do arquivo especificado.
  • Quando o valor da opção for unset ou uma cadeia de caracteres vazia, não exigirá um cabeçalho de arquivo.

Para obter informações sobre como configurar as opções, consulte Formato da opção.

file_header_template

Propriedade Valor Descrição
Nome da opção file_header_template
Valores da opção cadeia de caracteres não vazia, opcionalmente contendo um espaço reservado {fileName} Prefira a cadeia de caracteres como o cabeçalho do arquivo necessário.
unset ou cadeia de caracteres vazia Não exige um cabeçalho de arquivo.
Valor da opção padrão unset 
// file_header_template = Copyright (c) SomeCorp. All rights reserved.\nLicensed under the xyz license.

// Copyright (c) SomeCorp. All rights reserved.
// Licensed under the xyz license.
namespace N1
{
    class C1 { }
}

// file_header_template = unset
//      OR
// file_header_template =
namespace N2
{
    class C2 { }
}

' file_header_template = Copyright (c) SomeCorp. All rights reserved.\nLicensed under the xyz license.

' Copyright (c) SomeCorp. All rights reserved.
' Licensed under the xyz license.
Namespace N1
    Class C1
    End Class
End Namespace

' file_header_template = unset
'      OR
' file_header_template =
Namespace N2
    Class C2
    End Class
End Namespace

Suprimir um aviso

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

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

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

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

Para desabilitar todas as regras de estilo de código, defina a severidade da categoria Style como none no arquivo de configuração.

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none

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

Confira também