Classe HistoryContext

Articolo
12/18/2014

[Questa pagina è specifica della versione 6 di Entity Framework. La versione più recente è disponibile come pacchetto NuGet per "Entity Framework". Per ulteriori informazioni su Entity Framework, vedere la pagina msdn.com/data/ef.]

Questa classe viene utilizzata da Migrazioni Code First per leggere e scrivere la cronologia delle migrazioni dal database. Per personalizzare la definizione della tabella relativa alla cronologia delle migrazioni, è possibile derivare da questa classe ed eseguire l'override di OnModelCreating. Le istanze derivate possono essere registrate in base alla configurazione delle migrazioni tramite SetHistoryContextFactory(String, Func<DbConnection, String, HistoryContext>) o a livello globale tramite SetDefaultHistoryContext(Func<DbConnection, String, HistoryContext>).

Gerarchia di ereditarietà

System.Object
System.Data.Entity.DbContext
System.Data.Entity.Migrations.History.HistoryContext

Spazio dei nomi: System.Data.Entity.Migrations.History
Assembly: EntityFramework (in EntityFramework.dll)

Sintassi

'Dichiarazione
Public Class HistoryContext _
    Inherits DbContext _
    Implements IDbModelCacheKeyProvider
'Utilizzo
Dim instance As HistoryContext

public class HistoryContext : DbContext, 
    IDbModelCacheKeyProvider

public ref class HistoryContext : public DbContext, 
    IDbModelCacheKeyProvider

type HistoryContext =  
    class 
        inherit DbContext 
        interface IDbModelCacheKeyProvider 
    end

public class HistoryContext extends DbContext implements IDbModelCacheKeyProvider

Il tipo HistoryContext espone i seguenti membri.

Costruttori

	rapporti	Descrizione
	HistoryContext	Inizializza una nuova istanza della classe HistoryContext.Per creare un contesto di cronologia derivato, in genere viene esposto un costruttore che accetta questi stessi parametri e li passa al costruttore base.

In alto

Proprietà

	rapporti	Descrizione
	CacheKey	Ottiene la chiave utilizzata per trovare un modello compilato in precedenza per questo contesto.Utilizzato per evitare l'elaborazione di OnModelCreating e il calcolo del modello ogni volta che viene creata una nuova istanza di contesto.Per impostazione predefinita, questa proprietà restituisce lo schema predefinito.Nella maggior parte dei casi, non è necessario eseguire l'override di questa proprietà.Se, tuttavia, l'implementazione di OnModelCreating contiene logica condizionale che restituisce un modello diverso compilato per lo schema predefinito e lo stesso provider di database, è necessario eseguire l'override di questa proprietà e calcolare una chiave appropriata.
	ChangeTracker	Fornisce l'accesso alle funzionalità del contesto che gestiscono il rilevamento delle modifiche delle entità. (Ereditato da DbContext)
	Configuration	Fornisce l'accesso alle opzioni di configurazione del contesto. (Ereditato da DbContext)
	Database	Crea un'istanza del database per questo contesto che consente i controlli di creazione, eliminazione e presenza per il database sottostante. (Ereditato da DbContext)
	DefaultSchema	Ottiene lo schema predefinito del modello di cui viene eseguita la migrazione.Questo schema verrà utilizzato per la tabella relativa alla cronologia delle migrazioni a meno che in OnModelCreating non sia stato configurato uno schema diverso.
	History	Ottiene o imposta un oggetto DbSet<TEntity> da utilizzare per leggere e scrivere istanze di HistoryRow.

In alto

Metodi

	rapporti	Descrizione
	Dispose()	Chiama il metodo Dispose protetto. (Ereditato da DbContext)
	Dispose(Boolean)	Elimina il contesto.Viene eliminato anche l'oggetto ObjectContext sottostante se è stato creato da questo contesto o se la proprietà è stata passata a questo contesto alla creazione del contesto.La connessione al database (oggetto DbConnection) viene eliminata anche se è stata creata da tale contesto o se la proprietà è stata passata a questo contesto durante la creazione dello stesso. (Ereditato da DbContext)
	Entry(Object)	Ottiene un oggetto DbEntityEntry per l'entità specificata che fornisce l'accesso alle informazioni sull'entità e la possibilità di eseguire azioni sull'entità. (Ereditato da DbContext)
	Entry<TEntity>(TEntity)	Ottiene un oggetto DbEntityEntry<TEntity> per l'entità specificata che fornisce l'accesso alle informazioni sull'entità e la possibilità di eseguire azioni sull'entità. (Ereditato da DbContext)
	Equals	Determina se l'oggetto DbContext specificato è uguale all'oggetto DbContext corrente. (Ereditato da DbContext)
	Finalize	(Ereditato da Object)
	GetHashCode	Restituisce la funzione hash per questo oggetto DBContext. (Ereditato da DbContext)
	GetType	Restituisce il tipo per l'oggetto DbContext corrente. (Ereditato da DbContext)
	GetValidationErrors	Convalida le entità rilevate e restituisce una raccolta di DbEntityValidationResult che contiene i risultati della convalida. (Ereditato da DbContext)
	MemberwiseClone	(Ereditato da Object)
	OnModelCreating	Applica la configurazione predefinita per la tabella relativa alla cronologia delle migrazioni.Se si esegue l'override di questo metodo, è consigliabile chiamare questa implementazione di base prima di applicare la configurazione personalizzata. (Esegue l'override di DbContext.OnModelCreating(DbModelBuilder)).
	SaveChanges	Salva tutte le modifiche apportate in questo contesto nel database sottostante. (Ereditato da DbContext)
	SaveChangesAsync()	Salva in modo asincrono tutte le modifiche apportate in questo contesto nel database sottostante. (Ereditato da DbContext)
	SaveChangesAsync(CancellationToken)	Salva in modo asincrono tutte le modifiche apportate in questo contesto nel database sottostante. (Ereditato da DbContext)
	Set(Type)	Restituisce un'istanza di DbSet non generica per l'accesso alle entità del tipo specificato nel contesto e all'archivio sottostante. (Ereditato da DbContext)
	Set<TEntity>()	Restituisce un'istanza di DbSet<TEntity> per l'accesso alle entità del tipo specificato nel contesto e all'archivio sottostante. (Ereditato da DbContext)
	ShouldValidateEntity	Punto di estensione che consente all'utente di eseguire l'override del comportamento predefinito della convalida solo delle entità Added e Modified. (Ereditato da DbContext)
	ToString	Restituisce la rappresentazione in forma di stringa dell'oggetto DbContext. (Ereditato da DbContext)
	ValidateEntity	Punto di estensione che consente all'utente di personalizzare la convalida di un'entità o di filtrare i risultati della convalida.Chiamato da GetValidationErrors(). (Ereditato da DbContext)