Exemplos de uso
Visão geral
Exemplos de uso fornecem pontos de partida convenientes para operações MongoDB populares. Cada exemplo fornece as seguintes informações:
Um trecho de código que mostra como executar a operação em estruturas síncronas e assíncronas
Um link para um aplicativo de console totalmente executável usando a operação
O resultado esperado após a execução do exemplo
Dica
O uso de uma estrutura síncrona ou assíncrona em seu aplicativo depende do caso de uso. As chamadas síncronas são mais adequadas para fluxos de trabalho de query simples ou quando você precisa implementar lógica sequencial. Use chamadas assíncronas quando seu aplicativo depender de várias solicitações simultâneas de banco de dados ou se seu programa não exigir uma resposta imediata do banco de dados para continuar sendo executado.
Sugerimos experimentar as duas abordagens para determinar o framework mais adequado para suas finalidades.
Como usar os exemplos de uso
Esses exemplos usam osconjuntos de dados de amostra fornecidos pelo Atlas. Você pode carregá-los em seu banco de dados na camada gratuita do MongoDB Atlas seguindo o Guia de Comece a usar o Atlas ou pode importar o conjunto de dados de amostra para uma instância local do MongoDB.
Depois de importar o conjunto de dados, você pode copiar e colar um exemplo de uso no ambiente de desenvolvimento de sua escolha. Você pode seguir o Início rápido para saber mais sobre como começar a usar o Driver MongoDB .NET/C#. Depois de copiar um exemplo de uso , você precisará editar o URI da conexão para obter o exemplo conectado à sua instância MongoDB :
// Replace the following with your MongoDB deployment's connection string. private static string _mongoConnectionString = "<connection string>";
Para obter mais informações sobre como se conectar à sua instância do MongoDB, consulte o Guia de Conexão.
Classes de exemplo
Os exemplos de uso nesta seção mostram como executar operações em documentos na coleção restaurants
. Os exemplos utilizam as seguintes classes Restaurant
, Address
e GradeEntry
para modelar os dados nesta coleção:
public class Restaurant { public ObjectId Id { get; set; } public string Name { get; set; } [ ] public string RestaurantId { get; set; } public string Cuisine { get; set; } public Address Address { get; set; } public string Borough { get; set; } public List<GradeEntry> Grades { get; set; } }
public class Address { public string Building { get; set; } [ ] public double[] Coordinates { get; set; } public string Street { get; set; } [ ] public string ZipCode { get; set; } }
public class GradeEntry { public DateTime Date { get; set; } public string Grade { get; set; } public float? Score { get; set; } }
Observação
Os documentos na collection restaurants
usam a convenção de nomenclatura snake-case. Os exemplos neste guia usam um ConventionPack
para desserializar os campos na coleção em maiúsculas e minúsculas Pascal e mapeá-los para as propriedades na classe Restaurant
.
Para saber mais sobre serialização personalizada, consulte Serialização personalizada.