DbContext.AddAsync 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í.
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)
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.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> AddAsync (object entity, System.Threading.CancellationToken cancellationToken = default);
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.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>
override this.AddAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry>
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 Task(Of 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
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
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.
Se aplica 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 .
public virtual System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync<TEntity> (TEntity entity, System.Threading.CancellationToken cancellationToken = default) where TEntity : class;
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.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>> (requires 'Entity : null)
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 Task(Of EntityEntry(Of TEntity))
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
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
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.