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>
パラメーター
- entities
型 : System.Collections.Generic.IEnumerable<TEntity>
追加されるエンティティのコレクション。
戻り値
型 : System.Collections.Generic.IEnumerable<TEntity>
エンティティのコレクション。
解説
AutoDetectChangesEnabled を true (これが既定です) に設定すると、何らかのエンティティを追加する前に DetectChanges が 1 回だけ呼び出され、再び呼び出されることはないことに注意してください。 これは、状況によっては、AddRange の方が Add を複数回呼び出すよりもかなり良いパフォーマンスになる可能性があること意味しています。 その他の状態でコンテキスト内に既に存在するエンティティは、状態が Added に設定されることに注意してください。 AddRange は、Added 状態のコンテキストにすでに存在するエンティティには何も行いません。