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
| Nombre | Description |
|---|---|
| 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 de modo que se insertarán 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 de modo que se insertarán en la base de datos cuando SaveChanges() se llame a . |
AddAsync(Object, CancellationToken)
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- 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 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> 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 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 de la entidad.
Excepciones
CancellationToken Si se cancela .
Comentarios
Use State para establecer el estado de solo una sola entidad.
Este método solo es asincrónico para permitir generadores de valores especiales, como el usado por "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.
Entity Framework Core no admite la ejecución de varias operaciones paralelas 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 independientes de DbContext 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)
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- Source:
- DbContext.cs
- 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 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>(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
Tipo de la entidad.
Parámetros
- entity
- TEntity
Entidad que se va a agregar.
- cancellationToken
- CancellationToken
Que CancellationToken se debe 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
CancellationToken Si se cancela .
Comentarios
Este método solo es asincrónico para permitir generadores de valores especiales, como el usado por "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.
Entity Framework Core no admite la ejecución de varias operaciones paralelas 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 independientes de DbContext 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.