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

Definición

Espacio de nombres:

Microsoft.EntityFrameworkCore

Ensamblado:

Microsoft.EntityFrameworkCore.dll

Paquete:

Microsoft.EntityFrameworkCore v8.0.0

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

Entidad que se va a agregar.

cancellationToken

CancellationToken

que CancellationToken se va a observar mientras espera a que se complete la tarea.

Devoluciones

ValueTask<EntityEntry<TEntity>>

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

OperationCanceledException

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.