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
Dies DataContext ist die Quelle aller Entitäten, die über eine Datenbankverbindung zugeordnet sind. Es verfolgt Änderungen, die Sie an allen abgerufenen Entitäten vorgenommen haben, und verwaltet einen "Identitätscache", der garantiert, dass entitäten, die mehrere Mal abgerufen wurden, mithilfe derselben Objektinstanz dargestellt werden.
Im Allgemeinen ist eine DataContext Instanz so konzipiert, dass sie für eine "Arbeitseinheit" verwendet werden kann, aber Ihre Anwendung definiert diesen Begriff. A DataContext ist leicht und ist nicht teuer zu erstellen. Eine typische LINQ to SQL-Anwendung erstellt DataContext Instanzen im Methodenbereich oder als Mitglied von kurzlebigen Klassen, die einen logischen Satz verwandter Datenbankvorgänge darstellen.
Konstruktoren
| Name | Beschreibung |
|---|---|
| DataContext(IDbConnection, MappingSource) |
Initialisiert eine neue Instanz der DataContext Klasse, indem auf eine Verbindung und eine Zuordnungsquelle verwiesen wird. |
| DataContext(IDbConnection) |
Initialisiert eine neue Instanz der klasse DataContext, indem auf die vom .NET Framework verwendete Verbindung verwiesen wird. |
| DataContext(String, MappingSource) |
Initialisiert eine neue Instanz der DataContext Klasse, indem auf eine Dateiquelle und eine Zuordnungsquelle verwiesen wird. |
| DataContext(String) |
Initialisiert eine neue Instanz der DataContext Klasse, indem auf eine Dateiquelle verwiesen wird. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| ChangeConflicts |
Ruft eine Auflistung von Objekten ab, die Parallelitätskonflikte SubmitChanges() beim Aufrufen verursacht haben. |
| CommandTimeout |
Dient zum Abrufen oder Festlegen eines Werts, der den Timeoutzeitraum (in Sekunden) für Abfragen erhöht, die andernfalls während des Standardtimeoutzeitraums zeitüberschreitungen würden. |
| Connection |
Ruft die vom Framework verwendete Verbindung ab. |
| DeferredLoadingEnabled |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob 1:n- oder 1:1-Beziehungen verzögert werden sollen. |
| LoadOptions |
Dient zum Abrufen oder Festlegen des DataLoadOptions zugeordneten Werts DataContext. |
| Log |
Ruft ab oder legt das Ziel fest, um die SQL-Abfrage oder den Befehl zu schreiben. |
| Mapping |
Ruft ab MetaModel , auf der die Zuordnung basiert. |
| ObjectTrackingEnabled |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Objektverfolgung aktiviert ist. |
| Transaction |
Dient zum Abrufen oder Festlegen einer lokalen Transaktion für das .NET Framework für den Zugriff auf die Datenbank. |
Methoden
| Name | Beschreibung |
|---|---|
| CreateDatabase() |
Erstellt eine Datenbank auf dem Server. |
| CreateMethodCallQuery<TResult>(Object, MethodInfo, Object[]) |
Führt die Tabellenwertdatenbankfunktion aus, die der angegebenen .NET-Methode zugeordnet ist. |
| DatabaseExists() |
Bestimmt, ob die zugeordnete Datenbank geöffnet werden kann. |
| DeleteDatabase() |
Löscht die zugeordnete Datenbank. |
| Dispose() |
Gibt alle Ressourcen frei, die von der aktuellen Instanz der DataContext Klasse verwendet werden. |
| Dispose(Boolean) |
Gibt die von der DataContext Klasse verwendeten nicht verwalteten Ressourcen frei und gibt optional die verwaltete 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-Überschreibungsmethoden aus, um LINQ to SQL neu zu definieren, um die Aufgabe zum Generieren und Ausführen dynamischer SQL für Löschvorgänge zu generieren und auszuführen. |
| ExecuteDynamicInsert(Object) |
Führt innerhalb von Insert-Überschreibungsmethoden aus, um LINQ to SQL neu zu definieren, um die Aufgabe zum Generieren und Ausführen von dynamischem SQL für Einfügevorgänge zu generieren und auszuführen. |
| ExecuteDynamicUpdate(Object) |
Führt innerhalb von Updateüberschreibungsmethoden aus, um LINQ to SQL neu zu deaktivieren, um die Aufgabe zum Generieren und Ausführen dynamischer SQL für Aktualisierungsvorgänge zu generieren und auszuführen. |
| ExecuteMethodCall(Object, MethodInfo, Object[]) |
Führt die gespeicherte Datenbankprozedur oder skalare Funktion aus, die der angegebenen .NET-Methode zugeordnet ist. |
| 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. |
| GetCommand(IQueryable) |
Ruft die Informationen zu SQL-Befehlen ab, die von LINQ to SQL generiert werden. |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetTable(Type) |
Gibt eine Auflistung von Objekten eines bestimmten Typs zurück, wobei der Typ durch den |
| GetTable<TEntity>() |
Gibt eine Auflistung von Objekten eines bestimmten Typs zurück, wobei der Typ durch den |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| Refresh(RefreshMode, IEnumerable) |
Aktualisiert eine Auflistung von Entitätsobjekten gemäß dem angegebenen Modus. |
| Refresh(RefreshMode, Object) |
Aktualisiert ein Entitätsobjekt gemäß dem angegebenen Modus. |
| Refresh(RefreshMode, Object[]) |
Aktualisiert ein Array von Entitätsobjekten gemäß dem angegebenen Modus. |
| SubmitChanges() |
Berechnet den Satz geänderter Objekte, die eingefügt, aktualisiert oder gelöscht werden sollen, und führt die entsprechenden Befehle aus, um die Änderungen an der Datenbank zu implementieren. |
| SubmitChanges(ConflictMode) |
Sendet Änderungen, die an abgerufenen Objekten an die zugrunde liegende Datenbank vorgenommen wurden, und gibt die auszuführende Aktion an, wenn die Übermittlung fehlschlägt. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| Translate(DbDataReader) |
Konvertiert eine vorhandene DbDataReader in Objekte. |
| Translate(Type, DbDataReader) |
Konvertiert eine vorhandene DbDataReader in Objekte. |
| Translate<TResult>(DbDataReader) |
Konvertiert eine vorhandene DbDataReader in Objekte. |