DbContext.AddAsync Metode

Definisi

Ruang nama:

Microsoft.EntityFrameworkCore

Rakitan:

Microsoft.EntityFrameworkCore.dll

Paket:

Microsoft.EntityFrameworkCore v8.0.0

Overload

AddAsync(Object, CancellationToken)	Mulai melacak entitas yang diberikan, dan entitas lain yang dapat dijangkau yang belum dilacak, dalam Added status sedingin itu mereka akan dimasukkan ke dalam database saat SaveChanges() dipanggil.
AddAsync<TEntity>(TEntity, CancellationToken)	Mulai melacak entitas yang diberikan, dan entitas lain yang dapat dijangkau yang belum dilacak, dalam Added status sedingin itu mereka akan dimasukkan ke dalam database saat SaveChanges() dipanggil.

AddAsync(Object, CancellationToken)

Mulai melacak entitas yang diberikan, dan entitas lain yang dapat dijangkau yang belum dilacak, dalam Added status sedingin itu mereka akan dimasukkan ke dalam database saat SaveChanges() dipanggil.

public virtual System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> AddAsync (object entity, System.Threading.CancellationToken cancellationToken = default);

abstract member AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>
override this.AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>

Public Overridable Function AddAsync (entity As Object, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EntityEntry)

Parameter

entity

Object

Entitas yang akan ditambahkan.

cancellationToken

CancellationToken

A CancellationToken untuk mengamati sambil menunggu tugas selesai.

Mengembalikan

ValueTask<EntityEntry>

Tugas yang mewakili operasi Tambahkan asinkron. Hasil tugas berisi EntityEntry untuk entitas. Entri ini menyediakan akses untuk mengubah informasi dan operasi pelacakan untuk entitas.

Pengecualian

OperationCanceledException

CancellationToken Jika dibatalkan.

Keterangan

Gunakan State untuk mengatur status hanya dari satu entitas.

Metode ini hanya asinkron untuk memungkinkan generator nilai khusus, seperti yang digunakan oleh 'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo', untuk mengakses database secara asinkron. Untuk semua kasus lain, metode non asinkron harus digunakan.

Entity Framework Core tidak mendukung beberapa operasi paralel yang dijalankan pada instans DbContext yang sama. Ini termasuk eksekusi paralel kueri asinkron dan penggunaan bersamaan eksplisit dari beberapa utas. Oleh karena itu, selalu tunggu panggilan asinkron segera, atau gunakan instans DbContext terpisah untuk operasi yang dijalankan secara paralel. Lihat Menghindari masalah utas DbContext untuk informasi dan contoh selengkapnya.

Lihat Pelacakan perubahan EF Core untuk informasi dan contoh selengkapnya.

AddAsync<TEntity>(TEntity, CancellationToken)

Mulai melacak entitas yang diberikan, dan entitas lain yang dapat dijangkau yang belum dilacak, dalam Added status sedingin itu mereka akan dimasukkan ke dalam database saat SaveChanges() dipanggil.

public virtual System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync<TEntity> (TEntity entity, System.Threading.CancellationToken cancellationToken = default) where TEntity : class;

abstract member AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)

Public Overridable Function AddAsync(Of TEntity As Class) (entity As TEntity, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EntityEntry(Of TEntity))

Jenis parameter

TEntity

Jenis entitas.

Parameter

entity

TEntity

Entitas yang akan ditambahkan.

cancellationToken

CancellationToken

A CancellationToken untuk mengamati sambil menunggu tugas selesai.

Mengembalikan

ValueTask<EntityEntry<TEntity>>

Tugas yang mewakili operasi Tambahkan asinkron. Hasil tugas berisi EntityEntry<TEntity> untuk entitas. Entri ini menyediakan akses untuk mengubah informasi dan operasi pelacakan untuk entitas.

Pengecualian

OperationCanceledException

CancellationToken Jika dibatalkan.

Keterangan

Metode ini hanya asinkron untuk memungkinkan generator nilai khusus, seperti yang digunakan oleh 'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo', untuk mengakses database secara asinkron. Untuk semua kasus lain, metode non asinkron harus digunakan.

Entity Framework Core tidak mendukung beberapa operasi paralel yang dijalankan pada instans DbContext yang sama. Ini termasuk eksekusi paralel kueri asinkron dan penggunaan bersamaan eksplisit dari beberapa utas. Oleh karena itu, selalu tunggu panggilan asinkron segera, atau gunakan instans DbContext terpisah untuk operasi yang dijalankan secara paralel. Lihat Menghindari masalah utas DbContext untuk informasi dan contoh selengkapnya.

Lihat Pelacakan perubahan EF Core untuk informasi dan contoh selengkapnya.