Database 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.
Eine Instanz dieser Klasse wird aus einem DbContext Objekt abgerufen und kann zum Verwalten der tatsächlichen Datenbank verwendet werden, die einen DbContext oder eine Verbindung unterstützt. Dies umfasst das Erstellen, Löschen und Überprüfen des Vorhandenseins einer Datenbank. Beachten Sie, dass das Löschen und Überprüfen auf das Vorhandensein einer Datenbank nur mithilfe einer Verbindung (d. h. ohne vollständigen Kontext) mithilfe der statischen Methoden dieser Klasse ausgeführt werden kann.
public class Database
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1001:TypesThatOwnDisposableFieldsShouldBeDisposable", Justification="The DbContextTransaction and EntityTransaction should never be disposed by this class")]
public class Database
type Database = class
Public Class Database
- Vererbung
-
Database
- Attribute
Eigenschaften
| Name | Beschreibung |
|---|---|
| CommandTimeout |
Dient zum Abrufen oder Festlegen des Timeoutwerts in Sekunden für alle Kontextvorgänge. Der Standardwert ist NULL, wobei NULL angibt, dass der Standardwert des zugrunde liegenden Anbieters verwendet wird. |
| Connection |
Gibt die Verbindung zurück, die von diesem Kontext verwendet wird. Dies kann dazu führen, dass die Verbindung erstellt wird, wenn sie noch nicht vorhanden ist. |
| CurrentTransaction |
Ruft die Transaktion ab, in der die zugrunde liegende Speicherverbindung aufgelistet ist. Kann null sein. |
| DefaultConnectionFactory |
Veraltet.
Die Verbindungsfactory, die beim Erstellen eines Aus DbConnection nur einem Datenbanknamen oder einer Verbindungszeichenfolge verwendet werden soll. |
| Log |
Legen Sie diese Eigenschaft fest, um die vom angegebenen Delegaten generierte DbContext SQL-Datei zu protokollieren. Wenn Sie sich beispielsweise bei der Konsole anmelden möchten, legen Sie diese Eigenschaft auf Write(String). |
Methoden
| Name | Beschreibung |
|---|---|
| BeginTransaction() |
Startet eine Transaktion für die zugrunde liegende Speicherverbindung. |
| BeginTransaction(IsolationLevel) |
Startet eine Transaktion für die zugrunde liegende Speicherverbindung mithilfe der angegebenen Isolationsstufe. |
| CompatibleWithModel(Boolean) |
Überprüft, ob die Datenbank mit dem aktuellen Code First-Modell kompatibel ist. |
| Create() |
Erstellt eine neue Datenbank auf dem Datenbankserver für das im Sicherungskontext definierte Modell. Beachten Sie, dass das Aufrufen dieser Methode, bevor die Datenbankinitialisierungsstrategie ausgeführt wurde, die Ausführung dieser Strategie deaktiviert. |
| CreateIfNotExists() |
Erstellt eine neue Datenbank auf dem Datenbankserver für das im Sicherungskontext definierte Modell, aber nur, wenn eine Datenbank mit demselben Namen noch nicht auf dem Server vorhanden ist. |
| Delete() |
Löscht die Datenbank auf dem Datenbankserver, falls vorhanden, andernfalls nichts. Wenn Sie diese Methode von außerhalb eines Initialisierers aufrufen, wird die Datenbank als nicht initialisiert markiert. Dies bedeutet, dass bei einem erneuten Versuch, die Datenbank nach dem Löschen erneut zu verwenden, alle Initialisierungssätze erneut ausgeführt werden und in der Regel erneut versuchen, die Datenbank automatisch zu erstellen. |
| Delete(DbConnection) |
Löscht die Datenbank auf dem Datenbankserver, falls vorhanden, andernfalls nichts. |
| Delete(String) |
Löscht die Datenbank auf dem Datenbankserver, falls vorhanden, andernfalls nichts. Die Verbindung mit der Datenbank wird mit dem angegebenen Datenbanknamen oder Verbindungszeichenfolge auf die gleiche Weise erstellt wie in der Dokumentation für die DbContext Klasse beschrieben. |
| Equals(Object) |
Eine Instanz dieser Klasse wird aus einem DbContext Objekt abgerufen und kann zum Verwalten der tatsächlichen Datenbank verwendet werden, die einen DbContext oder eine Verbindung unterstützt. Dies umfasst das Erstellen, Löschen und Überprüfen des Vorhandenseins einer Datenbank. Beachten Sie, dass das Löschen und Überprüfen auf das Vorhandensein einer Datenbank nur mithilfe einer Verbindung (d. h. ohne vollständigen Kontext) mithilfe der statischen Methoden dieser Klasse ausgeführt werden kann. |
| ExecuteSqlCommand(String, Object[]) |
Führt den angegebenen DDL/DML-Befehl für die Datenbank aus. Wie bei jeder API, die SQL akzeptiert, ist es wichtig, jede Benutzereingabe zu parametrisieren, um vor einem SQL-Einfügungsangriff zu schützen. Sie können Parameterplatzhalter in die SQL-Abfragezeichenfolge einschließen und dann Parameterwerte als zusätzliche Argumente angeben. Alle parameterwerte, die Sie angeben, werden automatisch in einen DbParameter konvertiert. kontext. Database.ExecuteSqlCommand("UPDATE dbo. Beiträge SET Rating = 5 WHERE Author = @p0", userSuppliedAuthor); Alternativ können Sie auch einen DbParameter erstellen und an SqlQuery bereitstellen. Auf diese Weise können Sie benannte Parameter in der SQL-Abfragezeichenfolge verwenden. kontext. Database.ExecuteSqlCommand("UPDATE dbo. Beiträge SET Rating = 5 WHERE Author = @author", new SqlParameter("@author", userSuppliedAuthor)); |
| ExecuteSqlCommand(TransactionalBehavior, String, Object[]) |
Führt den angegebenen DDL/DML-Befehl für die Datenbank aus. Wie bei jeder API, die SQL akzeptiert, ist es wichtig, jede Benutzereingabe zu parametrisieren, um vor einem SQL-Einfügungsangriff zu schützen. Sie können Parameterplatzhalter in die SQL-Abfragezeichenfolge einschließen und dann Parameterwerte als zusätzliche Argumente angeben. Alle parameterwerte, die Sie angeben, werden automatisch in einen DbParameter konvertiert. kontext. Database.ExecuteSqlCommand("UPDATE dbo. Beiträge SET Rating = 5 WHERE Author = @p0", userSuppliedAuthor); Alternativ können Sie auch einen DbParameter erstellen und an SqlQuery bereitstellen. Auf diese Weise können Sie benannte Parameter in der SQL-Abfragezeichenfolge verwenden. kontext. Database.ExecuteSqlCommand("UPDATE dbo. Beiträge SET Rating = 5 WHERE Author = @author", new SqlParameter("@author", userSuppliedAuthor)); |
| ExecuteSqlCommandAsync(String, CancellationToken, Object[]) |
Führt den angegebenen DDL/DML-Befehl asynchron für die Datenbank aus. Wie bei jeder API, die SQL akzeptiert, ist es wichtig, jede Benutzereingabe zu parametrisieren, um vor einem SQL-Einfügungsangriff zu schützen. Sie können Parameterplatzhalter in die SQL-Abfragezeichenfolge einschließen und dann Parameterwerte als zusätzliche Argumente angeben. Alle parameterwerte, die Sie angeben, werden automatisch in einen DbParameter konvertiert. kontext. Database.ExecuteSqlCommandAsync("UPDATE dbo. Beiträge SET Rating = 5 WHERE Author = @p0", userSuppliedAuthor); Alternativ können Sie auch einen DbParameter erstellen und an SqlQuery bereitstellen. Auf diese Weise können Sie benannte Parameter in der SQL-Abfragezeichenfolge verwenden. kontext. Database.ExecuteSqlCommandAsync("UPDATE dbo. Beiträge SET Rating = 5 WHERE Author = @author", new SqlParameter("@author", userSuppliedAuthor)); |
| ExecuteSqlCommandAsync(String, Object[]) |
Führt den angegebenen DDL/DML-Befehl asynchron für die Datenbank aus. Wie bei jeder API, die SQL akzeptiert, ist es wichtig, jede Benutzereingabe zu parametrisieren, um vor einem SQL-Einfügungsangriff zu schützen. Sie können Parameterplatzhalter in die SQL-Abfragezeichenfolge einschließen und dann Parameterwerte als zusätzliche Argumente angeben. Alle parameterwerte, die Sie angeben, werden automatisch in einen DbParameter konvertiert. kontext. Database.ExecuteSqlCommandAsync("UPDATE dbo. Beiträge SET Rating = 5 WHERE Author = @p0", userSuppliedAuthor); Alternativ können Sie auch einen DbParameter erstellen und an SqlQuery bereitstellen. Auf diese Weise können Sie benannte Parameter in der SQL-Abfragezeichenfolge verwenden. kontext. Database.ExecuteSqlCommandAsync("UPDATE dbo. Beiträge SET Rating = 5 WHERE Author = @author", new SqlParameter("@author", userSuppliedAuthor)); |
| ExecuteSqlCommandAsync(TransactionalBehavior, String, CancellationToken, Object[]) |
Führt den angegebenen DDL/DML-Befehl asynchron für die Datenbank aus. Wie bei jeder API, die SQL akzeptiert, ist es wichtig, jede Benutzereingabe zu parametrisieren, um vor einem SQL-Einfügungsangriff zu schützen. Sie können Parameterplatzhalter in die SQL-Abfragezeichenfolge einschließen und dann Parameterwerte als zusätzliche Argumente angeben. Alle parameterwerte, die Sie angeben, werden automatisch in einen DbParameter konvertiert. kontext. Database.ExecuteSqlCommandAsync("UPDATE dbo. Beiträge SET Rating = 5 WHERE Author = @p0", userSuppliedAuthor); Alternativ können Sie auch einen DbParameter erstellen und an SqlQuery bereitstellen. Auf diese Weise können Sie benannte Parameter in der SQL-Abfragezeichenfolge verwenden. kontext. Database.ExecuteSqlCommandAsync("UPDATE dbo. Beiträge SET Rating = 5 WHERE Author = @author", new SqlParameter("@author", userSuppliedAuthor)); |
| ExecuteSqlCommandAsync(TransactionalBehavior, String, Object[]) |
Führt den angegebenen DDL/DML-Befehl asynchron für die Datenbank aus. Wie bei jeder API, die SQL akzeptiert, ist es wichtig, jede Benutzereingabe zu parametrisieren, um vor einem SQL-Einfügungsangriff zu schützen. Sie können Parameterplatzhalter in die SQL-Abfragezeichenfolge einschließen und dann Parameterwerte als zusätzliche Argumente angeben. Alle parameterwerte, die Sie angeben, werden automatisch in einen DbParameter konvertiert. kontext. Database.ExecuteSqlCommandAsync("UPDATE dbo. Beiträge SET Rating = 5 WHERE Author = @p0", userSuppliedAuthor); Alternativ können Sie auch einen DbParameter erstellen und an SqlQuery bereitstellen. Auf diese Weise können Sie benannte Parameter in der SQL-Abfragezeichenfolge verwenden. kontext. Database.ExecuteSqlCommandAsync("UPDATE dbo. Beiträge SET Rating = 5 WHERE Author = @author", new SqlParameter("@author", userSuppliedAuthor)); |
| Exists() |
Überprüft, ob die Datenbank auf dem Server vorhanden ist. |
| Exists(DbConnection) |
Überprüft, ob die Datenbank auf dem Server vorhanden ist. |
| Exists(String) |
Überprüft, ob die Datenbank auf dem Server vorhanden ist. Die Verbindung mit der Datenbank wird mit dem angegebenen Datenbanknamen oder Verbindungszeichenfolge auf die gleiche Weise erstellt wie in der Dokumentation für die DbContext Klasse beschrieben. |
| GetHashCode() |
Eine Instanz dieser Klasse wird aus einem DbContext Objekt abgerufen und kann zum Verwalten der tatsächlichen Datenbank verwendet werden, die einen DbContext oder eine Verbindung unterstützt. Dies umfasst das Erstellen, Löschen und Überprüfen des Vorhandenseins einer Datenbank. Beachten Sie, dass das Löschen und Überprüfen auf das Vorhandensein einer Datenbank nur mithilfe einer Verbindung (d. h. ohne vollständigen Kontext) mithilfe der statischen Methoden dieser Klasse ausgeführt werden kann. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. |
| Initialize(Boolean) |
Führt den registrierten IDatabaseInitializer<TContext> in diesem Kontext aus. Wenn "force" auf "true" festgelegt ist, wird der Initialisierer unabhängig davon ausgeführt, ob er zuvor ausgeführt wurde. Dies kann nützlich sein, wenn eine Datenbank gelöscht wird, während eine App ausgeführt wird und erneut initialisiert werden muss. Wenn "force" auf "false" festgelegt ist, wird der Initialisierer nur ausgeführt, wenn er für diesen Kontext, das Modell und die Verbindung in dieser App-Domäne noch nicht ausgeführt wurde. Diese Methode wird in der Regel verwendet, wenn sie erforderlich ist, um sicherzustellen, dass die Datenbank erstellt und initialet wurde, bevor Sie einen Vorgang starten, bei dem dies lazily erfolgt, Zu Problemen führen, z. B. wenn der Vorgang Teil einer Transaktion ist. |
| SetInitializer<TContext>(IDatabaseInitializer<TContext>) |
Legt den Datenbankinitialisierer fest, der für den angegebenen Kontexttyp verwendet werden soll. Der Datenbankinitialisierer wird aufgerufen, wenn ein bestimmter DbContext Typ verwendet wird, um zum ersten Mal auf eine Datenbank zuzugreifen. Die Standardstrategie für Code First-Kontexte ist eine Instanz von CreateDatabaseIfNotExists<TContext>. |
| SqlQuery(Type, String, Object[]) |
Erstellt eine unformatierte SQL-Abfrage, die Elemente des angegebenen Typs zurückgibt. Der Typ kann ein beliebiger Typ sein, der Eigenschaften enthält, die den Namen der spalten entsprechen, die von der Abfrage zurückgegeben werden, oder ein einfacher Grundtyp sein. Der Typ muss kein Entitätstyp sein. Die Ergebnisse dieser Abfrage werden niemals vom Kontext nachverfolgt, auch wenn der zurückgegebene Objekttyp ein Entitätstyp ist. Verwenden Sie die SqlQuery(String, Object[]) Methode, um Entitäten zurückzugeben, die vom Kontext nachverfolgt werden. |
| SqlQuery<TElement>(String, Object[]) |
Erstellt eine unformatierte SQL-Abfrage, die Elemente des angegebenen generischen Typs zurückgibt. Der Typ kann ein beliebiger Typ sein, der Eigenschaften enthält, die den Namen der spalten entsprechen, die von der Abfrage zurückgegeben werden, oder ein einfacher Grundtyp sein. Der Typ muss kein Entitätstyp sein. Die Ergebnisse dieser Abfrage werden niemals vom Kontext nachverfolgt, auch wenn der zurückgegebene Objekttyp ein Entitätstyp ist. Verwenden Sie die SqlQuery(String, Object[]) Methode, um Entitäten zurückzugeben, die vom Kontext nachverfolgt werden. |
| ToString() |
Eine Instanz dieser Klasse wird aus einem DbContext Objekt abgerufen und kann zum Verwalten der tatsächlichen Datenbank verwendet werden, die einen DbContext oder eine Verbindung unterstützt. Dies umfasst das Erstellen, Löschen und Überprüfen des Vorhandenseins einer Datenbank. Beachten Sie, dass das Löschen und Überprüfen auf das Vorhandensein einer Datenbank nur mithilfe einer Verbindung (d. h. ohne vollständigen Kontext) mithilfe der statischen Methoden dieser Klasse ausgeführt werden kann. |
| UseTransaction(DbTransaction) |
Ermöglicht es dem Benutzer, eine außerhalb des Database Objekts erstellte Datenbanktransaktion zu übergeben, wenn das Entity Framework Befehle innerhalb dieser externen Transaktion ausführen soll. Alternativ können Sie null übergeben, um das Wissen des Frameworks für diese Transaktion zu löschen. |