更新 1

項目一覧

Overview

サンプルデータ
メソッドとパラメーター
複数の値の更新
更新の定義を組み合わせた
更新パイプライン
設定オプション
戻り値
詳細情報
API ドキュメント

Overview

UpdateOne()
UpdateOneAsync(): UpdateOne() の非同期バージョン。

次のセクションでは、これらの方法について詳しく説明します。

注意

メソッドのオーバーロード

このページのメソッドの多くには、複数のオーバーロードがあります。 The examples in this ガイド show only one definition of each method. For more information about the available overloads, see the API documentation.

サンプルデータ

このガイドの例では、 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; }
}

注意

restaurantsコレクションのドキュメントは、スニペットケースの命名規則を使用します。このガイドの例では、ConventionPack を使用してコレクション内のフィールドをパスカルケースに逆シリアル化し、Restaurantクラスのプロパティにマップします。

カスタム直列化について詳しくは、「カスタム直列化」を参照してください。

このコレクションは、Atlas が提供するサンプルデータセットから構成されています。 MongoDB クラスターを無料で作成して、このサンプルデータをロードする方法については、クイックスタートを参照してください。

メソッドとパラメーター

UpdateOne() メソッドと UpdateOneAsync() メソッドは次のパラメータを受け入れます。

Parameter	説明
`filter`	データ型： FilterDefinition
`update`	データ型： UpdateDefinition<TDocument>
`options`	任意。 An インスタンス of the`UpdateOptions` クラス that specifies the configuration for the update 操作. The デフォルト value is.利用可能なオプションのリストについては、`null` 「構成オプション」を参照してください。データ型： UpdateOptions
`cancellationToken`	任意。操作をキャンセルするために使用できるトークン。データ型：`CancellationToken`

複数の値の更新

The UpdateOne() and UpdateOneAsync() methods each accept only one UpdateDefinition オブジェクト.次のセクションでは、1 回のメソッド呼び出しで複数の値をアップデートする方法について説明します。

更新の定義を組み合わせた

Builders.Update.Combine() メソッドを使用すると、複数の UpdateDefinition オブジェクトを組み合わせることができます。このメソッドは次のパラメーターを受け入れます:

Parameter	説明
`updates`	組み合わせる更新定義の配列。データ型： `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);

更新パイプライン

To create an update パイプライン, call the Builders.Update.Pipeline() method.このメソッドは次のパラメーターを受け入れます:

Parameter	説明
`pipeline`	データ型： `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);

注意

サポートされていない操作

設定オプション

プロパティ	説明
`ArrayFilters`	データ型: IEnumerable[ArrayFilterDefinition]>
`BypassDocumentValidation`	データ型： `bool?`
`Collation`	データ型：照合
`Comment`	データ型： BsonValue
`Hint`	データ型： BsonValue
`IsUpsert`	データ型： `bool`
`Let`	データ型： BsonDocument

戻り値

プロパティ	説明
`IsAcknowledged`	アップデート操作が MongoDB によって確認されたかどうかを示します。データ型： `bool`
`IsModifiedCountAvailable`	`UpdateResult` で更新レコードの数を読み取れるかどうかを示します。データ型： `bool`
`MatchedCount`	データ型： `long`
`ModifiedCount`	データ型： `long`
`UpsertedId`	ドライバーがアップサートを実行した場合、データベースでアップサートされたドキュメントのID。データ型： BsonValue

詳細情報

更新操作の実行可能な例については、「ドキュメントの更新」ページを参照してください。

クエリフィルターの作成の詳細については、「クエリの指定」ガイドを参照してください。

API ドキュメント

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

戻る

Insert

フィールド