Convertendo Enums em Valores Legíveis por Humanos em C#

Enums, ou enumerações, são uma “classe” especial em C# que representa um grupo de constantes. Eles são amplamente utilizados para definir tipos de variáveis que podem conter um conjunto predefinido de valores. No entanto, ao trabalhar com enums, converter seus nomes codificados em strings legíveis por humanos pode ser um desafio. Este post aborda esse problema e fornece uma solução simples.

O Desafio da Legibilidade dos Enums

Imagine que você tem um enum definido assim:

public enum SampleEnum
{
    ThisIsValueA,
    ThisIsValueB,
    AnotherValue
}

Usando este enum, se você precisar exibir ThisIsValueA de uma maneira amigável para o usuário em sua aplicação, você gostaria que ele aparecesse como “This is Value A”. O desafio está na conversão automática dessas convenções de nomenclatura em camel case em texto limpo e legível.

A Solução: Um Método Simples de Wordify

Para converter um valor de enum em uma string legível por humanos, podemos usar um método chamado Wordify. Este método recebe uma string passada em PascalCase (que é como os nomes dos enums são tipicamente definidos) e separa as palavras com espaços onde necessário.

Aqui está uma descrição passo a passo:

Passo 1: Implementar o Método Wordify

Você pode implementar o método Wordify no seu código como mostrado abaixo:

using System.Text.RegularExpressions;

public static string Wordify(string pascalCaseString)
{            
    Regex regex = new Regex("(?<=[a-z])(?<x>[A-Z])|(?<y>.)(?<x>[A-Z])(?=[a-z])");
    return regex.Replace(pascalCaseString, " ${x}");
}

Explicação:

• Padrão Regex: O padrão regex funciona ao encontrar letras maiúsculas que estão precedidas por uma letra minúscula ou seguidas por uma letra minúscula. Isso garante que siglas (grupos de letras maiúsculas) permaneçam intactas.
• Instrução de Retorno: O método substitui essas correspondências por um espaço seguido pela letra maiúscula correspondente, separando-as em palavras distintas.

Passo 2: Usando o Método Wordify

Para ver o método em ação, você pode executar o seguinte código:

Console.WriteLine(Wordify(SampleEnum.ThisIsValueA.ToString()));

Saída:

Esta linha de código irá gerar a seguinte saída:

"This Is Value A"

Benefícios de Usar Wordify

• Simplicidade: É uma solução direta que requer código mínimo.
• Evitar Atributos: Este método é mais simples e menos redundante do que definir atributos de Descrição para enums, o que pode complicar desnecessariamente seu código.
• Abordagem Direta: Permite que você obtenha nomes de enums legíveis por humanos sem sobrecarga adicional.

Conclusão

Converter enums em valores legíveis por humanos em C# não precisa ser complicado. Ao implementar o método Wordify, você pode transformar facilmente qualquer string em PascalCase em um formato amigável ao usuário em apenas algumas linhas de código, melhorando a clareza e a usabilidade de suas aplicações. Tente incorporar este método em seu próximo projeto para agilizar o processo de exibição de valores de enum para os usuários.