언어

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 작업이 완료 될 때까지 기다리는 동안 관찰할 A입니다.

반품

Task<EntityEntry<TEntity>>

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

예외

설명

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

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

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

적용 대상