DbSet<TEntity>.AddRange 方法

[此頁面專屬於 Entity Framework 第 6 版。最新版本可從 'Entity Framework' NuGet 套件取得。如需 Entity Framework 的詳細資訊,請參閱 msdn.com/data/ef。]

將給定的實體集合加入至要置於 Added 狀態之每個實體的集合基礎內容中,好讓呼叫 SaveChanges 時可將它插入資料庫中。

命名空間:  System.Data.Entity
組件:  EntityFramework (在 EntityFramework.dll 中)

語法

'宣告
Public Overridable Function AddRange ( _
    entities As IEnumerable(Of TEntity) _
) As IEnumerable(Of TEntity)
'用途
Dim instance As DbSet 
Dim entities As IEnumerable(Of TEntity)
Dim returnValue As IEnumerable(Of TEntity)

returnValue = instance.AddRange(entities)
public virtual IEnumerable<TEntity> AddRange(
    IEnumerable<TEntity> entities
)
public:
virtual IEnumerable<TEntity>^ AddRange(
    IEnumerable<TEntity>^ entities
)
abstract AddRange : 
        entities:IEnumerable<'TEntity> -> IEnumerable<'TEntity> 
override AddRange : 
        entities:IEnumerable<'TEntity> -> IEnumerable<'TEntity> 
public function AddRange(
    entities : IEnumerable<TEntity>
) : IEnumerable<TEntity>

參數

傳回值

類型:System.Collections.Generic.IEnumerable<TEntity>
實體的集合。

備註

請注意,如果 AutoDetectChangesEnabled 設為 true (這是預設值),則在加入任何實體之前,將會呼叫一次 DetectChanges,並且不會再次呼叫。 這表示,在某此情況下,相較於呼叫 Add 多次,AddRange 可能會顯得有更好的效果。 請注意,若實體已經在某個其他狀態的內容中,會將其狀態設定為 Added。 若實體已經在 Added 狀態的內容中,AddRange 就不會執行任何作業。

請參閱

參考

DbSet<TEntity> 類別

System.Data.Entity 命名空間