DbContext.AddAsync Yöntem

Tanım

Ad Alanı:

Microsoft.EntityFrameworkCore

Bütünleştirilmiş Kod:

Microsoft.EntityFrameworkCore.dll

Paket:

Microsoft.EntityFrameworkCore v8.0.0

Aşırı Yüklemeler

AddAsync(Object, CancellationToken)	Verilen varlığı ve henüz izlenmeyen diğer erişilebilir varlıkları, Added çağrıldığında SaveChanges() veritabanına eklenecek şekilde izlemeye başlar.
AddAsync<TEntity>(TEntity, CancellationToken)	Verilen varlığı ve henüz izlenmeyen diğer erişilebilir varlıkları, Added çağrıldığında SaveChanges() veritabanına eklenecek şekilde izlemeye başlar.

AddAsync(Object, CancellationToken)

Verilen varlığı ve henüz izlenmeyen diğer erişilebilir varlıkları, Added çağrıldığında SaveChanges() veritabanına eklenecek şekilde izlemeye başlar.

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)

Parametreler

entity

Object

Eklenecek varlık.

cancellationToken

CancellationToken

CancellationToken Görevin tamamlanmasını beklerken gözlemlemek için bir.

Döndürülenler

ValueTask<EntityEntry>

Zaman uyumsuz Add işlemini temsil eden görev. Görev sonucu, varlığın öğesini içerir EntityEntry . girdisi, varlık için değişiklik izleme bilgilerine ve işlemlerine erişim sağlar.

Özel durumlar

OperationCanceledException

CancellationToken İptal edilirse.

Açıklamalar

Yalnızca tek bir varlığın durumunu ayarlamak için kullanın State .

Bu yöntem yalnızca 'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo' tarafından kullanılan gibi özel değer oluşturucuların veritabanına zaman uyumsuz olarak erişmesine izin vermek için zaman uyumsuzdur. Diğer tüm durumlarda zaman uyumsuz yöntem kullanılmalıdır.

Entity Framework Core, aynı DbContext örneğinde çalıştırılan birden çok paralel işlemi desteklemez. Buna hem zaman uyumsuz sorguların paralel yürütülmesi hem de birden çok iş parçacığından açık eş zamanlı kullanım dahildir. Bu nedenle, her zaman zaman uyumsuz çağrıları hemen bekleyin veya paralel olarak yürütülen işlemler için ayrı DbContext örnekleri kullanın. Daha fazla bilgi ve örnek için bkz. DbContext iş parçacığı oluşturma sorunlarını önleme .

Daha fazla bilgi ve örnek için bkz. EF Core değişiklik izleme .

AddAsync<TEntity>(TEntity, CancellationToken)

Verilen varlığı ve henüz izlenmeyen diğer erişilebilir varlıkları, Added çağrıldığında SaveChanges() veritabanına eklenecek şekilde izlemeye başlar.

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))

Tür Parametreleri

TEntity

Varlığın türü.

Parametreler

entity

TEntity

Eklenecek varlık.

cancellationToken

CancellationToken

CancellationToken Görevin tamamlanmasını beklerken gözlemlemek için bir.

Döndürülenler

ValueTask<EntityEntry<TEntity>>

Zaman uyumsuz Add işlemini temsil eden görev. Görev sonucu, varlığın öğesini içerir EntityEntry<TEntity> . girdisi, varlık için değişiklik izleme bilgilerine ve işlemlerine erişim sağlar.

Özel durumlar

OperationCanceledException

CancellationToken İptal edilirse.

Açıklamalar

Bu yöntem yalnızca 'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo' tarafından kullanılan gibi özel değer oluşturucuların veritabanına zaman uyumsuz olarak erişmesine izin vermek için zaman uyumsuzdur. Diğer tüm durumlarda zaman uyumsuz yöntem kullanılmalıdır.

Entity Framework Core, aynı DbContext örneğinde çalıştırılan birden çok paralel işlemi desteklemez. Buna hem zaman uyumsuz sorguların paralel yürütülmesi hem de birden çok iş parçacığından açık eş zamanlı kullanım dahildir. Bu nedenle, her zaman zaman uyumsuz çağrıları hemen bekleyin veya paralel olarak yürütülen işlemler için ayrı DbContext örnekleri kullanın. Daha fazla bilgi ve örnek için bkz. DbContext iş parçacığı oluşturma sorunlarını önleme .

Daha fazla bilgi ve örnek için bkz. EF Core değişiklik izleme .