Compartilhar via


Gerar um construtor no Visual Studio

Esta geração de código aplica-se a:

  • C#

  • Visual Basic

O quê: permite gerar imediatamente o código para um novo construtor em uma classe.

Quando: você introduz um novo construtor e deseja declará-lo corretamente automaticamente, ou modifica um construtor existente.

Por quê: você poderia declarar o construtor antes de usá-lo; no entanto, esse recurso o gerará automaticamente com os parâmetros apropriados. Além disso, modificar um construtor existente exige a atualização de todos os callsites, a menos que você use este recurso para atualizá-los automaticamente.

Como: há várias maneiras de gerar um construtor:

Gerar construtor e selecionar membros (somente C#)

  1. Coloque o cursor em qualquer linha vazia em uma classe:

    Cursor in empty line

  2. Depois, siga um destes procedimentos:

    • Teclado
      • Pressione (Ctrl+.) para acionar o menu Ações Rápidas e Refatorações.
    • Mouse
      • Clique com o botão direito do mouse e selecione o menu Ações Rápidas e Refatorações.
      • Clique no ícone que aparece na margem esquerda quando o cursor de texto já está na linha vazia na classe.

    Screenshot of the Generate constructor option.

  3. Selecione Gerar construtor no menu suspenso.

    A caixa de diálogo Selecionar membros abre.

  4. Selecione os membros que você deseja incluir como parâmetros do construtor. Você pode ordená-los usando as setas para cima e para baixo. Selecione OK.

    Pick members dialog

    Dica

    Você pode marcar a caixa de diálogo Adicionar verificações nulas para gerar automaticamente verificações nulas para os parâmetros do construtor.

    O construtor é criado com os parâmetros especificados.

    Screenshot showing that constructor is created with the specified parameters.

Gerar construtor com propriedades (somente C#)

  1. Coloque o cursor na instância.

  2. Pressione (Ctrl+.) para acionar o menu Ações Rápidas e Refatorações.

  3. Selecione Gerar o construtor em <QualifiedName> (com propriedades).

    Screenshot of the Generate constructor in Key (with properties) option.

Gerar construtor usando campos selecionados (somente C#)

  1. Realce os membros que você deseja inserir no construtor gerado:

    Highlight members

  2. Depois, siga um destes procedimentos:

    • Teclado

      • Pressione (Ctrl+.) para acionar o menu Ações Rápidas e Refatorações.
    • Mouse

      • Clique com o botão direito do mouse e selecione o menu Ações Rápidas e Refatorações.
      • Clique no ícone que aparece na margem esquerda quando o cursor de texto já está na linha com a seleção.

      Screenshot of the Generate constructor Person string string option.

  3. Selecione Gerar construtor 'TypeName(...)' no menu suspenso.

    O construtor é criado com os parâmetros selecionados.

    Screenshot showing that the constructor is created with the selected parameters.

Gerar construtor de uso novo (C# e Visual Basic)

  1. Coloque o cursor na linha em que há um rabisco vermelho. O rabisco vermelho indica uma chamada para um construtor que ainda não existe.

    • C#:

      Highlighted code C#

    • Visual Basic:

      Highlighted code VB

  2. Depois, siga um destes procedimentos:

    • Teclado

      • Pressione (Ctrl+.) para acionar o menu Ações Rápidas e Refatorações.
    • Mouse

      • Clique com o botão direito do mouse e selecione o menu Ações Rápidas e Refatorações.
      • Passe o mouse sobre o risco vermelho e clique no ícone que aparece.
      • Clique no ícone que aparece na margem esquerda quando o cursor de texto já está na linha com o risco vermelho.

      Screenshot of the Generate constructor in Person option.

  3. Selecione Gerar construtor em 'TypeName' no menu suspenso.

    Dica

    Use o link Visualizar alterações na parte inferior da janela de visualização para ver todas as alterações que serão feitas antes de fazer sua seleção.

    O construtor é criado, com os parâmetros inferidos com base em seu uso.

    • C#:

      Generate method result C#

    • Visual Basic:

      Generate method result VB

Adicionar parâmetro ao construtor existente (somente C#)

  1. Adicione um parâmetro a uma chamada de construtor existente.

  2. coloque o cursor na linha em que há um rabisco vermelho indicando que você usou um construtor que ainda não existe.

    Screenshot showing the line where there is a red squiggle.

  3. Depois, siga um destes procedimentos:

    • Teclado

      • Pressione (Ctrl+.) para acionar o menu Ações Rápidas e Refatorações.
    • Mouse

      • Clique com o botão direito do mouse e selecione o menu Ações Rápidas e Refatorações.
      • Passe o mouse sobre o risco vermelho e clique no ícone que aparece.
      • Clique no ícone que aparece na margem esquerda quando o cursor de texto já está na linha com o risco vermelho.

      Screenshot of the Add parameter to Person string string option.

  4. Selecione Adicionar parâmetro em 'TypeName(...)' no menu suspenso.

    O parâmetro é adicionado ao construtor, com o tipo inferido com base em seu uso.

    Screenshot showing that the parameter is added to the constructor, with its type inferred from its usage.

Também é possível adicionar um parâmetro a um método existente. Para saber mais, confira Adicionar parâmetro a um método.

Criar e inicializar um campo ou uma propriedade de um parâmetro de construtor (somente C#)

  1. Localize um construtor existente e adicione um parâmetro:

    Screenshot showing an existing constructor.

  2. Coloque o cursor dentro do parâmetro recém-adicionado.

  3. Depois, siga um destes procedimentos:

    • Teclado
      • Pressione (Ctrl+.) para acionar o menu Ações Rápidas e Refatorações.
    • Mouse
      • Clique com o botão direito do mouse e selecione o menu Ações Rápidas e Refatorações.
      • Clique no ícone que aparece na margem esquerda quando o cursor de texto já está na linha com o parâmetro adicionado.

    Screenshot of the Create and initialize property Age option.

  4. Selecione Criar e inicializar propriedade ou Criar e inicializar campo no menu suspenso.

    O campo ou a propriedade é declarada e automaticamente nomeada para corresponder aos seus tipos. Uma linha de código também é adicionada para inicializar o campo ou a propriedade no corpo do construtor.

    Screenshot showing that the field or property is declared and automatically named to match your types.

Confira também