Overview
Un builder es una clase proporcionada por el driver de .NET/C# para ayudarte a construir operaciones comunes como query y actualizar.
Para obtener más información sobre los desarrolladores, consulta Operaciones con desarrolladores en la documentación del driver .NET/C#.
Traduce a la API de query de MongoDB
Utiliza el C# Analyzer para traducir tus expresiones de constructor en la API de Query de MongoDB. Haz clic en las siguientes pestañas para ver un ejemplo de una expresión de constructor y su traducción correspondiente en la API de query de 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/ } ] }
Nota
Nombres de variables.
Las traducciones de la API de query de MongoDB generadas por el C# Analyzer contienen nombres de variables del código de su driver de .NET/C#. El driver de .NET/C# reemplaza estos nombres de variables por sus valores correspondientes cuando la aplicación se comunica con MongoDB.
Analizar desarrolladores en Visual Studio
Para analizar tus expresiones de desarrollador en Visual Studio, realiza las siguientes acciones:
Instala el Analizador de C# como se describe en el Install guía.
Escribe una expresión de otización con el driver .NET/C#
Mueva su mouse sobre el ... anotación debajo del primer método de tu expresión de constructor para mostrar un mensaje informativo que contiene la traducción de la API de query de MongoDB.
Expresiones del constructor simple
Haz clic en la siguiente pestaña correspondiente para ver una expresión de constructor con o sin un mensaje de información mostrado:
Variables del Generador de rutas
El C# Analyzer admite el seguimiento y la composición de variables builder. Puede combinar múltiples expresiones de constructor con operadores lógicos y ver la traducción de la API de Query de MongoDB en el mensaje de información.
Haga clic en la siguiente pestaña correspondiente para ver una variable de constructor compuesta con o sin un mensaje informativo mostrado:
API fluida
El C# Analyzer admite la API Fluent mediante el uso de clases builder en el controlador .NET/C# . Se puede crear una secuencia de métodos de construcción encadenados y visualizar la traducción de la API de MongoDB query en el mensaje informativo.
Haga clic en la siguiente pestaña correspondiente para ver una operación utilizando métodos concatenados de desarrolladores, con o sin la visualización de un mensaje informativo:
Tip
Panel de lista de errores
Si utilizas Visual Studio para Windows, puedes ver la salida del C# Analyzer en la ventana Lista de errores.
Para aprender más información, consulta Ventana de lista de errores de Microsoft.
Expresiones de desarrollador no soportadas
Si no se admite su expresión de construcción, el Analizador de C# produce una
MABuilders2001 advertencia.
El siguiente snippet de código contiene una expresión builder que accede a la propiedad no compatible Length:
var filter = Builders<Movie>.Filter.Gt(m => m.Reviews.Length, 2);
El C# Analyzer muestra una anotación en la expresión no permitida y genera el siguiente mensaje de advertencia:
Expression not supported: ArrayLength(m.Reviews).
La siguiente captura de pantalla muestra el código anotado y la advertencia que se muestra cuando se pasa el cursor sobre la anotación:
Tip
Panel de lista de errores
Si utilizas Visual Studio para Windows, puedes ver la salida del C# Analyzer en la ventana Lista de errores.
Para aprender más información, consulta Ventana de lista de errores de Microsoft.
Para ver más ejemplos de expresiones de constructor no soportadas, consulta el repositorio de Github del Analizador C# de MongoDB.