DbContext.AddAsync Метод

Определение

Пространство имен:

Microsoft.EntityFrameworkCore

Сборка:

Microsoft.EntityFrameworkCore.dll

Пакет:

Microsoft.EntityFrameworkCore v8.0.0

Перегрузки

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

AddAsync(Object, CancellationToken)

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

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.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 ValueTask(Of EntityEntry)

Параметры

entity

Object

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

cancellationToken

CancellationToken

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

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

ValueTask<EntityEntry>

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

Исключения

OperationCanceledException

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

Комментарии

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

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

Entity Framework Core не поддерживает выполнение нескольких параллельных операций в одном экземпляре DbContext. включая параллельное выполнение асинхронных запросов и любое явное использование экземпляра из нескольких потоков одновременно. Поэтому всегда ожидайте асинхронные вызовы немедленно или используйте отдельные экземпляры DbContext для операций, которые выполняются параллельно. Дополнительные сведения и примеры см. в разделе Предотвращение проблем с потоком DbContext .

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

AddAsync<TEntity>(TEntity, CancellationToken)

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

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.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 ValueTask(Of EntityEntry(Of TEntity))

Параметры типа

TEntity

Тип сущности.

Параметры

entity

TEntity

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

cancellationToken

CancellationToken

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

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

ValueTask<EntityEntry<TEntity>>

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

Исключения

OperationCanceledException

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

Комментарии

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

Entity Framework Core не поддерживает выполнение нескольких параллельных операций в одном экземпляре DbContext. включая параллельное выполнение асинхронных запросов и любое явное использование экземпляра из нескольких потоков одновременно. Поэтому всегда ожидайте асинхронные вызовы немедленно или используйте отдельные экземпляры DbContext для операций, которые выполняются параллельно. Дополнительные сведения и примеры см. в разделе Предотвращение проблем с потоком DbContext .

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