Язык

DbContext.AddAsync Метод

Определение

Перегрузки

Имя. Описание
AddAsync(Object, CancellationToken)

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

AddAsync<TEntity>(TEntity, CancellationToken)

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

AddAsync(Object, CancellationToken)

Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs

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

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)

Параметры

entity
Object

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

cancellationToken
CancellationToken

Необходимо CancellationToken наблюдать за ожиданием завершения задачи.

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

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

Исключения

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

Комментарии

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

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

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

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

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

AddAsync<TEntity>(TEntity, CancellationToken)

Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs
Исходный код:
DbContext.cs

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

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))

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

TEntity

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

Параметры

entity
TEntity

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

cancellationToken
CancellationToken

Необходимо CancellationToken наблюдать за ожиданием завершения задачи.

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

Task<EntityEntry<TEntity>>

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

Исключения

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

Комментарии

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

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

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

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