DbContext.AddAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Przeciążenia
| AddAsync(Object, CancellationToken) |
Rozpoczyna śledzenie danej jednostki i innych osiągalnych jednostek, które nie są jeszcze śledzone, w Added stanie, w którym zostaną one wstawione do bazy danych po SaveChanges() wywołaniu. Służy State do ustawiania stanu tylko jednej jednostki. Ta metoda jest asynchroniczna tylko w celu zezwolenia na generatory wartości specjalnych, takich jak ta używana przez element "Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo", aby uzyskać dostęp do bazy danych asynchronicznie. W przypadku wszystkich pozostałych przypadków należy użyć metody innej niż asynchroniczna. Program Entity Framework Core nie obsługuje wielu równoległych operacji uruchamianych w tym samym wystąpieniu dbContext. Obejmuje to zarówno równoległe wykonywanie zapytań asynchronicznych, jak i jawne współbieżne użycie z wielu wątków. Dlatego zawsze czekaj na wywołania asynchroniczne natychmiast lub używaj oddzielnych wystąpień dbContext dla operacji wykonywanych równolegle. Aby uzyskać więcej informacji, zobacz Unikanie problemów z wątkowaniem dbContext . |
| AddAsync<TEntity>(TEntity, CancellationToken) |
Rozpoczyna śledzenie danej jednostki i innych osiągalnych jednostek, które nie są jeszcze śledzone, w Added stanie, w którym zostaną one wstawione do bazy danych po SaveChanges() wywołaniu. Ta metoda jest asynchroniczna tylko w celu zezwolenia na generatory wartości specjalnych, takich jak ta używana przez element "Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo", aby uzyskać dostęp do bazy danych asynchronicznie. W przypadku wszystkich pozostałych przypadków należy użyć metody innej niż asynchroniczna. Program Entity Framework Core nie obsługuje wielu równoległych operacji uruchamianych w tym samym wystąpieniu dbContext. Obejmuje to zarówno równoległe wykonywanie zapytań asynchronicznych, jak i jawne współbieżne użycie z wielu wątków. Dlatego zawsze czekaj na wywołania asynchroniczne natychmiast lub używaj oddzielnych wystąpień dbContext dla operacji wykonywanych równolegle. Aby uzyskać więcej informacji, zobacz Unikanie problemów z wątkowaniem dbContext . |
AddAsync(Object, CancellationToken)
Rozpoczyna śledzenie danej jednostki i innych osiągalnych jednostek, które nie są jeszcze śledzone, w Added stanie, w którym zostaną one wstawione do bazy danych po SaveChanges() wywołaniu.
Służy State do ustawiania stanu tylko jednej jednostki.
Ta metoda jest asynchroniczna tylko w celu zezwolenia na generatory wartości specjalnych, takich jak ta używana przez element "Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo", aby uzyskać dostęp do bazy danych asynchronicznie. W przypadku wszystkich pozostałych przypadków należy użyć metody innej niż asynchroniczna.
Program Entity Framework Core nie obsługuje wielu równoległych operacji uruchamianych w tym samym wystąpieniu dbContext. Obejmuje to zarówno równoległe wykonywanie zapytań asynchronicznych, jak i jawne współbieżne użycie z wielu wątków. Dlatego zawsze czekaj na wywołania asynchroniczne natychmiast lub używaj oddzielnych wystąpień dbContext dla operacji wykonywanych równolegle. Aby uzyskać więcej informacji, zobacz Unikanie problemów z wątkowaniem dbContext .
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)Parametry
- entity
- Object
Jednostka do dodania.
- cancellationToken
- CancellationToken
Element CancellationToken do obserwowania podczas oczekiwania na ukończenie zadania.
Zwraca
Zadanie reprezentujące asynchroniczną operację Dodaj. Wynik zadania zawiera element EntityEntry dla jednostki. Wpis zapewnia dostęp do informacji i operacji śledzenia zmian dla jednostki.
Wyjątki
Jeśli element CancellationToken zostanie anulowany.
Uwagi
Aby uzyskać więcej informacji, zobacz Śledzenie zmian platformy EF Core .
Dotyczy
AddAsync<TEntity>(TEntity, CancellationToken)
Rozpoczyna śledzenie danej jednostki i innych osiągalnych jednostek, które nie są jeszcze śledzone, w Added stanie, w którym zostaną one wstawione do bazy danych po SaveChanges() wywołaniu.
Ta metoda jest asynchroniczna tylko w celu zezwolenia na generatory wartości specjalnych, takich jak ta używana przez element "Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.SequenceHiLo", aby uzyskać dostęp do bazy danych asynchronicznie. W przypadku wszystkich pozostałych przypadków należy użyć metody innej niż asynchroniczna.
Program Entity Framework Core nie obsługuje wielu równoległych operacji uruchamianych w tym samym wystąpieniu dbContext. Obejmuje to zarówno równoległe wykonywanie zapytań asynchronicznych, jak i jawne współbieżne użycie z wielu wątków. Dlatego zawsze czekaj na wywołania asynchroniczne natychmiast lub używaj oddzielnych wystąpień dbContext dla operacji wykonywanych równolegle. Aby uzyskać więcej informacji, zobacz Unikanie problemów z wątkowaniem dbContext .
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))Parametry typu
- TEntity
Typ jednostki.
Parametry
- entity
- TEntity
Jednostka do dodania.
- cancellationToken
- CancellationToken
Element CancellationToken do obserwowania podczas oczekiwania na ukończenie zadania.
Zwraca
- Task<EntityEntry<TEntity>>
- ValueTask<EntityEntry<TEntity>>
Zadanie reprezentujące asynchroniczną operację Dodaj. Wynik zadania zawiera element EntityEntry<TEntity> dla jednostki. Wpis zapewnia dostęp do informacji i operacji śledzenia zmian dla jednostki.
Wyjątki
Jeśli element CancellationToken zostanie anulowany.
Uwagi
Aby uzyskać więcej informacji, zobacz Śledzenie zmian platformy EF Core .
Dotyczy
Opinia
Prześlij i wyświetl opinię dla