Compartir a través de


Búsqueda de código funcional

Azure DevOps Services | Azure DevOps Server 2022: Azure DevOps Server 2019

Busque el código que necesita más rápido con la búsqueda de código funcional. En este artículo se explica cómo refinar la búsqueda entre repositorios mediante tipos de código y otras funciones con la extensión Marketplace de Code Search para Azure DevOps.

Prerrequisitos

  • Niveles de acceso:
    • Acceso básico:
      • Para usar la búsqueda de código, tenga al menos acceso básico.
      • Para acceder al código de un proyecto privado, tenga al menos acceso básico.
    • Acceso de parte interesada:
      • Los usuarios con acceso a partes interesadas no tienen acceso al código, por lo que no pueden buscar código.
      • Los usuarios con acceso de partes interesadas para un proyecto público tienen acceso completo al código, por lo que pueden buscar código.
  • Resultados de búsqueda:
    • Resultados basados en acceso: Al buscar en toda la organización o colección, solo se muestran los resultados para los que un miembro del proyecto tiene acceso.
  • Niveles de acceso:
    • Acceso básico:
      • Para usar la búsqueda de código, tenga al menos acceso básico.
      • Para acceder al código de un proyecto privado, tenga al menos acceso básico.
    • Acceso de parte interesada:
      • Los usuarios con acceso a partes interesadas no tienen acceso al código, por lo que no pueden buscar código.
  • Resultados de búsqueda:
    • Resultados basados en el acceso: Al buscar en toda la organización o colección, solo se muestran los resultados a los que tiene acceso un miembro del proyecto.
  • Herramientas:

Procedimientos recomendados de búsqueda de código

  • Inicio amplio: Comience con una búsqueda amplia y, a continuación, use operadores de filtro para restringirlo por proyecto, repositorio, ruta de acceso, nombre de archivo, etc.
  • Use caracteres comodín y operadores booleanos : si no conoce el término exacto, use caracteres comodín para ampliar su búsqueda y operadores booleanos para ajustarla.
  • Mantener el puntero para obtener más información: Para obtener más información sobre un elemento de código, mantenga el puntero sobre él y use el menú contextual para buscar ese texto en todos los proyectos y archivos.
  • funcionalidad de código de seguimiento: Use el menú contextual para buscar elementos relacionados como definiciones y referencias en un archivo o en los resultados de búsqueda para realizar un seguimiento de cómo funciona el código.
  • Usar filtros de tipo de código: Para buscar la implementación de una API u otro elemento de código, use filtros de tipo de código para buscar tipos de código específicos, como:
    • Definiciones
    • Referencias
    • Funciones
    • Comentarios
    • Instrumentos de cuerda
    • Espacios de nombres y más

Nota

La búsqueda de código no funciona para repositorios bifurcados.

Funciones para buscar tipos específicos de código

Para crear la consulta más rápido, elija funciones y palabras clave en la lista desplegable a medida que escriba texto. Seleccione Mostrar más para ver todas las opciones. Puede combinar diferentes funciones según sea necesario.

También puede usar filtros de la columna izquierda para restringir la búsqueda. Mostrar más muestra todas las funciones y palabras clave.

O bien, puede escribir las funciones y los parámetros en el cuadro de búsqueda. En la tabla siguiente se enumeran las funciones para buscar tipos o miembros específicos en el código de C#, C, C++, Java y Visual Basic.NET.

Para buscar código en el que findThis aparece como... ... buscar argumento arg:findThis
Argumento arg:findThisDeprecated in July 2019
Tipo base basetype:findThis
Función de llamada caller:findThisDeprecated in July 2019
Definición o declaración de clase class:findThis
Declaración de clase classdecl:findThisMerged with class:
Definición de clase classdef:findThisMerged with class:
Comentario comment:findThis
Constructor ctor:findThisMerged with method:
Declaración decl:findThis
Definición def:findThis
Destructor dtor:findThisMerged with method:
Enumerador enum:findThis
Extern extern:findThisDeprecated in July 2019
Campo field:findThis
Función Friend friend:findThisDeprecated in July 2019
Función func:findThisMerged with method:
Declaración de función funcdecl:findThisMerged with method:
Definición de función funcdef:findThisMerged with method:
Global global:findThisDeprecated in July 2019
Encabezado header:findThisDeprecated in July 2019
Interfaz interface:findThis
Macro macro:findThis
Definición de macro macrodef:findThisMerged with macro:
Referencia de macro macroref:findThisMerged with macro:
Método method:findThis
Declaración de método methoddecl:findThisMerged with method:
Definición del método methoddef:findThisMerged with method:
Namespace namespace:findThis
Propiedad prop:findThis
Referencia ref:findThis
Literal de cadena strlit:findThis
Estructura struct:findThisMerged with type:
Declaración de estructura structdecl:findThisMerged with type:
Definición de estructura structdef:findThisMerged with type:
Argumento de plantilla tmplarg:findThisDeprecated in July 2019
Especificación de plantilla tmplspec:findThisDeprecated in July 2019
Tipo type:findThis
Definición de tipo typedef:findThisMerged with type:
Unión union:findThisDeprecated in July 2019

Funciones para seleccionar proyectos, repositorios, rutas de acceso y archivos

Las funciones facilitan la búsqueda a ubicaciones especificadas, tipos específicos de archivos dentro de estas ubicaciones o nombres de archivo especificados. Restrinja la búsqueda a una ubicación específica mediante los filtros de proj, repoo path. Combine y haga coincidir con las siguientes funciones según sea necesario.

