Nota
L'accés a aquesta pàgina requereix autorització. Podeu provar d'iniciar la sessió o de canviar els directoris.
L'accés a aquesta pàgina requereix autorització. Podeu provar de canviar els directoris.
| Propiedad | Valor |
|---|---|
| Identificador de la regla | CA1713 |
| Título | Los eventos no deben tener prefijos antes ni después |
| Categoría | Nomenclatura |
| La corrección interrumpe o no interrumpe | Ruptura |
| Habilitado de forma predeterminada en .NET 10 | No |
| Idiomas aplicables | C# y Visual Basic |
Causa
El nombre de un evento empieza por "Before" o "After".
Descripción de la regla
Los nombres de eventos deben describir la acción que genera el evento. Para nombrar los eventos relacionados que se provocan en una secuencia específica, utilice el tiempo presente o pasado para indicar la posición relativa en la secuencia de acciones. Por ejemplo, al asignar un nombre a un par de eventos que se genera al cerrar un recurso, podría asignarle el nombre "Closing" y "Closed", en lugar de "BeforeClose" y "AfterClose".
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 prefijo del nombre del evento y plantéese cambiar el nombre para utilizar el presente o pasado de un verbo.
Example
public class Session
{
// This code violates the rule.
public event EventHandler? BeforeClose;
public event EventHandler? AfterClose;
// This code satisfies the rule.
public event EventHandler? Closing;
public event EventHandler? Closed;
}
Cuándo suprimir las advertencias
No suprima las advertencias de esta regla.