Testando uma classe

Artigo
08/25/2010

Nesta lição, você aprenderá como criar uma instância de uma classe para testar a classe.

Em algumas lições passadas, você criou uma classe Persons e deu a ela propriedades, métodos e eventos.Até o momento, tudo que fez foi adicionar código. Agora é hora de usar a classe Persons e verificar se ela funciona como esperado.

Criando uma instância de uma classe

Embora você possa não ter percebido, você usou classes em muitas das lições anteriores.Formulários e controles são na verdade classes; quando você arrasta um controle Button para um formulário, você está, na verdade, criando uma instância da classe Button.

Você pode também criar uma instância de qualquer classe em seu código usando uma declaração com a palavra-chave New.Por exemplo, para criar uma nova instância da classe Button, você deve adicionar o código a seguir.

Dim aButton As New Button

Para usar e testar a classe Persons, você deve primeiro criar um projeto de teste e adicionar uma referência ao módulo de classe.

Tente-o!

Para criar um projeto de teste para sua classe

Abra o projeto Persons que você criou na lição anterior.Se você não o salvou, você primeiro precisará voltar para a lição anterior, Adicionando métodos a uma classe, e concluir os procedimentos na lição.
No menu File, aponte para Add, e clique New Project.
Sobre o Modelos painel o Novo projeto diálogo, clicar Aplicativo do Windows Forms.
Na caixa Name digite PersonsTeste clique em OK.

Um novo projeto Windows Forms é adicionado ao O gerenciador de soluções e um novo formulário é exibido.
No Solution Explorer, selecione o projeto PersonsTest e em seguida, no menu Project, clique em Set as StartUp Project.
No Solution Explorer, selecione o projeto PersonsTest e em seguida, no menu Project, clique em Add Reference.

The Adicionar referência caixa de diálogo é exibida.
Clique na guia Projects e em seguida, selecione Persons e clique em OK.
Clique duas vezes no formulário para abrir o Editor de Código e em seguida, digite a seguinte declaração apenas sob a linha Public Class Form1.
```
Dim person1 As New Persons.Persons
```
Isso declara uma nova instância da classe Persons.Você deve estar imaginando por que você teve que digitar pessoas duas vezes — a primeira instância é o módulo de classe persons.vb; a segunda instância é o Persons classe dentro desse módulo.
No menu File, clique em Save All.

Testando sua classe

A próxima etapa é adicionar uma interface do usuário e código que usa a classe Persons.Você irá adicionar caixas de texto nas quais o usuário irá inserir valores para cada uma das propriedades (exceto a propriedade somente leitura Age), uma caixa de seleção para o campo Married e botões para testar cada um dos métodos públicos.

Tente-o!

Para testar sua classe

No Solution Explorer, selecione Form1 e em seguida, no menu View, clique em Designer.
Da Toolbox, arraste quatro controles TextBox, um controle CheckBox e dois controles Button para o formulário.
selecionar a primeira Button controle e, em seguida, nas Propriedades janela defina seus Text propriedade para Update**.**
Selecionar o segundo controle Button e em seguida, na janela Properties, defina sua propriedade Text para Full Name**.**
Clique duas vezes no primeiro botão (Update) para abrir o Editor de Código e, em seguida, adicione o código a seguir no manipulador de eventos Button1_Click.
```
With person1
    .FirstName = Textbox1.Text
    .MiddleName = Textbox2.Text
    .LastName = Textbox3.Text
    .BirthYear = Textbox4.Text
    .Married = CheckBox1.Checked
End With
```
Observe que ao digitar, uma lista que contém os membros da classe Persons é exibida.Como ele foi adicionado como uma referência, o IntelliSense exibe informações sobre sua classe exatamente como ele faria para qualquer outra classe.

No manipulador de eventos Button2_Click, adicione o código a seguir.

' Test the FullName method.
MsgBox(person1.FullName)

' test the Age property and CalcAge method.
MsgBox(CStr(person1.Age) & " years old")

' Test the Married property.
If person1.Married = True Then
    MsgBox(person1.FirstName & " is married")
Else
    MsgBox(person1.FirstName & " is single")
End If

Pressione F5 para executar o projeto e exibir o formulário.
1. Na primeira caixa de texto, digite seu nome.
2. Na segunda caixa de texto, digite seu primeiro sobrenome.
3. Na terceira caixa de texto, digite seu último sobrenome.
4. Na quarta caixa de texto, insira o ano de quatro dígitos do seu nascimento (por exemplo, 1983).
5. Marque a caixa de seleção se são casado.
Clique no botão Update para definir as propriedades da classe e em seguida, clique no botão Full Name.

Três caixas de mensagem são exibidas.Essas caixas de mensagem mostram seu nome completo, sua idade e seu estado civil.
No menu File, clique em Save All.

Testando os métodos sobrecarregados

