DataContext DataContext DataContext DataContext Class

Definition

Stellt den Haupteinstiegspunkt für das LINQ to SQL-Framework dar.Represents the main entry point for the LINQ to SQL framework.

public ref class DataContext : IDisposable
public class DataContext : IDisposable
type DataContext = class
    interface IDisposable
Public Class DataContext
Implements IDisposable
Vererbung
DataContextDataContextDataContextDataContext
Implementiert

Hinweise

Die DataContext ist die Quelle aller Entitäten, die über eine datenbankverbindung zugeordnet.The DataContext is the source of all entities mapped over a database connection. Es verfolgt Änderungen, die Sie für alle abgerufenen Entitäten vorgenommen und verwaltet einen "Identitäts-Cache", die garantiert, dass Entitäten mit mehr als einmal abgerufen durch dargestellt werden über die gleiche Objektinstanz.It tracks changes that you made to all retrieved entities and maintains an "identity cache" that guarantees that entities retrieved more than one time are represented by using the same object instance.

Im Allgemeinen eine DataContext Instanz ist so konzipiert, für eine "Arbeitseinheit" Ihrer Anwendung dieser Begriff definiert.In general, a DataContext instance is designed to last for one "unit of work" however your application defines that term. Ein DataContext ist nicht sehr umfangreich und ist nicht aufwendig zu erstellen.A DataContext is lightweight and is not expensive to create. Eine typische LINQ to SQLLINQ to SQL Anwendung erstellt DataContext Datenbank-Vorgängen für die Instanzen im Geltungsbereich der Methode oder als Mitglied der kurzlebige Klassen, die einen logischen Satz darstellen.A typical LINQ to SQLLINQ to SQL application creates DataContext instances at method scope or as a member of short-lived classes that represent a logical set of related database operations.

Konstruktoren

DataContext(IDbConnection) DataContext(IDbConnection) DataContext(IDbConnection) DataContext(IDbConnection)

Initialisiert eine neue Instanz der dem DataContext -Klasse durch Verweisen auf die Verbindung ein, die die .NET Framework.NET Framework.Initializes a new instance of the DataContext class by referencing the connection used by the .NET Framework.NET Framework.

DataContext(IDbConnection, MappingSource) DataContext(IDbConnection, MappingSource) DataContext(IDbConnection, MappingSource) DataContext(IDbConnection, MappingSource)

Initialisiert eine neue Instanz der dem DataContext -Klasse durch Verweisen auf eine Verbindung und eine Zuordnungsquelle.Initializes a new instance of the DataContext class by referencing a connection and a mapping source.

DataContext(String) DataContext(String) DataContext(String) DataContext(String)

Initialisiert eine neue Instanz der dem DataContext -Klasse durch Verweisen auf eine Dateiquelle.Initializes a new instance of the DataContext class by referencing a file source.

DataContext(String, MappingSource) DataContext(String, MappingSource) DataContext(String, MappingSource) DataContext(String, MappingSource)

Initialisiert eine neue Instanz der dem DataContext -Klasse durch Verweisen auf eine Dateiquelle und eine Zuordnungsquelle.Initializes a new instance of the DataContext class by referencing a file source and a mapping source.

Eigenschaften

ChangeConflicts ChangeConflicts ChangeConflicts ChangeConflicts

Ruft eine Auflistung von Objekten, die Parallelitätskonflikte verursacht haben beim SubmitChanges() aufgerufen wurde.Gets a collection of objects that caused concurrency conflicts when SubmitChanges() was called.

CommandTimeout CommandTimeout CommandTimeout 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.Gets or sets a value that increases the time-out period (in seconds) for queries that would otherwise time out during the default time-out period.

Connection Connection Connection Connection

Ruft die vom Framework verwendete Verbindung ab.Gets the connection used by the framework.

DeferredLoadingEnabled DeferredLoadingEnabled DeferredLoadingEnabled DeferredLoadingEnabled

Übernimmt oder bestimmt einen Wert, der angibt, ob 1- oder 1: n Beziehungen verzögertes Laden.Gets or sets a value that indicates whether to delay-load one-to-many or one-to-one relationships.

LoadOptions LoadOptions LoadOptions LoadOptions

Übernimmt oder bestimmt den DataLoadOptions zugeordneten DataContext.Gets or sets the DataLoadOptions associated with this DataContext.

Log Log Log Log

Übernimmt oder bestimmt das Ziel, die SQL-Abfrage oder den Befehl zu schreiben.Gets or sets the destination to write the SQL query or command.

