Freigeben über

Exemplarische Vorgehensweise: Einfache Datenbindung in Projekten auf Dokumentebene

  • Artikel

Aktualisiert: November 2007

Betrifft

Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office.

Projekttyp

  • Projekte auf Dokumentebene

Microsoft Office-Version

  • Excel 2007

  • Excel 2003

Weitere Informationen finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Diese exemplarische Vorgehensweise veranschaulicht die Grundlagen der Datenbindung in einem Projekt auf Dokumentebene. Ein einzelnes Datenfeld in einer SQL Server-Datenbank wird an einen benannten Bereich in Microsoft Office Excel gebunden. Die exemplarische Vorgehensweise erklärt auch das Hinzufügen von Steuerelementen, mit denen Sie einen Bildlauf durch alle Datensätze in der Tabelle durchführen können.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

  • Erstellen einer Datenquelle für ein Excel-Projekt.

  • Hinzufügen von Steuerelementen zu einem Arbeitsblatt

  • Durchführen von Bildläufen durch Datenbankdatensätze.

Hinweis:

Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Vorbereitungsmaßnahmen

Zum Durchführen dieser exemplarischen Vorgehensweise benötigen Sie die folgenden Komponenten:

  • Visual Studio Tools for Office (eine optionale Komponente von Visual Studio 2008 Professional und Visual Studio Team System).

  • Microsoft Office Excel 2003 oder Microsoft Office Excel 2007.

  • Zugriff auf einen Server mit der SQL Server-Beispieldatenbank Northwind.

  • Lese- und Schreibberechtigungen für die SQL Server-Datenbank.

Erstellen eines neuen Projekts

In diesem Schritt wird ein Excel-Arbeitsmappenprojekt erstellt.

So erstellen Sie ein neues Projekt

Visual Studio öffnet die neue Excel-Arbeitsmappe im Designer und fügt dem Projektmappen-Explorer das My Simple Data Binding-Projekt hinzu.

Erstellen der Datenquelle

Verwenden Sie das Datenquellenfenster, um dem Projekt ein typisiertes Dataset hinzuzufügen.

So erstellen Sie die Datenquelle

  1. Wenn das Datenquellenfenster nicht sichtbar ist, klicken Sie im Menü Daten auf Datenquellen anzeigen.

    Hinweis:

    Wenn der Menüpunkt Datenquellen anzeigen nicht verfügbar ist, klicken Sie in die Excel-Arbeitsmappe, und versuchen Sie es dann erneut.

  2. Klicken Sie auf Neue Datenquelle hinzufügen , um den Assistenten zum Konfigurieren von Datenquellen zu starten.

  3. Wählen Sie Datenbank aus, und klicken Sie auf Weiter.

  4. Wählen Sie eine Datenverbindung zur SQL Server-Beispieldatenbank Northwind aus, oder fügen Sie mithilfe der Schaltfläche Neue Verbindung eine neue Verbindung hinzu.

  5. Klicken Sie nach dem Auswählen oder Erstellen einer Verbindung auf Weiter.

  6. Deaktivieren Sie ggf. die Option zum Speichern der Verbindung, und klicken Sie dann auf Weiter.

  7. Erweitern Sie im Fenster Datenbankobjekte den Knoten Tabellen.

  8. Aktivieren Sie das Kontrollkästchen neben der Tabelle Customers.

  9. Klicken Sie auf Fertig stellen.

Der Assistent fügt dem Datenquellenfenster die Tabelle Customers hinzu. Außerdem wird dem Projekt ein typisiertes Dataset hinzugefügt, das im Projektmappen-Explorer sichtbar ist.

Hinzufügen von Steuerelementen zum Arbeitsblatt

Diese exemplarische Vorgehensweise setzt zwei benannte Bereiche und vier Schaltflächen auf dem ersten Arbeitsblatt voraus. Fügen Sie zuerst die beiden benannten Bereiche aus dem Datenquellenfenster hinzu, damit diese automatisch an die Datenquelle gebunden werden. Fügen Sie dann die Schaltflächen aus der Toolbox hinzu.

So fügen Sie zwei benannte Bereiche hinzu

  1. Stellen Sie sicher, dass die Arbeitsmappe My Simple Data Binding.xls in Visual Studio Designer geöffnet ist und Sheet1 angezeigt wird.

  2. Öffnen Sie das Datenquellenfenster, und erweitern Sie den Knoten Customers.

  3. Wählen Sie die Spalte CompanyName, und klicken Sie anschließend auf den angezeigten Dropdownpfeil.

  4. Klicken Sie in der Dropdownliste auf NamedRange, und ziehen Sie die Spalte CompanyName auf die Zelle A1.

    Ein NamedRange-Steuerelement mit dem Namen companyNameNamedRange wird in der Zelle A1 erstellt. Gleichzeitig werden dem Projekt eine BindingSource mit dem Namen customersBindingSource, ein Tabellenadapter und eine DataSet-Instanz hinzugefügt. Das Steuerelement ist an die BindingSource gebunden, die wiederum an die DataSet-Instanz gebunden ist.

  5. Wählen Sie im Datenquellenfenster die Spalte CustomerID, und klicken Sie anschließend auf den angezeigten Dropdownpfeil.

  6. Klicken Sie in der Dropdownliste auf NamedRange, und ziehen Sie die Spalte CustomerID auf die Zelle B1.

  7. Es wird ein weiteres, mit customerIDNamedRange benanntes NamedRange-Steuerelement in der Zelle B1 erstellt und an die BindingSource gebunden.

