Compartilhar via


Corresponder a um padrão usando o Visual C# e expressões regulares

Este artigo passo a passo apresenta como criar e usar expressões regulares para determinar se as cadeias de caracteres correspondem a determinados padrões.

Versão original do produto: Visual C#
Número original do KB: 308252

Resumo

As expressões regulares permitem fácil análise e correspondência de strings com um padrão específico. Usando os objetos disponíveis no RegularExpressions namespace, você pode comparar uma cadeia de caracteres com um determinado padrão, substituir um padrão de cadeia de caracteres por outra cadeia de caracteres ou recuperar apenas partes de uma cadeia de caracteres formatada. Neste exemplo, construiremos um padrão para validar um endereço de email. Este artigo refere-se ao namespace System.Text.RegularExpressionsda Biblioteca de Classes do Microsoft .NET Framework.

Requisitos

Este artigo pressupõe que você esteja familiarizado com os seguintes tópicos:

  • Visual C#
  • Sintaxe de expressões regulares

Usar expressões regulares para corresponder a um padrão

  1. Inicie o Visual C#.

  2. Crie um novo aplicativo de console do Visual C#.

  3. Especifique a palavra-chave using no Text.RegularExpressions namespace para que você não precise qualificar declarações nesses namespaces posteriormente em seu código. A instrução using deve ser usada antes de qualquer outra declaração:

    using System.Text.RegularExpressions;
    
  4. Defina uma nova expressão regular que usará uma correspondência de padrão para validar um endereço de email. A seguinte expressão regular é estruturada para realizar três coisas:

    1. Capture a substring antes do @ símbolo e coloque-a user no grupo.
    2. Capture a substring após o @ símbolo e coloque-a host no grupo.
    3. Certifique-se de que a primeira metade da string não tenha um @ símbolo.
    Regex emailregex = new Regex("(?<user>[^@]+)@(?<host>.+)");
    
  5. Defina uma nova cadeia de caracteres contendo um endereço de email válido. Isso fornece um valor padrão se o argumento de linha de comando do método estiver vazio:

    String s = "johndoe@tempuri.org";
    
  6. Verifique se há algum parâmetro de linha de comando; se houver, recupere o primeiro parâmetro e atribua-o à variável s.

    if (args.Length > 0) {
        s = args[0];
    }
    
  7. Use o Match método para passar a variável de endereço de email e retornar um novo Match objeto. O Match objeto retornará independentemente de alguma correspondência ter sido encontrada na cadeia de caracteres de origem.

    Match m = emailregex.Match(s);
    
  8. Ao examinar a Success propriedade, podemos decidir se devemos continuar processando o Match objeto ou imprimir uma mensagem de erro. Se for bem-sucedido, exiba os user grupos e host nomeados na Groups coleção do Match objeto.

    if (m.Success)
    {
        Console.WriteLine ("User: " + m.Groups["user"].Value);
        Console.WriteLine ("Host: " + m.Groups["host"].Value);
    }
    else
    {
        Console.WriteLine (s + " is not a valid email address");
    }
    Console.WriteLine ();
    
  9. Para manter a janela do console aberta após executar o aplicativo, adicione as seguintes linhas de código:

    System.Console.WriteLine("Press Enter to Continue...");
    System.Console.ReadLine();
    
  10. Compile o projeto.

  11. Para executar o aplicativo no ambiente de desenvolvimento usando o endereço de email padrão especificado no código, pressione F5 ou selecione Iniciar no menu Depurar . Para iniciar o aplicativo com um argumento de linha de comando, há três opções:

    • No menu Projeto , clique em Propriedades e, em seguida, clique em Depurar. Na seção Opções de Início, no painel direito, especifique o endereço de email que você deseja testar. Pressione F5 ou clique em Iniciar no menu Depurar para executar o aplicativo.
    • Inicie uma janela de comando e navegue até a pasta bin ou debug na pasta em que seu projeto reside. Em seguida, digite o nome do executável seguido do endereço de e-mail que deseja testar.
    • Localize o arquivo executável deste projeto e arraste-o para o menu Iniciar... Executar na barra de tarefas. Adicione o endereço de e-mail a ser verificado e clique em OK.

Referências