Mapping Mapping Mapping Mapping

Ruft die MetaModel auf dem die Zuordnung basiert.Gets the MetaModel on which the mapping is based.

ObjectTrackingEnabled ObjectTrackingEnabled ObjectTrackingEnabled ObjectTrackingEnabled

Ruft ab oder legt einen Wert, der angibt, ob die objektnachverfolgung aktiviert ist.Gets or sets a value that indicates whether object tracking is enabled.

QueryCacheEnabled QueryCacheEnabled QueryCacheEnabled QueryCacheEnabled
Transaction Transaction Transaction Transaction

Ruft ab oder legt eine lokale Transaktion für die .NET Framework.NET Framework zu verwenden, um die Datenbank zuzugreifen.Gets or sets a local transaction for the .NET Framework.NET Framework to use to access the database.

Methoden

CreateDatabase() CreateDatabase() CreateDatabase() CreateDatabase()

Erstellt eine Datenbank auf dem Server.Creates a database on the server.

CreateMethodCallQuery<TResult>(Object, MethodInfo, Object[]) CreateMethodCallQuery<TResult>(Object, MethodInfo, Object[]) CreateMethodCallQuery<TResult>(Object, MethodInfo, Object[]) CreateMethodCallQuery<TResult>(Object, MethodInfo, Object[])

Führt die der angegebenen .NET-Methode zugeordnete Tabellenwert-Datenbankfunktion aus.Executes the table-valued database function associated with the specified .NET method.

DatabaseExists() DatabaseExists() DatabaseExists() DatabaseExists()

Bestimmt, ob die zugeordnete Datenbank geöffnet werden kann.Determines whether the associated database can be opened.

DeleteDatabase() DeleteDatabase() DeleteDatabase() DeleteDatabase()

Löscht die zugeordnete Datenbank.Deletes the associated database.

Dispose() Dispose() Dispose() Dispose()

Gibt alle von der aktuellen Instanz der DataContext-Klasse verwendeten Ressourcen frei.Releases all resources used by the current instance of the DataContext class.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Nicht verwalteten Ressourcen ein, die die DataContext -Klasse und gibt optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the DataContext class and optionally releases the managed resource.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExecuteCommand(String, Object[]) ExecuteCommand(String, Object[]) ExecuteCommand(String, Object[]) ExecuteCommand(String, Object[])

Führt SQL-Befehle direkt in der Datenbank an.Executes SQL commands directly on the database.

ExecuteDynamicDelete(Object) ExecuteDynamicDelete(Object) ExecuteDynamicDelete(Object) ExecuteDynamicDelete(Object)

Delete-außer Kraft setzen-Methoden, um Überschreibungsmethoden wird LINQ to SQLLINQ to SQL die Aufgabe, generieren und Ausführen von dynamischem SQL für Löschvorgänge.Executes, inside delete override methods, to redelegate to LINQ to SQLLINQ to SQL the task of generating and executing dynamic SQL for delete operations.

ExecuteDynamicInsert(Object) ExecuteDynamicInsert(Object) ExecuteDynamicInsert(Object) ExecuteDynamicInsert(Object)

Wird in Überschreibungsmethoden zum Einfügen ausgeführt, um das Generieren und Ausführen von dynamischem SQL für Einfügevorgänge neu an LINQ to SQLLINQ to SQL zu delegieren.Executes, inside insert override methods, to redelegate to LINQ to SQLLINQ to SQL the task of generating and executing dynamic SQL for insert operations.

ExecuteDynamicUpdate(Object) ExecuteDynamicUpdate(Object) ExecuteDynamicUpdate(Object) ExecuteDynamicUpdate(Object)

Wird außer Kraft setzen updatemethoden, um Überschreibungsmethoden LINQ to SQLLINQ to SQL die Aufgabe der generieren und Ausführen von dynamischem SQL für Aktualisierungsvorgänge.Executes, inside update override methods, to redelegate to LINQ to SQLLINQ to SQL the task of generating and executing dynamic SQL for update operations.

ExecuteMethodCall(Object, MethodInfo, Object[]) ExecuteMethodCall(Object, MethodInfo, Object[]) ExecuteMethodCall(Object, MethodInfo, Object[]) ExecuteMethodCall(Object, MethodInfo, Object[])

Führt die der angegebenen .NET-Methode zugeordnete gespeicherte Datenbankprozedur oder Skalarfunktion aus.Executes the stored database procedure or scalar function associated with the specified .NET method.

