Code-Beispiel

Auf- und Abbau einer OLEDB-Verbindung

Ein Beispiel zum Einsatz der Klasse System.Data.OleDb.OleDbConnection aus der .NET-Klassenbibliothek.

Autor: Dr. Holger Schwichtenberg

Beschreibung

Sehr ähnlich sind sich ADO und ADO.NET in Bezug auf die Kommunikation zwischen der Datenzugriffs-Komponente und der Datenquelle. Sowohl ADO als auch ADO.NET nutzen dazu das Konzept einer Verbindung, die zu einer (passiven) Datenbankdatei (z.B. einer Microsoft Access Datenbank .mdb) oder einem (aktiven) Datenbankserverprozess einer Client/Server-Datenbank vor dem ersten Zugriff aufgebaut wird. Im ersten Fall entspricht die Verbindung einem Zugriff auf die Datei, im letzteren einer Netzwerkverbindung. Zur Spezifikation der Datenquelle werden so genannte Verbindungszeichenfolgen (engl. Connection Strings) verwendet.

Durch den Verbindungsaufbau wird eine Sitzung eingerichtet. Innerhalb einer Sitzung können eine oder mehrere Datenbankoperationen ausgeführt werden. Nach dem Ende der Nutzung der Datenquelle sollte die Verbindung unbedingt geschlossen werden, um die von der Sitzung benötigten Ressourcen freizugeben.

Der OLEDB Data Provider und der SQL Server Data Provider unterstützen Connection Pooling, d.h. dass zwei Sitzungen, die mit der exakt gleichen Verbindungszeichenfolge aufgebaut werden, auf ein und dieselbe Sitzung abgebildet werden. Auch werden Sitzungen nicht sofort nach dem Schließen mit Close() abgebaut, sondern noch eine Zeit lang aufrechterhalten für den Fall, dass es neue Verbindungswünsche gibt.

Die Änderungen beim Verbindungs-Handling zwischen ADO und ADO.NET sind – im Vergleich zu allen anderen Klassen – gering:
  • Der Klassenname hat sich von ADODB.Connection zu System.Data.OleDb.OleDbConnection geändert.
  • Die Verbindungszeichenfolge kann nun per Konstruktor übergeben werden.
  • Die Methoden Open() und Close() existieren weiterhin. Open() besitzt in ADO.NET aber im Gegensatz zu ADO keine Parameter mehr.

Beispiel
Die folgende Routine baut eine Verbindung zu einer Datenbank auf und gibt dann einige Informationen über diese Verbindung aus. Danach wird die Verbindung wieder geschlossen. Die Attribute Provider, DataSource, ServerVersion und Database sind dabei Extrakte der übergebenen Verbindungszeichenfolge. Die komplette Verbindungszeichenfolge steht im Attribut ConnectionString.

Programmcodebeispiele Visual Basic .NET (VB.NET)

' ============================
' .NET-Code-Beispiel in Visual Basic .NET
' Auf- und Abbau einer OLEDB-Verbindung
' (C) Holger@Schwichtenberg.de
' ============================
Sub ADONET_Connect()
Dim Conn As OleDbConnection
Dim Com As OleDbCommand
Dim DR As OleDbDataReader

outtitle("OLEDB-Verbindung testen")

' --- Verbindung aufbauen
Conn = New OleDbConnection(CONNSTRING)
Conn.Open()

' --- Informationen über die Verbindung ausgeben
out("OLEDB Provider: " & Conn.Provider)
out("Datenquelle: " & Conn.DataSource)
out("Serverversion: " & Conn.ServerVersion)
out("Datenbank: " & Conn.Database)
out("Verbindungszeichenfolge: " & Conn.ConnectionString)
out("Timout-Zeit: " & Conn.ConnectionTimeout)
out("Verbindungsstatus: " & Conn.State)
out(Conn.ToString)

' --- Verbindung schließen
Conn.Close()

out("Verbindung beendet!")
End Sub

