IDbConnection-Schnittstelle
Stellt eine geöffnete Verbindung mit einer Datenquelle dar und wird von .NET Framework-Datenprovidern implementiert, die auf relationale Datenbanken zugreifen.
Namespace: System.Data
Assembly: System.Data (in system.data.dll)
Syntax
'Declaration
Public Interface IDbConnection
Inherits IDisposable
'Usage
Dim instance As IDbConnection
public interface IDbConnection : IDisposable
public interface class IDbConnection : IDisposable
public interface IDbConnection extends IDisposable
public interface IDbConnection extends IDisposable
Hinweise
Die IDbConnection-Schnittstelle ermöglicht einer erbenden Klasse das Implementieren einer Connection-Klasse, die eine eindeutige Sitzung mit einer Datenquelle darstellt (z. B. eine Netzwerkverbindung mit einem Server). Weitere Informationen über Connection-Klassen finden Sie unter Herstellen von Verbindungen zu Datenquellen. Weitere Informationen über das Implementieren von .NET Framework-Datenanbietern finden Sie unter Implementing a .NET Framework Data Provider.
Eine Anwendung erstellt eine Instanz der IDbConnection-Schnittstelle nicht direkt, sondern erstellt eine Instanz einer Klasse, die eine IDbConnection-Schnittstelle erbt.
Klassen, die IDbConnection erben, müssen alle geerbten Member implementieren. Sie definieren i. d. R. zusätzliche Member, um anbieterspezifische Funktionen hinzuzufügen. Die IDbConnection-Schnittstelle definiert z. B. die ConnectionTimeout-Eigenschaft. Die SqlConnection-Klasse erbt wiederum diese Eigenschaft und definiert außerdem die PacketSize-Eigenschaft.
Hinweise für Implementierer Benennen Sie zur Förderung der Konsistenz unter den .NET Framework-Datenprovidern die erbende Klasse in der Form PrvClassname, wobei Prv das einheitliche Präfix für alle Klassen in einem bestimmten Namespace von .NET Framework-Datenprovidern ist. Sql ist z. B. das Präfix der SqlConnection-Klasse im System.Data.SqlClient-Namespace. Wenn Sie die IDbConnection-Schnittstelle vererben, müssen Sie die folgenden Konstruktoren implementieren:
Element |
Beschreibung |
|---|---|
PrvConnection() |
Initialisiert eine neue Instanz der PrvConnection-Klasse. |
PrvConnection(string connectionString) |
Initialisiert eine neue Instanz der PrvConnection-Klasse, sofern eine Zeichenfolge mit der Verbindungszeichenfolge angegeben wird. |
Beispiel
Im folgenden Beispiel werden Instanzen der abgeleiteten Klasse SqlCommand und der abgeleiteten KlasseSqlConnection erstellt. Die SqlConnection-Klasse wird geöffnet und als Connection-Eigenschaft für die SqlCommand-Klasse festgelegt. Anschließend wird ExecuteNonQuery aufgerufen, und die Verbindung wird geschlossen. Dafür wird an ExecuteNonQuery eine Verbindungszeichenfolge und eine Abfragezeichenfolge übergeben, die eine Transact-SQL-INSERT-Anweisung ist.
Private Sub OpenSqlConnection()
Dim connectionString As String = GetConnectionString()
Using connection As New SqlConnection(connectionString)
connection.Open()
Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
Console.WriteLine("State: {0}", connection.State)
End Using
End Sub
Private Function GetConnectionString() As String
' To avoid storing the connection string in your code,
' you can retrieve it from a configuration file, using the
' System.Configuration.ConfigurationSettings.AppSettings property
Return "Data Source=(local);Database=AdventureWorks;" _
& "Integrated Security=SSPI;"
End Function
private static void OpenSqlConnection()
{
string connectionString = GetConnectionString();
using (SqlConnection connection = new SqlConnection(connectionString))
{
connection.Open();
Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
Console.WriteLine("State: {0}", connection.State);
}
}
static private string GetConnectionString()
{
// To avoid storing the connection string in your code,
// you can retrieve it from a configuration file, using the
// System.Configuration.ConfigurationSettings.AppSettings property
return "Data Source=(local);Initial Catalog=AdventureWorks;"
+ "Integrated Security=SSPI;";
}
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0