Saiba mais sobre projetos e soluções usando o Visual Basic

Neste artigo introdutório, exploraremos o que significa criar uma solução e um projeto no Visual Studio. Uma solução é um contêiner usado para organizar um ou mais projetos de código relacionados, por exemplo, um projeto de biblioteca de classes e um projeto de teste correspondente. Examinaremos as propriedades de um projeto e alguns dos arquivos que ele pode conter. Também criaremos uma referência de um projeto para outro.

Dica

Se você ainda não instalou o Visual Studio, acesse a página downloads do Visual Studio para instalá-lo gratuitamente.

Construiremos uma solução e um projeto do zero como um exercício educacional para entender o conceito de um projeto. Em seu uso geral do Visual Studio, você provavelmente usará alguns dos vários modelos de de projeto que o Visual Studio oferece ao criar um novo projeto.

Nota

Soluções e projetos não são necessários para desenvolver aplicativos no Visual Studio. Você também pode simplesmente abrir uma pasta que contém código e iniciar a programação, compilação e depuração. Por exemplo, se você clonar um repositório do GitHub, ele poderá não conter projetos e soluções do Visual Studio. Para obter mais informações, consulte Desenvolver código no Visual Studio sem projetos ou soluções.

Soluções e projetos

Apesar do nome, uma solução não é uma "resposta". Uma solução é simplesmente um contêiner usado pelo Visual Studio para organizar um ou mais projetos relacionados. Quando você abre uma solução no Visual Studio, ela carrega automaticamente todos os projetos que a solução contém.

Criar uma solução

Começaremos nossa exploração criando uma solução vazia. Depois de conhecer o Visual Studio, você provavelmente não se verá criando soluções vazias com frequência. Quando você cria um novo projeto, o Visual Studio cria automaticamente uma solução para abrigar o projeto se ainda não houver uma solução aberta.

1. Abra o Visual Studio.

2. Na janela inicial, escolha Criar um novo projeto.

3. Na página Criar um novo projeto, insira solução em branco na caixa de pesquisa, selecione o modelo Solução em Branco e escolha Avançar.

   

4. Nomeie a solução como QuickSolutione, em seguida, escolha Criar.

   Uma solução aparece no Gerenciador de Soluções no lado direito da janela do Visual Studio. Você provavelmente usará Gerenciador de Soluções com frequência, para navegar pelo conteúdo de seus projetos.

Adicionar um projeto

Agora vamos adicionar nosso primeiro projeto à solução. Começaremos com um projeto vazio e adicionaremos os itens necessários ao projeto.

1. Ao clicar com o botão direito do mouse ou no menu de contexto da Solução ‘QuickSolution’ no Gerenciador de Soluções, escolha Adicionar>Novo Projeto.

   Uma caixa de diálogo é aberta que diz Adicionar um novo projeto.

2. Insira o texto vazio na caixa de pesquisa na parte superior e, em seguida, selecione Visual Basic na lista suspensa Todos os idiomas.

3. Selecione o modelo Projeto Vazio (.NET Framework) e, em seguida, escolha Next.

4. Nomeie o projeto QuickDate e, em seguida, escolha Criar.

   Um projeto chamado QuickDate aparece abaixo da solução no do Gerenciador de Soluções. Atualmente, ele contém um único arquivo chamado App.config.

   Nota

   Se você não vir o modelo Projeto Vazio (.NET Framework), será necessário instalar a carga de trabalho do Visual Studio de desenvolvimento para desktop do .NET. O Visual Studio usa a instalação baseada em carga de trabalho para instalar apenas os componentes necessários para o tipo de desenvolvimento que você faz. Uma maneira fácil de instalar uma nova carga de trabalho quando estiver criando um novo projeto é escolher o link Instalar mais ferramentas e recursos no texto que diz Não está encontrando o que você está procurando?. Depois que o Visual Studio Installer for iniciado, escolha a carga de trabalho Desenvolvimento para desktop do .NET e, em seguida, o botão Modificar.

   

Adicionar um item ao projeto

Temos um projeto vazio. Vamos adicionar um arquivo de código.

1. No menu de clique com o botão direito do mouse ou de contexto do projeto QuickDate no Gerenciador de Soluções, escolha Adicionar>Novo Item.

   A caixa de diálogo Adicionar Novo Item é aberta.

2. Expanda Itens Comuns e, em seguida, escolha Código. No painel do meio, escolha o modelo de item Classe. Nomeie a classe Calendar e, em seguida, escolha o botão Adicionar.

   Um arquivo chamado Calendar.vb é adicionado ao projeto. O .vb no final é a extensão de arquivo fornecida aos arquivos de código do Visual Basic. O arquivo aparece na hierarquia do projeto visual do Gerenciador de Soluções e seu conteúdo é aberto no editor.

3. Substitua o conteúdo do arquivo Calendar.vb pelo seguinte código:

   Class Calendar
       Public Shared Function GetCurrentDate() As Date
           Return DateTime.Now.Date
       End Function
   End Class
   

   A classe Calendar contém uma única função, GetCurrentDate, que retorna a data atual.

4. Abra as propriedades do projeto clicando duas vezes em Meu Projeto no Gerenciador de Soluções . Na guia Aplicativo, altere Tipo de aplicativo para Biblioteca de Classes. Essa etapa é necessária para criar o projeto com êxito.

