DbContext Třída

Definice

Obor názvů:

Microsoft.EntityFrameworkCore

Sestavení:

Microsoft.EntityFrameworkCore.dll

Balíček:

Microsoft.EntityFrameworkCore v8.0.0

Instance DbContext představuje relaci s databází a lze ji použít k dotazování a ukládání instancí vašich entit. DbContext je kombinace vzorů Unit Of Work (Jednotka práce) a Repository (Úložiště).

public class DbContext : IAsyncDisposable, IDisposable, Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, Microsoft.EntityFrameworkCore.Internal.IDbContextDependencies, Microsoft.EntityFrameworkCore.Internal.IDbContextPoolable, Microsoft.EntityFrameworkCore.Internal.IDbSetCache

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

Implementuje

IInfrastructure<IServiceProvider> IDisposable Microsoft.EntityFrameworkCore.Internal.IDbContextDependencies Microsoft.EntityFrameworkCore.Internal.IDbContextPoolable Microsoft.EntityFrameworkCore.Internal.IDbSetCache IResettableService 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 okamžitě vyčkejte na asynchronní volání nebo používejte samostatné instance DbContext pro operace, které se provádějí paralelně. Další informace a příklady najdete v tématu Předcházení 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řejné 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 prováděli konfiguraci externě místo vložené v kontextu, můžete použít DbContextOptionsBuilder<TContext> (neboDbContextOptionsBuilder) k externímu vytvoření instance DbContextOptions<TContext> (neboDbContextOptions) a jejímu předání do základního konstruktoru .DbContext

Model se zjistí spuštěním sady konvencí pro třídy entit, které se nacházejí ve DbSet<TEntity> vlastnostech v odvozeném kontextu. Pokud chcete dále nakonfigurovat model, který je zjištěn konvencí, můžete metodu OnModelCreating(ModelBuilder) přepsat.

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

Konstruktory

DbContext()	Inicializuje novou instanci DbContext třídy . Metoda OnConfiguring(DbContextOptionsBuilder) bude volána ke konfiguraci databáze (a dalších možností), která se má použít pro tento kontext.
DbContext(DbContextOptions)	Inicializuje novou instanci DbContext třídy pomocí zadaných možností. Metoda OnConfiguring(DbContextOptionsBuilder) bude stále volána, aby bylo možné další konfiguraci možností.

Vlastnosti

ChangeTracker	Poskytuje přístup k informacím a operacím pro instance entit, které tento kontext sleduje.
ContextId	Jedinečný identifikátor instance kontextu 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, o vztazích mezi nimi a o tom, jak se mapují na databázi. Nemusí obsahovat všechny informace potřebné k inicializaci databáze.

Metody

