Freigeben über

Erstellen von Anwendungen für Desktopcomputer (SQL Server Compact)

  • Artikel

Sie können SQL Server Compact als Datenspeicher für Computeranwendungen verwenden. In diesem Thema erfahren Sie, wie Sie SQL Server Compact einem Visual Studio-Produkt hinzufügen und dann für den System.Data.SqlServerCe-Namespace programmieren können. Informationen zu verwalteten Verweisen für den System.Data.SqlServerCe-Namespace finden Sie in der Referenzdokumentation zu .NET Framework.

Erstellen eines Computerprojekts

Um eine neue Computeranwendung zu erstellen, müssen Sie zunächst ein Windows-Projekt in Visual Studio erstellen. Für eine Computeranwendung müssen Sie anschließend einen Verweis auf den Microsoft.Ink-Namespace hinzufügen.

Hinweis

Wenn Sie die Tablet PC-Anwendung auf einem Computer ohne Windows XP Tablet PC Edition entwickeln, müssen Sie zunächst das Microsoft Windows XP Tablet PC Edition Development Kit installieren. Sie können die neueste Version vom Developer Center für mobile und eingebettete Anwendungen herunterladen.

So erstellen Sie ein neues Computerprojekt

  1. Zeigen Sie in Visual Studio im Menü Datei auf Neu, und wählen Sie Projekt aus.

  2. Erweitern Sie im Dialogfeld Neues Projekt in der Liste Installierte Vorlagen die Programmiersprache, die Sie verwenden möchten. Wählen Sie dann Windows aus.

  3. Wählen Sie in der Liste Vorlagen den Eintrag Windows Forms-Anwendung aus.

  4. Geben Sie einen Namen und einen Speicherort für Ihr Projekt an, und klicken Sie dann auf OK.

    Visual Studio erstellt ein neues Projekt und zeigt das Hauptformular (Form1) an.

  5. (Optional) Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und wählen Sie Verweis hinzufügen aus.

    Hinweis

    Wenn der Ordner Verweise nicht im Projektmappen-Explorer aufgelistet wird, klicken Sie oben im Projektmappen-Explorer auf Alle Dateien anzeigen.

  6. (Optional) Wählen Sie in der Liste der .NET-Assemblys den Eintrag Microsoft Tablet PC API aus, und klicken Sie dann auf OK.

    Die Liste der Verweise enthält jetzt Microsoft.Ink.

Hinzufügen von SQL Server Compact 4.0 zum Projekt bei zentraler Bereitstellung

Nachdem Sie das Projekt erstellt haben, müssen Sie einen Verweis auf die SQL Server Compact-Assembly hinzufügen. Die Verfahren zum Hinzufügen von Verweisen auf die SQL Server Compact-Assemblys unterscheiden sich geringfügig, je nachdem, ob Sie eine Anwendung für die private oder für die zentrale Bereitstellung von SQL Server Compact erstellen. Führen Sie folgende Schritte für die zentrale Bereitstellung aus.

