Uso de fragmentos de código en Visual Studio

Los fragmentos de código son pequeños bloques de código reutilizables que puede agregar a un archivo de código. Los fragmentos de código suelen contener constructos de uso frecuente, como Try...FinallybloquesIf...Else. También puede usar fragmentos de código para agregar clases o métodos completos.

Un fragmento de código tiene un título que usas para seleccionarlo y puede tener un atajo que escribes para insertarlo. Los fragmentos de código también pueden contener parámetros de reemplazo, que actúan como marcadores de posición. Visual Studio proporciona fragmentos de código para muchos lenguajes, como C#, C++, y Visual Basic.

Prerequisites

  • Visual Studio con compatibilidad instalada para el lenguaje de programación que desea usar. Los fragmentos de código disponibles dependen de las cargas de trabajo instaladas y los componentes de lenguaje.
  • Un archivo de código abierto en el editor y reconocido por el servicio de idioma adecuado. Para el ejemplo de C++, abra un .cpp archivo o .h .

Descripción de los tipos de fragmento de código

Visual Studio admite dos tipos de fragmentos de código:

  • Un fragmento de código de expansión agrega código en un punto de inserción especificado.
  • Un fragmento surround-with añade código en torno al código seleccionado. Los fragmentos de código envolventes solo están disponibles para C# y C++.

Búsqueda de fragmentos de código disponibles

Para ver los fragmentos de códigoinstalados para un idioma, seleccione Herramientas Administrador> de fragmentos de código o presione Ctrl+K, Ctrl+B. En Administrador de fragmentos de código, seleccione un idioma en la lista Idioma .

Para crear e importar su propio fragmento de código para que aparezca en la lista de fragmentos de código, vea Tutorial: Creación de un fragmento de código en Visual Studio.

Note

Los métodos abreviados de teclado pueden variar según el perfil de configuración, el contexto, el diseño del teclado y los enlaces de teclas personalizados. Para encontrar la asignación de teclas de un comando, consulte Identificar y personalizar los atajos de teclado.

Insertar un fragmento de código de expansión

Un fragmento de código de expansión inserta código en el punto de inserción. Por ejemplo, el fragmento de código de C# tryf agrega un try/finally bloque:

try
{

}
finally
{

}

Debe insertar el fragmento tryf en un lugar donde una instrucción sea válida, como dentro de un método, indexador, descriptor de acceso de propiedad o descriptor de acceso de evento.

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

  2. Realice una de las siguientes acciones:

    • En la barra de menús, seleccione Editar>intelliSense>Insertar fragmento de código.
    • Haga clic con el botón derecho y seleccione Fragmento>Insertar fragmento de código.
    • Presione Ctrl+K, Ctrl+X.

  3. En el selector de fragmentos de código, abra la carpeta Visual C# y, a continuación, haga doble clic en tryf. También puede seleccionar tryf y presionar Tab o Entrar.

El try/finally bloque aparece en el punto de inserción, listo para personalizarlo.

Sugerencia

En un punto de inserción válido, escriba tryfy presione Tab dos veces para expandir el fragmento de código sin abrir el selector de fragmentos de código.

Insertar un fragmento alrededor del código seleccionado

Un fragmento de código envolvente ajusta el código seleccionado. Por ejemplo, el fragmento de código de C++ if envuelve la línea seleccionada return FALSE; en un bloque if:

if (true)
{
    return FALSE;
}

Para rodear el código de C++ seleccionado:

  1. En un .cpp archivo o .h , seleccione el código que desea encapsular.

  2. Realice una de las siguientes acciones:

    • En la barra de menús, seleccione Editar>IntelliSense>Surround With.
    • Haga clic con el botón derecho y seleccione Rodear con.

  3. En el selector de fragmentos de código, haga doble clic si, o seleccione si y presione Tab o Entrar.

El if bloque aparece alrededor del código seleccionado. Sustituya el marcador de posición true por la condición que desea evaluar.

Para obtener más ejemplos de fragmentos de código de C++, vea Fragmentos de código de Visual C++.

Editar campos de reemplazo

Los fragmentos de código pueden contener campos de reemplazo que personalice después de la inserción. Cuando el mismo campo aparece más de una vez, cambiar una repetición cambia todas las repeticiones vinculadas. Presione Tab para desplazarse al siguiente campo de reemplazo.

Por ejemplo, el fragmento de código de Visual Basic Definir una propiedad contiene campos vinculados para la variable subyacente, el nombre de la propiedad y el tipo de propiedad. Para insertarlo:

  1. En un archivo de código de Visual Basic, haga clic con el botón derecho donde quiera insertar la propiedad y, a continuación, seleccione Fragmento de código>Insertar fragmento de código.
  2. Seleccione Patrones de código>Propiedades, Procedimientos, Eventos>Defina una propiedad.

Captura de pantalla del selector de fragmentos de código de Visual Basic con Definir una propiedad seleccionada en Propiedades, Procedimientos, Eventos.

Se inserta el código siguiente:

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, cada instancia vinculada de newPropertyValue cambia. Si cambia el tipo de propiedad de String a Integer, cada instancia vinculada de String cambia a Integer.

Solución de problemas de fragmentos de código

Si un fragmento de código o comando no está disponible:

  • Confirme que Visual Studio reconoce el archivo como lenguaje de programación esperado.
  • Confirme que está instalada la carga de trabajo o el componente de idioma necesarios.
  • En Herramientas>, compruebe que el fragmento esté instalado para el idioma seleccionado.
  • Si un método abreviado de teclado no funciona según lo previsto, use Identificar y personalizar métodos abreviados de teclado para buscar el enlace actual del comando.
  • Compruebe que el punto de inserción es válido para el fragmento de código seleccionado. Por ejemplo, algunos fragmentos de código de C# solo son válidos dentro de una declaración de método o tipo. Para obtener ubicaciones de inserción válidas de C#, consulte Fragmentos de código de C#.

Revisar el código insertado mediante fragmentos de código

El fragmento de código muestra una forma básica de realizar una tarea. Revise y adapte el código generado antes de usarlo en una aplicación. Tenga en cuenta cómo el código controla las excepciones, accede a los recursos, valida la entrada y protege los secretos.

Trate los fragmentos de código descargados de Internet como otro código descargado. Descargue fragmentos de código solo de orígenes que confíe e inspeccione el código y los metadatos del fragmento de código antes de importarlo o ejecutarlo.

En los proyectos de .NET Framework, un fragmento de código puede usar el elemento References para agregar referencias a proyectos. Revise los elementos Imports y References y compruebe que confía en los ensamblados a los que se hace referencia. Para obtener más información, consulte Importar un espacio de nombres y la referencia del esquema de fragmentos de código.

Véase también

  • Last updated on