Uso Ejemplo
Busque todas las apariciones de la palabra QueueJobsNow en el proyecto Fabrikam. QueueJobsNow proj:Fabrikam
Busque todas las apariciones de la palabra QueueJobsNow en el repositorio contoso. QueueJobsNow repo:Contoso
Busque todas las apariciones de la palabra QueueJobsNow en la ruta VisualStudio/Services/Framework y sus subrutas. QueueJobsNow path:VisualStudio/Services/Framework
Busque todas las apariciones de la palabra QueueJobsNow en la ruta */Doc*/Framework/* y */Doc*/*/*/Framework/* y sus subdirectorios. El patrón de globbing (**) coincide con cero o más caracteres en varios segmentos. Por ejemplo, path:**/Doc**/Framework también coincide con abc/DocTest/gh/ijk/mnop/Framework/ QueueJobsNow path:**/Doc**/Framework
Busque todas las apariciones de la palabra QueueJobsNow en la ruta de acceso */Doc*/Framework/* y sus subrutas y nombre de archivo Test*.txt (Usar patrón de Globbing **). Por ejemplo, path:**/Doc**/Framework/**/Test*.txt coincide también con abc/def/DocA/gh/Framework/TestMisc.txt QueueJobsNow path:**/Doc**/Framework/**/Test*.txt
Incluya el argumento en el filtro entre comillas dobles si contiene un espacio. QueueJobsNow path:"VisualStudio/Windows Phones and Devices/Services"
Busque todas las apariciones de la palabra QueueJobsNow en todos los archivos donde el nombre de archivo comienza con queueRegister. QueueJobsNow file:queueRegister*
Busque todos los archivos con el nombre QueueRegister sin una extensión. Use comillas para buscar archivos sin extensiones. file:"queueRegister"
Busque todas las apariciones de la palabra QueueJobsNow solo en archivos de código fuente de C#. Una cadena de búsqueda de texto sin formato que no incluye funciones de tipo de archivo también busca archivos donde la cadena coincide con parte del nombre de archivo. QueueJobsNow ext:cs

Code Search le permite expandir interactivamente la búsqueda en función de los resultados anteriores. Por ejemplo, puede ampliar la búsqueda a archivos relacionados cuando esté realizando el seguimiento o depurando código.

Haga clic con el botón derecho en un término en el archivo e inicie una nueva búsqueda de otros archivos con el mismo término. Puede buscarlo como texto o como definición o referencia si es un nombre de objeto.

Para obtener más información, consulte Introducción a las búsquedas.

Más operaciones de búsqueda de código

Aquí hay algunas funciones más de búsqueda de código. Puede buscar tipos de código en archivos de C#, C, C++, Java y Visual Basic.NET. Para abrir los resultados de la búsqueda en una nueva pestaña, seleccione Ctrl + Entrar en el cuadro de búsqueda principal. Para cambiar a la nueva pestaña de Google Chrome, seleccione Ctrl + Mayús + Intro.

Uso ejemplo
Buscar todos los comentarios Historia:Palabra clave
Buscar todas las apariciones de comentarios marcados como "ToDo" en su código Seleccione comment: y escriba todo
Buscar en ubicaciones específicas, como dentro de una ruta de acceso determinada Usar una cadena de búsqueda como Driver path:MyShuttle/Server
Buscar archivos por nombre o simplemente por extensión de archivo Driver file:GreenCabs.cs. La cadena de búsqueda error ext:resx podría ser útil si desea revisar todas las cadenas de error del código. Incluso si la cadena de búsqueda de texto sin formato coincide con parte de un nombre de archivo, el archivo aparece en la lista de archivos encontrados. Esta búsqueda funciona sin hacer coincidir funciones específicas de tipo de archivo.

Búsqueda de proyectos y repositorios de Git

Un proyecto de Git tiene una lista de repositorios. Para ampliar la búsqueda, marque las casillas del proyecto y del repositorio. Puede buscar en todos o más proyectos, o en menos proyectos y repositorios. Si hay muchos proyectos o repositorios, seleccione Mostrar más para verlos todos.

La búsqueda de código puede indexar diferentes ramas en un repositorio de Git. Solo indexa archivos en la rama predeterminada de los repositorios de Git de forma predeterminada. La rama predeterminada es 'main'. Para indexar otras ramas, vaya a la pestaña Opciones en la sección Repositorios de la página de configuración del proyecto.

Nota

De forma predeterminada, la búsqueda de código busca la cadena especificada en la rama principal o predeterminada de un repositorio. Sin embargo, puede restringir la búsqueda especificando un filtro para una rama específica.

Captura de pantalla en la que se muestran las ramas de Git para la configuración.

Buscar proyectos de TFVC

Los proyectos de TFVC solo muestran las carpetas que puede leer. No puede ver ningún otro proyecto o carpeta. Para filtrar la búsqueda, elija carpetas del árbol.

Sugerencia

Búsqueda de código guarda tus últimas configuraciones, como el proyecto y el repositorio o la ruta en la que buscaste. Cuando quiera buscar en otro ámbito, seleccione Borrar todos los vínculos para desactivar las casillas y buscar en todos los proyectos. La búsqueda de código resalta las primeras 100 visitas o coincidencias en los archivos de destino en el panel de resultados.

Buscar código con la API REST

Puede usar las API para ampliar o complementar las funcionalidades enumeradas en este artículo. Para obtener información sobre la búsqueda de código con la API REST, consulte Capturar resultados de búsqueda de código.

Pasos siguientes