DbContext.AddAsync Methode

Definition

Namespace:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Paket:

Microsoft.EntityFrameworkCore v8.0.0

Ü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.ValueTask<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> AddAsync (object entity, System.Threading.CancellationToken cancellationToken = default);

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

ValueTask<EntityEntry>

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

OperationCanceledException

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 .

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

ValueTask<EntityEntry<TEntity>>

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

OperationCanceledException

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 .