Programmcodebeispiele CSharp (C#)

using System;
using System.Data;
using System.Data.OleDb;

namespace FCLBuch._SystemData {

public class SamplesADONETDataReader {

public void ADONET_connect() {

// Auf- und Abbau einer OLEDB-Verbindung
FclOutput.PrintOut( "OLEDB-Verbindung testen" );

// Verbindung aufbauen
OleDbConnection conn = new OleDbConnection( ADONET_Globals.ConnectionString );
conn.Open();

// Informationen über die Verbindung ausgeben
FclOutput.PrintOut("OLEDB Provider: " + conn.Provider);
FclOutput.PrintOut("Datenquelle: " + conn.DataSource);
FclOutput.PrintOut("Serverversion: " + conn.ServerVersion);
FclOutput.PrintOut("Datenbank: " + conn.Database);
FclOutput.PrintOut("Verbindungszeichenfolge: " + conn.ConnectionString);
FclOutput.PrintOut("Timeout-Zeit: " + conn.ConnectionTimeout);
FclOutput.PrintOut("Verbindungsstatus: " + conn.State);
FclOutput.PrintOut(conn.ToString() );

// Verbindung schließen
conn.Close();

FclOutput.PrintOut("Verbindung beendet!");
}
}
}

Hinweise

Ausgaben werden in den Beispielen durch Hilfsroutinen wie out() und PrintOut() erzeugt. Diese sind hier nicht angegeben, da deren Implementierung von der jeweiligen Umgebung abhängt. Für Konsolenanwendungen können hier z.B. Console.WriteLine() einsetzen.


 

Querverweise

 Liste aller Codebeispiele  Definition '.NET Framework Class Library'  Verfügbarkeit der Klasse 'System.Data.OleDb.OleDbConnection'  Übersicht über den FCL-Namensraum 'System.Data.OleDb'  .NET & Visual Studio Community Portal

Buchtipp

Buchcover PowerShell 7 und Windows PowerShell 5 – das Praxishandbuch (5. Auflage Oktober 2022 (9. Auflage Gesamtreihe)) PowerShell 7 und Windows PowerShell 5 – das Praxishandbuch
Autoren: Dr. Holger Schwichtenberg
erschienen 10/2022, 1426 Seiten
ISBN: 3446472967

Beratung & Support

Schulungen zu diesem Thema

 Visual Basic .NET - Aufbauwissen
 Grundlagen der objektorientierten Programmierung anhand von C# oder Visual Basic .NET
 Unit Testing / Testgetriebene Entwicklung / Test Driven Development (TDD) von .NET-Anwendungen (C# oder Visual Basic .NET)
 Visual Basic 6.0 (VB6.0)
 Objektorientierte Entwurfsmuster (Design-Pattern/Architektur-Pattern) mit .NET (C#, Visual Basic .NET)
 Visual Basic .NET - Basiswissen
 Windows Modern Apps/Windows Universal Apps entwickeln mit der Windows Runtime (WinRT), XAML und .NET/C#/Visual Basic
 Visual Basic Script (VBScript/VBS) - Sprachsyntax und Praxiseinsatz
 Word-Programmierung mit Visual Basic for Applications (VBA)
 Visual Studio Tools for Microsoft Office (VSTO) - Microsoft Office-Programmierung mit .NET und C# oder Visual Basic in Visual Studio
 Multi-Threading in .NET mit C#/Visual Basic .NET und/oder C++ und C++/CLI
 C# für Umsteiger von Visual Basic .NET
 Objektorientierte Programmierung (OOP) mit C#, Java, C++, Visual Basic.NET o.ä.
 Excel-Programmierung mit Visual Basic for Applications (VBA)
 Visual Basic .NET für Umsteiger von VBA/VB 4/5/6
 Visual Basic 2005 (Visual Basic 8.0)
 .NET und C# für Umsteiger von klassischem Visual Basic/COM
 Outlook-Programmierung mit Visual Basic for Applications (VBA)
 Das Component Object Model - für Script- und Visual Basic-Entwickler
 C#-Basiswissen (Grundlagen der Programmiersprache C#)
 .NET Akademie: Unit Testing und Test Driven Development (TDD) mit .NET/C# (3-Tages-Agenda des öffentlichen Seminars)
 Neuerungen in C# 7.0/7.1/7.2/7.3
 Task Parallel Library (TPL) - Parallelprogrammierung/Multi-Threading in .NET/C#
 Event Driven Design (mit .NET/C# oder Java)
 Neuerung in der CLR 2.0 und C# 2005
 Neuerungen in C# 6.0
 .NET Akademie: Blazor-Hands-On: Echte Single-Page-Web-Apps mit .NET und C# entwickeln (3-Tages-Agenda des öffentlichen Seminars)
 Neuerungen in C# 3.0 (Visual C# 2008)
 Refactoring von Programmcode in C, C++, C#, Java, Kotlin, JavaScript, TypeScript, Python, Go oder Rust
 Windows 8/Windows 8.1 für Entwickler: Programmierung mit der Windows Runtime (WinRT) - Erstellen von Windows Apps mit C#/XAML und/oder JavaScript/HTML
 Anfrage für eine individuelle Schulung zum Thema Visual Basic C#  Gesamter Schulungsthemenkatalog

Bücher zu diesem Thema

  Blazor 8.0: Moderne Webanwendungen und hybride Cross-Platform-Apps mit .NET 8.0, C# 12.0 und Visual Studio 2022
  C# 12.0 Crashkurs
  C# 11.0 Crashkurs
  C# 10.0 Crashkurs
  C# 9.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET 5.0, .NET Core und Xamarin
  ASP.NET Core Blazor 3.1/3.2: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio
  ASP.NET Core Blazor 3.0/3.1: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio
  C# 8.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
  C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
  Modern Data Access with Entity Framework Core: Database Programming Using .NET, .NET Core, UWP, and Xamarin with C#
  C# 7.2 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
  Effizienter Datenzugriff mit Entity Framework Core: Datenbankprogrammierung mit C# für .NET Framework, .NET Core und Xamarin
  Windows Store Apps entwickeln mit C# und XAML - Crashkurs
  Microsoft ASP.NET 4.0 mit C# 2010 - Entwicklerbuch
  Microsoft Viusal C# 2010
  Visual Basic 2010: Grundlagen, ADO.NET, Windows Presentation Foundation
  ASP.NET 4.0 mit Visual C# 2010
  Visual Basic 2010
  Microsoft ASP.NET 3.5 mit Visual Basic 2008 - Entwicklerbuch
 Alle unsere aktuellen Fachbücher  E-Book-Abo für ab 99 Euro im Jahr