다음을 통해 공유


DbSet<TEntity>.AddAsync(TEntity, CancellationToken) 메서드

정의

가 호출될 때 SaveChanges() 데이터베이스에 삽입되도록 지정된 엔터티 및 아직 추적되지 않은 기타 연결 가능한 엔터티를 추적 Added 하기 시작합니다.

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

매개 변수

entity
TEntity

추가할 엔터티입니다.

cancellationToken
CancellationToken

CancellationToken 작업이 완료 될 때까지 기다리는 동안 관찰할 입니다.

반환

Task<EntityEntry<TEntity>>

비동기 추가 작업을 나타내는 작업입니다. 작업 결과에는 엔터티에 대한 가 포함 EntityEntry<TEntity> 됩니다. 항목은 엔터티에 대한 변경 내용 추적 정보 및 작업에 대한 액세스를 제공합니다.

예외

설명

이 메서드는 'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo'에서 사용하는 것과 같은 특수 값 생성기가 데이터베이스에 비동기적으로 액세스할 수 있도록 하기 위한 비동기입니다. 다른 모든 경우에서는 비동기 메서드를 사용해야 합니다.

를 사용하여 State 단일 엔터티의 상태만 설정합니다.

자세한 내용 및 예제 는 EF Core 변경 내용 추적 을 참조하세요.

적용 대상