DataContext Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje hlavní vstupní bod pro architekturu LINQ to SQL.
public ref class DataContext : IDisposable
public class DataContext : IDisposable
type DataContext = class
interface IDisposable
Public Class DataContext
Implements IDisposable
- Dědičnost
-
DataContext
- Implementuje
Poznámky
Je DataContext zdrojem všech entit namapovaných přes připojení k databázi. Sleduje změny, které jste udělali ve všech načtených entitách, a udržuje "mezipaměť identit", která zaručuje, že entity načtené více než jednou budou reprezentovány pomocí stejné instance objektu.
Obecně platí, že instance je navržená tak, aby vydržela jednu "jednotku práce", DataContext ale aplikace tento termín definuje. Je DataContext jednoduchý a jeho vytvoření není nákladné. Typická LINQ to SQL aplikace vytváří DataContext instance v oboru metody nebo jako člen krátkodobých tříd, které představují logickou sadu souvisejících databázových operací.
Konstruktory
DataContext(IDbConnection) |
Inicializuje novou instanci DataContext třídy odkazem na připojení používané rozhraním .NET Framework. |
DataContext(IDbConnection, MappingSource) |
Inicializuje novou instanci DataContext třídy odkazováním na připojení a zdroj mapování. |
DataContext(String) |
Inicializuje novou instanci DataContext třídy odkazem na zdroj souboru. |
DataContext(String, MappingSource) |
Inicializuje novou instanci DataContext třídy odkazem na zdroj souboru a zdroj mapování. |
Vlastnosti
ChangeConflicts |
Získá kolekci objektů, které způsobily konflikty souběžnosti při SubmitChanges() zavolání. |
CommandTimeout |
Získá nebo nastaví hodnotu, která zvyšuje časový limit (v sekundách) pro dotazy, které by jinak vypršel časový limit během výchozího časového limitu. |
Connection |
Získá připojení používané architekturou. |
DeferredLoadingEnabled |
Získá nebo nastaví hodnotu, která označuje, zda zpoždění a načtení 1:N nebo 1-k-1 relace. |
LoadOptions |
Získá nebo nastaví přidružený k DataLoadOptions tomuto DataContext. |
Log |
Získá nebo nastaví cíl pro zápis dotazu nebo příkazu SQL. |
Mapping |
Získá, MetaModel na kterém je mapování založeno. |
ObjectTrackingEnabled |
Získá nebo nastaví hodnotu, která označuje, zda je povoleno sledování objektů. |
Transaction |
Získá nebo nastaví místní transakce pro rozhraní .NET Framework pro přístup k databázi. |
Metody
CreateDatabase() |
Vytvoří databázi na serveru. |
CreateMethodCallQuery<TResult>(Object, MethodInfo, Object[]) |
Spustí funkci databáze s hodnotou tabulky přidruženou k zadané metodě .NET. |
DatabaseExists() |
Určuje, zda lze otevřít přidruženou databázi. |
DeleteDatabase() |
Odstraní přidruženou databázi. |
Dispose() |
Uvolní všechny prostředky používané aktuální instancí DataContext třídy. |
Dispose(Boolean) |
Uvolní nespravované prostředky používané DataContext třídou a volitelně uvolní spravovaný prostředek. |
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
ExecuteCommand(String, Object[]) |
Spouští příkazy SQL přímo v databázi. |
ExecuteDynamicDelete(Object) |
Provede v rámci metod přepsání odstranění předefinované delegování na LINQ to SQL úlohy generování a spouštění dynamického SQL pro operace odstranění. |
ExecuteDynamicInsert(Object) |
Provádí v rámci metod přepsání vložení k opětovnému odstranění LINQ to SQL úlohy generování a spouštění dynamického SQL pro operace vložení. |
ExecuteDynamicUpdate(Object) |
Provede v rámci metod přepsání aktualizací předefinované delegování na LINQ to SQL úlohy generování a spouštění dynamického SQL pro operace aktualizace. |
ExecuteMethodCall(Object, MethodInfo, Object[]) |
Spustí uloženou databázový proceduru nebo skalární funkci přidruženou k zadané metodě .NET. |
ExecuteQuery(Type, String, Object[]) |
Provádí dotazy SQL přímo v databázi. |
ExecuteQuery<TResult>(String, Object[]) |
Spouští dotazy SQL přímo v databázi a vrací objekty. |
GetChangeSet() |
Získá změněné objekty sledované pomocí DataContext. |
GetCommand(IQueryable) |
Získá informace o příkazech SQL vygenerovaných LINQ to SQL. |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetTable(Type) |
Vrátí kolekci objektů určitého typu, kde typ je definován parametrem |
GetTable<TEntity>() |
Vrátí kolekci objektů určitého typu, kde typ je definován parametrem |
GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
Refresh(RefreshMode, IEnumerable) |
Aktualizuje kolekci objektů entit podle zadaného režimu. |
Refresh(RefreshMode, Object) |
Aktualizuje objekt entity podle zadaného režimu. |
Refresh(RefreshMode, Object[]) |
Aktualizuje pole objektů entit podle zadaného režimu. |
SubmitChanges() |
Vypočítá sadu upravených objektů, které se mají vložit, aktualizovat nebo odstranit, a spustí příslušné příkazy pro implementaci změn v databázi. |
SubmitChanges(ConflictMode) |
Odešle změny provedené u načtených objektů do podkladové databáze a určuje akci, která se má provést v případě selhání odeslání. |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
Translate(DbDataReader) |
Převede existující DbDataReader objekt na objekty. |
Translate(Type, DbDataReader) |
Převede existující DbDataReader objekt na objekty. |
Translate<TResult>(DbDataReader) |
Převede existující DbDataReader objekt na objekty. |