Add(Object)	Začne sledovat danou entitu a všechny ostatní dosažitelné entity, které se ještě nesledují, ve Added stavu, který při zavolání vloží do databáze SaveChanges() .
Add<TEntity>(TEntity)	Začne sledovat danou entitu a všechny ostatní dosažitelné entity, které se ještě nesledují, ve Added stavu, který při zavolání vloží do databáze SaveChanges() .
AddAsync(Object, CancellationToken)	Začne sledovat danou entitu a všechny ostatní dosažitelné entity, které se ještě nesledují, ve Added stavu, který při zavolání vloží do databáze SaveChanges() .
AddAsync<TEntity>(TEntity, CancellationToken)	Začne sledovat danou entitu a všechny ostatní dosažitelné entity, které se ještě nesledují, ve Added stavu, který 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, který 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, který při zavolání vloží do databáze SaveChanges() .
AddRangeAsync(IEnumerable<Object>, CancellationToken)	Začne sledovat danou entitu a všechny ostatní dosažitelné entity, které se ještě nesledují, ve Added stavu, který při zavolání vloží do databáze SaveChanges() .
AddRangeAsync(Object[])	Začne sledovat danou entitu a všechny ostatní dosažitelné entity, které se ještě nesledují, ve Added stavu, který 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 níže najdete informace o 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 níže najdete informace o 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 níže najdete 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 níže najdete případy, kdy se použije jiný stav.
ConfigureConventions(ModelConfigurationBuilder)	Přepsat tuto metodu nastavit výchozí hodnoty a nakonfigurovat konvence před spuštěním. 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á objekt EntityEntry pro danou entitu. Položka poskytuje přístup k informacím a operacím sledování změn pro entitu.
Entry<TEntity>(TEntity)	Získá objekt EntityEntry<TEntity> pro danou entitu. Položka poskytuje přístup k informacím a operacím sledování změn pro entitu.
Find(Type, Object[])	Najde entitu s danými hodnotami primárního klíče. Pokud kontext sleduje entitu s danými hodnotami primárního klíče, vrátí se okamžitě bez požadavku na databázi. V opačném případě se v databázi provede dotaz na entitu s danými hodnotami primárního klíče a tato entita, pokud se najde, připojí se ke kontextu a vrátí se. Pokud se nenajde žádná entita, vrátí se hodnota null.
Find<TEntity>(Object[])	Najde entitu s danými hodnotami primárního klíče. Pokud kontext sleduje entitu s danými hodnotami primárního klíče, vrátí se okamžitě bez požadavku na databázi. V opačném případě se v databázi provede dotaz na entitu s danými hodnotami primárního klíče a tato entita, pokud se najde, připojí se ke kontextu a vrátí se. Pokud se nenajde žádná entita, vrátí se hodnota null.
FindAsync(Type, Object[], CancellationToken)	Najde entitu s danými hodnotami primárního klíče. Pokud kontext sleduje entitu s danými hodnotami primárního klíče, vrátí se okamžitě bez požadavku na databázi. V opačném případě se v databázi provede dotaz na entitu s danými hodnotami primárního klíče a tato entita, pokud se najde, připojí se ke kontextu a vrátí se. Pokud se nenajde žádná entita, vrátí se hodnota null.
FindAsync(Type, Object[])	Najde entitu s danými hodnotami primárního klíče. Pokud kontext sleduje entitu s danými hodnotami primárního klíče, vrátí se okamžitě bez požadavku na databázi. V opačném případě se v databázi provede dotaz na entitu s danými hodnotami primárního klíče a tato entita, pokud se najde, připojí se ke kontextu a vrátí se. Pokud se nenajde žádná entita, vrátí se hodnota null.
FindAsync<TEntity>(Object[], CancellationToken)	Najde entitu s danými hodnotami primárního klíče. Pokud kontext sleduje entitu s danými hodnotami primárního klíče, vrátí se okamžitě bez požadavku na databázi. V opačném případě se v databázi provede dotaz na entitu s danými hodnotami primárního klíče a tato entita, pokud se najde, připojí se ke kontextu a vrátí se. Pokud se nenajde žádná entita, vrátí se hodnota null.
FindAsync<TEntity>(Object[])	Najde entitu s danými hodnotami primárního klíče. Pokud kontext sleduje entitu s danými hodnotami primárního klíče, vrátí se okamžitě bez požadavku na databázi. V opačném případě se v databázi provede dotaz na entitu s danými hodnotami primárního klíče a tato entita, pokud se najde, připojí se ke kontextu a vrátí se. Pokud se nenajde žádná entita, vrátí se hodnota null.
FromExpression<TResult>(Expression<Func<IQueryable<TResult>>>)	Vytvoří dotazovatelný pro daný výraz dotazu.
OnConfiguring(DbContextOptionsBuilder)	Přepište tuto metodu a nakonfigurujte databázi (a další možnosti), která se má použít pro tento kontext. Tato metoda je volána pro každou instanci kontextu, který je vytvořen. Základní implementace nedělá nic.
OnModelCreating(ModelBuilder)	Přepsáním této metody můžete 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, kdy se při zavolání odebere z databáze SaveChanges() .
Remove<TEntity>(TEntity)	Začne sledovat danou entitu Deleted ve stavu, kdy se při zavolání odebere z databáze SaveChanges() .
RemoveRange(IEnumerable<Object>)	Začne sledovat danou entitu Deleted ve stavu, kdy se při zavolání odebere z databáze SaveChanges() .
RemoveRange(Object[])	Začne sledovat danou entitu Deleted ve stavu, kdy se při zavolání odebere z databáze SaveChanges() .
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ří objektDbSet<TEntity>, který lze použít k dotazování a ukládání instancí .TEntity
Set<TEntity>(String)	DbSet<TEntity> Vytvoří typ entity sdíleného typu, který lze použít k dotazování a ukládání instancí TEntity.
Update(Object)	Začne sledovat danou entitu a položky dostupné z dané entity pomocí výchozího Modified stavu, ale níže najdete případy, kdy se použije jiný stav.
Update<TEntity>(TEntity)	Začne sledovat danou entitu a položky dostupné z dané entity pomocí výchozího Modified stavu, ale níže najdete případy, kdy se použije jiný stav.
UpdateRange(IEnumerable<Object>)	Začne sledovat dané entity a položky dostupné z daných entit pomocí výchozího Modified stavu, ale níže najdete případy, kdy se použije jiný stav.
UpdateRange(Object[])	Začne sledovat dané entity a položky dostupné z daných entit pomocí výchozího Modified stavu, ale níže najdete případy, kdy se použije jiný stav.

Událost

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

Explicitní implementace rozhraní

