Jegliche Interaktion zwischen einer .NET-Anwendung und einem MySQL Server vollzieht sich durch ein MySqlConnection-Objekt. Also muss, ehe Sie mit dem Server kommunizieren können, zunächst ein MySqlConnection-Objekt erzeugt, konfiguriert und geöffnet werden.

Auch wenn die Klasse MySqlHelper benutzt wird, wird ein MySqlConnection-Objekt von dieser Hilfsklasse angelegt.

In diesem Abschnitt wird beschrieben, wie man über das MySqlConnection-Objekt mit MySQL Verbindung aufnimmt.

Das MySqlConnection-Objekt ist für einen Verbindungs-String konfiguriert. Dieser String enthält mehrere, durch Semikola getrennte Schlüssel/Wert-Paare, die jeweils durch ein Gleichheitszeichen verbunden sind.

Sehen Sie hier ein Beispiel für einen Verbindungs-String:

    Server=127.0.0.1;Uid=root;Pwd=12345;Database=test;
    

In diesem Beispiel ist das MySqlConnection-Objekt so konfiguriert, dass es sich mit einem MySQL Server auf 127.0.0.1 verbindet und dazu den Benutzernamen root und das Passwort 12345 verwendet. Als Standarddatenbank für alle Anweisungen benutzen wir test.

Die folgenden Optionen werden typischerweise gesetzt (eine vollständige Liste der Optionen finden Sie in der nachfolgenden Tabelle):

Die folgende Tabelle führt die Namen für alle zulässigen Schlüsselwortwerte des ConnectionStrings auf.

Sobald Sie den Verbindungs-String angelegt haben, können Sie ihn nutzen, um eine Verbindung zu einem MySQL Server damit aufzubauen.

Der folgende Code erzeugt ein MySqlConnection-Objekt, weist den Verbindungs-String zu und öffnet die Verbindung.

Visual Basic-Beispiel

Dim conn As New MySql.Data.MySqlClient.MySqlConnection
Dim myConnectionString as String

myConnectionString = "server=127.0.0.1;" _
            & "uid=root;" _
            & "pwd=12345;" _
            & "database=test;"

Try
  conn.ConnectionString = myConnectionString
  conn.Open()

Catch ex As MySql.Data.MySqlClient.MySqlException
  MessageBox.Show(ex.Message)
End Try
  

C#-Beispiel

MySql.Data.MySqlClient.MySqlConnection conn;
string myConnectionString;
    
myConnectionString = "server=127.0.0.1;uid=root;" +
    "pwd=12345;database=test;";
  
try
{
    conn = new MySql.Data.MySqlClient.MySqlConnection();
    conn.ConnectionString = myConnectionString;
    conn.Open();
}
catch (MySql.Data.MySqlClient.MySqlException ex)
{
    MessageBox.Show(ex.Message);
}

Sie können den Verbindungs-String auch an den Klassenkonstruktor von MySqlConnection übergeben:

Visual Basic-Beispiel

Dim myConnectionString as String

myConnectionString = "server=127.0.0.1;" _
              & "uid=root;" _
              & "pwd=12345;" _
              & "database=test;" 

Try
    Dim conn As New MySql.Data.MySqlClient.MySqlConnection(myConnectionString)
    conn.Open()
Catch ex As MySql.Data.MySqlClient.MySqlException
   MessageBox.Show(ex.Message)
End Try
  

C#-Beispiel

MySql.Data.MySqlClient.MySqlConnection conn;
string myConnectionString;

myConnectionString = "server=127.0.0.1;uid=root;" +
    "pwd=12345;database=test;";

try
{
    conn = new MySql.Data.MySqlClient.MySqlConnection(myConnectionString);
    conn.Open();
}
catch (MySql.Data.MySqlClient.MySqlException ex)
{
    MessageBox.Show(ex.Message);
}

Sobald die Verbindung geöffnet ist, können auch andere Connector/NET-Klassen sie zur Kommunikation mit dem MySQL Server nutzen.

Da eine Verbindung mit einem externen Server immer Unwägbarkeiten in sich birgt, muss Ihre .NET-Anwendung auch mit Fehlern umgehen können. Tritt bei der Verbindung ein Fehler auf, gibt die Klasse MySqlConnection ein MySqlException-Objekt zurück. Dieses Objekt hat zwei Eigenschaften, die für die Fehlerbehandlung interessant sind:

Sie können die Reaktion Ihrer Anwendung auf Fehler auf der Basis der Fehlernummer gestalten. Die beiden Fehler, die bei Verbindungsproblemen am häufigsten auftreten, sind:

Der folgende Code zeigt, wie die Anwendung auf die jeweilige Fehlernummer reagieren kann:

Visual Basic-Beispiel

Dim myConnectionString as String

myConnectionString = "server=127.0.0.1;" _
          & "uid=root;" _
          & "pwd=12345;" _
          & "database=test;" 

Try
    Dim conn As New MySql.Data.MySqlClient.MySqlConnection(myConnectionString)
    conn.Open()
Catch ex As MySql.Data.MySqlClient.MySqlException
    Select Case ex.Number
        Case 0
            MessageBox.Show("Cannot connect to server. Contact administrator")
        Case 1045
            MessageBox.Show("Invalid username/password, please try again")
    End Select
End Try
  

C#-Beispiel

MySql.Data.MySqlClient.MySqlConnection conn;
string myConnectionString;

myConnectionString = "server=127.0.0.1;uid=root;" +  
    "pwd=12345;database=test;";

try
{
    conn = new MySql.Data.MySqlClient.MySqlConnection(myConnectionString);
    conn.Open();
}
    catch (MySql.Data.MySqlClient.MySqlException ex)
{
    switch (ex.Number)
    {
        case 0:
            MessageBox.Show("Cannot connect to server.  Contact administrator");
        case 1045:
            MessageBox.Show("Invalid username/password, please try again");
    }
}
  

Wichtig: Wenn Sie Datenbanken mit mehreren Sprachen verwenden, müssen Sie den jeweiligen Zeichensatz im Verbindungs-String angeben, sonst wird latin1 als Standardzeichensatz zugrunde gelegt. Ein Beispiel für die Angabe eines Zeichensatzes im Verbindungs-String folgt:

MySqlConnection myConnection = new MySqlConnection("server=127.0.0.1;uid=root;" +
    "pwd=12345;database=test;Charset=latin1;");