UpdateOne

Nesta página

Visão geral

Dados de amostra
Métodos e parâmetros
Atualizar vários valores
Definições de atualização combinadas
Atualizar pipelines
Opções de configuração
Valor de retorno
Informações adicionais
Documentação da API

Visão geral

UpdateOne()
UpdateOneAsync(): A versão assíncrona do UpdateOne().

As seções a seguir descrevem esses métodos em mais detalhes.

Observação

Sobrecargas de método

Muitos dos métodos nesta página têm múltiplas sobrecargas. Os exemplos deste guia mostram apenas uma definição de cada método. Para obter mais informações sobre as sobrecargas disponíveis, consulte a documentação da API .

Dados de amostra

Os exemplos neste guia utilizam a coleção do restaurants a partir do banco de dados do sample_restaurants. Os documentos nesta coleção usam as seguintes classes Restaurant, Address e GradeEntry como modelos:

public class Restaurant
{
    public ObjectId Id { get; set; }
    public string Name { get; set; }
    [BsonElement("restaurant_id")]
    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; }
    [BsonElement("coord")]
    public double[] Coordinates { get; set; }
    public string Street { get; set; }
    [BsonElement("zipcode")]
    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.

Essa coleção é dos conjuntos de dados de amostra fornecidos pelo Atlas. Consulte o Quick Start para saber como criar um cluster MongoDB gratuito e carregar esses dados de amostra.

Métodos e parâmetros

Os métodos UpdateOne() e UpdateOneAsync() aceitam os seguintes parâmetros:

Parâmetro	Descrição
`filter`	An instance of the `FilterDefinition` classe that specifies the documento to update. Para saber como criar um filtro de query, consulte Especificar uma query. Tipo de dados: FilterDefinition
`update`	Tipo de dados: UpdateDefinition<TDocument>
`options`	Opcional. An instance of the `UpdateOptions` classe that specifies the configuration for the update operation. O valor padrão `null` é. Para obter uma lista de opções disponíveis, consulte Opções de configuração. Tipo de dados: UpdateOptions
`cancellationToken`	Opcional. Um token que você pode usar para cancelar a operação. Tipo de dados: `CancellationToken`

Atualizar vários valores

The UpdateOne() and UpdateOneAsync() methods each accept only one UpdateDefinition objeto. As seções a seguir descrevem como atualizar vários valores em uma única chamada de método.

Definições de atualização combinadas

O método Builders.Update.Combine() permite combinar vários objetos UpdateDefinition. Este método aceita o seguinte parâmetro:

Parâmetro	Descrição
`updates`	Uma array de definições de atualizações para combinar. Tipo de dados: `UpdateDefinition<TDocument>[]`

var filter = Builders<Restaurant>.Filter
    .Eq("name", "Downtown Deli");
var combinedUpdate = Builders<Restaurant>.Update.Combine(
    Builders<Restaurant>.Update.Set("cuisine", "French"),
    Builders<Restaurant>.Update.Unset("borough")
);
_restaurantsCollection.UpdateOne(filter, combinedUpdate);

var filter = Builders<Restaurant>.Filter
    .Eq("name", "Downtown Deli");
var combinedUpdate = Builders<Restaurant>.Update.Combine(
    Builders<Restaurant>.Update.Set("cuisine", "French"),
    Builders<Restaurant>.Update.Unset("borough")
);
await _restaurantsCollection.UpdateOneAsync(filter, combinedUpdate);

Atualizar pipelines

Para criar um pipeline de atualização, chame o método Builders.Update.Pipeline(). Este método aceita o seguinte parâmetro:

Parâmetro	Descrição
`pipeline`	Uma instância `PipelineDefinition` que representa o pipeline de atualização. To create a `PipelineDefinition` objeto, create a BSON documento for each update operation you want to perform, then pass these documents to the `PipelineDefinition.Create()` method. Tipo de dados: `PipelineDefinition<TDocument, TDocument>`

var filter = Builders<Restaurant>.Filter
    .Eq("name", "Downtown Deli");
var updatePipeline = Builders<Restaurant>.Update.Pipeline(
    PipelineDefinition<Restaurant, Restaurant>.Create(
        new BsonDocument("$set", new BsonDocument("cuisine", "French")),
        new BsonDocument("$unset", "borough")
    )
);
_restaurantsCollection.UpdateOne(filter, updatePipeline);

var filter = Builders<Restaurant>.Filter
    .Eq("name", "Downtown Deli");
var updatePipeline = Builders<Restaurant>.Update.Pipeline(
    PipelineDefinition<Restaurant, Restaurant>.Create(
        new BsonDocument("$set", new BsonDocument("cuisine", "French")),
        new BsonDocument("$unset", "borough")
    )
);
await _restaurantsCollection.UpdateOneAsync(filter, updatePipeline);

Observação

Operações não suportadas

Opções de configuração

The UpdateOne() and UpdateOneAsync() methods optionally accept an UpdateOptions objeto as a parameter. Você pode utilizar este argumento para configurar a operação de atualização.

A classe UpdateOptions contém as seguintes propriedades:

Propriedade	Descrição
`ArrayFilters`	Tipo de dados: IEnumerable
`BypassDocumentValidation`	Tipo de dados: `bool?`
`Collation`	Especifica o tipo de agrupamento de idiomas a ser usado ao classificar os resultados. Consulte o manual do MongoDB Server para obter mais informações sobre agrupamento. Tipo de dados: Agrupamentos
`Comment`	Obtém ou define o comentário fornecido pelo usuário para a operação. Consulte o manual do MongoDB Server para obter mais informações. Tipo de dados: BsonValor
`Hint`	Obtém ou define o índice a ser usado para digitalizar documentos. Consulte o manual do MongoDB Server para obter mais informações. Tipo de dados: BsonValor
`IsUpsert`	Especifica se a operação de atualização executará uma operação de upsert se nenhum documento corresponder ao filtro de consulta. See the MongoDB Server manual for more information. Tipo de dados: `bool`
`Let`	Obtém ou define o documento let . Consulte o manual do MongoDB Server para obter mais informações. Tipo de dados: Documento BSON

Valor de retorno

Propriedade	Descrição
`IsAcknowledged`	Indica se a operação de atualização foi reconhecida pelo MongoDB. Tipo de dados: `bool`
`IsModifiedCountAvailable`	Indica se você pode ler a contagem de registros de atualização no `UpdateResult`. Tipo de dados: `bool`
`MatchedCount`	O número de documentos que corresponderam ao filtro de query, independentemente de um ter sido atualizado. Tipo de dados: `long`
`ModifiedCount`	O número de documentos atualizados pela operação de atualização. Tipo de dados: `long`
`UpsertedId`	O ID do documento que foi atualizado no banco de dados, se o driver executou um upsert. Tipo de dados: BsonValor

Informações adicionais

Para obter exemplos executáveis das operações de atualização, consulte a página Atualizar um documento.

Para saber mais sobre como criar filtros de queries, consulte o guia Especifique uma consulta.

Documentação da API

Para obter mais informações sobre qualquer um dos métodos ou tipos discutidos neste guia, consulte a seguinte documentação da API:

Voltar

Insert

Campos