CSHARP-5994: Remove ReplaceOptions and UpdateOptions in favor of ReplaceOptions<T> and UpdateOptions<T>

[sanych-sun]

No description provided.

[Copilot]

Pull request overview

This PR updates the driver’s update/replace option types and related CRUD APIs to remove the non-generic ReplaceOptions / UpdateOptions in favor of generic ReplaceOptions<T> / UpdateOptions<T>, and adjusts tests accordingly.

Changes:

• Refactors UpdateOptions and ReplaceOptions into sealed generic types (UpdateOptions<T>, ReplaceOptions<T>) and updates conversion helpers.
• Updates IMongoCollection<TDocument>, MongoCollectionBase, and IMongoCollectionExtensions method signatures to use the new generic options.
• Updates driver test suite call sites to compile against the new options types.

Reviewed changes

Copilot reviewed 16 out of 16 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
tests/MongoDB.Driver.Tests/UnifiedTestOperations/UnifiedUpdateOneOperation.cs	Updates unified test operation to use UpdateOptions<BsonDocument>.
tests/MongoDB.Driver.Tests/UnifiedTestOperations/UnifiedUpdateManyOperation.cs	Updates unified test operation parsing/building to use UpdateOptions<BsonDocument>.
tests/MongoDB.Driver.Tests/OfTypeMongoCollectionTests.cs	Updates UpdateOptions construction to UpdateOptions<T>.
tests/MongoDB.Driver.Tests/MongoCollectionImplTests.cs	Updates replace/update options test coverage to ReplaceOptions<T> / UpdateOptions<T>.
tests/MongoDB.Driver.Tests/Linq/Integration/ReplaceOneUpsertedIdTests.cs	Updates replace options usage to ReplaceOptions<T>.
tests/MongoDB.Driver.Tests/Linq/Integration/PipelineUpdateWithToListTests.cs	Updates update-many options usage to UpdateOptions<T>.
tests/MongoDB.Driver.Tests/Linq/Integration/PipelineUpdateConditionalNestedObjectTests.cs	Updates update-many options usage to UpdateOptions<T>.
tests/MongoDB.Driver.Tests/JsonDrivenTests/JsonDrivenUpdateOneTest.cs	Updates stored options field to UpdateOptions<BsonDocument>.
tests/MongoDB.Driver.Tests/JsonDrivenTests/JsonDrivenUpdateManyTest.cs	Updates stored options field to UpdateOptions<BsonDocument>.
tests/MongoDB.Driver.Tests/JsonDrivenTests/JsonDrivenReplaceOneTest.cs	Updates stored options field to ReplaceOptions<BsonDocument>.
tests/MongoDB.Driver.Tests/IMongoCollectionExtensionsTests.cs	Updates mocks/verifications and options types to generic forms.
src/MongoDB.Driver/UpdateOptions.cs	Replaces the old non-generic + derived generic pattern with a single sealed UpdateOptions<T>.
src/MongoDB.Driver/ReplaceOptions.cs	Replaces the old non-generic + derived generic pattern with a single sealed ReplaceOptions<T> and updates From(...).
src/MongoDB.Driver/MongoCollectionBase.cs	Updates CRUD implementation signatures to accept the new generic options.
src/MongoDB.Driver/IMongoCollectionExtensions.cs	Updates extension method signatures to accept the new generic options.
src/MongoDB.Driver/IMongoCollection.cs	Updates public interface signatures to accept the new generic options.

Comments suppressed due to low confidence (3)

src/MongoDB.Driver/ReplaceOptions.cs:51

• ReplaceOptions<T>.From(UpdateOptions<T>) drops Comment (and Sort) when converting options. This changes behavior for the obsolete ReplaceOne overload that accepts UpdateOptions<T> and should preserve equivalent settings.

                return new ReplaceOptions<T>
                {
                    BypassDocumentValidation = updateOptions.BypassDocumentValidation,
                    Collation = updateOptions.Collation,
                    Hint = updateOptions.Hint,

src/MongoDB.Driver/MongoCollectionBase.cs:699

• UpdateMany now accepts UpdateOptions<TDocument>, which includes Sort, but this method ignores options.Sort. Consider throwing when Sort is set to avoid silently ignoring user input.

            options ??= new UpdateOptions<TDocument>();
            var model = new UpdateManyModel<TDocument>(filter, update)
            {
                ArrayFilters = options.ArrayFilters,
                Collation = options.Collation,

src/MongoDB.Driver/MongoCollectionBase.cs:741

• UpdateManyAsync now accepts UpdateOptions<TDocument>, which includes Sort, but this method ignores options.Sort. Consider throwing when Sort is set to avoid silently ignoring user input.

            options ??= new UpdateOptions<TDocument>();
            var model = new UpdateManyModel<TDocument>(filter, update)
            {
                ArrayFilters = options.ArrayFilters,
                Collation = options.Collation,

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.