DbContext.AddAsync 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.
Überlädt
| AddAsync(Object, CancellationToken) |
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 beim SaveChanges() Aufruf in die Datenbank eingefügt werden. |
| AddAsync<TEntity>(TEntity, CancellationToken) |
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 beim SaveChanges() Aufruf in die Datenbank eingefügt werden. |
AddAsync(Object, CancellationToken)
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 beim SaveChanges() Aufruf in die Datenbank eingefügt werden.
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)Parameter
- entity
- Object
Die Entität, die hinzugefügt werden soll.
- cancellationToken
- CancellationToken
Ein CancellationToken , der beim Warten auf den Abschluss der Aufgabe zu beobachten ist.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang Zum Hinzufügen darstellt. Das Vorgangsergebnis enthält das EntityEntry für die Entität. Der Eintrag bietet Zugriff auf Änderungsnachverfolgungsinformationen und -vorgänge für die Entität.
Ausnahmen
Wenn CancellationToken abgebrochen ist.
Hinweise
Verwenden Sie State , um nur den Status einer einzelnen Entität festzulegen.
Diese Methode ist nur asynchron, um speziellen Wertgeneratoren wie dem von "Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo" verwendeten Wertgeneratoren den asynchronen Zugriff auf die Datenbank zu ermöglichen. In allen anderen Fällen sollte die nicht asynchrone Methode verwendet werden.
Entity Framework Core unterstützt nicht mehrere parallele Vorgänge, die auf demselben DbContext-instance ausgeführt werden. Dies schließt die parallele Ausführung von asynchronen Abfragen und jede explizite gleichzeitige Verwendung aus mehreren Threads ein. Warten Sie daher immer sofort auf asynchrone Aufrufe, oder verwenden Sie separate DbContext-Instanzen für parallel ausgeführte Vorgänge. Weitere Informationen und Beispiele finden Sie unter Vermeiden von Problemen beim DbContext-Threading .
Weitere Informationen und Beispiele finden Sie unter EF Core-Änderungsnachverfolgung .
Gilt für:
AddAsync<TEntity>(TEntity, CancellationToken)
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 beim SaveChanges() Aufruf in die Datenbank eingefügt werden.
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))Typparameter
- TEntity
Der Typ der Entität
Parameter
- entity
- TEntity
Die Entität, die hinzugefügt werden soll.
- cancellationToken
- CancellationToken
Ein CancellationToken , der beim Warten auf den Abschluss der Aufgabe zu beobachten ist.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang Zum Hinzufügen darstellt. Das Vorgangsergebnis enthält das EntityEntry<TEntity> für die Entität. Der Eintrag bietet Zugriff auf Änderungsnachverfolgungsinformationen und -vorgänge für die Entität.
Ausnahmen
Wenn CancellationToken abgebrochen ist.
Hinweise
Diese Methode ist nur asynchron, um speziellen Wertgeneratoren wie dem von "Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo" verwendeten Wertgeneratoren den asynchronen Zugriff auf die Datenbank zu ermöglichen. In allen anderen Fällen sollte die nicht asynchrone Methode verwendet werden.
Entity Framework Core unterstützt nicht mehrere parallele Vorgänge, die auf demselben DbContext-instance ausgeführt werden. Dies schließt die parallele Ausführung von asynchronen Abfragen und jede explizite gleichzeitige Verwendung aus mehreren Threads ein. Warten Sie daher immer sofort auf asynchrone Aufrufe, oder verwenden Sie separate DbContext-Instanzen für parallel ausgeführte Vorgänge. Weitere Informationen und Beispiele finden Sie unter Vermeiden von Problemen beim DbContext-Threading .
Weitere Informationen und Beispiele finden Sie unter EF Core-Änderungsnachverfolgung .
Gilt für:
Entity Framework