Compartilhar via


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

Neste artigo introdutório, você explora o que significa criar uma solution e um project em 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. Este artigo analisa as propriedades de um projeto e alguns dos arquivos que ele pode conter. Você também cria uma referência de um projeto para outro.

Neste artigo, você constrói uma solução e um projeto do zero para entender o conceito de um projeto. Em seu uso geral de Visual Studio, você provavelmente usará alguns dos vários projetos templates que Visual Studio oferece ao criar um novo projeto.

Nota

Soluções e projetos não são necessários para desenvolver aplicativos em 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 GitHub, ele poderá não conter Visual Studio projetos e soluções. Para obter mais informações, consulte Desenvolver código no Visual Studio sem projetos ou soluções.

Pré-requisitos

  • Você precisa Visual Studio para acompanhar este artigo. Para instalá-lo gratuitamente, consulte Visual Studio downloads.

Soluções e projetos

Apesar do nome, uma solução não é uma resposta. Uma solução é um contêiner usado por 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

Para iniciar sua exploração, crie uma solução vazia. Depois de conhecer Visual Studio, provavelmente não será possível criar soluções vazias com frequência. Quando você cria um novo projeto, Visual Studio cria automaticamente uma solução para abrigar o projeto se ainda não houver uma solução aberta.

  1. Abra Visual Studio.

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

  3. Na janela Criar um novo projeto , insira uma solução em branco na caixa de pesquisa. Selecione o modelo de solução em branco . Em seguida, escolha Avançar.

    Captura de tela mostrando a janela Criar um novo projeto com 'solução em branco' na caixa de pesquisa e o modelo de projeto solução em branco selecionado.

    Screenshot mostrando a janela Criar um novo projeto no Visual Studio 2022 com

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

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

Adicionar um projeto

Agora, adicione seu primeiro projeto à solução. Adicione um projeto vazio e adicione os itens necessários ao projeto.

  1. No menu de contexto ou clique com o botão direito do mouse do Solution 'QuickSolution' no Gerenciador de Soluções, escolha Add>New Project.

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

  2. Insira o texto empty na caixa de pesquisa na parte superior e selecione Visual Basic na lista suspensa All languages.

  3. Selecione o modelo Empty Project (.NET Framework) e escolha Next.

  4. Nomeie o projeto QuickDate, e então escolha Criar.

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

    Nota

    Se você não vir o modelo Empty Project (.NET Framework), será necessário instalar a carga de trabalho do Visual Studio desenvolvimento para desktop .NET. Visual Studio usa a instalação baseada em carga de trabalho para instalar os componentes necessários para o tipo de desenvolvimento que você faz.

    Uma maneira fácil de instalar uma nova carga de trabalho é escolher o link Instalar mais ferramentas e recursos no texto que diz Não encontrar o que você está procurando?. Depois que o Instalador do Visual Studio for iniciado, escolha a carga de trabalho .NET para desenvolvimento de área de trabalho e, em seguida, o botão Modificar.

    Captura de tela mostrando a janela Criar um novo projeto com o link "Instalar mais ferramentas e recursos" realçado.

    Nota

    Se você não vir o modelo Empty Project (.NET Framework), será necessário instalar a carga de trabalho .NET para desenvolvimento de aplicativos de área de trabalho do Visual Studio workload. Visual Studio usa a instalação baseada em carga de trabalho para instalar os componentes necessários para o tipo de desenvolvimento que você faz.

    Uma maneira fácil de instalar uma nova carga de trabalho é escolher o link Instalar mais ferramentas e recursos no texto que diz Não encontrar o que você está procurando?. Depois que o Instalador do Visual Studio for iniciado, escolha a carga de trabalho .NET para desenvolvimento de desktop e, em seguida, o botão Modificar.

    Screenshot mostrando a janela Criar um novo projeto no Visual Studio 2022 com o link

Adicionar um item ao projeto