So fügen Sie einen Verweis auf SQL Server Compact 4.0 für die zentrale Bereitstellung hinzu

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und wählen Sie Verweis hinzufügen aus.

    Hinweis

    Wenn der Ordner Verweise nicht im Projektmappen-Explorer aufgelistet ist, klicken Sie oben im Projektmappen-Explorer auf Alle Dateien anzeigen.

  2. Wählen Sie in der Liste der .NET-Assemblys System.Data.SqlServerCe aus, und klicken Sie dann auf OK. Führen Sie die folgenden Schritte aus, wenn System.Data.SqlServerCe nicht aufgelistet ist:

    1. Klicken Sie im Dialogfeld Verweise hinzufügen auf Durchsuchen.

    2. Navigieren Sie zum Ordner %Program Files%\Microsoft SQL Server Compact Edition\v4.0\Desktop.

    3. Wählen Sie System.Data.SqlServerCe.dll aus, und klicken Sie auf OK.

    Die Liste der Verweise im Projektmappen-Explorer enthält nun auch System.Data.SqlServerCe, sodass die Assembly im Projekt verwendet werden kann.

    Hinweis

    Wenn das Projekt Entity Framework verwendet, wiederholen Sie die Schritte, um einen Verweis auf System.Data.SqlServerCe.Entity hinzuzufügen. Sie können System.Data.SqlServerCe.Entity aus der Liste der .NET-Assemblys hinzufügen oder zu %Program Files%\Microsoft SQL Server Compact Edition\v4.0 navigieren.

  3. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Form1.cs oder Form1.vb, und wählen Sie Code anzeigen aus.

  4. Fügen Sie zu Beginn des Formularcodes eine Direktive zum Verwenden des System.Data.SqlServerCe-Namespaces hinzu. Wenn Sie Entity Framework verwenden, fügen Sie eine Direktive zur Verwendung des System.Data.SqlServerCe-Namespaces hinzu. Fügen Sie für eine Tablet PC-Anwendung ebenfalls eine Direktive zur Verwendung der Tablet PC-API hinzu:

    • C#

      using System.Data.SqlServerCe;
using System.Data.SqlServerCe.Entity; 
using Microsoft.Ink;

    • Visual Basic

      Imports System.Data.SqlServerCe
Imports System.Data.SqlServerCe.Entity
Imports Microsoft.Ink

Hinzufügen von SQL Server Compact 4.0 zum Projekt bei privater Bereitstellung

Nachdem Sie das Projekt erstellt haben, müssen Sie einen Verweis auf die SQL Server Compact-Assembly hinzufügen. Die Verfahren zum Hinzufügen von Verweisen auf die SQL Server Compact-Assemblys unterscheiden sich geringfügig, je nachdem, ob Sie eine Anwendung für die private oder für die zentrale Bereitstellung von SQL Server Compact erstellen. Führen Sie folgende Schritte für die private Bereitstellung aus.

So fügen Sie einen Verweis auf SQL Server Compact 4.0 für die zentrale Bereitstellung hinzu

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und wählen Sie Verweis hinzufügen aus.

    Hinweis

    Wenn der Ordner Verweise nicht im Projektmappen-Explorer aufgelistet ist, klicken Sie oben im Projektmappen-Explorer auf Alle Dateien anzeigen.

  2. Klicken Sie im Dialogfeld Verweise hinzufügen auf Durchsuchen.

  3. Navigieren Sie zum Ordner %Program Files%\Microsoft SQL Server Compact Edition\v4.0\Private.

  4. Wählen Sie System.Data.SqlServerCe aus, und klicken Sie auf OK.

    Die Liste der Verweise im Projektmappen-Explorer enthält nun auch System.Data.SqlServerCe, sodass die Assembly im Projekt verwendet werden kann.

    Hinweis

    Wenn das Projekt Entity Framework verwendet, wiederholen Sie die Schritte, um einen Verweis auf System.Data.SqlServerCe.Entity hinzuzufügen. (Bei der privaten Bereitstellung wird System.Data.SqlServerCe.Entity ebenfalls aus dem Ordner %Program Files%\Microsoft SQL Server Compact Edition\v4.0\Private hinzugefügt.)

  5. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Form1.cs oder Form1.vb, und wählen Sie Code anzeigen aus.

  6. Fügen Sie zu Beginn des Formularcodes eine Direktive zum Verwenden des System.Data.SqlServerCe-Namespaces hinzu. Wenn Sie Entity Framework verwenden, fügen Sie eine Direktive zur Verwendung des System.Data.SqlServerCe-Namespaces hinzu. Fügen Sie für eine Tablet PC-Anwendung ebenfalls eine Direktive zur Verwendung der Tablet PC-API hinzu:

    • C#

      using System.Data.SqlServerCe;
using System.Data.SqlServerCe.Entity; 
using Microsoft.Ink;

    • Visual Basic

      Imports System.Data.SqlServerCe
Imports System.Data.SqlServerCe.Entity
Imports Microsoft.Ink

Konfigurieren von SQL Server Compact für die private Bereitstellung

