Partilhar via


Identificadores não devem ter o sufixo incorreto

TypeName

IdentifiersShouldNotHaveIncorrectSuffix

CheckId

CA1711

Category (Categoria)

Microsoft.Naming

Quebrando alterar

Quebrando

Causa

Um identificador tem um sufixo incorreto.

Descrição da regra

Por convenção, apenas os nomes dos tipos que estender certos tipos base ou que implementam certas interfaces ou tipos derivados de tipos, devem terminar com sufixos reservados específicos.Outros nomes de tipo não devem usar esses sufixos reservados.

A tabela a seguir lista os sufixos reservados e as interfaces e tipos base são associados.

Sufixo

Interface/tipo de base

Atributo

System.Attribute

Coleção

System.Collections.ICollection

System.Collections.IEnumerable

System.Collections.Queue

System.Collections.Stack

System.Collections.Generic.ICollection<T>

System.Data.DataSet

System.Data.DataTable

Dicionário

System.Collections.IDictionary

System.Collections.Generic.IDictionary<TKey, TValue>

EventArgs

System.EventArgs

EventHandler

Um delegado manipulador de eventos.

Exceção

System.Exception

Permissão

System.Security.IPermission

Fila

System.Collections.Queue

Pilha

System.Collections.Stack

Fluxo

System.IO.Stream

Além disso, os seguintes sufixos devem não ser usado:

  • Delegado

  • Enum

  • Implementação - em vez disso, use 'Core'

  • EX ou sufixo semelhante para distingui-lo de uma versão anterior do mesmo tipo

Convenções de nomenclatura fornecem uma aparência comum para bibliotecas de destino o common linguagem tempo de execução.Isso reduz a curva de aprendizado necessária para novas bibliotecas de software e aumenta a confiança do cliente que a biblioteca foi desenvolvida por uma pessoa com experiência em desenvolvimento de código gerenciado.

Como corrigir violações

Remova o sufixo do nome de tipo.

Quando suprimir avisos

Não suprimir um aviso da regra.

Regras relacionadas

Identificadores devem ter o correto sufixo

Consulte também

Conceitos

Eventos e representantes

Referência

Diretrizes de uso do atributo