IDbContextDependencies.ChangeDetector	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. V libovolné verzi může být bez upozornění změněna nebo odebrána. Měli byste ho používat přímo v kódu pouze s mimořádnou opatrností a s vědomím, že při aktualizaci na novou verzi Entity Framework Core může dojít k selháním aplikace.
IDbContextDependencies.EntityFinderFactory	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. V libovolné verzi může být bez upozornění změněna nebo odebrána. Měli byste ho používat přímo v kódu pouze s mimořádnou opatrností a s vědomím, že při aktualizaci na novou verzi Entity Framework Core může dojít k selháním aplikace.
IDbContextDependencies.EntityGraphAttacher	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. V libovolné verzi může být bez upozornění změněna nebo odebrána. Měli byste ho používat přímo v kódu pouze s mimořádnou opatrností a s vědomím, že při aktualizaci na novou verzi Entity Framework Core může dojít k selháním aplikace.
IDbContextDependencies.ExceptionDetector	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. V libovolné verzi může být bez upozornění změněna nebo odebrána. Měli byste ho používat přímo v kódu pouze s mimořádnou opatrností a s vědomím, že při aktualizaci na novou verzi Entity Framework Core může dojít k selháním aplikace.
IDbContextDependencies.InfrastructureLogger	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. V libovolné verzi může být bez upozornění změněna nebo odebrána. Měli byste ho používat přímo v kódu pouze s mimořádnou opatrností a s vědomím, že při aktualizaci na novou verzi Entity Framework Core může dojít k selháním aplikace.
IDbContextDependencies.QueryProvider	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. V libovolné verzi může být bez upozornění změněna nebo odebrána. Měli byste ho používat přímo v kódu pouze s mimořádnou opatrností a s vědomím, že při aktualizaci na novou verzi Entity Framework Core může dojít k selháním aplikace.
IDbContextDependencies.SetSource	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. V libovolné verzi může být bez upozornění změněna nebo odebrána. Měli byste ho používat přímo v kódu pouze s mimořádnou opatrností a s vědomím, že při aktualizaci na novou verzi Entity Framework Core může dojít k selháním aplikace.
IDbContextDependencies.StateManager	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. V libovolné verzi může být bez upozornění změněna nebo odebrána. Měli byste ho používat přímo v kódu pouze s mimořádnou opatrností a s vědomím, že při aktualizaci na novou verzi Entity Framework Core může dojít k selháním aplikace.
IDbContextDependencies.UpdateLogger	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. V libovolné verzi může být bez upozornění změněna nebo odebrána. Měli byste ho používat přímo v kódu pouze s mimořádnou opatrností a s vědomím, že při aktualizaci na novou verzi Entity Framework Core může dojít k selháním aplikace.
IDbContextPoolable.ClearLease()	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. V libovolné verzi může být bez upozornění změněna nebo odebrána. Měli byste ho používat přímo v kódu pouze s mimořádnou opatrností a s vědomím, že při aktualizaci na novou verzi Entity Framework Core může dojít k selháním aplikace.
IDbContextPoolable.SetLease(DbContextLease)	Toto je interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez předchozího upozornění v jakékoli verzi. Měli byste ho používat přímo v kódu pouze s extrémní opatrností a s vědomím, že to může vést k selhání aplikací při aktualizaci na novou verzi Entity Framework Core.
IDbContextPoolable.SetLeaseAsync(DbContextLease, CancellationToken)	Toto je interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez předchozího upozornění v jakékoli verzi. Měli byste ho používat přímo v kódu pouze s extrémní opatrností a s vědomím, že to může vést k selhání aplikací při aktualizaci na novou verzi Entity Framework Core.
IDbContextPoolable.SnapshotConfiguration()	Toto je interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez předchozího upozornění v jakékoli verzi. Měli byste ho používat přímo v kódu pouze s extrémní opatrností a s vědomím, že to může vést k selhání aplikací při aktualizaci na novou verzi Entity Framework Core.
IDbSetCache.GetOrAddSet(IDbSetSource, String, Type)	Toto je interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez předchozího upozornění v jakékoli verzi. Měli byste ho používat přímo v kódu pouze s extrémní opatrností a s vědomím, že to může vést k selhání aplikací při aktualizaci na novou verzi Entity Framework Core.
IDbSetCache.GetOrAddSet(IDbSetSource, Type)	Toto je interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez předchozího upozornění v jakékoli verzi. Měli byste ho používat přímo v kódu pouze s extrémní opatrností a s vědomím, že to může vést k selhání aplikací při aktualizaci na novou verzi Entity Framework Core.
IDbSetCache.GetSets()	Toto je interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez předchozího upozornění v jakékoli verzi. Měli byste ho používat přímo v kódu pouze s extrémní opatrností a s vědomím, že to může vést k selhání aplikací při aktualizaci na novou verzi Entity Framework Core.
IInfrastructure<IServiceProvider>.Instance	Získá vymezený IServiceProvider , který se používá k překladu služeb. Tato vlastnost je určená k použití rozšiřujícími metodami, které potřebují využívat služby, které nejsou přímo vystavené na veřejném prostoru rozhraní API.
IResettableService.ResetState()	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. V libovolné verzi může být bez upozornění změněna nebo odebrána. Měli byste ho používat přímo v kódu pouze s mimořádnou opatrností a s vědomím, že při aktualizaci na novou verzi Entity Framework Core může dojít k selháním aplikace.
IResettableService.ResetStateAsync(CancellationToken)	Jedná se o interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. V libovolné verzi může být bez upozornění změněna nebo odebrána. Měli byste ho používat přímo v kódu pouze s mimořádnou opatrností a s vědomím, že při aktualizaci na novou verzi Entity Framework Core může dojít k selháním aplikace.

Metody rozšíření

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