DataContext Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt den Haupteinstiegspunkt für das LINQ to SQL-Framework dar.
public ref class DataContext : IDisposable
public class DataContext : IDisposable
type DataContext = class
interface IDisposable
Public Class DataContext
Implements IDisposable
- Vererbung
-
DataContext
- Implementiert
Hinweise
ist DataContext die Quelle aller Entitäten, die über eine Datenbankverbindung zugeordnet sind. Es verfolgt Änderungen nach, die Sie an allen abgerufenen Entitäten vorgenommen haben, und verwaltet einen "Identitätscache", der garantiert, dass Entitäten, die mehr als einmal abgerufen wurden, mithilfe desselben Objekts instance dargestellt werden.
Im Allgemeinen ist ein DataContext instance für eine "Arbeitseinheit" konzipiert, aber Ihre Anwendung definiert diesen Begriff. Ein DataContext ist einfach und nicht teuer zu erstellen. Eine typische LINQ to SQL Anwendung erstellt DataContext Instanzen im Methodenbereich oder als Member von kurzlebigen Klassen, die einen logischen Satz verwandter Datenbankvorgänge darstellen.
Konstruktoren
DataContext(IDbConnection) |
Initialisiert eine neue instance der DataContext -Klasse, indem auf die verbindung verwiesen wird, die vom .NET Framework verwendet wird. |
DataContext(IDbConnection, MappingSource) |
Initialisiert durch das Verweisen auf eine Verbindung und eine Zuordnungsquelle eine neue Instanz der DataContext-Klasse. |
DataContext(String) |
Initialisiert eine neue Instanz der DataContext-Klasse durch Verweisen auf eine Dateiquelle. |
DataContext(String, MappingSource) |
Initialisiert durch das Verweisen auf eine Dateiquelle und eine Zuordnungsquelle eine neue Instanz der DataContext-Klasse. |
Eigenschaften
ChangeConflicts |
Ruft eine Auflistung von Objekten ab, die beim Aufrufen von SubmitChanges() Parallelitätskonflikte verursacht haben. |
CommandTimeout |
Ruft einen Wert ab (oder legt diesen fest), der das Zeitlimit (in Sekunden) für Abfragen erhöht, die andernfalls während der Standardzeitspanne zu einem Timeout führen würden. |
Connection |
Ruft die vom Framework verwendete Verbindung ab. |
DeferredLoadingEnabled |
Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob für 1:n- oder 1:1-Beziehungen ein verzögertes Laden stattfinden soll. |
LoadOptions |
Ruft die DataLoadOptions ab, die diesem DataContext zugeordnet sind, oder legt diese fest. |
Log |
Ruft das Ziel zum Schreiben der SQL-Abfrage oder des Befehls ab oder legt es fest. |
Mapping |
Ruft das MetaModel ab, auf dem die Zuordnung basiert. |
ObjectTrackingEnabled |
Ruft einen Wert ab, der angibt, ob die Objektnachverfolgung aktiviert ist, oder legt den Wert fest. |
Transaction |
Ruft eine lokale Transaktion für die .NET Framework ab, die für den Zugriff auf die Datenbank verwendet werden soll, oder legt diese fest. |
Methoden
CreateDatabase() |
Erstellt eine Datenbank auf dem Server. |
CreateMethodCallQuery<TResult>(Object, MethodInfo, Object[]) |
Führt die der angegebenen .NET-Methode zugeordnete Tabellenwert-Datenbankfunktion aus. |
DatabaseExists() |
Bestimmt, ob die zugeordnete Datenbank geöffnet werden kann. |
DeleteDatabase() |
Löscht die zugeordnete Datenbank. |
Dispose() |
Gibt alle von der aktuellen Instanz der DataContext-Klasse verwendeten Ressourcen frei. |
Dispose(Boolean) |
Gibt die von der DataContext-Klasse verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressource frei. |
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
ExecuteCommand(String, Object[]) |
Führt SQL-Befehle direkt in der Datenbank aus. |
ExecuteDynamicDelete(Object) |
Führt innerhalb von Delete-Außerkraftsetzungsmethoden aus, um LINQ to SQL die Aufgabe des Generierens und Ausführens von dynamischem SQL für Löschvorgänge neu zu definieren. |
ExecuteDynamicInsert(Object) |
Führt in insert override-Methoden aus, um die LINQ to SQL die Aufgabe des Generierens und Ausführens dynamischer SQL für Einfügevorgänge neu zu definieren. |
ExecuteDynamicUpdate(Object) |
Führt innerhalb von Updateüberschreibungsmethoden aus, um die LINQ to SQL aufgabe des Generierens und Ausführens dynamischer SQL für Updatevorgänge neu zu definieren. |
ExecuteMethodCall(Object, MethodInfo, Object[]) |
Führt die der angegebenen .NET-Methode zugeordnete gespeicherte Datenbankprozedur oder Skalarfunktion aus. |
ExecuteQuery(Type, String, Object[]) |
Führt SQL-Abfragen direkt in der Datenbank aus. |
ExecuteQuery<TResult>(String, Object[]) |
Führt SQL-Abfragen direkt in der Datenbank aus und gibt Objekte zurück. |
GetChangeSet() |
Ruft die geänderten Objekte ab, die von DataContext nachverfolgt werden. |
GetCommand(IQueryable) |
Ruft die Informationen zu SQL-Befehlen ab, die von LINQ to SQL generiert werden. |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetTable(Type) |
Gibt eine Auflistung von Objekten eines bestimmten Typs zurück; der Typ wird vom |
GetTable<TEntity>() |
Gibt eine Auflistung von Objekten eines bestimmten Typs zurück; der Typ wird vom |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
Refresh(RefreshMode, IEnumerable) |
Aktualisiert eine Auflistung von Entitätsobjekten anhand des angegebenen Modus. |
Refresh(RefreshMode, Object) |
Aktualisiert ein Entitätsobjekt anhand des angegebenen Modus. |
Refresh(RefreshMode, Object[]) |
Aktualisiert ein Array von Entitätsobjekten anhand des angegebenen Modus. |
SubmitChanges() |
Berechnet die geänderten Objekte, die eingefügt, aktualisiert oder gelöscht werden sollen, und führt die entsprechenden Befehle zur Implementierung der Änderungen für die Datenbank aus. |
SubmitChanges(ConflictMode) |
Sendet Änderungen an abgerufenen Objekten an die zugrunde liegende Datenbank und gibt die Aktion an, die bei einem Fehler ausgeführt werden soll. |
ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Translate(DbDataReader) |
Konvertiert einen vorhandenen DbDataReader in Objekte. |
Translate(Type, DbDataReader) |
Konvertiert einen vorhandenen DbDataReader in Objekte. |
Translate<TResult>(DbDataReader) |
Konvertiert einen vorhandenen DbDataReader in Objekte. |