Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

DataContext-Klasse

Stellt den Haupteinstiegspunkt für das LINQ to SQL-Framework dar.

System.Object
  System.Data.Linq.DataContext

Namespace:  System.Data.Linq
Assembly:  System.Data.Linq (in System.Data.Linq.dll)
public class DataContext : IDisposable

Der DataContext-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Öffentliche Methode DataContext(IDbConnection) Initialisiert eine neue Instanz der DataContext-Klasse durch Verweisen auf die Verbindung, die von .NET Framework verwendet wird.
Öffentliche Methode DataContext(String) Initialisiert eine neue Instanz der DataContext-Klasse durch Verweisen auf eine Dateiquelle.
Öffentliche Methode DataContext(IDbConnection, MappingSource) Initialisiert durch das Verweisen auf eine Verbindung und eine Zuordnungsquelle eine neue Instanz der DataContext-Klasse.
Öffentliche Methode DataContext(String, MappingSource) Initialisiert durch das Verweisen auf eine Dateiquelle und eine Zuordnungsquelle eine neue Instanz der DataContext-Klasse.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Eigenschaft ChangeConflicts Gibt eine Auflistung von Objekten zurück, die beim Aufrufen von SubmitChanges Parallelitätskonflikte verursacht haben.
Öffentliche Eigenschaft CommandTimeout Erhöht den Timeoutwert für Abfragen, die andernfalls während der Standardtimeoutspanne zu einem Timeout führen würden.
Öffentliche Eigenschaft Connection Gibt die vom Framework verwendete Verbindung zurück.
Öffentliche Eigenschaft DeferredLoadingEnabled Gibt an, ob 1:n-Beziehungen oder 1:1-Beziehungen mit Verzögerung geladen werden sollen.
Öffentliche Eigenschaft LoadOptions Ruft die DataLoadOptions ab, die diesem DataContext zugeordnet sind, oder legt diese fest.
Öffentliche Eigenschaft Log Gibt das Ziel zum Schreiben der SQL-Abfrage oder des Befehls an.
Öffentliche Eigenschaft Mapping Gibt das MetaModel zurück, auf dem die Zuordnung basiert.
Öffentliche Eigenschaft ObjectTrackingEnabled Weist das Framework an, den ursprünglichen Wert und die ursprüngliche Objektidentität für diesen DataContext nachzuverfolgen.
Öffentliche Eigenschaft Transaction Legt eine lokale Transaktion für .NET Framework fest, um auf die Datenbank zuzugreifen.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode CreateDatabase Erstellt eine Datenbank auf dem Server.
Geschützte Methode CreateMethodCallQuery<TResult> Infrastruktur. Führt die der angegebenen CLR-Methode zugeordnete Tabellenwert-Datenbankfunktion aus.
Öffentliche Methode DatabaseExists Bestimmt, ob die zugeordnete Datenbank geöffnet werden kann.
Öffentliche Methode DeleteDatabase Löscht die zugeordnete Datenbank.
Öffentliche Methode Dispose() Gibt sämtliche von DataContext verwendeten Ressourcen frei.
Geschützte Methode Dispose(Boolean) Gibt die vom DataContext verwendeten Ressourcen frei.
Öffentliche Methode Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Öffentliche Methode ExecuteCommand Führt SQL-Befehle direkt in der Datenbank aus.
Geschützte Methode ExecuteDynamicDelete Wird in Überschreibungsmethoden zum Löschen aufgerufen, um das Generieren und Ausführen von dynamischem SQL für Löschvorgänge an LINQ to SQL zu delegieren.
Geschützte Methode ExecuteDynamicInsert Wird in Überschreibungsmethoden zum Einfügen aufgerufen, um das Generieren und Ausführen von dynamischem SQL für Einfügevorgänge an LINQ to SQL zu delegieren.
Geschützte Methode ExecuteDynamicUpdate Wird in Überschreibungsmethoden zum Aktualisieren aufgerufen, um das Generieren und Ausführen von dynamischem SQL für Aktualisierungsvorgänge an LINQ to SQL zu delegieren.
Geschützte Methode ExecuteMethodCall Infrastruktur. Führt die der angegebenen CLR-Methode zugeordnete gespeicherte Datenbankprozedur oder Skalarfunktion aus.
Öffentliche Methode ExecuteQuery(Type, String, Object[]) Führt SQL-Abfragen direkt in der Datenbank aus.
Öffentliche Methode ExecuteQuery<TResult>(String, Object[]) Führt SQL-Abfragen direkt in der Datenbank aus und gibt Objekte zurück.
Geschützte Methode Finalize Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.)
Öffentliche Methode GetChangeSet Ermöglicht den Zugriff auf die geänderten Objekte, die von DataContext überwacht werden.
Öffentliche Methode GetCommand Stellt Informationen zu SQL-Befehlen bereit, die von LINQ to SQL generiert wurden.
Öffentliche Methode GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode GetTable(Type) Gibt eine Auflistung von Objekten eines bestimmten Typs zurück, wobei der Typ vom type-Parameter definiert wird.
Öffentliche Methode GetTable<TEntity>() Gibt eine Auflistung von Objekten eines bestimmten Typs zurück, wobei der Typ vom TEntity-Parameter definiert wird.
Öffentliche Methode GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte Methode MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche Methode Refresh(RefreshMode, IEnumerable) Aktualisiert eine Auflistung von Entitätsobjekten anhand des angegebenen Modus.
Öffentliche Methode Refresh(RefreshMode, Object) Aktualisiert ein Entitätsobjekt anhand des angegebenen Modus.
Öffentliche Methode Refresh(RefreshMode, Object[]) Aktualisiert ein Array von Entitätsobjekten anhand des angegebenen Modus.
Öffentliche Methode 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.
Öffentliche Methode 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.
Öffentliche Methode ToString Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Öffentliche Methode Translate(DbDataReader) Konvertiert einen vorhandenen DbDataReader in Objekte.
Öffentliche Methode Translate(Type, DbDataReader) Konvertiert einen vorhandenen DbDataReader in Objekte.
Öffentliche Methode Translate<TResult>(DbDataReader) Konvertiert einen vorhandenen DbDataReader in Objekte.
Zum Seitenanfang

Der DataContext ist die Quelle aller über eine Datenbankverbindung zugeordneten Entitäten. Änderungen, die Sie an den abgerufenen Entitäten vorgenommen haben, werden nachverfolgt, und mithilfe eines "Identitätscaches" wird sichergestellt, dass mehrfach abgerufene Entitäten durch die gleiche Objektinstanz dargestellt werden.

Im Allgemeinen ist eine DataContext-Instanz so konzipiert, dass sie für eine "Arbeitseinheit" verwendet werden kann, unabhängig davon, wie diese Einheit in Ihrer Anwendung definiert ist. Ein DataContext ist einfach, und die Erstellung ist nicht aufwändig. Eine typische LINQ to SQL-Anwendung erstellt DataContext-Instanzen im Methodenbereich oder als Member von Klassen mit kurzer Lebensdauer, die einen logischen Satz von zusammengehörigen Datenbankvorgängen darstellen.

.NET Framework

Unterstützt in: 4, 3.5

.NET Framework Client Profile

Unterstützt in: 4

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