OleDbConnection 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 eine offene Verbindung mit einer Datenquelle dar.
public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable
public ref class OleDbConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection
public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable
public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable, IDisposable
public sealed class OleDbConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection
public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable
type OleDbConnection = class
inherit DbConnection
interface ICloneable
interface IDbConnection
interface IDisposable
type OleDbConnection = class
inherit Component
interface ICloneable
interface IDbConnection
interface IDisposable
type OleDbConnection = class
inherit DbConnection
interface IDbConnection
interface IDisposable
interface ICloneable
Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable
Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable
- Vererbung
- Vererbung
- Implementiert
Beispiele
Das folgende Beispiel erstellt eine OleDbCommand und ein OleDbConnection. Wird OleDbConnection geöffnet und als für Connection festgelegt OleDbCommand. Im Beispiel wird dann die Verbindung aufgerufen ExecuteNonQuery und geschlossen. Um dies zu erreichen, wird ein Verbindungszeichenfolge und eine Abfragezeichenfolge übergeben, ExecuteNonQuery bei der es sich um eine SQL INSERT-Anweisung handelt.
public void InsertRow(string connectionString, string insertSQL)
{
using (OleDbConnection connection = new OleDbConnection(connectionString))
{
// The insertSQL string contains a SQL statement that
// inserts a new row in the source table.
OleDbCommand command = new OleDbCommand(insertSQL);
// Set the Connection to the new OleDbConnection.
command.Connection = connection;
// Open the connection and execute the insert command.
try
{
connection.Open();
command.ExecuteNonQuery();
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
// The connection is automatically closed when the
// code exits the using block.
}
}
Public Sub InsertRow(ByVal connectionString As String, _
ByVal insertSQL As String)
Using connection As New OleDbConnection(connectionString)
' The insertSQL string contains a SQL statement that
' inserts a new row in the source table.
Dim command As New OleDbCommand(insertSQL)
' Set the Connection to the new OleDbConnection.
command.Connection = connection
' Open the connection and execute the insert command.
Try
connection.Open()
command.ExecuteNonQuery()
Catch ex As Exception
Console.WriteLine(ex.Message)
End Try
' The connection is automatically closed when the
' code exits the Using block.
End Using
End Sub
Hinweise
Ein OleDbConnection -Objekt stellt eine eindeutige Verbindung mit einer Datenquelle dar. Bei einem Client/Server-Datenbanksystem entspricht dies einer Netzwerkverbindung mit dem Server. Abhängig von der Funktionalität, die vom nativen OLE DB-Anbieter unterstützt wird, sind einige Methoden oder Eigenschaften eines OleDbConnection Objekts möglicherweise nicht verfügbar.
Wenn Sie eine instance von OleDbConnectionerstellen, werden alle Eigenschaften auf ihre Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie im OleDbConnection Konstruktor.
Sie können mehrere DataReader in einer einzelnen OleDbConnectionöffnen. Wenn der verwendete OLE DB-Anbieter nicht mehr als einen DataReader für eine einzelne Verbindung unterstützt, öffnet der Anbieter implizit eine zusätzliche Verbindung für jeden.
Wenn der OleDbConnection außerhalb des Gültigkeitsbereichs liegt, wird es nicht geschlossen. Daher müssen Sie die Verbindung explizit schließen, indem Sie oder Dispose aufrufen Close oder das OleDbConnection -Objekt in einer Using
-Anweisung verwenden.
Hinweis
Um Hochleistungsanwendungen bereitzustellen, müssen Sie Verbindungspooling verwenden. Wenn Sie den .NET Framework-Datenanbieter für OLE DB verwenden, müssen Sie das Verbindungspooling nicht aktivieren, da der Anbieter dies automatisch verwaltet. Weitere Informationen zur Verwendung von Verbindungspools mit dem .NET Framework-Datenanbieter für OLE DB finden Sie unter OLE DB, ODBC und Oracle-Verbindungspooling.
Wenn ein schwerwiegender OleDbException (z. B. ein SQL Server Schweregrad von 20 oder höher) von der Methode generiert wird, die einen OleDbCommandausführt, kann geschlossen OleDbConnection werden. Die Benutzer können die Verbindung aber erneut öffnen und fortfahren.
Eine Anwendung, die eine instance des OleDbConnection Objekts erstellt, kann erfordern, dass alle direkten und indirekten Aufrufer über ausreichende Berechtigungen für den Code verfügen, indem deklarative oder imperative Sicherheitsanforderungen festgelegt werden. OleDbConnection stellt Sicherheitsanforderungen mithilfe des OleDbPermission -Objekts. Benutzer können überprüfen, ob ihr Code über ausreichende Berechtigungen verfügt, indem sie das OleDbPermissionAttribute -Objekt verwenden. Benutzer und Administratoren können auch die Caspol.exe (Code Access Security Policy Tool) verwenden, um die Sicherheitsrichtlinie auf Computer-, Benutzer- und Unternehmensebene zu ändern. Weitere Informationen finden Sie unter Code Access Security and ADO.NET.
Weitere Informationen zum Behandeln von Warnungen und Informationsmeldungen vom Datenserver finden Sie unter Verbindungsereignisse.
Hinweis
Das OleDbConnection -Objekt unterstützt das Festlegen oder Abrufen dynamischer Eigenschaften, die für einen OLE DB-Anbieter spezifisch sind, nicht. Es werden nur Eigenschaften unterstützt, die in der Verbindungszeichenfolge für den OLE DB-Anbieter übergeben werden können.
Konstruktoren
OleDbConnection() |
Initialisiert eine neue Instanz der OleDbConnection-Klasse. |
OleDbConnection(String) |
Initialisiert eine neue Instanz der OleDbConnection-Klasse mit der angegebenen Verbindungszeichenfolge. |
Eigenschaften
CanCreateBatch |
Ruft einen Wert ab, der angibt, ob diese DbConnection-Instanz die DbBatch-Klasse unterstützt (Geerbt von DbConnection) |
CanRaiseEvents |
Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component) |
ConnectionString |
Ruft die Zeichenfolge ab, mit der eine Datenbank geöffnet wird, oder legt diese fest. |
ConnectionTimeout |
Ruft die Zeit (in Sekunden) ab, die beim Verbindungsaufbau gewartet werden soll, bis der Versuch beendet und ein Fehler generiert wird. |
Container |
Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component) |
Database |
Ruft den Namen der aktuellen Datenbank oder der nach dem Öffnen einer Verbindung zu verwendenden Datenbank ab. |
DataSource |
Ruft den Servernamen oder den Dateinamen der Datenquelle ab. |
DbProviderFactory |
Ruft den DbProviderFactory für diesen DbConnection ab. (Geerbt von DbConnection) |
DesignMode |
Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component) |
Events |
Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component) |
Provider |
Ruft den in der "Provider= "-Klausel der Verbindungszeichenfolge angegebenen Namen des OLE DB-Providers ab. |
ServerVersion |
Ruft eine Zeichenfolge mit der Version des Servers ab, mit der der Client verbunden ist. |
Site |
Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component) |
State |
Ruft den aktuellen Zustand der Verbindung ab. |
Methoden
BeginDbTransaction(IsolationLevel) |
Startet beim Überschreiben in einer abgeleiteten Klasse eine Datenbanktransaktion (Geerbt von DbConnection) |
BeginDbTransactionAsync(IsolationLevel, CancellationToken) |
Startet asynchron eine Datenbanktransaktion (Geerbt von DbConnection) |
BeginTransaction() |
Beginnt eine Datenbanktransaktion mit dem aktuellen IsolationLevel-Wert. |
BeginTransaction(IsolationLevel) |
Startet eine Datenbanktransaktion mit dem angegebenen Isolationsgrad. |
BeginTransactionAsync(CancellationToken) |
Startet asynchron eine Datenbanktransaktion (Geerbt von DbConnection) |
BeginTransactionAsync(IsolationLevel, CancellationToken) |
Startet asynchron eine Datenbanktransaktion (Geerbt von DbConnection) |
ChangeDatabase(String) |
Ändert die aktuelle Datenbank für eine offene OleDbConnection. |
ChangeDatabaseAsync(String, CancellationToken) |
Ändert asynchron die aktuelle Datenbank für eine offene Verbindung (Geerbt von DbConnection) |
Close() |
Schließt die Verbindung mit der Datenquelle. |
CloseAsync() |
Schließt asynchron die Verbindung mit der Datenbank (Geerbt von DbConnection) |
CreateBatch() |
Gibt eine neue Instanz der Klasse des Anbieters zurück, die die DbBatch-Klasse implementiert. (Geerbt von DbConnection) |
CreateCommand() |
Erstellt ein OleDbCommand-Objekt, das der OleDbConnection zugeordnet ist, und gibt es zurück. |
CreateDbBatch() |
Gibt beim Überschreiben in einer abgeleiteten Klasse eine neue instance der Klasse des Anbieters zurück, die die DbBatch Klasse implementiert. (Geerbt von DbConnection) |
CreateDbCommand() |
Erstellt beim Überschreiben in einer abgeleiteten Klasse ein DbCommand-Objekt, das der aktuellen Verbindung zugeordnet ist, und gibt es zurück (Geerbt von DbConnection) |
CreateObjRef(Type) |
Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject) |
Dispose() |
Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Geerbt von DbConnection) |
Dispose() |
Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component) |
Dispose(Boolean) |
Gibt die von DbConnection verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von DbConnection) |
Dispose(Boolean) |
Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von Component) |
DisposeAsync() |
Stellt das Verbindungsobjekt asynchron bereit (Geerbt von DbConnection) |
EnlistDistributedTransaction(ITransaction) |
Trägt sich in der angegebenen Transaktion als verteilte Transaktion ein. |
EnlistTransaction(Transaction) |
Trägt sich in der angegebenen Transaktion als verteilte Transaktion ein. |
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetLifetimeService() |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
GetOleDbSchemaTable(Guid, Object[]) |
Gibt Schemainformationen aus einer Datenquelle entsprechend den Angaben einer GUID zurück und wendet anschließend die angegebenen Einschränkungen an. |
GetSchema() |
Gibt Schemainformationen für die Datenquelle dieser OleDbConnection zurück. |
GetSchema(String) |
Gibt Schemainformationen für die Datenquelle dieser OleDbConnection mithilfe der angegebenen Zeichenfolge des Schemanamens zurück. |
GetSchema(String, String[]) |
Gibt Schemainformationen für die Datenquelle dieser OleDbConnection mithilfe der angegebenen Zeichenfolge des Schemanamens und des angegebenen Zeichenfolgenarrays der Einschränkungswerte zurück. |
GetSchemaAsync(CancellationToken) |
Dies ist eine asynchrone Version von GetSchema().
Anbieter sollten mit einer entsprechenden Implementierung überschreiben.
Das |
GetSchemaAsync(String, CancellationToken) |
Dies ist die asynchrone Version von GetSchema(String).
Anbieter sollten mit einer entsprechenden Implementierung überschreiben.
Das |
GetSchemaAsync(String, String[], CancellationToken) |
Dies ist die asynchrone Version von GetSchema(String, String[]).
Anbieter sollten mit einer entsprechenden Implementierung überschreiben.
Das |
GetService(Type) |
Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component) |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
InitializeLifetimeService() |
Veraltet.
Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject) |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
MemberwiseClone(Boolean) |
Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject) |
OnStateChange(StateChangeEventArgs) |
Löst das StateChange-Ereignis aus. (Geerbt von DbConnection) |
Open() |
Öffnet eine Datenbankverbindung mit den von der ConnectionString angegebenen Eigenschafteneinstellungen. |
OpenAsync() |
Eine asynchrone Version von Open(), die eine Datenbankverbindung mit den Einstellungen öffnet, die durch ConnectionString angegeben werden. Diese Methode ruft die virtuelle Methode OpenAsync(CancellationToken) mit CancellationToken.None auf. (Geerbt von DbConnection) |
OpenAsync(CancellationToken) |
Dies ist die asynchrone Version von Open(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das Abbruchtoken kann optional berücksichtigt werden. Die Standardimplementierung ruft den asynchronen Open()-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten hat. Die Ausnahmen, die von Open ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt. Rufen Sie keine anderen Methoden und Eigenschaften des |
ReleaseObjectPool() |
Gibt an, dass der OleDbConnection-Objektpool freigegeben werden kann, sobald die letzte zugrunde liegende Verbindung freigegeben wurde. |
ResetState() |
Aktualisiert die State-Eigenschaft des OleDbConnection-Objekts. |
ToString() |
Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden. (Geerbt von Component) |
Ereignisse
Disposed |
Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird. (Geerbt von Component) |
InfoMessage |
Tritt beim Senden von Warn- oder Informationsmeldungen durch den Provider ein. |
StateChange |
Tritt auf, wenn sich der Status der Verbindung ändert. |
StateChange |
Tritt auf, wenn sich der Status der Verbindung ändert. (Geerbt von DbConnection) |
Explizite Schnittstellenimplementierungen
ICloneable.Clone() |
Eine Beschreibung dieses Elements finden Sie unter Clone(). |
IDbConnection.BeginTransaction() |
Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht. Beginnt eine Datenbanktransaktion. |
IDbConnection.BeginTransaction() |
Beginnt eine Datenbanktransaktion. (Geerbt von DbConnection) |
IDbConnection.BeginTransaction(IsolationLevel) |
Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht. Beginnt eine Datenbanktransaktion mit der angegebenen Isolationsstufe. |
IDbConnection.BeginTransaction(IsolationLevel) |
Beginnt eine Datenbanktransaktion mit der angegebenen Isolationsstufe. (Geerbt von DbConnection) |
IDbConnection.CreateCommand() |
Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht. Erstellt ein command-Objekt, das der Verbindung zugeordnet ist, und gibt dieses zurück. |
IDbConnection.CreateCommand() |
Erstellt ein DbCommand-Objekt, das der aktuellen Verbindung zugeordnet ist, und gibt dieses zurück. (Geerbt von DbConnection) |
Erweiterungsmethoden
ConfigureAwait(IAsyncDisposable, Boolean) |
Konfiguriert, wie Wartezeiten auf die Aufgaben angewandt werden, die von einem asynchronen verwerfbaren Element zurückgegeben werden. |
Gilt für:
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für