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

  • Referenz

Definition

Namespace:
Microsoft.EntityFrameworkCore
Assembly:
Microsoft.EntityFrameworkCore.dll
Paket:
Microsoft.EntityFrameworkCore v1.1.6
Paket:
Microsoft.EntityFrameworkCore v2.0.3
Paket:
Microsoft.EntityFrameworkCore v2.1.11
Paket:
Microsoft.EntityFrameworkCore v2.2.6
Paket:
Microsoft.EntityFrameworkCore v3.0.0
Paket:
Microsoft.EntityFrameworkCore v3.1.0
Paket:
Microsoft.EntityFrameworkCore v5.0.0
Paket:
Microsoft.EntityFrameworkCore v6.0.0
Paket:
Microsoft.EntityFrameworkCore v7.0.0
Paket:
Microsoft.EntityFrameworkCore v8.0.0

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

OperationCanceledException

Wenn CancellationToken abgebrochen ist.

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: