DbSet<TEntity>.AddAsync(TEntity, CancellationToken) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mulai melacak entitas yang diberikan, dan entitas lain yang dapat dijangkau yang belum dilacak, dalam Added status sedih sehingga entitas tersebut akan dimasukkan ke dalam database saat SaveChanges() dipanggil.
public virtual System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync (TEntity entity, System.Threading.CancellationToken cancellationToken = default);
public virtual System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync (TEntity entity, System.Threading.CancellationToken cancellationToken = default);
abstract member AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>
abstract member AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>
Public Overridable Function AddAsync (entity As TEntity, Optional cancellationToken As CancellationToken = Nothing) As Task(Of EntityEntry(Of TEntity))
Public Overridable Function AddAsync (entity As TEntity, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EntityEntry(Of TEntity))
Parameter
- entity
- TEntity
Entitas yang akan ditambahkan.
- cancellationToken
- CancellationToken
A CancellationToken untuk mengamati sambil menunggu tugas selesai.
Mengembalikan
Tugas yang mewakili operasi Tambahkan asinkron. Hasil tugas berisi EntityEntry<TEntity> untuk entitas. Entri ini menyediakan akses ke informasi dan operasi pelacakan perubahan untuk entitas.
Pengecualian
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.
Gunakan State untuk mengatur status hanya satu entitas.
Lihat Pelacakan perubahan EF Core untuk informasi dan contoh selengkapnya.
Berlaku untuk
Entity Framework