So fügen Sie vier Schaltflächen hinzu

  1. Klicken Sie in der Toolbox auf die Registerkarte Allgemeine Steuerelemente, und fügen Sie von dort ein Button-Steuerelement zur Zelle A3 des Arbeitsblattes hinzu.

    Diese Schaltfläche erhält den Namen Button1.

  2. Fügen Sie den folgenden Zellen je eine weitere Schaltfläche hinzu. Die Namen der Schaltflächen lauten dann:

    Zelle

    (Name)

    B3

    Button2

    C3

    Button3

    D3

    Button4

Der nächste Schritt besteht darin, den Schaltflächen Text hinzuzufügen und in C# Ereignishandler hinzuzufügen.

Initialisieren der Steuerelemente

Legen Sie den Schaltflächentext fest, und fügen Sie dem Startup-Ereignis Ereignishandler hinzu.

So initialisieren Sie die Steuerelemente

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Sheet1.vb oder Sheet1.cs, und klicken Sie dann im Kontextmenü auf Code anzeigen.

  2. Fügen Sie der Sheet1_Startup-Methode den folgenden Code hinzu, um den Text für die einzelnen Schaltflächen festzulegen.

    With Me
    .Button1.Text = "|<"
    .Button2.Text = "<"
    .Button3.Text = ">"
    .Button4.Text = ">|"
End With

    this.button1.Text = "|<";
this.button2.Text = "<";
this.button3.Text = ">";
this.button4.Text = ">|";

  3. Nur in C#: Fügen Sie der Sheet1_Startup-Methode Ereignishandler für die Klickereignisse der Schaltflächen hinzu.

    this.button1.Click += new EventHandler(button1_Click);
this.button2.Click += new EventHandler(button2_Click);
this.button3.Click += new EventHandler(button3_Click);
this.button4.Click += new EventHandler(button4_Click);

Fügen Sie nun Code für die Behandlung der Click-Ereignisse der Schaltflächen hinzu, damit der Benutzer durch die Datensätze blättern kann.

Hinzufügen von Code, um das Durchführen des Bildlaufs durch die Datensätze zu ermöglichen

Fügen Sie den Click-Ereignishandlern der einzelnen Schaltflächen Code hinzu, um durch die Datensätze zu navigieren.

So navigieren Sie zum ersten Datensatz

  • Fügen Sie dem Click-Ereignis der Button1-Schaltfläche einen Ereignishandler mit folgendem Code hinzu, um zum ersten Datensatz zu navigieren:

    Private Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Button1.Click

    Me.CustomersBindingSource.MoveFirst()
End Sub

    private void button1_Click(object sender, System.EventArgs e)
{
    this.customersBindingSource.MoveFirst();
}

So navigieren Sie zum vorherigen Datensatz

  • Fügen Sie dem Click-Ereignis der Button2-Schaltfläche einen Ereignishandler mit folgendem Code hinzu, um zur vorherigen Position zu navigieren:

    Private Sub Button2_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Button2.Click

    Me.CustomersBindingSource.MovePrevious()
End Sub

    private void button2_Click(object sender, System.EventArgs e)
{
    this.customersBindingSource.MovePrevious(); 
}

So navigieren Sie zum nächsten Datensatz

  • Fügen Sie dem Click-Ereignis der Button3-Schaltfläche einen Ereignishandler mit folgendem Code hinzu, um zur nächsten Position zu navigieren:

    Private Sub Button3_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Button3.Click

    Me.CustomersBindingSource.MoveNext()
End Sub

    private void button3_Click(object sender, System.EventArgs e)
{
    this.customersBindingSource.MoveNext();
}

So navigieren Sie zum letzten Datensatz

  • Fügen Sie dem Click-Ereignis der Button4-Schaltfläche einen Ereignishandler mit folgendem Code hinzu, um zum letzten Datensatz zu navigieren:

    Private Sub Button4_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Button4.Click

    Me.CustomersBindingSource.MoveLast()
End Sub

    private void button4_Click(object sender, System.EventArgs e)
{
    this.customersBindingSource.MoveLast();
}

Testen der Anwendung

Nun können Sie die Arbeitsmappe testen, um sicherzustellen, dass das Blättern durch die Datensätze der Datenbank möglich ist.

So testen Sie die Arbeitsmappe

  1. Drücken Sie F5, um das Projekt auszuführen.

  2. Bestätigen Sie, dass der erste Datensatz in den Zellen A1 und B1 angezeigt wird.

  3. Klicken Sie auf die Schaltfläche > (Button3), und prüfen Sie, ob in den Zellen A1 und B1 der nächste Datensatz angezeigt wird.

  4. Klicken Sie auf die anderen Navigationsschaltflächen, um zu prüfen, ob sich der Datensatz wie erwartet ändert.

Nächste Schritte

Diese exemplarische Vorgehensweise erläutert die Grundlagen des Bindens eines benannten Bereichs an ein Datenbankfeld. Die folgenden Aufgaben könnten sich daran anschließen:

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Komplexe Datenbindung in Projekten auf Dokumentebene

Konzepte

Binden von Daten an Steuerelemente

Weitere Ressourcen

Daten in Office-Lösungen