CA1701: En las palabras compuestas de la cadena de recursos se deben utilizar mayúsculas y minúsculas correctamente
Elemento | Valor |
---|---|
RuleId | CA1701 |
Category | Microsoft.Naming |
Cambio importante | Poco problemático |
Causa
Una cadena de recursos contiene una palabra compuesta que no parece utilizar las mayúsculas y minúsculas correctamente.
Nota
Esta regla está en desuso. Para más información, consulte Reglas en desuso.
Descripción de la regla
Cada palabra en la cadena de recursos se divide en tokens basados en el uso de mayúsculas y minúsculas. La biblioteca de correctores ortográficos de Microsoft comprueba cada combinación de dos tokens contiguos. Si la reconoce, la palabra genera una infracción de la regla. Entre los ejemplos de palabras compuestas que causan una infracción, se encuentran "CheckSum" y "MultiPart", cuyo uso de mayúsculas y minúsculas debe ser "Checksum" y "Multipart", respectivamente. Debido al uso común anterior, varias excepciones se integran en la regla y se marcan varias palabras únicas, como "Toolbar" y "Filename", cuyo uso de mayúsculas y minúsculas debe aplicarse como dos palabras distintas. En este ejemplo, se marcaría "ToolBar" y "FileName".
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
Cambie la palabra para que el uso de mayúsculas y minúsculas sea correcto.
Cambio del idioma del diccionario
De forma predeterminada, se usa la versión en inglés (EN) del corrector ortográfico. Si desea cambiar el idioma del corrector ortográfico, puede hacerlo agregando uno de los atributos siguientes al archivo AssemblyInfo.cs o AssemblyInfo.vb:
- Use AssemblyCultureAttribute para especificar la referencia cultural si los recursos están en un ensamblado satélite.
- Use NeutralResourcesLanguageAttribute para especificar la referencia cultural neutra del ensamblado si los recursos están en el mismo ensamblado que el código.
Importante
Si establece la referencia cultural en algo distinto de una referencia cultural basada en inglés, esta regla de análisis de código se deshabilita silenciosamente.
Cuándo suprimir las advertencias
Es seguro suprimir una advertencia de esta regla si el diccionario ortográfico reconoce las dos partes de la palabra compuesta y la intención es usar dos palabras.
También puede agregar palabras compuestas a un diccionario personalizado para el corrector ortográfico. Las palabras del diccionario personalizado no causan infracciones. Para obtener más información, consulte Cómo: Personalizar el diccionario de análisis de código.
Reglas relacionadas
- CA1702: En las palabras compuestas se deben utilizar mayúsculas y minúsculas correctamente
- CA1709: Los identificadores deben utilizar las mayúsculas y minúsculas correctamente
- CA1708: Los identificadores se deben diferenciar en algo más que en el uso de mayúsculas y minúsculas
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de