Partilhar via


DbSet<TEntity>.AddAsync(TEntity, CancellationToken) Método

Definição

Começa a acompanhar a entidade especificada e quaisquer outras entidades acessíveis que ainda não estão sendo rastreadas, no Added estado em que serão inseridas no banco de dados quando SaveChanges() for chamado.

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

Parâmetros

entity
TEntity

A entidade a ser adicionada.

cancellationToken
CancellationToken

Um CancellationToken a ser observado enquanto aguarda a conclusão da tarefa.

Retornos

Task<EntityEntry<TEntity>>

Uma tarefa que representa a operação assíncrona Adicionar. O resultado da tarefa contém o EntityEntry<TEntity> para a entidade. A entrada fornece acesso a informações e operações de controle de alterações para a entidade.

Exceções

Se o padrão CancellationToken for cancelado.

Comentários

Esse método é assíncrono apenas para permitir geradores de valor especial, como o usado por 'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo', para acessar o banco de dados de forma assíncrona. Para todos os outros casos, o método não assíncrono deve ser usado.

Use State para definir o estado de apenas uma única entidade.

Consulte Controle de alterações do EF Core para obter mais informações e exemplos.

Aplica-se a