Fragmentos de código

  • Artículo

Se aplica a:yesVisual Studio noVisual Studio para Mac noVisual Studio Code

Los fragmentos de código son pequeños bloques de código reutilizable que se pueden agregar en un archivo de código mediante un comando de menú contextual o una combinación de teclas de acceso rápido. Normalmente, los fragmentos de código contienen bloques de código usados a menudo, como bloques try-finally o if-else, pero también puede usarlos para agregar clases o métodos completos.

Nota:

Este artículo se aplica a Visual Studio para Windows. En el caso de Visual Studio para Mac, vea Fragmentos de código (Visual Studio para Mac).

Existen fragmentos de código disponibles para muchos lenguajes, como C#, C++ y Visual Basic, por nombrar unos cuantos.

Para ver todos los fragmento de código disponibles para un lenguaje, seleccione Herramientas>Administrador de fragmentos de código en la barra de menús (o bien, presione Ctrl+K, Ctrl+B) y, a continuación, seleccione el lenguaje que desee en el menú desplegable de la parte superior del cuadro de diálogo.

Screenshot of the Code Snippets Manager dialog box.

En Visual Studio, hay varias maneras diferentes de agregar un fragmento de código a un archivo de código:

  • En la barra de menús, elija Edición>IntelliSense>Insertar fragmento de código.

  • En el menú contextual del editor de código, elija Fragmento de código>Insertar fragmento de código.

  • En el teclado, presione Ctrl+K,Ctrl+X

Fragmentos de código de expansión y fragmentos de código envolventes

Hay dos tipos de fragmentos de código que puede agregar al código.

Tipo de fragmento de código Cómo se usa
expansión Se agregó en un punto de inserción especificado y podría reemplazar un acceso directo de fragmento de código.
rodear con Se ha agregado alrededor de un bloque de código seleccionado (disponible solo para C# y C++).

En el ejemplo siguiente de un fragmento de código de expansión en C#, el acceso directo tryf agrega un bloque try-finally:

try
{

}
finally
{

}

A continuación se muestra cómo agregar este fragmento de código de expansión:

  1. En la ventana de código, coloque el cursor donde desea agregar el fragmento de código.

  2. Seleccione Insertar fragmento de código en el menú contextual.

  3. Seleccione Visual C#, escriba tryf y presione Tab. (O bien, puede escribir tryf y presionar Tab dos veces).

En el ejemplo de código siguiente de un fragmento de código rodear con, el acceso directo de C++ if se puede utilizar como un fragmento de código de inserción o como un fragmento de código rodear con. Si selecciona una línea de código (por ejemplo, return FALSE;) y, después, hace clic en Envolver con>if, el fragmento de código se expandirá alrededor de la línea:

if (true)
{
    return FALSE;
}

Parámetros de reemplazo de fragmentos de código

Los fragmentos de código pueden contener parámetros de reemplazo, que son marcadores de posición que debe reemplazar para incluir el código que está escribiendo. En el ejemplo anterior, true es un parámetro de reemplazo, que podría reemplazar por la condición adecuada. El reemplazo que haga se repetirá por cada instancia del mismo parámetro de reemplazo del fragmento de código.

Por ejemplo, en Visual Basic hay un fragmento de código que inserta una propiedad. Para insertar el fragmento de código, elija Fragmento de código>Insertar fragmento de código en el menú contextual en un archivo de código de Visual Basic. Luego, elija Patrones de código>Propiedades, procedimientos, eventos>Definir una propiedad.

Screenshot of the code snippet menu for Define a Property.

Se inserta el siguiente 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

Si cambia newPropertyValue por m_property, se cambian todas las instancias de newPropertyValue. Si cambia String por Int en la declaración de la propiedad, también se cambia a Int el valor en el método set.

Contenido relacionado