Fragmentos de código en Visual Studio para Mac

Importante

Visual Studio para Mac está programado para su retirada el 31 de agosto de 2024 de acuerdo con la directiva de ciclo de vida moderno de Microsoft. Aunque puede seguir trabajando con Visual Studio para Mac, hay otras opciones para desarrolladores en Mac, como la versión preliminar de la nueva extensión del Kit de desarrollo de C# para VS Code.

Obtenga más información sobre las escalas de tiempo de soporte técnico y las alternativas.

Los fragmentos de código, que se suelen denominar plantillas de código, son útiles para una programación eficaz, ya que permiten la inserción y edición de bloques de código escritos previamente. El uso de fragmentos de código puede resultar cómodo para agregar rápidamente patrones comunes o incluso para aprender nuevos patrones si, como desarrollador, no está seguro de la sintaxis. Hay plantillas para C#, F#, HTML, XML, Python y Razor.

En esta sección se explica cómo crear, insertar y usar fragmentos de código en el código.

Insertar un fragmento de código

Hay varias maneras de agregar fragmentos de código, algunas de las cuales se explican a continuación:

  • Expansión de tabulación: empiece a escribir el nombre de la plantilla, selecciónela en la lista y presione Tab, Tab para agregarla:

    Tab Expansion in Code

  • Cuadro de herramientas: use la ventana Cuadro de herramientas para mostrar una lista de todos los fragmentos de código. Arrastre cualquier plantilla desde el cuadro de herramientas a la posición correcta del código fuente:

    Code snippets in Toolbox

  • Comando Insertar plantillas: actualmente no hay ningún enlace de teclado predeterminado para insertar una plantilla. Para crear uno, vaya a Visual Studio > Preferencias > Enlaces de teclado y busque template. Esto permite agregar el enlace de teclado deseado en el campo Editar enlace; luego, haga clic en Aplicar:

    Inset Template command

Crear una nueva plantilla

Aunque hay muchas plantillas existentes en una serie de lenguajes que se pueden usar y editar, también se pueden agregar nuevas plantillas si se va a Visual Studio > Preferencias > Editor de texto > Fragmentos de código:

Inset new template

Presione los botones Agregar o Editar para crear o editar fragmentos de código.

Palabras clave en fragmentos de código

Después de insertar un fragmento de código en el editor, cualquier palabra clave definida se resalta y se puede editar mediante el uso del tabulador para pasar de una a otra. Las palabras clave se comportan como una "variable" en el fragmento de código y se definen colocando un signo de dólar $ antes y después del nombre de la palabra clave.

A continuación se muestra la ventana Editar plantilla, con la edición del fragmento de código prop integrado. El fragmento de código contiene dos palabras clave, $type$ y $name$, que pueden tener un conjunto de propiedades adicionales (como un valor predeterminado e información sobre herramientas) en el lado derecho de la ventana:

Edit template window

Los siguientes campos se usan para definir un fragmento de código:

  • Método abreviado: el texto que el usuario escribe para insertar el fragmento de código.
  • Grupo: los fragmentos de código que se agrupan en el menú de contenido del fragmento de código usan este valor.
  • Descripción: explicación del propósito del fragmento de código.
  • Mime: controla en qué tipos de archivo está disponible el fragmento de código.
  • Es la plantilla expandible: asegúrese de que esta opción está activada para que el fragmento de código se puede insertar en la posición del cursor escribiendo el acceso directo.
  • Está rodeado con plantilla: active esta opción para mostrar este acceso directo en el menú de contenido Rodear con... en el editor.
  • Texto de la plantilla: el fragmento de código real que se insertará en el editor. Se pueden definir dos marcadores de posición de palabras clave al rodear un token con signos de dólar, por ejemplo, $type$.
  • Panel de propiedades de palabras clave: en el lado derecho de la ventana, utilice la lista desplegable de la parte superior para elegir una palabra clave (por ejemplo, type) y editar propiedades como el valor predeterminado y la información sobre herramientas.

Uso de palabras clave en el editor

Para utilizar un fragmento de código con palabras clave, como la definida anteriormente, escriba el acceso directo y presione la tecla Tab dos veces y el contenido del fragmento de código se insertará en el cursor:

Inserted snippet showing keywords

Presione la tecla Tab para moverse entre object y MyProperty, con el fin de personalizar el fragmento de código para la clase.

Una palabra clave puede repetirse en un fragmento de código, como este ejemplo for, observe que la palabra clave $i$ aparece tres veces:

Snippet template with repeated keywords

Cuando se usa en el editor, la tecla Tab cambiará entre la primera i y max. Si sobrescribe i con otro nombre de variable, se actualizarán las tres instancias:

Inserted snippet showing multiple keywords

Palabras clave reservadas

Hay dos palabras clave reservadas que se puede usar en un fragmento de código:

  • $selected$: si el fragmento de código tiene activada la opción Está rodeado con plantilla, esta palabra clave se reemplazará por el texto que estaba resaltado en el editor cuando se eligió el fragmento de código.
  • $end$: cuando el usuario haya terminado de editar las palabras clave de un fragmento de código, el cursor se colocará en la ubicación de la palabra clave $end$.

El fragmento de código for de la sección anterior es un ejemplo de estas dos palabras clave reservadas.

Consulte también