Exercício – Chamar os métodos de uma classe .NET
Quer você tenha percebido ou não, você tem chamado métodos C# desde o primeiro aplicativo "Olá, Mundo!". Esse aplicativo usa o método WriteLine() da classe Console para exibir a mensagem "Olá, Mundo!".
No entanto, nem todas as classes e métodos são implementados da mesma maneira. Esta unidade aborda algumas das variantes mais comuns que você precisará entender ao usar métodos da biblioteca de classes do .NET. Mais importante, você aprenderá a localizar e usar a documentação para entender melhor o método.
Como chamar métodos na Biblioteca de Classes do .NET
Com base em sua experiência anterior com o método Console.WriteLine(), você já deve conhecer os conceitos básicos:
- Comece digitando o nome da classe. Neste caso, o nome da classe é
Console. - Adicione o operador de acesso de membro, o símbolo
.. - Adicione o nome do método. Neste caso, o nome do método é
WriteLine. - Adicione o operador de chamada do método, que é um conjunto de parênteses
(). - Finalmente, especifique os argumentos que serão transmitidos ao método, se houver algum, entre os parênteses do operador de invocação de método. Aqui, você especifica o texto que deseja que o método
Console.WriteLine()escreva no console (por exemplo,"Hello World!").
Opcionalmente, dependendo de como os desenvolvedores criaram e implementaram o método especificado, você também precisará:
- Passar valores adicionais como parâmetros de entrada.
- Aceitar um valor retornado.
Na próxima unidade, você examinará como transmitir valores de entrada para um método e como um método pode ser usado para retornar um valor para a rotina de chamada.
Embora alguns métodos possam ser chamados da mesma forma que você chamou Console.WriteLine(), há outros na biblioteca de classes do .NET que requerem uma abordagem diferente.
Preparar o ambiente de codificação
Este módulo inclui atividades de codificação que o orientam no processo de compilação e execução do código de exemplo. É recomendado 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, acesse a pasta Área de Trabalho do Windows.
Se você mantém os projetos de código em um local de pasta diferente, use esse local. Neste treinamento, o importante é ter um local 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 você estiver trabalhando em seu próprio computador em vez de em uma área restrita ou ambiente hospedado e tiver concluído outros módulos do Microsoft Learn desta série de C#, talvez já tenha criado uma pasta de projeto para exemplos de código. Nesse caso, é possível ignorar a próxima etapa, que será usada para criar o aplicativo de console na pasta TestProject.
No prompt de comando Terminal, para criar o novo aplicativo de console na 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.
Chame diferentes tipos de métodos na biblioteca de classes do .NET
No Editor do Visual Studio Code, para criar um exemplo de código que implemente métodos das classes
System.RandomeSystem.Console, insira o seguinte código:Random dice = new Random(); int roll = dice.Next(1, 7); Console.WriteLine(roll);Este código simula um lançamento de dados usando o método
Random.Next()para gerar um número e o métodoConsole.WriteLine()para exibir o valor.Observação
Você examinará o código em detalhes posteriormente nesta unidade.
No menu Arquivo do Visual Studio Code, clique em Salvar.
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.
Observe que o painel “Terminal” inclui um prompt de comando que exibe um caminho de pasta. Por exemplo:
C:\Users\someuser\Desktop\CsharpProjects\TestProject>Quando você usar o Terminal para executar comandos da CLI do .NET, os comandos serão executados nesse local de pasta. Verifique se a pasta de código corresponde ao caminho de pasta exibido no prompt de comando antes de criar ou executar o código.
No prompt de comando do Terminal, para executar o código, digite dotnet run e pressione Enter.
Observe que um número de 1 a 6 é exibido na saída do console (o número de pontos no dado). Se você executar o código muitas vezes, verá eventualmente todos os números exibidos.
Dedique alguns minutos ao exame da sintaxe usada para acessar os métodos
Next()eWriteLine().Observe que você usa técnicas diferentes para acessar os métodos.
Random dice = new Random(); int roll = dice.Next(1, 7); Console.WriteLine(roll);Na terceira linha de código, você inclui uma referência à classe
Consolee chama o métodoConsole.WriteLine()diretamente. No entanto, você usa uma técnica diferente para chamar o métodoRandom.Next(). Você está usando duas técnicas diferentes porque alguns são métodos com estado e outros são métodos sem estado. A próxima etapa é examinar a diferença entre métodos com e sem estado.
Métodos com estado vs. sem estado
Em projetos de desenvolvimento de software, o termo estado é usado para descrever a condição do ambiente de execução em um momento específico no tempo. Conforme seu código executa linha por linha, os valores são armazenados em variáveis. A qualquer momento durante a execução, o estado atual do aplicativo é a coleção de todos os valores armazenados na memória.
Alguns métodos não dependem do estado atual do aplicativo para funcionarem corretamente. Em outras palavras, os métodos sem estado são implementados para que possam funcionar sem referenciar ou alterar os valores já armazenados na memória. Os métodos sem estado também são conhecidos como métodos estáticos.
Por exemplo, o método Console.WriteLine() não depende de nenhum valor armazenado na memória. Ele executa sua função e termina sem afetar o estado do aplicativo de qualquer forma.
Outros métodos, contudo, devem ter acesso ao estado do aplicativo para funcionar corretamente. Em outras palavras, os métodos com estado são construídos de maneira que os torna dependentes de valores armazenados na memória por linhas de código anteriores já executadas. Ou eles modificam o estado do aplicativo atualizando valores ou armazenando novos valores na memória. Eles também são conhecidos como métodos de instância.
Os métodos com estado (instância) controlam seu estado em campos, que são variáveis definidas na classe. Cada nova instância da classe tem sua própria cópia desses campos nos quais o estado é armazenado.
Uma única classe pode dar suporte a métodos com e sem estado. No entanto, quando você precisa chamar métodos com estado, deve primeiro criar uma instância da classe para que o método possa acessar o estado.
Criar uma instância de uma classe
Uma instância de uma classe é chamada de um objeto. Para criar uma instância de uma classe, use o operador new. Considere a seguinte linha de código que cria uma instância da classe Random para criar um objeto chamado dice:
Random dice = new Random();
O operador new faz várias coisas importantes:
- Primeiro, ele solicita um endereço na memória do computador grande o suficiente para armazenar um novo objeto com base na classe
Random. - Ele cria o objeto e o armazena no endereço de memória.
- Ele retorna o endereço de memória para que ele possa ser salvo na variável
dice.
Desse ponto em diante, quando a variável dice é referenciada, o Tempo de Execução do .NET executa uma pesquisa nos bastidores para dar a ilusão de que você está trabalhando diretamente com o próprio objeto.
A versão mais recente do Runtime do .NET permite que você crie uma instância de um objeto sem ter que repetir o nome do tipo (invocação de construtor com tipo de destino). Por exemplo, o código a seguir criará uma nova instância da classe Random:
Random dice = new();
A intenção é simplificar a legibilidade do código. Você sempre usa parênteses ao escrever uma expressão new do tipo de destino.
Por que o método Next() é com estado?
Talvez você esteja se perguntando por que o método Next() foi implementado como um método com estado? Os designers da Biblioteca de Classes do .NET não conseguiram descobrir uma maneira de gerar um número aleatório sem exigir estado? E o que exatamente está sendo armazenado ou referenciado pelo método Next()?
Essas são perguntas justas. Em um alto nível, os computadores são bons em seguir instruções específicas para criar um resultado confiável e repetível. Para criar a ilusão de aleatoriedade, os desenvolvedores do método Next() decidiram capturar a data e hora até a fração de um milissegundo e usar isso para propagar um algoritmo que produz um número diferente a cada vez. Embora não seja totalmente aleatório, isso é suficiente para a maioria dos aplicativos. O estado capturado e mantido durante o tempo de vida do objeto dice é o valor de semente. Cada chamada subsequente ao método Next() está executando novamente o algoritmo, mas verifica se a semente é alterada para que o mesmo valor não seja (necessariamente) retornado.
No entanto, para usar o método Random.Next(), você não precisa entender como ele funciona. O importante a saber é que alguns métodos exigem que você crie uma instância de uma classe antes de chamá-los, enquanto outros não.
Como é possível determinar se você precisa criar uma instância de uma classe antes de chamar seus métodos?
Uma abordagem para determinar se um método é um método com ou sem estado é consultar a documentação. A documentação inclui exemplos que mostram se ele deve ser chamado por meio da instância do objeto ou diretamente da classe.
Observação
Às vezes, você precisa rolar para baixo na página da documentação para encontrar os exemplos de código.
Como alternativa à pesquisa na documentação do produto, é possível tentar acessar o método diretamente por meio da própria classe. Se isso funcionar, você saberá que é um método sem estado. O pior que pode acontecer é você receber um erro de compilação.
Tente acessar o método Random.Next() diretamente e veja o que acontece.
Insira a seguinte linha de código no Editor do Visual Studio Code:
int result = Random.Next();Você já sabe que
Next()é um método com estado, no entanto, este exemplo demonstra como o Editor do Visual Studio Code reage quando você tenta acessar um método incorretamente.Observe que uma linha ondulada vermelha aparece abaixo de
Random.Next, indicando que há um erro de compilação.Se você estiver interessado em usar um método sem estado, nenhuma linha ondulada vermelha aparecerá.
Passe o ponteiro do mouse sobre a linha ondulada vermelha.
Uma janela pop-up deve aparecer com a seguinte mensagem:
(1,14): error CS0120: An object reference is required for the non-static field, method, or property 'Random.Next()'Como você viu no código do início da unidade, é possível corrigir esse erro criando uma instância da classe
Randomantes de acessar o métodoNext(). Por exemplo:Random dice = new Random(); int roll = dice.Next();Nesse caso, o método
Next()é chamado sem parâmetros de entrada.
Recapitulação
- Para chamar métodos de uma classe na Biblioteca de Classes do .NET, use o formato
ClassName.MethodName(), em que o símbolo.é o operador de acesso de membro para acessar um método definido na classe e os símbolos()são os operadores de invocação de método. - Ao chamar um método sem estado, não é necessário criar uma instância de sua classe primeiro.
- Ao chamar um método com estado, é necessário criar uma instância da classe e acessar o método no objeto.
- Use o operador
newpara criar uma instância de uma classe. - Uma instância de uma classe é chamada de um objeto.