DataContext Klasse

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
DataContext
Implementiert

Hinweise

Der DataContext ist die Quelle aller Entitäten, die über eine Datenbankverbindung zugeordnet sind.The DataContext is the source of all entities mapped over a database connection. Es verfolgt Änderungen, die Sie an allen abgerufenen Entitäten vorgenommen haben, und verwaltet einen "Identitäts Cache", mit dem sichergestellt wird, dass Entitäten, die mehrmals abgerufen werden, mithilfe derselben Objektinstanz dargestellt werden.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 ist eine DataContext -Instanz so konzipiert, dass Sie für eine "Arbeitseinheit" zuletzt verwendet wird, wenn die Anwendung diesen Begriff jedoch definiert.In general, a DataContext instance is designed to last for one "unit of work" however your application defines that term. Eine DataContext ist einfach und kann nicht aufwendig erstellt werden.A DataContext is lightweight and is not expensive to create. Eine typische LINQ to SQLLINQ to SQL Anwendung erstellt DataContext -Instanzen im Methoden Bereich oder als Member kurzlebiger Klassen, die einen logischen Satz verwandter Daten Bank Vorgänge 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)

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

DataContext(IDbConnection, MappingSource)

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

DataContext(String)

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

DataContext(String, MappingSource)

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

Eigenschaften

ChangeConflicts

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

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

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

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.Gets or sets a value that indicates whether to delay-load one-to-many or one-to-one relationships.

LoadOptions

Ruft die DataLoadOptions ab, die diesem DataContext zugeordnet sind, oder legt diese fest.Gets or sets the DataLoadOptions associated with this DataContext.

Log

Ruft das Ziel zum Schreiben der SQL-Abfrage oder des Befehls ab oder legt es fest.Gets or sets the destination to write the SQL query or command.

Mapping

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

ObjectTrackingEnabled

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

QueryCacheEnabled
Transaction

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

Methoden

CreateDatabase()

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

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()

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

DeleteDatabase()

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

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)

Gibt die von der DataContext-Klasse verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressource frei.Releases the unmanaged resources used by the DataContext class and optionally releases the managed resource.

Equals(Object)

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

(Geerbt von Object)
ExecuteCommand(String, Object[])

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

ExecuteDynamicDelete(Object)

Wird in Überschreibungsmethoden zum Löschen ausgeführt, um das Generieren und Ausführen von dynamischem SQL für Löschvorgänge an LINQ to SQLLINQ to SQL zu delegieren.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)

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)

Wird in Überschreibungsmethoden zum Aktualisieren ausgeführt, um das Generieren und Ausführen von dynamischem SQL für Aktualisierungsvorgänge an LINQ to SQLLINQ to SQL zu delegieren.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[])

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[])

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

ExecuteQuery<TResult>(String, Object[])

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

GetChangeSet()

Ruft die geänderten Objekte ab, die von DataContext nachverfolgt werden.Gets the modified objects tracked by DataContext.

GetCommand(IQueryable)

Ruft Informationen zu SQL-Befehlen ab, die von LINQ to SQLLINQ to SQL generiert wurden.Gets the information about SQL commands generated by LINQ to SQLLINQ to SQL.

GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetIDbCommand(IQueryable)
GetTable(Type)

Gibt eine Auflistung von Objekten eines bestimmten Typs zurück; der Typ wird vom type-Parameter definiert.Returns a collection of objects of a particular type, where the type is defined by the type parameter.

GetTable<TEntity>()

Gibt eine Auflistung von Objekten eines bestimmten Typs zurück; der Typ wird vom TEntity-Parameter definiert.Returns a collection of objects of a particular type, where the type is defined by the TEntity parameter.

GetType()

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

(Geerbt von Object)
MemberwiseClone()

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

(Geerbt von Object)
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)

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

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()

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.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)

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

ToString()

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

(Geerbt von Object)
Translate(DbDataReader)

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

Translate(Type, DbDataReader)

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

Translate<TResult>(DbDataReader)

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

Gilt für: