Compartir a través de


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

Nombre de tipo

IdentifiersShouldNotHaveIncorrectSuffix

Identificador de comprobación

CA1711

Categoría

Microsoft.Naming

Cambio 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.

La tabla siguiente muestra los sufijos reservados y los tipos base e interfaces a las que se asocian.

Sufijo

Tipo base/Interfaz

Atributo

System.Attribute

Collection

System.Collections.ICollection

System.Collections.IEnumerable

System.Collections.Queue

System.Collections.Stack

System.Collections.Generic.ICollection<T>

System.Data.DataSet

System.Data.DataTable

Dictionary

System.Collections.IDictionary

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

EventArgs

System.EventArgs

EventHandler

Delegado de controlador de eventos

Excepción

System.Exception

Permiso

System.Security.IPermission

Queue

System.Collections.Queue

Pila

System.Collections.Stack

Stream

System.IO.Stream

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

  • Delegado

  • Enum

  • Impl: use 'Core' en su lugar.

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

Las convenciones de nomenclatura proporcionan una apariencia común a las bibliotecas orientadas a Common Language Runtime.Esto reduce la curva de aprendizaje necesaria para las nuevas bibliotecas de software y aumenta la confianza por parte del cliente en lo que respecta a que la biblioteca fue desarrollada por 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 las advertencias de esta regla.

Reglas relacionadas

CA1710: Los identificadores deberían tener el sufijo correcto

Vea también

Referencia

Attribute Usage Guidelines

Otros recursos

Eventos y delegados