修改文档

打开交互式教程

样本数据

本指南中的示例使用 sample_restaurants 数据库中的 restaurants 集合。此集合中的文档使用以下 Restaurant、Address 和 GradeEntry 类作为模型：

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; }
}

此数据集来自 Atlas 提供的示例数据集。请参阅快速入门，以了解如何创建一个免费的 MongoDB 集群并加载这些示例数据。

所需参数

每种更新方法都需要以下参数：

• 查询筛选器文档，用于确定要更新的记录。 有关查询筛选器的更多信息，请参阅MongoDB 服务器手册。

• 更新文档，其中指定更新操作符（要执行的更新类型）以及应更改的字段和值。 有关更新操作符及其用法的完整列表，请参阅字段更新操作符手册页面。

.NET/C# 驱动程序提供了一个 Builders 类，可简化查询筛选器和更新文档的创建。以下代码示例使用 Builders 创建两个文档以用作更新操作中的参数：

• 查询筛选器，用于搜索 borough 字段值为“曼哈顿”的餐厅

• 更新文档，用于将这些餐厅的 borough 字段的值设置为“曼哈顿（北部）”

var filter = Builders<Restaurant>.Filter
    .Eq(restaurant => restaurant.Borough, "Manhattan");
var update = Builders<Restaurant>.Update
    .Set(restaurant => restaurant.Borough, "Manhattan (north)");

更新一个文档

以下代码将演示如何使用异步 UpdateOneAsync() 方法或同步 UpdateOne() 方法更新一个文档。

var result = await _restaurantsCollection.UpdateOneAsync(filter, update);

var result = _restaurantsCollection.UpdateOne(filter, update);

更新多个文档

以下代码将演示如何使用异步 UpdateManyAsync() 方法或同步 UpdateMany() 方法更新所有匹配文档。

var result = await _restaurantsCollection.UpdateManyAsync(filter, update);

var result = _restaurantsCollection.UpdateMany(filter, update);

自定义更新操作

这两种方法都可以选择接受 UpdateOptions 对象作为附加参数，该参数表示可用于配置更新操作的选项。如果您不指定任何 UpdateOptions 属性，则驱动程序不会自定义更新操作。

UpdateOptions 类型允许您使用以下属性配置选项：

返回值

UpdateOne() 和 UpdateMany() 方法会各自返回一个 UpdateResult 对象。UpdateResult 类型包含以下属性：

例子

以下代码使用 UpdateMany() 方法查找 borough 字段值为“曼哈顿”的所有文档，然后将这些文档中的 borough 值更新为“曼哈顿（北部）”。由于 IsUpsert 选项设置为 true，因此如果查询筛选器与任何现有文档都不匹配，驱动程序将插入新文档。

  var filter = Builders<Restaurant>.Filter
      .Eq(restaurant => restaurant.Borough, "Manhattan");
  var update = Builders<Restaurant>.Update
      .Set(restaurant => restaurant.Borough, "Manhattan (north)");
  UpdateOptions opts = new UpdateOptions()
  {
      Comment = new BsonString("Borough updated for C# Driver Fundamentals"),
      IsUpsert = true
  };
  Console.WriteLine("Updating documents...");
  var result = _restaurantsCollection.UpdateMany(filter, update, opts);
  Console.WriteLine($"Updated documents: {result.ModifiedCount}");
  Console.WriteLine($"Result acknowledged? {result.IsAcknowledged}");

所需参数

ReplaceOne() 方法需要使用以下参数：

• 查询筛选器文档，用于确定要替换的记录。

• 替换文档，用于指定要插入新文档的字段和值。如果集合中的文档映射到 C# 类，则替换文档可以是此类的实例。

与更新操作一样，您可以使用 .NET/C# 驱动程序中的 Builders 类来创建查询筛选器。以下代码示例使用 Builders 创建查询筛选器，用于搜索 name 字段值为“Pizza Town”的餐厅。该代码还创建一个新的 Restaurant 对象，以替换第一个匹配的文档。

var filter = Builders<Restaurant>.Filter.Eq(restaurant => restaurant.Name, "Pizza Town");
Restaurant newRestaurant = new()
{
    Name = "Food World",
    Cuisine = "American",
    Address = new BsonDocument
    {
        {"street", "Food St"},
        {"zipcode", "10003"},
    },
    Borough = "Manhattan",
};

以下代码将演示如何使用异步 ReplaceOneAsync() 方法或同步 ReplaceOne() 方法替换一个文档。

var result = await _restaurantsCollection.ReplaceOneAsync(filter, newRestaurant);

var result = _restaurantsCollection.ReplaceOne(filter, newRestaurant);

自定义替换操作

ReplaceOne() 方法可以选择性地采用 ReplaceOptions 对象作为附加参数，此参数表示可用来配置替换操作的选项。如果您不指定任何 ReplaceOptions 属性，则驱动程序不会自定义替换操作。

ReplaceOptions 类型允许您使用以下属性配置选项：

返回值

ReplaceOne() 方法返回 ReplaceOneResult 对象。ReplaceOneResult 类型包含以下属性：

例子

以下代码使用 ReplaceOne() 方法查找 name 字段值为“Pizza Town”的第一个文档，然后用名为“Food World”的新的 Restaurant 文档替换该文档。由于 IsUpsert 选项设置为 true，因此如果查询筛选器与任何现有文档都不匹配，驱动程序将插入新文档。

var filter = Builders<Restaurant>.Filter.Eq(restaurant => restaurant.Name, "Pizza Town");
Restaurant newRestaurant = new()
{
    Name = "Food World",
    Cuisine = "American",
    Address = new BsonDocument
    {
        {"street", "Food St"},
        {"zipcode", "10003"},
    },
    Borough = "Manhattan",
};
ReplaceOptions opts = new ReplaceOptions()
{
    Comment = new BsonString("Restaurant replaced for .NET/C# Driver Fundamentals"),
    IsUpsert = true
};
Console.WriteLine("Replacing document...");
var result = _restaurantsCollection.ReplaceOne(filter, newRestaurant, opts);
Console.WriteLine($"Replaced documents: {result.ModifiedCount}");
Console.WriteLine($"Result acknowledged? {result.IsAcknowledged}");

API 文档

要进一步了解本指南所讨论的任何方法或类型，请参阅以下 API 文档：

• UpdateOne()

• UpdateOneAsync()

• updateMany()

• UpdateManyAsync()

• UpdateOptions

• UpdateResult

• replaceOne()

• ReplaceOneAsync()

• ReplaceOptions

• ReplaceOneResult