DbContext Třída

Definice

Obor názvů:

Microsoft.EntityFrameworkCore

Sestavení:

Microsoft.EntityFrameworkCore.dll

Balíček:

Microsoft.EntityFrameworkCore v10.0.0

Zdroj:

DbContext.cs

Instance DbContext představuje relaci s databází a lze ji použít k dotazování a ukládání instancí entit. DbContext je kombinace vzorů Práce jednotek práce a úložiště.

[System.Runtime.CompilerServices.Nullable(0)]
public class DbContext : IAsyncDisposable, IDisposable, Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, Microsoft.EntityFrameworkCore.Internal.IDbContextDependencies, Microsoft.EntityFrameworkCore.Internal.IDbContextPoolable, Microsoft.EntityFrameworkCore.Internal.IDbSetCache

[<System.Runtime.CompilerServices.Nullable(0)>]
type DbContext = class
    interface IInfrastructure<IServiceProvider>
    interface IDbContextDependencies
    interface IDbSetCache
    interface IDbContextPoolable
    interface IResettableService
    interface IDisposable
    interface IAsyncDisposable

Public Class DbContext
Implements IAsyncDisposable, IDbContextDependencies, IDbContextPoolable, IDbSetCache, IDisposable, IInfrastructure(Of IServiceProvider)

Dědičnost

Object

DbContext

Atributy

NullableAttribute

Implementuje

IInfrastructure<IServiceProvider> IDisposable IResettableService Microsoft.EntityFrameworkCore.Internal.IDbContextDependencies Microsoft.EntityFrameworkCore.Internal.IDbContextPoolable Microsoft.EntityFrameworkCore.Internal.IDbSetCache IAsyncDisposable

Poznámky

Entity Framework Core nepodporuje spouštění více paralelních operací ve stejné instanci DbContext. To zahrnuje paralelní spouštění asynchronních dotazů i jakékoli explicitní souběžné používání z více vláken. Proto vždy čekejte asynchronní volání okamžitě nebo použijte samostatné instance DbContext pro operace, které se spouští paralelně. Další informace a příklady najdete v tématu Zabránění problémům s vlákny DbContext .

Obvykle vytvoříte třídu, která je odvozena z DbContext a obsahuje DbSet<TEntity> vlastnosti pro každou entitu v modelu. DbSet<TEntity> Pokud vlastnosti mají veřejnou setter, jsou automaticky inicializovány při vytvoření instance odvozeného kontextu.

Přepište metodu OnConfiguring(DbContextOptionsBuilder) konfigurace databáze (a dalších možností), která se má použít pro kontext. Případně pokud byste raději provedli konfiguraci externě místo vložené v kontextu, můžete DbContextOptionsBuilder<TContext>DbContextOptionsBuilderk externímu vytvoření instance (nebo) použít ( DbContextOptions<TContext> nebo DbContextOptions) a předat ji do základního konstruktoru DbContext.

Model je zjištěn spuštěním sady konvencí nad třídami entit nalezenými ve DbSet<TEntity> vlastnostech odvozeného kontextu. Pokud chcete dále nakonfigurovat model, který je zjištěn konvencí, můžete tuto metodu OnModelCreating(ModelBuilder) přepsat.

Další informace a příklady najdete v tématu Životnost, konfigurace a inicializace DbContext, Dotazování dat pomocí EF Core, sledování změn a ukládání dat pomocí EF Core .

Konstruktory

Název	Description
DbContext()	Inicializuje novou instanci DbContext třídy. Volá OnConfiguring(DbContextOptionsBuilder) se metoda pro konfiguraci databáze (a dalších možností), která se má pro tento kontext použít.
DbContext(DbContextOptions)	Inicializuje novou instanci DbContext třídy pomocí zadaných možností. Metoda OnConfiguring(DbContextOptionsBuilder) bude stále volána, aby byla povolena další konfigurace možností.

Vlastnosti