ExecuteQuery(Type, String, Object[]) ExecuteQuery(Type, String, Object[]) ExecuteQuery(Type, String, Object[]) ExecuteQuery(Type, String, Object[])

Führt SQL-Abfragen direkt in der Datenbank an.Executes SQL queries directly on the database.

ExecuteQuery<TResult>(String, Object[]) ExecuteQuery<TResult>(String, Object[]) ExecuteQuery<TResult>(String, Object[]) ExecuteQuery<TResult>(String, Object[])

Führt SQL-Abfragen direkt in der Datenbank, und gibt Objekte zurück.Executes SQL queries directly on the database and returns objects.

GetChangeSet() GetChangeSet() GetChangeSet() GetChangeSet()

Ruft die geänderten Objekte von nachverfolgten DataContext.Gets the modified objects tracked by DataContext.

GetCommand(IQueryable) GetCommand(IQueryable) GetCommand(IQueryable) GetCommand(IQueryable)

Ruft die Informationen zu SQL-Befehle, die vom LINQ to SQLLINQ to SQL.Gets the information about SQL commands generated by LINQ to SQLLINQ to SQL.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetIDbCommand(IQueryable) GetIDbCommand(IQueryable) GetIDbCommand(IQueryable) GetIDbCommand(IQueryable)
GetTable(Type) GetTable(Type) GetTable(Type) GetTable(Type)

Gibt eine Auflistung von Objekten eines bestimmten Typs, der Typ, in dem von definiert wird der type Parameter.Returns a collection of objects of a particular type, where the type is defined by the type parameter.

GetTable<TEntity>() GetTable<TEntity>() GetTable<TEntity>() GetTable<TEntity>()

Gibt eine Auflistung von Objekten eines bestimmten Typs, der Typ, in dem von definiert wird der TEntity Parameter.Returns a collection of objects of a particular type, where the type is defined by the TEntity parameter.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Refresh(RefreshMode, IEnumerable) Refresh(RefreshMode, IEnumerable) Refresh(RefreshMode, IEnumerable) Refresh(RefreshMode, IEnumerable)

Aktualisiert eine Auflistung von Entitätsobjekten anhand des angegebenen Modus.Refreshes a collection of entity objects according to the specified mode.

Refresh(RefreshMode, Object) Refresh(RefreshMode, Object) Refresh(RefreshMode, Object) Refresh(RefreshMode, Object)

Aktualisiert ein Entitätsobjekt anhand des angegebenen Modus.Refreshes an entity object according to the specified mode.

Refresh(RefreshMode, Object[]) Refresh(RefreshMode, Object[]) Refresh(RefreshMode, Object[]) Refresh(RefreshMode, Object[])

Aktualisiert ein Array von Entitätsobjekten anhand des angegebenen Modus.Refreshes an array of entity objects according to the specified mode.

SubmitChanges() SubmitChanges() SubmitChanges() SubmitChanges()

Berechnet die geänderten Objekte, die eingefügt, aktualisiert oder gelöscht werden, und führt die entsprechenden Befehle, um die Änderungen an der Datenbank zu implementieren.Computes the set of modified objects to be inserted, updated, or deleted, and executes the appropriate commands to implement the changes to the database.

SubmitChanges(ConflictMode) SubmitChanges(ConflictMode) SubmitChanges(ConflictMode) SubmitChanges(ConflictMode)

Sendet Änderungen wurden an abgerufenen Objekten an der zugrunde liegenden Datenbank und gibt die Aktion an, die ausgeführt werden, die bei einem Fehler.Sends changes that were made to retrieved objects to the underlying database, and specifies the action to be taken if the submission fails.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)
Translate(DbDataReader) Translate(DbDataReader) Translate(DbDataReader) Translate(DbDataReader)

Konvertiert einen vorhandenen DbDataReader auf Objekte.Converts an existing DbDataReader to objects.

Translate(Type, DbDataReader) Translate(Type, DbDataReader) Translate(Type, DbDataReader) Translate(Type, DbDataReader)

Konvertiert einen vorhandenen DbDataReader auf Objekte.Converts an existing DbDataReader to objects.

Translate<TResult>(DbDataReader) Translate<TResult>(DbDataReader) Translate<TResult>(DbDataReader) Translate<TResult>(DbDataReader)

Konvertiert einen vorhandenen DbDataReader auf Objekte.Converts an existing DbDataReader to objects.

Gilt für: