Crear un filtro de query

Overview

En esta guía, aprenderá a usar el controlador MongoDB.NET/C# para crear un filtro de consulta. Un filtro de consulta es una expresión que especifica los documentos que se leerán, actualizarán o eliminarán en una operación CRUD. Puede usar métodos de compilación, disponibles en Builders<TDocument>.Filter propiedad estática, para crear filtros de consulta y agregarles operaciones.

{ "_id": 1, "make": "Fender", "models": ["Stratocaster", "Telecaster"], "establishedYear": 1946, "rating": 9 }
{ "_id": 2, "make": "Gibson", "models": ["Les Paul", "SG", "Explorer"], "establishedYear": 1902, "rating": 8 }
{ "_id": 3, "make": "PRS", "models": ["Silver Sky", "SE", "Custom"], "establishedYear": 1985, "rating": 9 }
{ "_id": 4, "make": "Kiesel", "models": ["Ares", "Vader", "Solo"], "establishedYear": 2015 }
{ "_id": 5, "make": "Ibanez", "models": ["RG", "AZ"], "establishedYear": 1957, "rating": 7 }
{ "_id": 6, "make": "Strandberg", "models": ["Boden", "Salen"], "establishedYear": 1982 }

public class Guitar
{
    public int Id { get; set; }
    public string Make { get; set; }
    public List<string> Models { get; set; }
    public int EstablishedYear { get; set; }
    public int? Rating { get; set; }
}

var client = new MongoClient("localhost://27017");
var guitarCollection = client.GetDatabase("example").GetCollection<Guitar>("guitars");

Encuentre todos los documentos

Un filtro de query vacío coincide con todos los documentos de una colección. El siguiente ejemplo muestra cómo crear un filtro de query vacío:

var filter = Builders<Guitar>.Filter.Empty;

Operadores de comparación

Los operadores de comparación comparan el valor del query con el valor de un campo especificado. Algunos de estos métodos tienen una sintaxis alternativa que se puede usar en lugar del método, como se muestra en el siguiente ejemplo:

var filter = Builders<Guitar>.Filter.Eq(g => g.Make, "Fender");
var results = guitarCollection.Find(filter).ToList();
// Alternative syntax
var results = guitarCollection.Find(g => g.Make == "Fender").ToList();;

La siguiente tabla enumera los métodos del driver .NET/C# para las operaciones de comparación y los operadores equivalentes del MongoDB Server:

El siguiente ejemplo llama al método Find() y pasa un filtro lambda, que el driver traduce en un filtro de query. El query coincide con todos los documentos en los que el campo establishedYear es mayor que 1985.

// Finds all documents with an "establishedYear" value greater than 1985
var results = guitarCollection.Find(g => g.EstablishedYear > 1985).ToList();
foreach (var doc in results)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 4, "make" : "Kiesel", "models" : ["Ares", "Vader", "Solo"], "establishedYear" : 2015, "rating" : null }

En el siguiente ejemplo, se utilizan desarrolladores para crear un filtro de query que coincida con los mismos documentos que el ejemplo anterior:

// Creates a filter for all documents with an "establishedYear" value greater
// than 1985
var filter = Builders<Guitar>.Filter.Gt(g => g.EstablishedYear, 1985);
// Finds all documents that match the filter
var result = guitarCollection.Find(filter).ToList();
foreach (var doc in result)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 4, "make" : "Kiesel", "models" : ["Ares", "Vader", "Solo"], "establishedYear" : 2015, "rating" : null }

El siguiente ejemplo llama al método Find() y pasa una expresión lambda, que el driver traduce a un filtro de query. El query coincide con todos los documentos donde el campo makees igual a "Fender".

// Finds all documents with a "make" value of "Fender"
var results = guitarCollection.Find(g => g.Make == "Fender").ToList();
foreach (var doc in results)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 1, "make" : "Fender", "models" : ["Stratocaster", "Telecaster"], "establishedYear" : 1946, "rating" : 9 }

En el siguiente ejemplo, se utilizan desarrolladores para crear un filtro de query que coincida con los mismos documentos que el ejemplo anterior:

// Creates a filter for all documents with a "make" value of "Fender"
var filter = Builders<Guitar>.Filter.Eq(g => g.Make, "Fender");
// Finds all documents that match the filter
var result = guitarCollection.Find(filter).ToList();
foreach (var doc in result)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 1, "make" : "Fender", "models" : ["Stratocaster", "Telecaster"], "establishedYear" : 1946, "rating" : 9 }

Operadores lógicos

Los operadores lógicos combinan dos o más expresiones y devuelven resultados basados en los resultados de esas expresiones. Estos métodos tienen una sintaxis alternativa que puedes usar en lugar del método, como se muestra en el siguiente ejemplo:

var builder = Builders<Guitar>.Filter;
var filter = builder.And(
   builder.Gte(g => g.EstablishedYear, 1985),
   builder.Ne(r => r.Make, "Kiesel"));
var results = guitarCollection.Find(filter).ToList();
// Alternative syntax
var results = guitarCollection.Find(
   g => g.EstablishedYear >= 1985
   && g.Make != "Kiesel")
.ToList();

En la siguiente tabla se enumeran los métodos del driver .NET/C# para operaciones lógicas y los operadores de MongoDB Server equivalentes:

