ドキュメントの変更

オープン インタラクティブ チュートリアル

サンプル データ

このガイドの例では、 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を使用して更新操作のパラメータとして使用する 2 つのドキュメントを作成します。

• cuisineフィールド値が「Pizza」であるレストランを検索するクエリフィルター

• これらのレストランのcuisineフィールドの値を「Pasta and cake」に設定するアップデート ドキュメント

const string oldValue = "Pizza";
const string newValue = "Pasta and breadsticks";
// Creates a filter for all documents with a "cuisine" value of "Pizza"
var filter = Builders<Restaurant>.Filter
     .Eq(restaurant => restaurant.Cuisine, oldValue);
// Creates instructions to update the "cuisine" field of documents that
// match the filter
var update = Builders<Restaurant>.Update
    .Set(restaurant => restaurant.Cuisine, newValue);
// Updates all documents that have a "cuisine" value of "Pizza"
return _restaurantsCollection.UpdateMany(filter, update);

1 つのドキュメントの更新

次のコードは、非同期UpdateOneAsync()メソッドまたは同期UpdateOne()メソッドを使用して 1 つのドキュメントを更新する方法を示しています。

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フィールドの値が「manhattan」であるすべてのドキュメントを検索し、これらのドキュメントのborough値を「manhattan（north）」に更新します。 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}");

Updating documents...
Updated documents: 10259
Result acknowledged? True

必要なパラメーター

ReplaceOne() メソッドには次のパラメーターが必要です。

• 置き換えるレコードを決定する クエリフィルター ドキュメント 。

• 置換ドキュメントで、新しいドキュメントに挿入するフィールドと値を指定します。 コレクション内のドキュメントが C# クラスにマッピングされている場合、置換ドキュメントはこのクラスのインスタンスにすることができます。

アップデート操作と同様に、.NET/C# ドライバーのBuildersクラスを使用してクエリフィルターを作成できます。 次のコード例では、 Buildersを使用して、 nameフィールド値が「Pizzaクライアント」のレストランを検索するクエリフィルターを作成します。 このコードでは、最初に一致したドキュメントを置き換える新しいRestaurantオブジェクトも作成されます。

// Creates a filter for all restaurant documents that have a "cuisine" value of "Pizza"
var filter = Builders<Restaurant>.Filter
    .Eq(r => r.Cuisine, "Pizza");
// Finds the ID of the first restaurant document that matches the filter
var oldPizzaRestaurant = _restaurantsCollection.Find(filter).First();
var oldId = oldPizzaRestaurant.Id;
// Generates a new restaurant document
Restaurant newPizzaRestaurant = new()
{
    Id = oldId,
    Name = "Mongo's Pizza",
    Cuisine = "Pizza",
    Address = new()
    {
        Street = "Pizza St",
        ZipCode = "10003"
    },
    Borough = "Manhattan",
};
// Replaces the existing restaurant document with the new document
return _restaurantsCollection.ReplaceOne(filter, newPizzaRestaurant);

次のコードは、非同期ReplaceOneAsync()メソッドまたは同期ReplaceOne()メソッドを使用して 1 つのドキュメントを置き換える方法を示しています。

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

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

置換操作をカスタマイズする

ReplaceOne()メソッドは、置換操作を構成するために使用できるオプションを表す追加のパラメータとしてReplaceOptionsオブジェクトをオプションで受け入れます。 ReplaceOptionsプロパティを指定しない場合、ドライバーは置換操作をカスタマイズしません。

ReplaceOptionsタイプでは、次のプロパティを持つオプションを構成できます。

戻り値

ReplaceOne()メソッドはReplaceOneResultオブジェクトを返します。 ReplaceOneResult型には次のプロパティが含まれています。

例

次のコードでは、 ReplaceOne()メソッドを使用して、 nameフィールドの値が「Pizza Down」である最初のドキュメントを検索し、このドキュメントを「 Engine 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}");

Replacing document...
Replaced documents: 1
Result acknowledged? True

API ドキュメント

このガイドで説明したメソッドや型の詳細については、次の API ドキュメントを参照してください。

• UpdateOne()

• UpdateOneAsync()

• UpdateMany()

• UpdateManyAsync()

• UpdateOptions

• UpdateResult

• ReplaceOne()

• ReplaceOneAsync()

• ReplaceOptions

• ReplaceOneResult