Název	Description
ChangeTracker	Poskytuje přístup k informacím a operacím pro instance entit, které tento kontext sleduje.
ContextId	Jedinečný identifikátor pro kontextovou instanci a zapůjčení fondu, pokud existuje.
Database	Poskytuje přístup k informacím a operacím souvisejícím s databází pro tento kontext.
Model	Metadata o tvaru entit, relacích mezi nimi a o tom, jak se mapují na databázi. Nesmí obsahovat všechny informace potřebné k inicializaci databáze.

Metody

Název	Description
Add(Object)	Začne sledovat danou entitu a všechny další dosažitelné entity, které se ještě nesledují, ve Added stavu tak, že se při zavolání vloží do databáze SaveChanges() .
Add<TEntity>(TEntity)	Začne sledovat danou entitu a všechny další dosažitelné entity, které se ještě nesledují, ve Added stavu tak, že se při zavolání vloží do databáze SaveChanges() .
AddAsync(Object, CancellationToken)	Začne sledovat danou entitu a všechny další dosažitelné entity, které se ještě nesledují, ve Added stavu tak, že se při zavolání vloží do databáze SaveChanges() .
AddAsync<TEntity>(TEntity, CancellationToken)	Začne sledovat danou entitu a všechny další dosažitelné entity, které se ještě nesledují, ve Added stavu tak, že se při zavolání vloží do databáze SaveChanges() .
AddRange(IEnumerable<Object>)	Začne sledovat dané entity a všechny další dosažitelné entity, které se ještě nesledují, ve Added stavu tak, že se při zavolání vloží do databáze SaveChanges() .
AddRange(Object[])	Začne sledovat dané entity a všechny další dosažitelné entity, které se ještě nesledují, ve Added stavu tak, že se při zavolání vloží do databáze SaveChanges() .
AddRangeAsync(IEnumerable<Object>, CancellationToken)	Začne sledovat danou entitu a všechny další dosažitelné entity, které se ještě nesledují, ve Added stavu tak, že se při zavolání vloží do databáze SaveChanges() .
AddRangeAsync(Object[])	Začne sledovat danou entitu a všechny další dosažitelné entity, které se ještě nesledují, ve Added stavu tak, že se při zavolání vloží do databáze SaveChanges() .
Attach(Object)	Začne sledovat danou entitu a položky dostupné z dané entity pomocí Unchanged stavu ve výchozím nastavení, ale viz níže v případech, kdy se použije jiný stav.
Attach<TEntity>(TEntity)	Začne sledovat danou entitu a položky dostupné z dané entity pomocí Unchanged stavu ve výchozím nastavení, ale viz níže v případech, kdy se použije jiný stav.
AttachRange(IEnumerable<Object>)	Začne sledovat dané entity a položky dostupné z daných entit pomocí Unchanged stavu ve výchozím nastavení, ale viz níže pro případy, kdy se použije jiný stav.
AttachRange(Object[])	Začne sledovat dané entity a položky dostupné z daných entit pomocí Unchanged stavu ve výchozím nastavení, ale viz níže pro případy, kdy se použije jiný stav.
ConfigureConventions(ModelConfigurationBuilder)	Přepište tuto metodu tak, aby před spuštěním nastavily výchozí hodnoty a konfigurovali konvence. Tato metoda je vyvolána před OnModelCreating(ModelBuilder).
Dispose()	Uvolní přidělené prostředky pro tento kontext.
DisposeAsync()	Uvolní přidělené prostředky pro tento kontext.
Entry(Object)	Získá pro danou EntityEntry entitu. Tato položka poskytuje přístup k informacím a operacím sledování změn pro entitu.
Entry<TEntity>(TEntity)	Získá pro danou EntityEntry<TEntity> entitu. Tato položka poskytuje přístup k informacím a operacím sledování změn pro entitu.
Find(Type, Object[])	Vyhledá entitu s danými hodnotami primárního klíče. Pokud je entita s danými hodnotami primárního klíče sledována kontextem, vrátí se okamžitě bez provedení požadavku na databázi. V opačném případě se dotaz provede do databáze entity s danými hodnotami primárního klíče a tato entita je v případě nalezení připojena k kontextu a vrácena. Pokud se žádná entita nenajde, vrátí se hodnota null.
Find<TEntity>(Object[])	Vyhledá entitu s danými hodnotami primárního klíče. Pokud je entita s danými hodnotami primárního klíče sledována kontextem, vrátí se okamžitě bez provedení požadavku na databázi. V opačném případě se dotaz provede do databáze entity s danými hodnotami primárního klíče a tato entita je v případě nalezení připojena k kontextu a vrácena. Pokud se žádná entita nenajde, vrátí se hodnota null.
FindAsync(Type, Object[], CancellationToken)	Vyhledá entitu s danými hodnotami primárního klíče. Pokud je entita s danými hodnotami primárního klíče sledována kontextem, vrátí se okamžitě bez provedení požadavku na databázi. V opačném případě se dotaz provede do databáze entity s danými hodnotami primárního klíče a tato entita je v případě nalezení připojena k kontextu a vrácena. Pokud se žádná entita nenajde, vrátí se hodnota null.
FindAsync(Type, Object[])	Vyhledá entitu s danými hodnotami primárního klíče. Pokud je entita s danými hodnotami primárního klíče sledována kontextem, vrátí se okamžitě bez provedení požadavku na databázi. V opačném případě se dotaz provede do databáze entity s danými hodnotami primárního klíče a tato entita je v případě nalezení připojena k kontextu a vrácena. Pokud se žádná entita nenajde, vrátí se hodnota null.
FindAsync<TEntity>(Object[], CancellationToken)	Vyhledá entitu s danými hodnotami primárního klíče. Pokud je entita s danými hodnotami primárního klíče sledována kontextem, vrátí se okamžitě bez provedení požadavku na databázi. V opačném případě se dotaz provede do databáze entity s danými hodnotami primárního klíče a tato entita je v případě nalezení připojena k kontextu a vrácena. Pokud se žádná entita nenajde, vrátí se hodnota null.
FindAsync<TEntity>(Object[])	Vyhledá entitu s danými hodnotami primárního klíče. Pokud je entita s danými hodnotami primárního klíče sledována kontextem, vrátí se okamžitě bez provedení požadavku na databázi. V opačném případě se dotaz provede do databáze entity s danými hodnotami primárního klíče a tato entita je v případě nalezení připojena k kontextu a vrácena. Pokud se žádná entita nenajde, vrátí se hodnota null.
FromExpression<TResult>(Expression<Func<IQueryable<TResult>>>)	Vytvoří dotazovatelný pro daný výraz dotazu.
OnConfiguring(DbContextOptionsBuilder)	Tuto metodu přepište tak, aby se pro tento kontext nakonfiguruje databáze (a další možnosti). Tato metoda se volá pro každou instanci vytvořeného kontextu. Základní implementace nic nedělá.
OnModelCreating(ModelBuilder)	Tuto metodu přepište, pokud chcete dále nakonfigurovat model, který byl zjištěn konvencí z typů entit vystavených ve DbSet<TEntity> vlastnostech odvozeného kontextu. Výsledný model se může uložit do mezipaměti a znovu použít pro následné instance odvozeného kontextu.
Remove(Object)	Začne sledovat danou entitu Deleted ve stavu tak, aby se po SaveChanges() zavolání odebrala z databáze.
Remove<TEntity>(TEntity)	Začne sledovat danou entitu Deleted ve stavu tak, aby se po SaveChanges() zavolání odebrala z databáze.
RemoveRange(IEnumerable<Object>)	Začne sledovat danou entitu Deleted ve stavu tak, aby se po SaveChanges() zavolání odebrala z databáze.
RemoveRange(Object[])	Začne sledovat danou entitu Deleted ve stavu tak, aby se po SaveChanges() zavolání odebrala z databáze.
SaveChanges()	Uloží všechny změny provedené v tomto kontextu do databáze.
SaveChanges(Boolean)	Uloží všechny změny provedené v tomto kontextu do databáze.
SaveChangesAsync(Boolean, CancellationToken)	Uloží všechny změny provedené v tomto kontextu do databáze.
SaveChangesAsync(CancellationToken)	Uloží všechny změny provedené v tomto kontextu do databáze.
Set<TEntity>()	Vytvoří, DbSet<TEntity> který lze použít k dotazování a uložení instancí TEntity.
Set<TEntity>(String)	Vytvoří DbSet<TEntity> typ entity sdíleného typu, který lze použít k dotazování a uložení instancí TEntity.
Update(Object)	Začne sledovat danou entitu a položky dostupné z dané entity pomocí Modified stavu ve výchozím nastavení, ale viz níže v případech, kdy se použije jiný stav.
Update<TEntity>(TEntity)	Začne sledovat danou entitu a položky dostupné z dané entity pomocí Modified stavu ve výchozím nastavení, ale viz níže v případech, kdy se použije jiný stav.
UpdateRange(IEnumerable<Object>)	Začne sledovat dané entity a položky dostupné z daných entit pomocí Modified stavu ve výchozím nastavení, ale viz níže pro případy, kdy se použije jiný stav.
UpdateRange(Object[])	Začne sledovat dané entity a položky dostupné z daných entit pomocí Modified stavu ve výchozím nastavení, ale viz níže pro případy, kdy se použije jiný stav.

