DbSet<TEntity>.AddRange - метод
[Эта страница относится к документации к Entity Framework 6. Последняя версия доступна в составе пакета Entity Framework NuGet. Дополнительные сведения об Entity Framework см. в разделе msdn.com/data/ef.]
Добавляет заданную коллекцию сущностей к контексту, поддерживающему набор, каждая сущность которого находится в состоянии "Добавлено", в результате чего она будет вставлена в базу данных при вызове метода 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>
Параметры
- entities
Тип: System.Collections.Generic.IEnumerable<TEntity>
Коллекция сущностей для добавления.
Возвращаемое значение
Тип: System.Collections.Generic.IEnumerable<TEntity>
Коллекция сущностей.
Примечания
Обратите внимание, что если для AutoDetectChangesEnabled задано значение true (которое является значением по умолчанию), DetectChanges будет вызываться один раз перед добавлением любых сущностей, и не будет вызываться повторно. Это означает, что в некоторых ситуациях AddRange может давать значительно более высокую производительность, чем множественный вызов метода Add. Обратите внимание, что сущности, которые уже содержатся в контексте в каком-либо другом состоянии, изменят свое состояние на добавленное. Если сущность уже содержится в контексте в состоянии "Добавлено", то метод AddRange является пустой операцией.