Imported Upstream version 4.6.0.125

Former-commit-id: a2155e9bd80020e49e72e86c44da02a8ac0e57a4

mcs/class/referencesource/System.Data.Entity/System/Data/Objects/IObjectSet.cs

@@ -0,0 +1,57 @@
+//---------------------------------------------------------------------
+// <copyright file="IObjectSet.cs" company="Microsoft">
+//      Copyright (c) Microsoft Corporation.  All rights reserved.
+// </copyright>
+//
+// @owner       jeffders
+// @backupOwner avickers
+//---------------------------------------------------------------------
+
+using System.Collections;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace System.Data.Objects
+{
+    /// <summary>
+    /// Defines behavior for implementations of IQueryable that allow modifications to the membership of the resulting set.
+    /// </summary>
+    /// <typeparam name="TEntity">Type of entities returned from the queryable.</typeparam>
+    [System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")]
+    public interface IObjectSet<TEntity> : IQueryable<TEntity>
+        where TEntity : class
+    {
+        /// <summary>
+        /// Notify the set that an object representing a new entity should be added to the set.
+        /// Depending on the implementation, the change to the set may not be visible in an enumeration of the set 
+        /// until changes to that set have been persisted in some manner.
+        /// </summary>
+        /// <param name="entity">Entity object to be added.</param>
+        void AddObject(TEntity entity);
+
+        /// <summary>
+        /// Notify the set that an object representing a new entity should be added to the set.
+        /// Depending on the implementation, the change to the set may not be visible in an enumeration of the set 
+        /// until changes to that set have been persisted in some manner.
+        /// </summary>
+        /// <param name="entity">Entity object to be attached.</param>
+        void Attach(TEntity entity);
+
+        /// <summary>
+        /// Notify the set that an object representing an entity should be removed from the set.
+        /// Depending on the implementation, the change to the set may not be visible in an enumeration of the set 
+        /// until changes to that set have been persisted in some manner.
+        /// </summary>
+        /// <param name="entity">Entity object to be removed.</param>
+        /// <exception cref="InvalidOperationException">Throws if the specified object is not in the set.</exception>
+        void DeleteObject(TEntity entity);
+
+        /// <summary>
+        /// Notify the set that an object representing an entity should be removed from the set.
+        /// Depending on the implementation, the change to the set may not be visible in an enumeration of the set 
+        /// until changes to that set have been persisted in some manner.
+        /// </summary>
+        /// <param name="entity">Entity object to be detached.</param>        
+        void Detach(TEntity entity);
+    }
+}