DbSet<TEntity>.AddAsync(TEntity, CancellationToken) Метод

  • Ссылка

Определение

Пространство имен:
Microsoft.EntityFrameworkCore
Сборка:
Microsoft.EntityFrameworkCore.dll
Пакет:
Microsoft.EntityFrameworkCore v1.1.6
Пакет:
Microsoft.EntityFrameworkCore v2.0.3
Пакет:
Microsoft.EntityFrameworkCore v2.1.11
Пакет:
Microsoft.EntityFrameworkCore v2.2.6
Пакет:
Microsoft.EntityFrameworkCore v3.0.0
Пакет:
Microsoft.EntityFrameworkCore v3.1.0
Пакет:
Microsoft.EntityFrameworkCore v5.0.0
Пакет:
Microsoft.EntityFrameworkCore v6.0.0
Пакет:
Microsoft.EntityFrameworkCore v7.0.0
Пакет:
Microsoft.EntityFrameworkCore v8.0.0

Начинает отслеживание заданной сущности и любых других доступных сущностей, которые еще не отслеживаются, в Added состоянии таким образом, что они будут вставлены в базу данных при SaveChanges() вызове .

public virtual System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync (TEntity entity, System.Threading.CancellationToken cancellationToken = default);
public virtual System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> AddAsync (TEntity entity, System.Threading.CancellationToken cancellationToken = default);
abstract member AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>
abstract member AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>
override this.AddAsync : 'Entity * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>
Public Overridable Function AddAsync (entity As TEntity, Optional cancellationToken As CancellationToken = Nothing) As Task(Of EntityEntry(Of TEntity))
Public Overridable Function AddAsync (entity As TEntity, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EntityEntry(Of TEntity))

Параметры

entity
TEntity

Добавляемая сущность.

cancellationToken
CancellationToken

Объект CancellationToken , который необходимо наблюдать в ожидании завершения задачи.

Возвращаемое значение

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

Задача, представляющая асинхронную операцию Добавления. Результат задачи содержит EntityEntry<TEntity> для сущности . Запись предоставляет доступ к сведениям об отслеживании изменений и операциям для сущности.

Исключения

OperationCanceledException

Если CancellationToken отменяется.

Комментарии

Этот метод является асинхронным, чтобы разрешить специальным генераторам значений, таким как microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo, доступ к базе данных асинхронно. Во всех остальных случаях следует использовать неасинхронный метод.

Используется State для задания состояния только одной сущности.

Дополнительные сведения и примеры см. в статье Отслеживание изменений EF Core .

Применяется к