DataContext Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta il punto di ingresso principale per il framework LINQ to SQL.
public ref class DataContext : IDisposable
public class DataContext : IDisposable
type DataContext = class
interface IDisposable
Public Class DataContext
Implements IDisposable
- Ereditarietà
-
DataContext
- Implementazioni
Commenti
DataContext è l'origine di tutte le entità mappate su una connessione di database. Tiene traccia delle modifiche apportate a tutte le entità recuperate e mantiene una "cache delle identità" che garantisce che le entità recuperate più volte siano rappresentate usando la stessa istanza dell'oggetto.
In generale, un'istanza DataContext di è progettata per durare per una "unità di lavoro", tuttavia l'applicazione definisce tale termine. Un DataContext è leggero e non è costoso da creare. Un'applicazione LINQ to SQL tipica crea DataContext istanze nell'ambito del metodo o come membro di classi di breve durata che rappresentano un set logico di operazioni correlate al database.
Costruttori
| Nome | Descrizione |
|---|---|
| DataContext(IDbConnection, MappingSource) |
Inizializza una nuova istanza della DataContext classe facendo riferimento a una connessione e a un'origine di mapping. |
| DataContext(IDbConnection) |
Inizializza una nuova istanza della classe DataContext facendo riferimento alla connessione utilizzata da .NET Framework. |
| DataContext(String, MappingSource) |
Inizializza una nuova istanza della DataContext classe facendo riferimento a un'origine file e a un'origine di mapping. |
| DataContext(String) |
Inizializza una nuova istanza della DataContext classe facendo riferimento a un'origine file. |
Proprietà
| Nome | Descrizione |
|---|---|
| ChangeConflicts |
Ottiene una raccolta di oggetti che hanno causato conflitti di concorrenza quando SubmitChanges() è stato chiamato . |
| CommandTimeout |
Ottiene o imposta un valore che aumenta il periodo di timeout (in secondi) per le query che altrimenti si verificavano durante il periodo di timeout predefinito. |
| Connection |
Ottiene la connessione utilizzata dal framework. |
| DeferredLoadingEnabled |
Ottiene o imposta un valore che indica se ritardare il caricamento di relazioni uno-a-molti o uno-a-uno. |
| LoadOptions |
Ottiene o imposta l'oggetto associato all'oggetto DataLoadOptionsDataContext. |
| Log |
Ottiene o imposta la destinazione per scrivere la query o il comando SQL. |
| Mapping |
Ottiene l'oggetto MetaModel su cui si basa il mapping. |
| ObjectTrackingEnabled |
Ottiene o imposta un valore che indica se il rilevamento degli oggetti è abilitato. |
| Transaction |
Ottiene o imposta una transazione locale per il framework di .NET da utilizzare per accedere al database. |
Metodi
| Nome | Descrizione |
|---|---|
| CreateDatabase() |
Crea un database nel server. |
| CreateMethodCallQuery<TResult>(Object, MethodInfo, Object[]) |
Esegue la funzione di database con valori di tabella associata al metodo di .NET specificato. |
| DatabaseExists() |
Determina se il database associato può essere aperto. |
| DeleteDatabase() |
Elimina il database associato. |
| Dispose() |
Rilascia tutte le risorse usate dall'istanza corrente della DataContext classe . |
| Dispose(Boolean) |
Rilascia le risorse non gestite usate dalla DataContext classe e, facoltativamente, rilascia la risorsa gestita. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| ExecuteCommand(String, Object[]) |
Esegue i comandi SQL direttamente nel database. |
| ExecuteDynamicDelete(Object) |
Viene eseguito, all'interno dei metodi di override delete, per ridistribuire linQ to SQL l'attività di generazione ed esecuzione di SQL dinamico per le operazioni di eliminazione. |
| ExecuteDynamicInsert(Object) |
Esegue, all'interno dei metodi di override di inserimento, per ridistribuire in LINQ to SQL l'attività di generazione ed esecuzione di SQL dinamico per le operazioni di inserimento. |
| ExecuteDynamicUpdate(Object) |
Viene eseguito, all'interno dei metodi di override degli aggiornamenti, per ridistribuire in LINQ to SQL l'attività di generazione ed esecuzione di SQL dinamico per le operazioni di aggiornamento. |
| ExecuteMethodCall(Object, MethodInfo, Object[]) |
Esegue la stored procedure del database o la funzione scalare associata al metodo di .NET specificato. |
| ExecuteQuery(Type, String, Object[]) |
Esegue query SQL direttamente nel database. |
| ExecuteQuery<TResult>(String, Object[]) |
Esegue query SQL direttamente nel database e restituisce oggetti . |
| GetChangeSet() |
Ottiene gli oggetti modificati rilevati da DataContext. |
| GetCommand(IQueryable) |
Ottiene le informazioni sui comandi SQL generati da LINQ to SQL. |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetTable(Type) |
Restituisce una raccolta di oggetti di un particolare tipo, in cui il tipo è definito dal |
| GetTable<TEntity>() |
Restituisce una raccolta di oggetti di un particolare tipo, in cui il tipo è definito dal |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| Refresh(RefreshMode, IEnumerable) |
Aggiorna una raccolta di oggetti entità in base alla modalità specificata. |
| Refresh(RefreshMode, Object) |
Aggiorna un oggetto entità in base alla modalità specificata. |
| Refresh(RefreshMode, Object[]) |
Aggiorna una matrice di oggetti entità in base alla modalità specificata. |
| SubmitChanges() |
Calcola il set di oggetti modificati da inserire, aggiornare o eliminare ed esegue i comandi appropriati per implementare le modifiche apportate al database. |
| SubmitChanges(ConflictMode) |
Invia le modifiche apportate agli oggetti recuperati al database sottostante e specifica l'azione da eseguire se l'invio non riesce. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| Translate(DbDataReader) |
Converte un oggetto esistente DbDataReader in oggetti . |
| Translate(Type, DbDataReader) |
Converte un oggetto esistente DbDataReader in oggetti . |
| Translate<TResult>(DbDataReader) |
Converte un oggetto esistente DbDataReader in oggetti . |