Você tem um projeto vazio. Agora, adicione um arquivo de código.

  1. No menu de contexto ou clique com o botão direito do mouse do projeto QuickDate no Gerenciador de Soluções, escolha Add>New Item. A caixa de diálogo Adicionar Novo Item é aberta.

    Quando você adiciona um item pela primeira vez, Visual Studio abre uma exibição compacta dessa caixa de diálogo. Para ver a caixa de diálogo inteira, selecione Mostrar Todos os Modelos.

  2. Expanda Itens Comuns e, em seguida, escolha Código. No painel do meio, escolha o modelo de item Classe. Nomeie a classe Calendário. Em seguida, escolha Adicionar.

    Um arquivo chamado Calendar.vb é adicionado ao projeto. O .vb no final é a extensão de arquivo para arquivos de código Visual Basic. O arquivo aparece na hierarquia do projeto visual em Gerenciador de Soluções. 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 contém uma única função, , que retorna a data atual.

  4. Abra as propriedades do projeto clicando duas vezes My Project em 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. Crie 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.

    Captura de tela da janela Saída do Visual Studio.

Adicionar um segundo projeto

É comum que as soluções contenham mais de um projeto. Geralmente, 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.

Adicione um projeto de teste de unidade à sua solução. Comece a partir de um modelo de projeto para que você não precise adicionar outro arquivo de código ao projeto.

  1. No menu de contexto ou clique com o botão direito do mouse do Solution 'QuickSolution' no Gerenciador de Soluções, escolha Add>New Project.

  2. Na janela Adicionar um novo projeto , insira o teste de unidade de texto na caixa de pesquisa na parte superior. Em seguida, selecione Visual Basic na lista All languages.

  3. Escolha o modelo de projeto Unit Test Project (.NET Framework) e escolha Next.

  4. Nomeie o projeto QuickTeste, em seguida, escolha Criar.

    Um segundo projeto é adicionado a Gerenciador de Soluções. Um arquivo chamado UnitTest1.vb é aberto no editor.

Adicionar uma referência de projeto

Use o novo projeto de teste de unidade para testar seu método no projeto QuickDate , portanto, você precisa 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.

    Captura de tela mostrando o menu de contexto do nó Referências no projeto QuickTest, com a opção 'Adicionar Referência' selecionada.

    O Gerenciador de Referência é aberto.

  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 selecione OK.

    É adicionada uma referência ao projeto QuickDate.

Adicionar código de teste

  1. Agora, adicione o código de teste ao arquivo de código 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ê vê uma linha ondulada vermelha sob parte do código. Corrija esse erro tornando o projeto de teste um assembly amigável para o projeto QuickDate .

  2. De volta ao projeto QuickDate , abra o arquivo Calendar.vb se ele ainda não estiver aberto. Para resolver o erro no projeto de teste, adicione a seguinte instrução Imports e o atributo.

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

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

    Screenshot mostrando o código para Calendar.vb na janela do editor de código Visual Basic depois de adicionar a instrução Imports e as linhas de atributos Assembly.

Propriedades do projeto

A linha no arquivo Calendar.vb que contém o atributo 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. Em 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 AltEnter. Você também pode clicar duas vezes em My Project em 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. O nome do assembly do projeto QuickTest é, de fato, "QuickTest". Se você quiser alterar o nome do assembly, esta página é onde você faria isso. 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.

    Captura de tela mostrando a guia Aplicativo das páginas de propriedades do projeto QuickTest com o campo 'Nome do Assembly' destacado e o valor é QuickTest.

  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 TestarExecutar Todos os Testes na barra de menus. Uma janela chamada Gerenciador de Testes é aberta. Você deve ver que o teste TestGetCurrentDate é aprovado.

Screenshot do Gerenciador de Testes no Visual Studio mostrando que o teste TestGetCurrentDate passou.

Dica

Se o Gerenciador de Testes não abrir automaticamente, no menu, selecione o Gerenciador de Testes.

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

Os seguintes recursos também podem ser úteis: