Freigeben über


DbSet<TEntity>.AddAsync(TEntity, CancellationToken) Methode

Definition

Beginnt mit der Nachverfolgung der angegebenen Entität und aller anderen erreichbaren Entitäten, die noch nicht nachverfolgt werden, in dem Added Zustand, dass sie in die Datenbank eingefügt werden, wenn SaveChanges() aufgerufen wird.

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

Parameter

entity
TEntity

Die Entität, die hinzugefügt werden soll.

cancellationToken
CancellationToken

Ein CancellationToken , der beobachtet werden soll, während auf den Abschluss der Aufgabe gewartet wird.

Gibt zurück

Task<EntityEntry<TEntity>>

Eine Aufgabe, die den asynchronen Add-Vorgang darstellt. Das Vorgangsergebnis enthält den EntityEntry<TEntity> für die Entität. Der Eintrag bietet Zugriff auf Änderungsnachverfolgungsinformationen und -vorgänge für die Entität.

Ausnahmen

Hinweise

Diese Methode ist nur asynchron, um speziellen Wertgeneratoren wie dem von "Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo" verwendeten Generatoren den asynchronen Zugriff auf die Datenbank zu ermöglichen. Für alle anderen Fälle sollte die nicht asynchrone Methode verwendet werden.

Verwenden Sie State , um den Status einer einzelnen Entität festzulegen.

Weitere Informationen und Beispiele finden Sie unter EF Core-Änderungsnachverfolgung .

Gilt für: