DbSet<TEntity>.AddAsync(TEntity, CancellationToken) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Comienza a realizar el seguimiento de la entidad especificada y a cualquier otra entidad accesible que aún no se esté realizando el seguimiento, en el Added estado de modo que se insertarán en la base de datos cuando SaveChanges() se llame a .
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
Entidad que se va a agregar.
- cancellationToken
- CancellationToken
que CancellationToken se va a observar mientras espera a que se complete la tarea.
Devoluciones
Tarea que representa la operación Agregar asincrónica. El resultado de la tarea contiene para EntityEntry<TEntity> la entidad. La entrada proporciona acceso a la información y las operaciones de seguimiento de cambios de la entidad.
Excepciones
Si se cancela CancellationToken.
Comentarios
Este método solo es asincrónico para permitir generadores de valores especiales, como el que usa 'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo', para acceder a la base de datos de forma asincrónica. Para todos los demás casos, se debe usar el método no asincrónico.
Use State para establecer el estado de una sola entidad.
Consulte Seguimiento de cambios de EF Core para obtener más información y ejemplos.
