DbSet<TEntity>.AddAsync(TEntity, CancellationToken) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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
Entity Framework