DbContext.AddAsync Método

Definição

Sobrecargas

AddAsync(Object, CancellationToken)

Começa a controlar a entidade especificada e quaisquer outras entidades acessíveis que ainda não estão sendo rastreadas, no Added estado, de modo que elas sejam inseridas no banco de dados quando SaveChanges() for chamado.

Use State para definir o estado de apenas uma única entidade.

Esse método é assíncrono somente para permitir geradores de valor especiais, como aquele usado por ' Microsoft. EntityFrameworkCore. Metadata. SqlServerValueGenerationStrategy. SequenceHiLo ', para acessar o banco de dados de forma assíncrona. Para todos os outros casos, o método não assíncrono deve ser usado.

AddAsync<TEntity>(TEntity, CancellationToken)

Começa a controlar a entidade especificada e quaisquer outras entidades acessíveis que ainda não estão sendo rastreadas, no Added estado, de modo que elas sejam inseridas no banco de dados quando SaveChanges() for chamado.

Esse método é assíncrono somente para permitir geradores de valor especiais, como aquele usado por ' Microsoft. EntityFrameworkCore. Metadata. SqlServerValueGenerationStrategy. SequenceHiLo ', para acessar o banco de dados de forma assíncrona. Para todos os outros casos, o método não assíncrono deve ser usado.

AddAsync(Object, CancellationToken)

Começa a controlar a entidade especificada e quaisquer outras entidades acessíveis que ainda não estão sendo rastreadas, no Added estado, de modo que elas sejam inseridas no banco de dados quando SaveChanges() for chamado.

Use State para definir o estado de apenas uma única entidade.

Esse método é assíncrono somente para permitir geradores de valor especiais, como aquele usado por ' Microsoft. EntityFrameworkCore. Metadata. SqlServerValueGenerationStrategy. SequenceHiLo ', para acessar o banco de dados de forma assíncrona. Para todos os outros casos, o método não assíncrono deve ser usado.

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

A entidade a ser adicionada.

cancellationToken
CancellationToken

Um CancellationToken a ser observado enquanto aguarda a conclusão da tarefa.

Retornos

Task<EntityEntry>
ValueTask<EntityEntry>

Uma tarefa que representa a operação de adição assíncrona. O resultado da tarefa contém o EntityEntry para a entidade. A entrada fornece acesso às informações e às operações de controle de alterações para a entidade.

Aplica-se a

AddAsync<TEntity>(TEntity, CancellationToken)

Começa a controlar a entidade especificada e quaisquer outras entidades acessíveis que ainda não estão sendo rastreadas, no Added estado, de modo que elas sejam inseridas no banco de dados quando SaveChanges() for chamado.

Esse método é assíncrono somente para permitir geradores de valor especiais, como aquele usado por ' Microsoft. EntityFrameworkCore. Metadata. SqlServerValueGenerationStrategy. SequenceHiLo ', para acessar o banco de dados de forma assíncrona. Para todos os outros casos, o método não assíncrono deve ser usado.

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

O tipo da entidade.

Parâmetros

entity
TEntity

A entidade a ser adicionada.

cancellationToken
CancellationToken

Um CancellationToken a ser observado enquanto aguarda a conclusão da tarefa.

Retornos

Task<EntityEntry<TEntity>>
ValueTask<EntityEntry<TEntity>>

Uma tarefa que representa a operação de adição assíncrona. O resultado da tarefa contém o EntityEntry<TEntity> para a entidade. A entrada fornece acesso às informações e às operações de controle de alterações para a entidade.

Aplica-se a