Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.
Docs Menu

Configura el Analizador C# de MongoDB

Aprende cómo configurar el C# Analyzer en tu proyecto .NET y qué opciones de configuración están disponibles.

Para configurar el Analizador de C#, realice las siguientes acciones:

  1. Instala el Analizador de C# como se describe en la guía de instalación.

  2. Crea un archivo que especifique tu configuración para el Analizador C# llamado mongodb.analyzer.json.

    Importante

    Nombrar

    Debes nombrar tu archivo de configuración mongodb.analyzer.json.

  3. Agrega tu configuración a tu archivo mongodb.analyzer.json.

    La siguiente configuración de muestra desactiva el seguimiento de variables:

    { "EnableVariableTracking": "false" }
  4. Agregue lo siguiente al archivo .csproj de su aplicación .NET dentro de la etiqueta Project:

    <ItemGroup>
    <AdditionalFiles Include="<path to your mongodb.analyzer.json file>" />
    </ItemGroup>

Nota

La configuración es opcional

Si no especificas un archivo de configuración, el C# Analyzer usa el valor por defecto para todas las opciones de configuración.

Para obtener más información sobre los archivos de proyectos de .NET, consulta Comprensión del archivo del proyecto de Microsoft.

Para obtener más información sobre la etiqueta AdditionalFiles, consulta Uso de archivos adicionales en la documentación de Roslyn.

Lo siguiente es una descripción de todas las opciones de configuración admitidas por el C# Analyzer:

Nombre
Descripción

EnableVariableTracking

Tipo: booleano

Descripción: Especifica si el analizador de C# rastrea y compone las variables de expresión del constructor.

Tip

Para obtener más información sobre las expresiones del generador, consulte la página Analizar su código.

Valores aceptados: true o false
Valor predeterminado: true

Nombre de la entrada de registro

Tipo: cadena

Descripción: Especifica la ruta donde el analizador de C# escribe sus registros internos.

Importante

Para generar registros, debe especificar tanto un archivo de registro como la opción OutputInternalLogsToFile.

Utiliza la siguiente configuración de muestra para hacer que el C# Analyzer envíe información a un archivo de registro:

"OutputInternalLogsToFile": true,
"LogFileName": "<path to your logfile>"

Valores aceptados: Una ruta de archivo válida.
Valor predeterminado: ""

LinqAnalysisVerbosity

Tipo: cadena

Descripción: Especifica qué expresiones LINQ analiza el Analizador de C#. Puede establecer esta opción en uno de los siguientes valores:

  • "All": Analizar todas las expresiones LINQ, excepto colecciones y arreglos del sistema

  • "Medium"Analiza todas las expresiones LINQ, excepto colecciones y arreglos del sistema, en archivos que incluyan MongoDB.Driver y solo sus namespaces anidados

  • "None": No analizar expresiones LINQ

Importante

La opción de configuración LinqAnalysisVerbosity solo está disponible en C# Analyzer v2.0 y versiones posteriores.

Valores "All"aceptados:, "Medium" o Valor "None"
predeterminado: "Medium"

Versión del controlador de salida

Tipo: booleano

Descripción: Especifica si el Analizador de C# incluye la versión de su controlador .NET/C# en los mensajes de diagnóstico.

Valores aceptados: true o false
Valor predeterminado: false

OutputInternalExceptions

Tipo: booleano

Descripción: Especifica si el analizador de C# incluye excepciones internas en los mensajes de diagnóstico.

Valores aceptados: true o Valor false
predeterminado: false

OutputInternalLogsToFile

Tipo: booleano

Descripción: Especifica si el analizador de C# escribe sus registros internos en un archivo.

Importante

Para generar registros, debe especificar tanto un archivo de registro como la opción OutputInternalLogsToFile.

Utiliza la siguiente configuración de muestra para hacer que el C# Analyzer envíe información a un archivo de registro:

"OutputInternalLogsToFile": true,
"LogFileName": "<path to your logfile>"

Valores aceptados: true o false
Valor predeterminado: false

PocoAnalysisVerbosity

Tipo: cadena

Descripción: Especifica qué POCOs el analizador de C# previsualiza como JSON. Puede establecer esta opción en uno de los siguientes valores:

  • "All"Previsualizar todos los POCOs

  • "Medium"Vista previa solo de los POCOs que forman parte de una expresión LINQ o de desarrolladores, o que tienen atributos BSON

  • "None": No realizar una vista previa de los POCO

Valores "All"aceptados:, "Medium" o Valor "None"
predeterminado: "Medium"

SendTelemetry

Tipo: booleano

Descripción: Especifica si el analizador de C# recopila y envía información anonimizada a MongoDB Inc. para mejorar los productos.

Tip

Para saber más sobre la telemetría en el Analizador de C#, consulta la sección Telemetría de esta guía.

Valores aceptados: true o false
Valor predeterminado: true

Para obtener más información sobre las opciones de configuración que admite el Analizador de C#, consulta el Código fuente del Analizador de C# de MongoDB.

Cuando el C# Analyzer analice tu código fuente, la herramienta recopila y envía información anonimizada a MongoDB Inc. por defecto para mejorar los productos.

Para desactivar esta funcionalidad, especifica la siguiente opción en el archivo de configuración:

"SendTelemetry": false

Para ver una lista completa de toda la información recopilada por el C# Analyzer cuando has activado la telemetría, consulta la página de Preguntas Frecuentes.

Para obtener más información sobre cómo MongoDB Inc. utiliza los datos recopilados, consulte la Política de Privacidad.