Compartir a través de


CA1711: Los identificadores no deberían tener el sufijo incorrecto

TypeName

IdentifiersShouldNotHaveIncorrectSuffix

Identificador de comprobación

CA1711

Categoría

Microsoft.Naming

Cambio problemático

Problemático

Motivo

Un identificador tiene un sufijo incorrecto.

Descripción de la regla

Por convención, los nombres de tipos que extienden determinados tipos base o que implementan algunas interfaces, o tipos derivados de estos tipos, deben terminar con unos sufijos reservados específicos.Otros nombres de tipo no deben utilizar estos sufijos reservados.

En la tabla siguiente se muestran los sufijos reservados y los tipos base e interfaces a los que se asocian.

Sufijo

Tipo base/Interfaz

Atributo

Attribute

Collection

ICollection

IEnumerable

Queue

Stack

ICollection

DataSet

DataTable

Dictionary

IDictionary

IDictionary

EventArgs

EventArgs

EventHandler

Delegado del controlador de eventos.

Excepción

Exception

Permiso

IPermission

Cola

Queue

Pila

Stack

Stream

Stream

Además, no se deben usar los sufijos siguientes:

  • Delegate

  • Enum

  • Impl: use 'Core' en su lugar.

  • Ex o un sufijo similar para distinguir de una versión anterior del mismo tipo

Las convenciones de nomenclatura proporcionan una apariencia común para las bibliotecas destinadas a Common Language Runtime.Esto reduce la curva de aprendizaje necesaria para las nuevas bibliotecas de software y aumenta la confianza del cliente respecto a que la biblioteca se haya desarrollado por parte de un especialista en desarrollo de código administrado.

Cómo corregir infracciones

Quite el sufijo del nombre de tipo.

Cuándo suprimir advertencias

No suprima una advertencia de esta regla a menos que el sufijo no tenga un significado ambiguo en el dominio de aplicación.

Reglas relacionadas

CA1710: Los identificadores deberían tener el sufijo correcto

Vea también

Otros recursos

Attribute Usage Guidelines

Eventos y delegados