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

Definição

Namespace:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacote:

Microsoft.EntityFrameworkCore v8.0.0

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.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync (TEntity entity, System.Threading.CancellationToken cancellationToken = default);

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

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

OperationCanceledException

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.