Compartilhar via


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

Observação

A DataSet classe 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 são desconectados do banco de dados. As tecnologias são especialmente úteis para aplicativos que permitem que os usuários modifiquem dados e persistam as alterações no banco de dados. Embora os conjuntos de dados sejam uma tecnologia comprovadamente bem-sucedida, a abordagem recomendada para novos aplicativos .NET é usar o Entity Framework Core. O Entity Framework fornece uma maneira mais natural de trabalhar com dados tabulares como modelos de objeto e tem 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 maneira 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 Data Designers substitui a expressão regular padrão que controla rótulos de legenda. Para obter mais informações sobre expressões regulares, consulte Usando expressões regulares no Visual Studio.

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

Item do 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 do Registro.

Item do 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 $1 $2 O $1 representa todos os caracteres correspondentes nos primeiros parênteses da expressão, e o $2 representa todos os caracteres correspondentes no segundo 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 fará Company Name:

Cuidado

Tenha muito cuidado ao fazer qualquer coisa no Editor do Registro. Faça backup do Registro antes de editá-lo. Se você usar o Editor do Registro incorretamente, poderá causar sérios problemas que podem exigir a reinstalação do sistema operacional. A Microsoft não garante que os problemas causados usando o Editor do Registro incorretamente possam ser resolvidos. Use o Editor de Registro por sua conta e risco.

Para obter informações sobre como fazer backup, editar e restaurar o registro, consulte as informações do Registro do Windows para usuários avançados.

Modificar o comportamento de legendagem automática da janela Fontes de Dados

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

  2. Digite regedit a 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ó Data Designers e crie três novos valores de string:

    • 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 da maneira 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ê deseja 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 do Registro fornecidos.

Desativar o recurso de legenda inteligente

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

  2. Digite regedit a 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ó Data Designers e crie três novos valores de string:

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

  7. Insira (.*) para 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 o valor $1. Isso substitui a cadeia de caracteres pelo valor correspondente, que é a cadeia de caracteres inteira para 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.