DbContext.AddAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| AddAsync(Object, CancellationToken) |
가 호출될 때 SaveChanges() 데이터베이스에 삽입되도록 지정된 엔터티 및 아직 추적 Added 되지 않은 다른 연결 가능한 엔터티 추적을 시작합니다. |
| AddAsync<TEntity>(TEntity, CancellationToken) |
가 호출될 때 SaveChanges() 데이터베이스에 삽입되도록 지정된 엔터티 및 아직 추적 Added 되지 않은 다른 연결 가능한 엔터티 추적을 시작합니다. |
AddAsync(Object, CancellationToken)
가 호출될 때 SaveChanges() 데이터베이스에 삽입되도록 지정된 엔터티 및 아직 추적 Added 되지 않은 다른 연결 가능한 엔터티 추적을 시작합니다.
public virtual System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> AddAsync (object entity, System.Threading.CancellationToken cancellationToken = default);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.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>
override this.AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>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 Task(Of EntityEntry)Public Overridable Function AddAsync (entity As Object, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EntityEntry)매개 변수
- entity
- Object
추가할 엔터티입니다.
- cancellationToken
- CancellationToken
CancellationToken 작업이 완료 될 때까지 기다리는 동안 관찰할 입니다.
반환
비동기 추가 작업을 나타내는 작업입니다. 작업 결과에는 EntityEntry 엔터티에 대한 가 포함됩니다. 항목은 엔터티에 대한 변경 내용 추적 정보 및 작업에 대한 액세스를 제공합니다.
예외
설명
를 사용하여 State 단일 엔터티의 상태만 설정합니다.
이 메서드는 'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo'에서 사용하는 것과 같은 특수 값 생성기가 데이터베이스에 비동기적으로 액세스할 수 있도록 비동기식으로만 허용합니다. 다른 모든 경우에는 비동기 메서드를 사용해야 합니다.
Entity Framework Core는 동일한 DbContext instance 실행되는 여러 병렬 작업을 지원하지 않습니다. 여기에는 비동기 쿼리의 병렬 실행과 여러 스레드에서의 명시적 동시 사용이 모두 포함됩니다. 따라서 항상 즉시 비동기 호출을 기다리거나 병렬로 실행되는 작업에 별도의 DbContext 인스턴스를 사용합니다. 자세한 내용 및 예제 는 DbContext 스레딩 문제 방지 를 참조하세요.
자세한 내용 및 예제 는 EF Core 변경 내용 추적 을 참조하세요.
적용 대상
AddAsync<TEntity>(TEntity, CancellationToken)
가 호출될 때 SaveChanges() 데이터베이스에 삽입되도록 지정된 엔터티 및 아직 추적 Added 되지 않은 다른 연결 가능한 엔터티 추적을 시작합니다.
public virtual System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync<TEntity> (TEntity entity, System.Threading.CancellationToken cancellationToken = default) where TEntity : class;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.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)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 Task(Of EntityEntry(Of TEntity))Public Overridable Function AddAsync(Of TEntity As Class) (entity As TEntity, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EntityEntry(Of TEntity))형식 매개 변수
- TEntity
엔터티의 형식입니다.
매개 변수
- entity
- TEntity
추가할 엔터티입니다.
- cancellationToken
- CancellationToken
CancellationToken 작업이 완료 될 때까지 기다리는 동안 관찰할 입니다.
반환
비동기 추가 작업을 나타내는 작업입니다. 작업 결과에는 EntityEntry<TEntity> 엔터티에 대한 가 포함됩니다. 항목은 엔터티에 대한 변경 내용 추적 정보 및 작업에 대한 액세스를 제공합니다.
예외
설명
이 메서드는 'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo'에서 사용하는 것과 같은 특수 값 생성기가 데이터베이스에 비동기적으로 액세스할 수 있도록 비동기식으로만 허용합니다. 다른 모든 경우에는 비동기 메서드를 사용해야 합니다.
Entity Framework Core는 동일한 DbContext instance 실행되는 여러 병렬 작업을 지원하지 않습니다. 여기에는 비동기 쿼리의 병렬 실행과 여러 스레드에서의 명시적 동시 사용이 모두 포함됩니다. 따라서 항상 즉시 비동기 호출을 기다리거나 병렬로 실행되는 작업에 별도의 DbContext 인스턴스를 사용합니다. 자세한 내용 및 예제 는 DbContext 스레딩 문제 방지 를 참조하세요.
자세한 내용 및 예제 는 EF Core 변경 내용 추적 을 참조하세요.
적용 대상
Entity Framework