DbContext.AddAsync Methode

Definition

Überlädt

AddAsync(Object, CancellationToken)

Beginnt mit der Nachverfolgung der angegebenen Entität und aller anderen erreichbaren Entitäten, die noch nicht nachverfolgt werden, im Added Zustand , sodass sie beim Aufruf von in die Datenbank eingefügt SaveChanges() werden.

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

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. In allen anderen Fällen sollte die nicht asynchrone Methode verwendet werden.

Entity Framework Core unterstützt nicht mehrere parallele Vorgänge, die auf derselben DbContext-Instanz 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 Vorgänge, die parallel ausgeführt werden. Weitere Informationen finden Sie unter Vermeiden von DbContext-Threadingproblemen.

AddAsync<TEntity>(TEntity, CancellationToken)

Beginnt mit der Nachverfolgung der angegebenen Entität und aller anderen erreichbaren Entitäten, die noch nicht nachverfolgt werden, im Added Zustand , sodass sie beim Aufruf von in die Datenbank eingefügt SaveChanges() werden.

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. In allen anderen Fällen sollte die nicht asynchrone Methode verwendet werden.

Entity Framework Core unterstützt nicht mehrere parallele Vorgänge, die auf derselben DbContext-Instanz 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 Vorgänge, die parallel ausgeführt werden. Weitere Informationen finden Sie unter Vermeiden von DbContext-Threadingproblemen.

AddAsync(Object, CancellationToken)

Beginnt mit der Nachverfolgung der angegebenen Entität und aller anderen erreichbaren Entitäten, die noch nicht nachverfolgt werden, im Added Zustand , sodass sie beim Aufruf von in die Datenbank eingefügt SaveChanges() werden.

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

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. In allen anderen Fällen sollte die nicht asynchrone Methode verwendet werden.

Entity Framework Core unterstützt nicht mehrere parallele Vorgänge, die auf derselben DbContext-Instanz 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 Vorgänge, die parallel ausgeführt werden. Weitere Informationen finden Sie unter Vermeiden von DbContext-Threadingproblemen.

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 beobachtet werden soll.

Gibt zurück

Task<EntityEntry>
ValueTask<EntityEntry>

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

Ausnahmen

Hinweise

Weitere Informationen 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, im Added Zustand , sodass sie beim Aufruf von in die Datenbank eingefügt SaveChanges() werden.

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. In allen anderen Fällen sollte die nicht asynchrone Methode verwendet werden.

Entity Framework Core unterstützt nicht mehrere parallele Vorgänge, die auf derselben DbContext-Instanz 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 Vorgänge, die parallel ausgeführt werden. Weitere Informationen finden Sie unter Vermeiden von DbContext-Threadingproblemen.

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 beobachtet werden soll.

Gibt zurück

Task<EntityEntry<TEntity>>
ValueTask<EntityEntry<TEntity>>

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

Ausnahmen

Hinweise

Weitere Informationen finden Sie unter EF Core Änderungsnachverfolgung.

Gilt für