Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

Configurar o MongoDB C# Analyzer

Saiba como configurar o C# Analyzer em seu projeto .NET e quais opções de configuração estão disponíveis.

Para configurar o C# Analyzer, execute as seguintes ações:

  1. Instale o C# Analyzer conforme descrito no guia de instalação.

  2. Crie um arquivo especificando sua configuração para o C# Analyzer denominado mongodb.analyzer.json.

    Importante

    Nomenclatura

    Você deve nomear seu arquivo de configuração mongodb.analyzer.json.

  3. Adicione sua configuração ao seu arquivo mongodb.analyzer.json .

    A seguinte configuração de exemplo desabilita o rastreamento:

    { "EnableVariableTracking": "false" }
  4. Adicione o seguinte ao arquivo .csproj para seu aplicativo .NET dentro da marcação Project :

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

Observação

A configuração é opcional

Se você não especificar um arquivo de configuração, o C# Analyzer usará o valor padrão para todas as opções de configuração.

Para saber mais sobre arquivos de projeto .NET, consulte Noções básicas sobre o arquivo de projeto da Microsoft.

Para saber mais sobre a marcação AdditionalFiles, consulte Usando arquivos adicionais na documentação Roslyn.

A seguir está uma descrição de todas as opções de configuração suportadas pelo C# Analyzer:

Nome
Descrição

EnableVariableTratracking

Tipo: boolean

Descrição: Especifica se o MongoDB Analyzer rastreia e compõe variáveis de expressão do construtor.

Dica

Para saber mais sobre expressões de construtor, consulte a página Analise seu Código .

Valores aceitos: true ou false
Padrão: true

Nome do arquivo de log

Tipo: string

Descrição: especifica o caminho para o qual o MongoDB Analyzer grava seus logs internos.

Importante

Para gerar registros, você deve especificar um arquivo de log e a opção OutputInternalLogsToFile .

Use a seguinte configuração de exemplo para tornar as informações de saída do C# Analyzer em um arquivo de log:

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

Valores aceitos: um caminho de arquivo válido
Padrão: ""

LinqAnalysisVerbosity

Tipo: string

Descrição: especifica quais expressões LINQ o MongoDB Analyzer analisa. Você pode definir essa opção para um dos seguintes valores:

  • "All": Analisar todas as expressões LINQ, exceto coleções e arrays do sistema

  • "Medium": Analisar todas as expressões LINQ, exceto coleções e arrays do sistema, em arquivos que incluem MongoDB.Driver e seus namespaces aninhados somente

  • "None": Não analise expressões LINQ

Importante

A opção de configuração do LinqAnalysisVerbosity está disponível somente no MongoDB Analyzer v2.0 e posterior.

Valores "All"aceitos:, "Medium" ou "None"
Padrão: "Medium"

OutputDriverVersion

Tipo: booleano

Descrição: especifica se o MongoDB Analyzer inclui sua versão do driver .NET/C# em mensagens de diagnóstico.

Valores aceitos: true ou false
Padrão: false

OutputInternalExceptions

Tipo: boolean

Descrição: especifica se o MongoDB Analyzer inclui exceções internas nas mensagens de diagnóstico.

Valores aceitos: true ou false
Padrão: false

OutputInternalLogsToFile

Tipo: boolean

Descrição: Especifica se o MongoDB Analyzer grava seus logs internos em um arquivo.

Importante

Para gerar registros, você deve especificar um arquivo de log e a opção OutputInternalLogsToFile .

Use a seguinte configuração de exemplo para tornar as informações de saída do C# Analyzer em um arquivo de log:

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

Valores aceitos: true ou false
Padrão: false

PocoAnalysisVerbosity

Tipo: string

Descrição: especifica quais POCOs o MongoDB Analyzer visualiza como JSON. Você pode definir essa opção para um dos seguintes valores:

  • "All": Visualizar todos os POCOs

  • "Medium": Visualize apenas POCOs que fazem parte de uma expressão LINQ ou construtores ou têm atributos BSON

  • "None": Não visualize POCOs

Valores "All"aceitos:, "Medium" ou "None"
Padrão: "Medium"

Enviar telemetria

Tipo: booleano

Descrição: especifica se o MongoDB Analyzer coleta e envia informações anônimas para a MongoDB Inc.

Dica

Para saber mais sobre telemetria no C# Analyzer, consulte a seção Telemetria deste guia.

Valores aceitos: true ou false
Padrão: true

Para saber mais sobre as opções de configuração compatíveis com o MongoDB Analyzer, consulte o código-fonte do MongoDB C# Analyzer.

Quando o C# Analyzer analisa seu código-fonte, a ferramenta, por padrão, coleta e envia informações anônimas para a MongoDB Inc.

Para desativar esse recurso, especifique a seguinte opção em seu arquivo de configuração:

"SendTelemetry": false

Para exibir uma lista completa de todas as informações coletadas pelo C# Analyzer quando você tiver habilitado a telemetria, consulte a página de perguntas frequentes .

Para saber mais sobre como a MongoDB Inc. usa os dados coletados, consulte a Política de Privacidade.