Se você concluiu a lição opcional Examinar mais detalhadamente: Criando várias versões do mesmo método com sobrecarga, você também desejará testar os métodos sobrecarregados que você adicionou à classe Persons.Se você não concluiu a lição, você pode voltar e fazer isso agora, ou você pode ignorar o procedimento a seguir.

Tente-o!

Para testar os métodos sobrecarregados

No Solution Explorer, selecione Form1 e em seguida, no menu View, clique em Designer.
Na Toolbox, arraste mais dois controles Button para o formulário.
Selecione o terceiro controle Button e em seguida, na janela Properties, defina sua propriedade Text como With.
Selecione o quarto controle Button e em seguida, na janela Properties, defina sua propriedade Text como Without.
Clique duas vezes no primeiro botão (With) para abrir o Editor de Código e, em seguida, adicione o código a seguir no manipulador de eventos Button3_Click.
```
MsgBox(person1.FirstName & " " & person1.MiddleInitial(True) & _
                           " " & person1.LastName)
```
Observe que ao digitar, uma lista que contém os membros da classe Persons é exibida.Como ela foi adicionada como uma referência, o IntelliSense exibe informações sobre sua classe exatamente como ele faria para qualquer outra classe.

No manipulador de eventos Button4_Click, adicione o código a seguir.

MsgBox(person1.FirstName & " " & person1.MiddleInitial & _
                           " " & person1.LastName)

Pressione F5 para executar o projeto e exibir o formulário.
1. Na primeira caixa de texto, digite seu nome.
2. Na segunda caixa de texto, digite seu primeiro sobrenome.
3. Na terceira caixa de texto, digite seu último sobrenome.
4. Na quarta caixa de texto, insira o ano de quatro dígitos do seu nascimento (por exemplo, 1983).
5. Marque a caixa de seleção se são casado.
Clique no botão Update para definir as propriedades da classe e em seguida, clique no botão With.

Uma caixa de mensagem é exibida.Ela mostra seu nome com um período após a inicial do primeiro sobrenome.
Clique no botão Without.

Uma caixa de mensagem é exibida.Ela mostra seu nome sem um período após a inicial do primeiro sobrenome.
No menu File, clique em Save All.

Testando manipuladores de eventos

Se você concluiu a lição opcional Examinar mais detalhadamente: Tratamento de eventos, você também desejará testar os manipuladores de eventos que você adicionou à classe Persons.Se você não concluiu essa lição, você pode voltar e fazer isso agora, ou você pode ignorar o procedimento a seguir.

Tente-o!

Para testar o manipulador de eventos

No Solution Explorer, selecione Form1 e em seguida, no menu View, clique em Code.
Adicione a instrução WithEvents antes da declaração person1, conforme mostrado no código a seguir:
```
WithEvents person1 As New Persons.Persons
```

Adicione o seguinte procedimento ao Form1.Esse código verifica a idade calculada e exibe uma mensagem com base no resultado.

Private Sub person1_AgeCalculated(ByVal Age As Integer) _
    Handles person1.AgeCalculated

    If Age > 18 Then
        MsgBox("You have been over 18 for " & Age - 18 _
            & " years.")
    Else
        MsgBox("You will be 18 in " & 18 - Age & " years")
    End If

End Sub

Pressione F5 para executar o projeto e exibir o formulário.
1. Na primeira caixa de texto, digite seu nome.
2. Na segunda caixa de texto, digite seu primeiro sobrenome.
3. Na terceira caixa de texto, digite seu último sobrenome.
4. Na quarta caixa de texto, insira o ano de quatro dígitos do seu nascimento (por exemplo, 1983).
5. Marque a caixa de seleção se são casado.
Clique no botão Update para definir as propriedades da classe e em seguida, clique no botão Full Name.

Um caixa de mensagem exibe seu nome completo.Se você tiver mais de 18 anos de idade, outra caixa de mensagem exibe informações sobre quanto tempo você esteve mais 18.Se você tiver menos de 18 anos de idade, uma caixa de mensagem exibe informações sobre quanto tempo será até que ative 18.Em seguida, outra caixa de mensagem exibe sua idade.
No menu File, clique em Save All.

Próximas etapas

Nesta lição, você aprendeu como criar um projeto de teste e, em seguida, usá-lo para testar as propriedades, métodos e eventos da sua classe.Na próxima lição, você aprenderá como usar herança para criar uma classe com base em uma classe existente.

Próxima Lesson: Criando uma classe a partir de uma classe existente: Usando herança.

Consulte também

Tarefas

Adicionando métodos a uma classe

Examinar mais detalhadamente: Criando várias versões do mesmo método com sobrecarga

Compartilhar via

Testando uma classe

Criando uma instância de uma classe

Tente-o!

Para criar um projeto de teste para sua classe

Testando sua classe

Tente-o!

Para testar sua classe

Testando os métodos sobrecarregados

Tente-o!

Para testar os métodos sobrecarregados

Testando manipuladores de eventos

Tente-o!

Para testar o manipulador de eventos

Próximas etapas

Consulte também

Tarefas

Recursos adicionais