Um eine Anwendung zu erstellen, die die private Bereitstellung für SQL Server Compact verwendet, müssen Sie sicherstellen, dass der .NET Framework-Datenanbieter und alle erforderlichen systemeigenen DLLs im Ausgabeverzeichnis der Anwendung bereitgestellt werden. Wenn die Anwendung die private Bereitstellung für SQL Server Compact verwenden soll, führen Sie die Schritte in diesem Abschnitt aus. Wenn die Anwendung keine private Bereitstellung verwendet, überspringen Sie diesen Abschnitt. Weitere Informationen zur privaten Bereitstellung von SQL Server Compact finden Sie unter Private Bereitstellung oder zentrale Bereitstellung (SQL Server Compact). Bei den folgenden Schritten wird davon ausgegangen, dass die Anwendung für eine beliebige Plattform (32-Bit und 64-Bit) erstellt wird. Wenn die Anwendung nur für eine dieser Plattformen erstellt wird, können Sie Schritte auslassen, die sich auf die jeweils andere Plattform beziehen.

So konfigurieren Sie die Anwendung für die private Bereitstellung von SQL Server Compact

  1. Konfigurieren Sie den .NET Framework-Datenanbieter für die SQL Server Compact-Assembly so, dass er bei der Projekterstellung in das Ausgabeverzeichnis kopiert wird.

    1. Erweitern Sie im Projektmappen-Explorer die Option Verweise, klicken Sie mit der rechten Maustaste auf System.Data.SqlServerCe, und wählen Sie Eigenschaften aus.

    2. Legen Sie in den Verweiseigenschaften für System.Data.SqlServerCe die Option Lokale Kopie auf True fest.

    Hinweis

    Wenn das Projekt Entity Framework verwendet, wiederholen Sie die Schritte für System.Data.SqlServerCe.Entity, um den Entity Framework-Datenanbieter für SQL Server Compact so zu konfigurieren, dass er in das Ausgabeverzeichnis kopiert wird.

  2. Fügen Sie dem Projekt die erforderlichen systemeigenen SQL Server Compact-32-Bit-Bibliotheken hinzu.

    1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, zeigen Sie auf Hinzufügen, und wählen Sie Neuer Ordner aus. Geben Sie dem Ordner den Namen x86.

    2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Ordner x86, zeigen Sie auf Hinzufügen, und wählen Sie Vorhandenes Element aus.

    3. Wechseln Sie im Dialogfeld Vorhandenes Element hinzufügen zu dem Ordner, in dem sich die systemeigenen 32-Bit-Bibliotheken befinden. Unter einer 32-Bit-Version von Windows ist dies %Programm Files%\Microsoft SQL Server Compact Edition\v4.0. Unter einer 64-Bit-Version von Windows ist dies %Program Files (x86)%\Microsoft SQL Server Compact Edition\v4.0.

    4. Klicken Sie bei gedrückter STRG-TASTE auf jede der erforderlichen systemeigenen Bibliotheken für das Projekt, um sie in der Dateiliste auszuwählen, und klicken Sie dann auf OK. Die Bibliotheken werden dem Ordner x86 hinzugefügt.

      Hinweis

      Sie müssen mindestens die folgenden Bibliotheken hinzufügen: sqlceme40.dll, sqlceqp40.dll, sqlcese40.dll und sqlceer40.dll.

  3. Fügen Sie dem Projekt die erforderlichen systemeigenen 64-Bit-SQL Server Compact-Bibliotheken hinzu.

    1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, zeigen Sie auf Hinzufügen, und wählen Sie Neuer Ordner aus. Geben Sie dem Ordner den Namen x64.

    2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Ordner x64, zeigen Sie auf Hinzufügen, und wählen Sie Vorhandenes Element aus.

    3. Wechseln Sie im Dialogfeld Vorhandenes Element hinzufügen zu dem Ordner, in dem sich die systemeigenen 64-Bit-Bibliotheken befinden. Unter einer 64-Bit-Version von Windows ist dies %Programm Files%\Microsoft SQL Server Compact Edition\v4.0.

      Hinweis

      Die 64-Bit-Version von SQL Server Compact kann nicht auf einem Computer installiert werden, auf dem eine 32-Bit-Version von Windows ausgeführt wird. Um einem Projekt, das in einer 32-Bit-Entwicklungsumgebung erstellt wird, systemeigene 64-Bit-Bibliotheken hinzuzufügen, müssen Sie die Dateien zuerst aus dem 64-Bit-Installationsprogramm in ein Verzeichnis auf dem Entwicklungscomputer extrahieren. Anschließend können Sie zu diesem Verzeichnis wechseln, um dem Projekt die systemeigenen 64-Bit-Bibliotheken hinzuzufügen. Informationen zum Extrahieren von Dateien aus dem Installationsprogramm finden Sie unter Vorgehensweise: Extrahieren von 64-Bit-DLLs aus dem Installationsprogramm für SQL Server Compact Runtime.

    4. Klicken Sie bei gedrückter STRG-TASTE auf jede der erforderlichen systemeigenen Bibliotheken für das Projekt, um sie in der Dateiliste auszuwählen, und klicken Sie dann auf OK. Die Bibliotheken werden dem Ordner x64 hinzugefügt.

      Hinweis

      Sie müssen mindestens die folgenden Bibliotheken hinzufügen: sqlceme40.dll, sqlceqp40.dll, sqlcese40.dll und sqlceer40.dll.

  4. Konfigurieren Sie jede der in den vorangehenden Schritten hinzugefügten, systemeigenen Bibliotheken so, dass sie bei der Projekterstellung in das Ausgabeverzeichnis kopiert werden. Dieser Schritt muss für die Bibliotheken in beiden Verzeichnissen ausgeführt werden.

    1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Bibliothek (z. B. sqlcese40.dll), und wählen Sie die Eigenschaften aus.

      Hinweis

      Wenn die Assemblys nicht im Projektmappen-Explorer aufgeführt sind, klicken Sie oben im Projektmappen-Explorer auf Alle Dateien anzeigen.

    2. Wählen Sie unter Eigenschaften den Eintrag Immer kopieren oder Kopieren, wenn neuer aus der Dropdownliste In Ausgabeverzeichnis kopieren aus.

  5. Konfigurieren Sie das Projekt für die Erstellung mit der Option Beliebige CPU.

    1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, und wählen Sie Eigenschaften aus, um den Projekt-Designer zu öffnen.

    2. Klicken Sie auf Erstellen, und wählen Sie aus der Dropdownliste Zielplattform den Eintrag Beliebige CPU aus.

