DbContext.AddAsync Método

Definición

Espacio de nombres:

Microsoft.EntityFrameworkCore

Ensamblado:

Microsoft.EntityFrameworkCore.dll

Paquete:

Microsoft.EntityFrameworkCore v9.0.0

Sobrecargas

AddAsync(Object, CancellationToken)	Comienza a realizar el seguimiento de la entidad dada y a cualquier otra entidad accesible que aún no se esté realizando el seguimiento, en el Added estado para que se inserten en la base de datos cuando SaveChanges() se llame a .
AddAsync<TEntity>(TEntity, CancellationToken)	Comienza a realizar el seguimiento de la entidad dada y a cualquier otra entidad accesible que aún no se esté realizando el seguimiento, en el Added estado para que se inserten en la base de datos cuando SaveChanges() se llame a .

AddAsync(Object, CancellationToken)

Source:

DbContext.cs

Comienza a realizar el seguimiento de la entidad dada y a cualquier otra entidad accesible que aún no se esté realizando el seguimiento, en el Added estado para que se inserten en la base de datos cuando SaveChanges() se llame a .

public virtual System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> AddAsync (object entity, System.Threading.CancellationToken cancellationToken = default);

abstract member AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>
override this.AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>

Public Overridable Function AddAsync (entity As Object, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EntityEntry)

Parámetros

entity

Object

Entidad que se va a agregar.

cancellationToken

CancellationToken

Que CancellationToken se debe observar mientras se espera a que se complete la tarea.

Devoluciones

ValueTask<EntityEntry>

Tarea que representa la operación Agregar asincrónica. El resultado de la tarea contiene para EntityEntry la entidad. La entrada proporciona acceso a la información y las operaciones de seguimiento de cambios para la entidad.

Excepciones

OperationCanceledException

Si se cancela CancellationToken.

Comentarios

Use State para establecer el estado de solo una entidad.

Este método solo es asincrónico para permitir que los generadores de valores especiales, como el usado por 'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo', accedan a la base de datos de forma asincrónica. Para todos los demás casos, se debe usar el método no asincrónico.

Entity Framework Core no admite varias operaciones paralelas que se ejecutan en la misma instancia de DbContext. Esto incluye la ejecución en paralelo de consultas asincrónicas y cualquier uso simultáneo explícito desde varios subprocesos. Por lo tanto, espere siempre llamadas asincrónicas inmediatamente o use instancias de DbContext independientes para las operaciones que se ejecutan en paralelo. Consulte Evitar problemas de subprocesos de DbContext para obtener más información y ejemplos.

Consulte Seguimiento de cambios de EF Core para obtener más información y ejemplos.

AddAsync<TEntity>(TEntity, CancellationToken)

Source:

DbContext.cs

Comienza a realizar el seguimiento de la entidad dada y a cualquier otra entidad accesible que aún no se esté realizando el seguimiento, en el Added estado para que se inserten en la base de datos cuando SaveChanges() se llame a .

public virtual System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync<TEntity> (TEntity entity, System.Threading.CancellationToken cancellationToken = default) where TEntity : class;

abstract member AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)

Public Overridable Function AddAsync(Of TEntity As Class) (entity As TEntity, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EntityEntry(Of TEntity))

Parámetros de tipo

TEntity

El tipo de la entidad.

Parámetros

entity

TEntity

Entidad que se va a agregar.

cancellationToken

CancellationToken

Que CancellationToken se debe observar mientras se 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 para la entidad.

Excepciones

OperationCanceledException

Si se cancela CancellationToken.

Comentarios

Este método solo es asincrónico para permitir que los generadores de valores especiales, como el usado por 'Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo', accedan a la base de datos de forma asincrónica. Para todos los demás casos, se debe usar el método no asincrónico.

Entity Framework Core no admite varias operaciones paralelas que se ejecutan en la misma instancia de DbContext. Esto incluye la ejecución en paralelo de consultas asincrónicas y cualquier uso simultáneo explícito desde varios subprocesos. Por lo tanto, espere siempre llamadas asincrónicas inmediatamente o use instancias de DbContext independientes para las operaciones que se ejecutan en paralelo. Consulte Evitar problemas de subprocesos de DbContext para obtener más información y ejemplos.

Consulte Seguimiento de cambios de EF Core para obtener más información y ejemplos.