Exercício – Criar seu primeiro método

10 minutos

Normalmente, um método é criado para executar uma tarefa específica. Neste exercício, você criará um método que gera e exibe cinco números aleatórios. Vamos começar!

Preparar o ambiente de codificação

Este módulo inclui atividades práticas que orientam você durante o processo de criação e execução do código de demonstração. Incentivamos você a concluir essas atividades usando o Visual Studio Code como ambiente de desenvolvimento. Usar o Visual Studio Code nessas atividades ajudará você a se sentir mais confortável escrevendo e executando o código em um ambiente de desenvolvedor usado por profissionais em todo o mundo.

Abra o Visual Studio Code.

Você pode usar o menu Iniciar do Windows (ou recurso equivalente em outro sistema operacional) para abrir o Visual Studio Code.
No Visual Studio Code, no menu Arquivo, selecione Abrir Pasta.
Na caixa de diálogo Abrir Pasta, navegue até a pasta Área de Trabalho do Windows.

Se você tiver um local de pasta diferente no qual mantém os projetos de código, poderá usar esse local de pasta. Neste treinamento, o importante é ter um local que seja fácil de localizar e lembrar.
Na caixa de diálogo Abrir Pasta, selecione Selecionar Pasta.

Se aparecer uma caixa de diálogo de segurança perguntando se confia nos autores, selecione Sim.
No Visual Studio Code, no menu Terminal, selecione Novo Terminal.

Observe que o prompt de comando no painel Terminal exibe o caminho da pasta atual. Por exemplo:
```
C:\Users\someuser\Desktop>
```
Observação

Se estiver trabalhando no seu PC, em vez de em um ambiente de área restrita ou hospedado, e tiver concluído outros módulos do Microsoft Learn nesta série C#, talvez já tenha criado uma pasta de projeto para amostras de código. Se esse for o caso, você poderá ignorar a próxima etapa, que será usada para criar o aplicativo de console na pasta TestProject.
No prompt de comando terminal, para criar um novo aplicativo de console em uma pasta especificada, digite dotnet new console -o ./CsharpProjects/TestProject e pressione Enter.

Este comando da CLI do .NET usa um modelo de programa .NET para criar o novo projeto de aplicativo de console C# no local da pasta especificada. O comando cria as pastas CsharpProjects e TestProject para você e usa TestProject como o nome do arquivo .csproj.
No painel EXPLORER, expanda a pasta CsharpProjects.

Você deve ver a pasta TestProject e dois arquivos: o arquivo de programa do C#, denominado Program.cs, e o arquivo de projeto do C#, denominado TestProject.csproj.
No painel EXPLORER, para exibir o arquivo de código no painel Editor, selecione Program.cs.
Exclua as linhas de código existentes.

Você usará esse projeto de console C# para criar, compilar e executar exemplos de código durante este módulo.
Feche o painel do terminal.

Criar um método para exibir números aleatórios

Para criar um método, primeiro crie uma assinatura de método e adicione o corpo do método. Para criar a assinatura do método, você declara o tipo de retorno, o nome do método e os parâmetros. Crie o corpo do método usando colchetes {} que contêm o código.

Insira o código de exemplo a seguir no editor do Visual Studio Code:
```
void DisplayRandomNumbers();
```
Nesse caso, o método só precisa gerar e exibir informações, portanto, o tipo de retorno é void. Por enquanto, você não precisa incluir nenhum parâmetro.
Para criar o corpo do método, remova o ponto e vírgula ; e atualize o código para o seguinte:
```
void DisplayRandomNumbers() 
{
    Random random = new Random();
}
```
Aqui você cria um objeto Random usado para gerar os números.
Para exibir cinco inteiros aleatórios, adicione um loop for ao seu método:
```
void DisplayRandomNumbers() 
{
    Random random = new Random();

    for (int i = 0; i < 5; i++) 
    {
        Console.Write($"{random.Next(1, 100)} ");
    }
}
```
Nesse código, você gera um número entre 1 e 99 (inclusive). Você também adiciona um espaço depois que o número é impresso. Em seguida, você exibirá uma nova linha antes que o método seja encerrado.

Atualize o método pelo seguinte código:

void DisplayRandomNumbers() 
{
    Random random = new Random();

    for (int i = 0; i < 5; i++) 
    {
        Console.Write($"{random.Next(1, 100)} ");
    }

    Console.WriteLine();
}

Agora seu método adicionará uma nova linha depois de exibir os números.

Chamar seu método

Insira uma nova linha de código em branco acima do método DisplayRandomNumbers.

Insira o seguinte código na nova linha de código em branco:

Console.WriteLine("Generating random numbers:");
DisplayRandomNumbers();

Compare o código com o seguinte para garantir que ele esteja correto:
```
Console.WriteLine("Generating random numbers:");
DisplayRandomNumbers();

void DisplayRandomNumbers() 
{
    Random random = new Random();

    for (int i = 0; i < 5; i++) 
    {
        Console.Write($"{random.Next(1, 100)} ");
    }

    Console.WriteLine();
}
```
Observe como usar um método torna o código fácil de entender. Em vez de gastar tempo tentando decifrar o loop for por conta própria, você pode ler rapidamente o nome do método para saber que esse código exibe números aleatórios.

Verificar seu trabalho

Nesta tarefa, você executará o aplicativo no Terminal Integrado e verificará se o código está funcionando corretamente. Vamos começar.

Salve o trabalho usando Ctrl + S ou usando o menu Arquivo no Visual Studio Code.
Se necessário, abra o painel Terminal Integrado do Visual Studio Code.

No painel EXPLORER, para abrir o Terminal no local da pasta TestProject, clique com o botão direito do mouse em TestProject e selecione Abrir no Terminal Integrado.
No prompt de comando do Terminal, digite dotnet run
Para verificar se o código está funcionando conforme o esperado, verifique se a saída do aplicativo é semelhante à seguinte saída (levando em conta os números gerados aleatoriamente):
```
17 29 46 36 3 
```
Se o código exibir resultados diferentes, você precisará examinar o código para encontrar o erro e fazer atualizações. Execute o código novamente para ver se você corrigiu o problema. Continue atualizando e executando o código até que ele produza os resultados esperados.

Recapitulação

Aqui está o que você aprendeu sobre métodos até agora:

Crie um método declarando o tipo de retorno, o nome, os parâmetros de entrada e o corpo do método.
Os nomes de método devem refletir claramente a tarefa que o método executa.
Use um método chamando seu nome e incluindo parênteses ().

Comentários

Esta página foi útil?