Událost

Název	Description
SaveChangesFailed	Událost se aktivovala, pokud volání SaveChanges nebo SaveChangesAsync selže s výjimkou.
SavedChanges	Událost se aktivovala na konci hovoru nebo SaveChangesSaveChangesAsync
SavingChanges	Událost se aktivovala na začátku hovoru nebo SaveChangesSaveChangesAsync

Explicitní implementace rozhraní

Název	Description
IDbContextDependencies.ChangeDetector	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IDbContextDependencies.EntityFinderFactory	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IDbContextDependencies.EntityGraphAttacher	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IDbContextDependencies.ExceptionDetector	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IDbContextDependencies.InfrastructureLogger	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IDbContextDependencies.QueryProvider	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IDbContextDependencies.SetSource	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IDbContextDependencies.StateManager	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IDbContextDependencies.UpdateLogger	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IDbContextPoolable.ClearLease()	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IDbContextPoolable.SetLease(DbContextLease)	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IDbContextPoolable.SetLeaseAsync(DbContextLease, CancellationToken)	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IDbContextPoolable.SnapshotConfiguration()	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IDbSetCache.GetOrAddSet(IDbSetSource, String, Type)	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IDbSetCache.GetOrAddSet(IDbSetSource, Type)	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IDbSetCache.GetSets()	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IInfrastructure<IServiceProvider>.Instance	Získá vymezený IServiceProvider obor používaný k překladu služeb. Tato vlastnost je určená pro použití metodami rozšíření, které potřebují využívat služby, které nejsou přímo vystaveny na povrchu veřejného rozhraní API.
IResettableService.ResetState()	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.
IResettableService.ResetStateAsync(CancellationToken)	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nevztahuje se na stejné standardy kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez upozornění v jakékoli verzi. Měli byste ho používat přímo ve svém kódu s extrémní opatrností a vědět, že to může vést k selháním aplikace při aktualizaci na novou Entity Framework Core verzi.

Metody rozšíření

Název	Description
CreateProxy(DbContext, Type, Object[])	Vytvoří instanci proxy pro typ entity, pokud bylo vytvoření proxy serveru zapnuté.
CreateProxy<TEntity>(DbContext, Action<TEntity>, Object[])	Vytvoří instanci proxy pro typ entity, pokud bylo vytvoření proxy serveru zapnuté.
CreateProxy<TEntity>(DbContext, Object[])	Vytvoří instanci proxy pro typ entity, pokud bylo vytvoření proxy serveru zapnuté.
GetInfrastructure<T>(IInfrastructure<T>)	Získá hodnotu z vlastnosti, která je skryta pomocí IInfrastructure<T>. Tuto metodu obvykle používají poskytovatelé databáze (a další rozšíření). Obvykle se nepoužívá v kódu aplikace.