El siguiente ejemplo llama al método Find() y pasa una expresión lambda, que el driver traduce a un filtro de query. El query coincide con todos los documentos en los que el campo establishedYear es mayor o igual a 1985 y el campo make no es igual a "Kiesel".

// Finds all documents with an "establishedYear" value greater than 1985
// and a "make" value that is not equal to "Kiesel"
var results = guitarCollection.Find(g => g.EstablishedYear >= 1985 && r.Make != "Kiesel").ToList();
foreach (var doc in results)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 3, "make" : "PRS", "models" : ["Silver Sky", "SE", "Custom"], "establishedYear" : 1985, "rating" : 9 }

En el siguiente ejemplo, se utilizan desarrolladores para crear un filtro de query que coincida con los mismos documentos que el ejemplo anterior:

// Creates a filter for all documents with an "establishedYear" value greater
// than 1985 and a "make" value that does not equal "Kiesel"
var builder = Builders<Guitar>.Filter;
var filter = builder.And(builder.Gte(g => g.EstablishedYear, 1985), builder.Ne(r => r.Make, "Kiesel"));
// Finds all documents that match the filter
var result = guitarCollection.Find(filter).ToList();
foreach (var doc in result)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 3, "make" : "PRS", "models" : ["Silver Sky", "SE", "Custom"], "establishedYear" : 1985, "rating" : 9 }

Operadores de arreglos

Los operadores de arreglo seleccionan documentos según el valor o la cantidad de elementos en un campo de arreglo. La siguiente tabla enumera los métodos del Driver .NET/C# para operaciones de arreglo y los operadores equivalentes de MongoDB Server:

El siguiente ejemplo utiliza desarrolladores para crear un filtro de query que seleccione todos los documentos que tengan exactamente tres elementos en el campo models:

// Creates a filter for all documents with 3 elements in the "models" field
var filter = Builders<Guitar>.Filter.Size(g => g.Models, 3);
// Finds all documents that match the filter
var result = guitarCollection.Find(filter).ToList();
foreach (var doc in result)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 2, "make" : "Gibson", "models" : ["Les Paul", "SG", "Explorer"], "establishedYear" : 1902, "rating" : 8 }
{ "_id" : 3, "make" : "PRS", "models" : ["Silver Sky", "SE", "Custom"], "establishedYear" : 1985, "rating" : 9 }
{ "_id" : 4, "make" : "Kiesel", "models" : ["Ares", "Vader", "Solo"], "establishedYear" : 2015, "rating" : null }

Operadores de elementos

Los operadores de elemento seleccionan documentos del query según la presencia o el tipo de un campo. La siguiente tabla enumera los métodos del Driver .NET/C# para operaciones de elemento y los operadores equivalentes de MongoDB Server:

En el siguiente ejemplo, se utilizan desarrolladores para crear un filtro de query que coincida con todos los documentos que tengan un campo rating:

// Creates a filter for all documents with a populated "ratings" field
var filter = Builders<Guitar>.Filter.Exists(g => g.Rating);
// Finds all documents that match the filter
var result = guitarCollection.Find(filter).ToList();
foreach (var doc in result)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 1, "make" : "Fender", "models" : ["Stratocaster", "Telecaster"], "establishedYear" : 1946, "rating" : 9 }
{ "_id" : 2, "make" : "Gibson", "models" : ["Les Paul", "SG", "Explorer"], "establishedYear" : 1902, "rating" : 8 }
{ "_id" : 3, "make" : "PRS", "models" : ["Silver Sky", "SE", "Custom"], "establishedYear" : 1985, "rating" : 9 }
{ "_id" : 5, "make" : "Ibanez", "models" : ["RG", "AZ"], "establishedYear" : 1957, "rating" : 7 }

Operadores de evaluación

Los operadores de evaluación analizan los datos de campos individuales o de todos los documentos de la colección. La siguiente tabla enumera los métodos del driver .NET/C# para las operaciones de evaluación y los operadores equivalentes de MongoDB Server:

En el siguiente ejemplo, se utilizan desarrolladores para crear un filtro de query que coincida con todos los documentos que tengan un valor en el campo make que comience con la letra “G”:

// Creates a filter for all documents with a populated "ratings" field
var filter = Builders<Guitar>.Filter.Regex(g => g.Make, "^G");
// Finds all documents that match the filter
var result = guitarCollection.Find(filter).ToList();
foreach (var doc in result)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 2, "make" : "Gibson", "models" : ["Les Paul", "SG", "Explorer"], "establishedYear" : 1902, "rating" : 8 }

Operadores geoespaciales

Los operadores geoespaciales devuelven datos en función de las condiciones de expresión geoespacial. En la siguiente tabla se enumeran los métodos del driver .NET/C# para operaciones geoespaciales y los operadores de MongoDB Server equivalentes:

Operadores a nivel de bits

Los operadores a nivel de bits seleccionan documentos según condiciones de posición de bits. La siguiente tabla enumera los métodos del Driver .NET/C# para operaciones a nivel de bits y los operadores equivalentes de MongoDB Server:

Otros operadores

El driver.NET/C# también proporciona los siguientes métodos que crean definiciones de filtros:

Información Adicional

Para obtener más información sobre cualquiera de los métodos de drivers en esta página, se puede consultar la documentación de la API para la clase FilterDefinitionBuilder<TDocument>.