Verwenden der SQL Server Compact 4.0-Objekte

Nachdem Sie den System.Data.SqlServerCe-Namespace hinzugefügt haben, können Sie ihn mithilfe der SQL Server Compact-Objekte im Code verwenden. Im folgenden Codebeispiel wird gezeigt, wie mithilfe des Engine-Objekts eine neue SQL Server Compact-Datenbankdatei erstellt werden kann.

using System;
using System.Data.SqlServerCe;
using System.IO;

public class MySqlCeEngine
{
    public void CreateDB()
    {
        File.Delete("Test.sdf");
        string connString = "Data Source='Test.sdf'; LCID=1031;   Password=<enterStrongPasswordHere>; Encrypt = TRUE;";
        SqlCeEngine engine = new SqlCeEngine(connString);
        engine.CreateDatabase();
    }
}

Imports System
Imports System.Data.SqlServerCe
Imports System.IO

Public Class MySqlCeEngine

    Public Sub CreateDB()
        File.Delete("Test.sdf")
        Dim connString As String = "Data Source='Test.sdf'; LCID=1031; Password=<enterStrongPasswordHere>; Encrypt = TRUE;"
        Dim engine As New SqlCeEngine(connString)
        engine.CreateDatabase()
    End Sub
End Class

Siehe auch

Verweis

System.Data.SqlServerCe-Namespace (.NET Framework-Referenzdokumentation)