UpdateMany

인터랙티브 튜토리얼 열기

개요

이 가이드 에서는 MongoDB .NET/ C# 드라이버 사용하여 여러 문서의 값을 업데이트 방법을 학습 수 있습니다.

.NET/ C# 드라이버 다음 메서드를 제공하여 값을 업데이트 .

• UpdateMany(): 여러 문서에서 하나 이상의 필드를 업데이트합니다.

• UpdateManyAsync(): UpdateMany()의 비동기 버전입니다.

다음 섹션에서는 이러한 메서드에 대해 자세히 설명합니다.

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

메서드 및 매개변수

UpdateMany() 및 UpdateManyAsync() 메서드는 다음 매개변수를 허용합니다.

여러 값 업데이트

UpdateMany() 및 UpdateManyAsync() 메서드는 각각 하나의 UpdateDefinition 객체 만 허용합니다. 다음 섹션에서는 단일 메서드 호출로 여러 값을 업데이트 방법을 설명합니다.

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

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

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

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

구성 옵션

UpdateMany() 및 UpdateManyAsync() 메서드는 선택적으로 UpdateOptions 객체 매개 변수로 허용합니다. 이 인수를 사용하여 업데이트 작업을 구성할 수 있습니다.

UpdateOptions 클래스에는 다음과 같은 속성이 포함되어 있습니다.

반환 값

UpdateMany() 메서드는 UpdateResult을 반환하고, UpdateManyAsync() 메서드는 Task<UpdateResult> 객체 반환합니다. UpdateResult 클래스에는 다음과 같은 속성이 포함되어 있습니다.

추가 정보

이 페이지에는 UpdateManyAsync() 메서드를 사용하여 데이터를 수정하는 방법을 보여주는 짧은 인터랙티브 실습이 포함되어 있습니다. MongoDB 또는 코드 편집기를 설치하지 않고도 브라우저 창에서 직접 이 실습을 완료할 수 있습니다.

실습을 시작하려면 페이지 상단에 있는 Open Interactive Tutorial 버튼을 클릭하세요. 실습을 전체 화면 형식으로 확장하려면 랩 창의 오른쪽 상단 모서리에 있는 전체 화면 버튼(⛶)을 클릭합니다.

업데이트 작업의 실행 가능한 예제는 많은 문서 업데이트 페이지를 참조하세요.

쿼리 필터 생성에 대해 자세히 알아보려면 쿼리 지정 가이드를 참조하세요.