El tema Creación de fragmentos contiene toda la información para crear fragmentos. Esta guía / ejemplo sólo muestra cómo puede convertir sus propios fragmentos en una extensión para compartir. El flujo de trabajo sugerido es:
También puede añadir snippets de TextMate (.tmSnippets) a su instalación de VS Code utilizando el generador de extensiones de yo code. El generador tiene una opción New Code Snippets que le permite apuntar a una carpeta que contenga múltiples archivos .tmSnippets y que serán empaquetados en una extensión de fragmentos de código VS. El generador también soporta fragmentos de código de Sublime (.sublime-snippets).
El resultado final del generador tiene dos archivos: un manifiesto de extensión package.json que tiene metadatos para integrar los snippets en VS Code y un archivo snippets.json que incluye los snippets convertidos al formato de snippet de VS Code.
Los fragmentos de código son pequeños bloques de código reutilizable que pueden insertarse en un archivo de código mediante un comando del menú contextual o una combinación de teclas de acceso rápido. Suelen contener bloques de código de uso común, como los bloques try-finally o if-else, pero pueden utilizarse para insertar clases o métodos enteros.
Los fragmentos de código están disponibles para multitud de lenguajes, como C#, C++, Visual Basic, XML y T-SQL, por nombrar algunos. Para ver todos los fragmentos instalados disponibles para un idioma, abra el Administrador de fragmentos de código en el menú Herramientas (o bien, pulse Ctrl+K, Ctrl+B) y elija el idioma en el menú desplegable de la parte superior.
En Visual Studio hay dos tipos de fragmentos de código: los fragmentos de expansión, que se añaden en un punto de inserción especificado y pueden sustituir a un fragmento de código abreviado, y los fragmentos rodeados (sólo en C# y C++), que se añaden alrededor de un bloque de código seleccionado.
Puede insertar este fragmento de código haciendo clic en Insertar fragmento de código en el menú del botón derecho (menú contextual) de la ventana de código, luego en Visual C#, a continuación, escriba tryf y, a continuación, pulse el tabulador. O bien, puede escribir tryf y pulsar el tabulador dos veces.
Cada snippet define un prefijo bajo el cual aparecerá en IntelliSense a través de (kb(editor.action.triggerSuggest)) así como un cuerpo que se inserta cuando se selecciona el snippet. La sintaxis del fragmento sigue la sintaxis del fragmento de TextMate, con la excepción de los “reemplazos de expresiones regulares”, el “código shell interpolado” y las “transformaciones”, que no son compatibles.
También puede añadir fragmentos de código TextMate (.tmSnippets) a su instalación de VS Code utilizando el generador de extensiones de código yo. El generador tiene una opción New Code Snippets que le permite apuntar a una carpeta que contenga múltiples archivos .tmSnippets y que serán empaquetados en una extensión de fragmentos de código VS Code. El generador también soporta fragmentos de código de Sublime (.sublime-snippets).
La salida final del generador tiene dos archivos: un manifiesto de extensión package.json que tiene metadatos para integrar los snippets en VS Code y un archivo snippets.json que incluye los snippets convertidos al formato de snippet de VS Code.
donde (idioma).json depende del idioma al que se destinen los fragmentos (por ejemplo, markdown.json para los fragmentos de Markdown). Cree una nueva carpeta para su extensión y copie su archivo de fragmentos en un subdirectorio de fragmentos.
Este tema proporciona una guía para escribir muestras y fragmentos de código y marcas para la documentación publicada en webplatform.org. Su objetivo es proporcionar un listón de calidad para las muestras de código y los fragmentos, y proporcionar coherencia de estilo en esta documentación, no en la funcionalidad. El código de muestra sirve como un mini-portal al contenido. Los desarrolladores utilizan las muestras como documentación, y casi siempre hojean el código antes de leer un tema en su totalidad. Debido a su especial consideración, el código requiere una atención especial.
Fragmento de código: Un fragmento de código es cualquier ejemplo en la documentación. Muestra cómo utilizar un miembro específico o cómo realizar una tarea concreta. Puede ser un fragmento corto que se centra en una tarea específica (por ejemplo, cómo hacer que un botón cambie de color utilizando el evento onhover), o un tutorial más largo o cómo hacerlo. Es posible que el código mostrado ni siquiera se compile fuera de contexto, pero lo ideal es que sea posible pegar el código en un proyecto existente sin necesidad de reescribirlo. Un fragmento de código es código real; no es pseudocódigo.