DbSet<TEntity>.AddAsync(TEntity, CancellationToken) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Beginnt mit der Nachverfolgung der angegebenen Entität und allen anderen erreichbaren Entitäten, die noch nicht nachverfolgt werden, in dem Added Zustand, dass sie beim SaveChanges() Aufrufen in die Datenbank eingefügt werden.
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 hinzuzufügende Entität.
- cancellationToken
- CancellationToken
A CancellationToken , um zu beobachten, während sie auf den Abschluss der Aufgabe warten.
Gibt zurück
Eine Aufgabe, die den asynchronen Add-Vorgang darstellt. Das Aufgabenergebnis enthält die EntityEntry<TEntity> Entität. Der Eintrag bietet Zugriff auf Änderungsnachverfolgungsinformationen und -vorgänge für die Entität.
Ausnahmen
Wenn der CancellationToken Vorgang abgebrochen wird.
Hinweise
Diese Methode ist nur asynchron, um spezielle Wertgeneratoren zuzulassen, z. B. die von 'Microsoft verwendete. EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo', um asynchron auf die Datenbank zuzugreifen. Für alle anderen Fälle sollte die nicht asynchrone Methode verwendet werden.
Wird verwendet State , um den Status nur einer einzelnen Entität festzulegen.
Weitere Informationen und Beispiele finden Sie unter EF Core-Änderungsnachverfolgung .
