Compartir a través de

Extensión del editor de Visual Studio

El editor de Visual Studio admite extensiones que se agregan a sus funcionalidades. Entre los ejemplos se incluyen extensiones que:

  • Insertar y modificar código en un lenguaje existente.
  • Personalice el comportamiento de determinadas características del editor, como CodeLens.

Por lo general, el editor de Visual Studio hace referencia a la funcionalidad de editar archivos de texto, conocidos como documentos, de cualquier tipo. Puede abrir archivos individuales para su edición. La ventana del editor abierto se conoce como una vista de texto.

Para obtener más información sobre el modelo de objetos del editor, vea Conceptos de extensibilidad del editor.

En las secciones siguientes se resumen los escenarios de extensibilidad del editor de alto nivel que VisualStudio.Extensibility admite. Cada uno de estos escenarios es completo en conceptos y API. Entre las secciones independientes y más detalladas se incluyen vínculos para proporcionar explicaciones más detalladas de las API y cómo usarlas.

Leer texto y observar los cambios en el editor

El punto de extensibilidad más fundamental para el editor de Visual Studio es manipular texto, ya sea leyendo el texto en el editor o editando el texto. Estos escenarios son fundamentales para cualquier extensión basada en editor. Por ejemplo, para proporcionar información de diagnóstico, como advertencias o errores, la extensión debe leer el código en el editor y, a continuación, interpretarlo. Una extensión también necesita una manera de detectar cuándo ha cambiado el texto del editor, si se abre un archivo nuevo o si se cierra un archivo abierto.

Para ver un tutorial sobre cómo leer el texto y realizar un seguimiento de los cambios de texto mediante VisualStudio.Extensibility, vea Trabajar con texto en el editor.

Realizar modificaciones en texto en el editor

Cualquier extensión que tenga como objetivo aumentar la productividad de edición mediante la inserción automática de texto (como generar automáticamente un GUID e insertarlo) necesita API para definir dónde y qué insertar. El VisualStudio.Extensibility modelo de extensión ejecuta código fuera del proceso y de forma asincrónica, lo que requiere el cumplimiento de principios específicos al desarrollar extensiones de edición de texto.

Para ver un tutorial sobre cómo editar texto mediante VisualStudio.Extensibility, vea Cambiar texto en el editor.

Extensión de las características del editor

Las extensiones también pueden conectar a muchas características del editor que proporcionan información contextual. En las secciones siguientes se resumen las distintas características del editor que puede ampliar.

Margen de visualización de texto

Las extensiones pueden agregar nuevos márgenes de vista de texto al editor de Visual Studio. Un margen de vista de texto es un control de interfaz de usuario rectangular adjunto a una vista de texto en uno de sus cuatro lados. Estos controles de interfaz de usuario ofrecen más información de un vistazo, lo que permite a los desarrolladores mantenerse productivos cuando trabajan en el editor. Muchas de las características más populares del editor de Visual Studio usan márgenes de vista de texto, como el control de zoom, el indicador de punto de interrupción y el indicador de número de línea.

Para ver un tutorial sobre cómo personalizar los márgenes de la vista de texto con la extensión, consulte Extensión del editor de Visual Studio con un nuevo margen.

CodeLens

Las extensiones pueden aportar nuevos CodeLenses al editor de Visual Studio. CodeLens es un indicador visual que aparece encima de las líneas de texto para proporcionar información contextual accionable. Algunos ejemplos incluyen el número de referencias a un elemento de código, los resultados de la última ejecución de pruebas unitarias o las acciones para ejecutar o depurar una prueba unitaria. Algunos CodeLenses comunes incluyen la referencia de código CodeLens, que proporciona información sobre todas las distintas partes del código que hacen referencia a un bloque específico de código. El historial de código CodeLens proporciona información sobre cómo ha cambiado un bloque específico de código en el control de código fuente.

Para ver un tutorial sobre cómo proporcionar su propia extensión a CodeLens, consulte Extensión del editor de Visual Studio con un nuevo CodeLens.

Etiquetadores

Las extensiones pueden incorporar nuevos taggers al editor de Visual Studio. Los taggers se usan para asociar datos a intervalos de texto. Otras características de Visual Studio (por ejemplo, CodeLens y clasificación) consumen estos datos.

Para obtener una guía sobre cómo proporcionar sus propios etiquetadores con su extensión, consulte Ampliar el editor de Visual Studio con un nuevo etiquetador.

Contenido relacionado