Compartilhar via

Personalizar como o Visual Studio cria legendas para controles associados a dados em aplicativos do .NET Framework

  • Artigo

Observação

Os conjuntos de dados e as classes relacionadas são tecnologias herdadas do .NET Framework do início dos anos 2000 que permitem que os aplicativos trabalhem com dados na memória enquanto os aplicativos estão desconectados do banco de dados. Eles são bastante úteis em aplicativos que permitem que os usuários modifiquem dados e persistam as alterações no banco de dados. Embora os conjuntos de dados tenham se mostrado uma tecnologia muito bem-sucedida, é recomendado que os novos aplicativos .NET usem o Entity Framework Core. O Entity Framework proporciona uma forma mais natural de trabalhar com dados tabulares como modelos de objeto e conta com uma interface de programação mais simples.

Ao arrastar itens da janela Fontes de Dados para um designer, uma consideração especial entra em jogo: os nomes de coluna nos rótulos de legenda são reformatados em uma cadeia de caracteres mais legível quando duas ou mais palavras são concatenadas.

Você pode personalizar a forma como esses rótulos são criados definindo os valores SmartCaptionExpression, SmartCaptionReplacement e SmartCaptionSuffix na chave do Registro HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\16.0\Data Designers.

Observação

Essa chave do Registro não existe até que você a crie.

A legenda inteligente é controlada pela expressão regular inserida no valor SmartCaptionExpression. Adicionar a chave do Registro de Designers de Dados substitui a expressão regular padrão que controla rótulos de legenda. Para obter mais informações sobre expressões regulares, confira Usar expressões regulares no Visual Studio.

A tabela a seguir descreve os valores de registro que controlam rótulos de legenda.

Item de registro Descrição
SmartCaptionExpression A expressão regular que você usa para corresponder aos seus padrões.
SmartCaptionReplacement O formato para exibir todos os grupos correspondentes no SmartCaptionExpression.
SmartCaptionSuffix Uma cadeia de caracteres opcional a ser acrescentada ao final da legenda.

A tabela a seguir lista as configurações padrão internas para esses valores de registro.

Item de registro Valor padrão Explicação
SmartCaptionExpression (\\p{Ll})(\\p{Lu})|_+ Corresponde a um caractere minúsculo seguido por um caractere maiúsculo ou um sublinhado.
SmartCaptionReplacement USD 1, USD 2 O $1 representa todos os caracteres correspondentes nos primeiros parênteses da expressão, e $2 representa todos os caracteres correspondentes nos segundos parênteses. A substituição é a primeira correspondência, um espaço e, em seguida, a segunda correspondência.
SmartCaptionSuffix : Representa um caractere acrescentado à cadeia de caracteres retornada. Por exemplo, se a legenda for Company Name, o sufixo o tornará Company Name:.

Cuidado

Tenha muito cuidado ao fazer qualquer coisa no Editor de registro. Faça backup do registro antes de editá-lo. Se o Editor do registro for usado incorretamente, você poderá causar sérios problemas que podem obrigar a reinstalação do sistema operacional. A Microsoft não garante que seja possível resolver os problemas causados pelo uso incorreto do Editor de registro. Use o Editor de Registro por sua conta e risco.

Para obter informações sobre backup, edição e restauração do registro, confira Informações de registro do Windows para usuários avançados.

Modificar o comportamento de legendagem inteligente da janela Fontes de Dados

  1. Abra uma janela de comando clicando em Iniciar e depois em Executar.

  2. Digite regedit na caixa de diálogo Executar e clique em OK.

  3. Expanda o nó HKEY_CURRENT_USER>Software>Microsoft>VisualStudio.

  4. Clique com o botão direito do mouse no nó 16.0 e crie uma nova Chave chamada Data Designers.

  5. Clique com o botão direito do mouse no nó Designers de Dados e crie três novos valores da cadeia de caracteres:

    • SmartCaptionExpression
    • SmartCaptionReplacement
    • SmartCaptionSuffix

  6. Clique com o botão direito do mouse no valor SmartCaptionExpression e selecione Modificar.

  7. Insira a expressão regular que você deseja que a janela Fontes de Dados use.

  8. Clique com o botão direito do mouse no valor SmartCaptionReplacement e selecione Modificar.

  9. Insira a cadeia de caracteres de substituição formatada do modo que você deseja exibir os padrões correspondentes em sua expressão regular.

  10. Clique com o botão direito do mouse no valor SmartCaptionSuffix e selecione Modificar.

  11. Insira todos os caracteres que você quer que apareçam no final da legenda.

    Na próxima vez que você arrastar itens da janela Fontes de Dados, os rótulos de legenda serão criados usando os novos valores de registro fornecidos.

Desativar o recurso de legendagem inteligente

  1. Abra uma janela de comando clicando em Iniciar e depois em Executar.

  2. Digite regedit na caixa de diálogo Executar e clique em OK.

  3. Expanda o nó HKEY_CURRENT_USER>Software>Microsoft>VisualStudio.

  4. Clique com o botão direito do mouse no nó 16.0 e crie uma nova Chave chamada Data Designers.

  5. Clique com o botão direito do mouse no nó Designers de Dados e crie três novos valores da cadeia de caracteres:

    • SmartCaptionExpression
    • SmartCaptionReplacement
    • SmartCaptionSuffix

  6. Clique com o botão direito do mouse no item SmartCaptionExpression e selecione Modificar.

  7. Insira (.*) como o valor. Isso corresponderá à toda a cadeia de caracteres.

  8. Clique com o botão direito do mouse no item SmartCaptionReplacement e selecione Modificar.

  9. Insira $1 como o valor. Isso substitui a cadeia de caracteres pelo valor correspondente, que é a cadeia de caracteres inteira, de modo que ela permaneça inalterada.

    Na próxima vez que você arrastar itens da janela Fontes de Dados, os rótulos de legenda serão criados com legendas não modificadas.

Conteúdo relacionado