DbContext.AddRangeAsync Método

Definição

Namespace:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacote:

Microsoft.EntityFrameworkCore v9.0.0

Sobrecargas

AddRangeAsync(Object[])	Começa a acompanhar a entidade especificada e quaisquer outras entidades acessíveis que ainda não estão sendo rastreadas, no Added estado em que serão inseridas no banco de dados quando SaveChanges() for chamado.
AddRangeAsync(IEnumerable<Object>, CancellationToken)	Começa a acompanhar a entidade especificada e quaisquer outras entidades acessíveis que ainda não estão sendo rastreadas, no Added estado em que serão inseridas no banco de dados quando SaveChanges() for chamado.

AddRangeAsync(Object[])

Origem:

DbContext.cs

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

public virtual System.Threading.Tasks.Task AddRangeAsync (params object[] entities);

abstract member AddRangeAsync : obj[] -> System.Threading.Tasks.Task
override this.AddRangeAsync : obj[] -> System.Threading.Tasks.Task

Public Overridable Function AddRangeAsync (ParamArray entities As Object()) As Task

Parâmetros

entities

Object[]

As entidades a serem adicionadas.

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Comentários

Esse método é assíncrono apenas para permitir geradores de valor especial, como o 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.

O Entity Framework Core não dá suporte a várias operações paralelas que estão sendo executadas na mesma instância DbContext. Isso inclui a execução paralela de consultas assíncronas e qualquer uso simultâneo explícito de vários threads. Portanto, sempre aguarde chamadas assíncronas imediatamente ou use instâncias DbContext separadas para operações executadas em paralelo. Consulte Evitando problemas de threading de DbContext para obter mais informações e exemplos.

Consulte Controle de alterações do EF Core e Usando AddRange, UpdateRange, AttachRange e RemoveRange para obter mais informações e exemplos.

AddRangeAsync(IEnumerable<Object>, CancellationToken)

Origem:

DbContext.cs

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

public virtual System.Threading.Tasks.Task AddRangeAsync (System.Collections.Generic.IEnumerable<object> entities, System.Threading.CancellationToken cancellationToken = default);

abstract member AddRangeAsync : seq<obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.AddRangeAsync : seq<obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function AddRangeAsync (entities As IEnumerable(Of Object), Optional cancellationToken As CancellationToken = Nothing) As Task

Parâmetros

entities

IEnumerable<Object>

As entidades a serem adicionadas.

cancellationToken

CancellationToken

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

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Exceções

OperationCanceledException

Se o padrão CancellationToken for cancelado.

Comentários

Esse método é assíncrono apenas para permitir geradores de valor especial, como o 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.

O Entity Framework Core não dá suporte a várias operações paralelas que estão sendo executadas na mesma instância DbContext. Isso inclui a execução paralela de consultas assíncronas e qualquer uso simultâneo explícito de vários threads. Portanto, sempre aguarde chamadas assíncronas imediatamente ou use instâncias DbContext separadas para operações executadas em paralelo. Consulte Evitando problemas de threading de DbContext para obter mais informações e exemplos.

Consulte Controle de alterações do EF Core e Usando AddRange, UpdateRange, AttachRange e RemoveRange para obter mais informações e exemplos.