5. Compile o projeto clicando com o botão direito do mouse em QuickDate no Gerenciador de Soluções e escolhendo Build. Você deverá ver uma mensagem de build bem-sucedido na Janela de Saída.

   

Adicionar um segundo projeto

É comum que as soluções contenham mais de um projeto e, muitas vezes, esses projetos fazem referência uns aos outros. Alguns projetos em uma solução podem ser bibliotecas de classes, alguns aplicativos executáveis e alguns podem ser projetos de teste de unidade ou sites.

Vamos adicionar um projeto de teste de unidade à nossa solução. Desta vez, começaremos a partir de um modelo de projeto para que não precisemos adicionar um arquivo de código adicional ao projeto.

1. No menu de contexto ou de clique com o botão direito do mouse da solução 'QuickSolution' no Gerenciador de Soluções , escolha Adicionar>Novo Projeto.

2. Na caixa de diálogo Adicionar um novo projeto, insira o texto teste de unidade na caixa de pesquisa na parte superior e, em seguida, selecione Visual Basic em Todos os idiomas.

3. Escolha o modelo de Projeto de Teste de Unidade (.NET Framework) e escolha Avançar.

4. Nomeie o projeto QuickTest, e depois escolha Criar.

   Um segundo projeto é adicionado ao do Gerenciador de Soluçõese um arquivo chamado UnitTest1.vb é aberto no editor.

Adicionar uma referência de projeto

Vamos usar o novo projeto de teste de unidade para testar nosso método no projeto QuickDate, portanto, precisamos adicionar uma referência a esse projeto. A referência cria uma dependência de build entre os dois projetos, o que significa que quando a solução é criada, o QuickDate é criado antes do QuickTest.

1. Escolha o nó Referências no projeto QuickTest e, ao clicar com o botão direito do mouse ou no menu de contexto, escolha Adicionar Referência.

   

   A caixa de diálogo Gerenciador de Referências é aberta.

2. No painel esquerdo, expanda Projetos e escolha Solução. No painel do meio, escolha a caixa de seleção ao lado de QuickDate e escolha o botão OK.

   Uma referência ao projeto QuickDate será adicionada.

Adicionar código de teste

1. Agora, adicionaremos o código de teste ao arquivo de código do Visual Basic. Substitua o conteúdo de UnitTest1.vb pelo código a seguir.

   <TestClass()> Public Class UnitTest1
   
       <TestMethod()> Public Sub TestGetCurrentDate()
           Assert.AreEqual(Date.Now.Date, QuickDate.Calendar.GetCurrentDate())
       End Sub
   
   End Class
   

   Você verá uma linha sinuosa vermelha em alguns dos códigos. Nós corrigiremos esse erro ao tornar o projeto de teste um assembly amigável para o projeto QuickDate.

2. De volta ao projeto QuickDate, abra o arquivo Calendar.vb caso ele ainda não esteja aberto e adicione a instrução Imports a seguir e o atributo InternalsVisibleToAttribute para resolver o erro no projeto de teste.

   Imports System.Runtime.CompilerServices
   
   <Assembly: InternalsVisibleTo("QuickTest")>
   

   O arquivo de código deve ter esta aparência:

   

Propriedades do projeto

A linha no arquivo Calendar.vb que contém o atributo InternalsVisibleToAttribute faz referência ao nome do assembly (nome do arquivo) do projeto QuickTest. O nome do assembly pode não ser sempre o mesmo que o nome do projeto. Para localizar o nome do assembly de um projeto, abra as propriedades do projeto.

1. No Gerenciador de Soluções, selecione o projeto QuickTest. Ao clicar com o botão direito do mouse ou no menu de contexto, selecione Propriedades ou pressione Alt+Enter. (Você também pode clicar duas vezes em Meu Projeto no Gerenciador de Soluções.)

   As páginas de propriedades para o projeto são abertas na guia do aplicativo. As páginas de propriedades contêm várias configurações para o projeto. Observe que o nome do assembly do projeto QuickTest é de fato "QuickTest". Caso deseje alterá-lo, este é o local para executar essa tarefa. Em seguida, quando você cria o projeto de teste, o nome do arquivo binário resultante seria alterado de QuickTest.dll para o que você escolheu.

   

2. Explore algumas das outras guias das páginas de propriedades do projeto, como Compilar e Configurações. Essas guias são diferentes para diferentes tipos de projetos.

(Opcional) Executar o teste

Se você quiser verificar se o teste de unidade está funcionando, escolha Testar>Executar Todos os Testes na barra de menus. Uma janela chamada Test Explorer é aberta e você verá que o teste TestGetCurrentDate é aprovado.

Dica

Se o Gerenciador de Testes não abrir automaticamente, abra-o escolhendo Teste>Windows>Gerenciador de Testes na barra de menus.

Próximas etapas

Se você quiser explorar ainda mais o Visual Studio, considere criar um aplicativo seguindo um dos tutoriais do Visual Basic.

Consulte também

• Criar projetos e soluções
• Gerenciar propriedades de projeto e solução
• Gerenciar referências em um projeto
• Desenvolver código no Visual Studio sem projetos ou soluções
• visão geral do IDE do Visual Studio