Visão geral
Um construtor é uma classe fornecida pelo driver .NET/C# para ajudá-lo a construir operações comuns, como query e atualizações.
Para saber mais sobre construtores, consulte Operações com construtores na documentação do driver .NET/C#.
Traduzir para a API de query MongoDB
Use o C# Analyzer para traduzir suas expressões de construtor na API de query do MongoDB. Clique nas seguintes abas para ver um exemplo de uma expressão de construtor e sua tradução correspondente da API de query do MongoDB:
var filter = Builders<Book>.Filter.Eq(b => b.Genre, genre) & Builders<Book>.Filter.Gte(b => b.Price, minPrice) & Builders<Book>.Filter.Regex(b => b.Title, titleSearchTerm);
{ "$and": [ { "Genre": genre }, { "Price": { "$gte": minPrice } }, { "Title": /titleSearchTerm/ } ] }
Observação
Nomes de variáveis
As traduções da API de query do MongoDB geradas pelo C# Analyzer contêm nomes de variáveis do seu código de driver .NET/C#. O driver .NET/C# substitui os nomes dessas variáveis pelos valores correspondentes quando seu aplicativo se comunica com o MongoDB.
Analisar Construtores no Visual Studio
Para analisar sua expressão de construtor no Visual Studio, execute a seguinte ação:
Instale o C# Analyzer conforme descrito no guia deinstalação .
Grave uma expressão de construtor com o driver .NET/C#
Passe o mouse sobre a anotação ... abaixo do primeiro método da expressão do construtor para exibir uma mensagem informativa que contém a tradução da MongoDB Query API.
Expressões simples do construtor
Clique na seguinte guia correspondente para ver uma expressão de construtor com ou sem uma mensagem de informações exibida:
Variáveis do construtor de caminhos
O MongoDB Analyzer suporta rastreamento e composição de variáveis de construtor. Você pode combinar múltiplas expressões de construtor com operadores lógicos e visualizar a tradução da MongoDB Query API na mensagem informativa.
Clique na seguinte aba correspondente para ver uma variável de construtor composta com ou sem uma mensagem de informações exibida:
API fluente
O C# Analyzer suporta a API Fluent usando classes de construtor no driver .NET/C#. Você pode criar uma sequência de métodos construtores encadeados e visualizar a tradução da API de query do MongoDB na mensagem informativa.
Clique na seguinte guia correspondente para ver uma operação usando métodos de construtor encadeados com ou sem uma mensagem informativa exibida:
Dica
Painel de lista de erros
Se você estiver usando o Visual Studio para Windows, poderá exibir a saída do MongoDB Analyzer na janela Lista de erros.
Para saber mais, consulte a Janela de lista de erros da Microsoft.
Expressões de construtor não suportadas
Se a sua expressão de construtor não for suportada, o MongoDB Analyzer gerará um aviso de MABuilders2001.
O seguinte trecho de código contém uma expressão de construtor que acessa a propriedade Length não suportada :
var filter = Builders<Movie>.Filter.Gt(m => m.Reviews.Length, 2);
O MongoDB Analyzer mostra uma anotação na expressão não suportada e gera a seguinte mensagem de aviso:
Expression not supported: ArrayLength(m.Reviews).
A seguinte captura de tela mostra o código anotado e o aviso exibido quando você passa o mouse sobre a anotação:
Dica
Painel de lista de erros
Se você estiver usando o Visual Studio para Windows, poderá exibir a saída do MongoDB Analyzer na janela Lista de erros.
Para saber mais, consulte a Janela de lista de erros da Microsoft.
Para visualizar mais exemplos de expressões de construtor não suportadas, consulte o repositório do MongoDB MongoDB Analyzer Github.