Use excertos de código no Visual Studio

Trechos de código são pequenos blocos de código reutilizável que você pode adicionar a um arquivo de código. Os fragmentos geralmente contêm construções usadas com frequência, como blocos Try...Finally ou If...Else. Também podes usar excertos para adicionar classes ou métodos inteiros.

Um excerto de código tem um título que usas para o selecionar e pode ter um atalho que escreves para o inserir. Os trechos também podem conter parâmetros substituíveis, que atuam como espaços reservados. O Visual Studio fornece excertos para muitas linguagens, incluindo C#, C++ e Visual Basic.

Pré-requisitos

  • Visual Studio com suporte instalado para a linguagem de programação que pretende usar. Os snippets disponíveis dependem das cargas de trabalho instaladas e dos componentes da linguagem.
  • Um ficheiro de código aberto no editor e reconhecido pelo serviço de linguagem apropriado. Para o exemplo do C++, abre um .cpp ficheiro ou .h .

Compreender os tipos de excertos

O Visual Studio suporta dois tipos de excertos de código:

  • Um excerto de expansão adiciona código num ponto de inserção especificado.
  • Um fragmento surround-with adiciona código à volta do código selecionado. Os excertos surround-with estão disponíveis apenas para C# e C++.

Encontre trechos disponíveis

Para visualizar os excertos instalados para uma língua, selecioneGestor de Excertos de Códigode Ferramentas> ou pressione Ctrl+K, Ctrl+B. No Gestor de Excertos de Código, selecione uma língua da lista de Línguas .

Para criar e importar seu próprio trecho para que ele apareça na lista de trechos, consulte Passo a passo: Criar um trecho de código no Visual Studio.

Note

Os atalhos de teclado podem variar consoante as definições, perfil, contexto, layout do teclado e combinações de teclas personalizadas. Para encontrar a ligação de um comando, veja Identificar e personalizar atalhos de teclado.

Inserir um fragmento de expansão

Um fragmento de expansão insere código no ponto de inserção. Por exemplo, o fragmento de código C# tryf adiciona um bloco try/finally:

try
{

}
finally
{

}

Tem de inserir o fragmento de código tryf num local em que uma instrução seja válida, por exemplo, dentro de um método, indexador, acessor de propriedade ou acessor de evento.

  1. No editor de códigos, posicione o cursor onde deseja adicionar o trecho.

  2. Efetue uma das seguintes ações:

    • Na barra de menus, selecione Editar>Inserir Fragmento do IntelliSense>.
    • Clique com o botão direito e selecione Snippet>Insert Snippet.
    • Pressione Ctrl+K, Ctrl+X.

  3. No snippet picker, abra a pasta Visual C# e depois clique duas vezes em tryf. Também podes selecionar tryf e premir Tab ou Enter.

O try/finally bloco aparece no ponto de inserção, pronto para personalizar.

Sugestão

Num ponto de inserção válido, escreva tryf, e depois pressione Tab duas vezes para expandir o snippet sem abrir o snippet picker.

Rodear o código selecionado com um excerto

Um snippet surround-with envolve código selecionado. Por exemplo, o fragmento C++ if envolve a linha selecionada return FALSE; num bloco if:

if (true)
{
    return FALSE;
}

Para rodear código C++ selecionado:

  1. Num ficheiro .cpp ou .h, selecione o código que pretende inserir entre essas etiquetas.

  2. Efetue uma das seguintes ações:

    • Na barra de menus, selecione Editar>Surround IntelliSense>Com.
    • Clique com o botão direito e selecione Surround With.

  3. No seletor de excertos, clique duas vezes em if ou selecione if e pressione Tab ou Enter.

O bloco if aparece em torno do código selecionado. Substitua o marcador de posição true pela condição que pretende avaliar.

Para mais exemplos de excertos em C++, veja excertos de código Visual C++.

Editar campos de substituição

Os snippets podem conter campos de substituição que personaliza após a inserção. Quando o mesmo campo aparece mais do que uma vez, alterar uma ocorrência altera todas as ocorrências ligadas. Prima Tab para avançar para o próximo campo de substituição.

Por exemplo, o Visual Basic Define a Property snippet contém campos ligados para a variável de apoio, nome da propriedade e tipo de propriedade. Para inserir:

  1. Num ficheiro de código do Visual Basic, clique com o botão direito do rato no local onde pretende inserir a propriedade e, em seguida, selecione Fragmento de Código>Inserir Fragmento de Código.
  2. Selecione Padrões de Código>Propriedades, Procedimentos, Eventos>Definir uma Propriedade.

Captura de ecrã do seletor de excertos do Visual Basic com Definir uma Propriedade selecionada em Propriedades, Procedimentos, Eventos.

É inserido o seguinte código:

Private newPropertyValue As String
Public Property NewProperty() As String
    Get
        Return newPropertyValue
    End Get
    Set(ByVal value As String)
        newPropertyValue = value
    End Set
End Property

Se mudares newPropertyValue para m_property, todas as instâncias newPropertyValue ligadas mudam. Se mudar o tipo de propriedade de String para Integer, cada instância ligada de String passa para Integer.

Resolver problemas em fragmentos de código

Se um excerto ou comando não estiver disponível:

  • Confirme que o Visual Studio reconhece o ficheiro como a linguagem de programação esperada.
  • Confirme que a carga de trabalho necessária ou o componente de linguagem está instalado.
  • Em Ferramentas>, confirme que o fragmento está instalado para o idioma selecionado.
  • Se um atalho de teclado não funcionar como esperado, use Identificar e personalize atalhos de teclado para consultar a ligação atual do comando.
  • Verifique se o ponto de inserção é válido para o fragmento selecionado. Por exemplo, alguns fragmentos em C# são válidos apenas dentro de uma declaração de método ou tipo. Para localizações válidas de inserção de C#, veja excertos de código C#.

Código de revisão inserido por excertos

O código de excertos mostra uma forma básica de realizar uma tarefa. Revê e adapta o código gerado antes de o usares numa aplicação. Considere como o código gere exceções, acede a recursos, valida a entrada e protege segredos.

Trate excertos descarregados da internet como outros códigos descarregados. Descarregue apenas excertos de fontes em que confie e inspecione o código e os metadados antes de os importar ou executar.

Em projetos .NET Framework, um snippet pode usar o References elemento para adicionar referências de projeto. Reveja os elementos Imports e References e verifique se confia nas assemblies referenciadas. Para mais informações, consulte Importar um namespace e os excertos de código referência ao esquema.

Ver também

  • Last updated on