Exemplarische Vorgehensweise: Eine parametrisierte Abfrageanwendung

Artikel
09/02/2008

Aktualisiert: November 2007

Diese exemplarische Vorgehensweise veranschaulicht die Verwendung der Visual Studio-Umgebung zum Entwickeln einer einfachen Anwendung für parametrisierte Abfragen. Datenbindung und ein Großteil der Benutzeroberfläche werden automatisch für Sie generiert. Wenn Sie die bekannte Datenbank Northwind verwenden, stellt diese Anwendung ein Szenario bereit, in dem Benutzer von intelligenten Geräten Shipping Country nur anhand von Order Number angeben müssen. Die von Ihnen erstellten Anwendungen enthalten Benutzereingaben der Order Number und die sich daraus ergebende Anzeige von Shipping Country.

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.

Diese exemplarische Vorgehensweise wurde mit Visual Basic-Entwicklungseinstellungen und Visual C#-Entwicklungseinstellungen geschrieben.

Vorbereitungsmaßnahmen

Die in Visual Studio enthaltene Datenbank Northwind für SQL Server Compact 3.5.

Hinweis:
Wenn Sie auf dem Entwicklungscomputer nicht als Administrator angemeldet sind, können Sie die Datei Northwind.sdf nicht von ihrem Standardspeicherort, Laufwerk:\Programme\Microsoft SQL Server Compact Edition\v3.5\Samples, aus öffnen. Kopieren Sie die Datei auf den Desktop oder in Eigene Dateien, und öffnen Sie sie von dort, sobald Sie dazu aufgefordert werden.

Auswählen eines Zielgeräts

Um sicherzustellen, dass Sie beim Bereitstellen der Projektmappe eine Eingabeaufforderung für ein Zielgerät erhalten, führen Sie die folgenden Schritte durch.

So legen Sie fest, dass zum Bereitstellungszeitpunkt ein Gerät ausgewählt werden kann

Klicken Sie im Menü Extras auf Optionen, erweitern Sie Gerätetools, und klicken Sie dann auf Allgemein.
Aktivieren Sie das Kontrollkästchen Vor Bereitstellung von Geräteprojekten Geräteauswahl anzeigen.

Erstellen der Anwendung

Dies ist eine einfache Windows Forms-Anwendung, um die Datenfunktionen dieser exemplarischen Vorgehensweise zu hosten.

So erstellen Sie ein Windows Forms-Geräteprojekt

(Visual Basic) Klicken Sie im Menü Datei in Visual Studio auf Neues Projekt.

- oder -

(Visual C#) Zeigen Sie im Menü Datei in Visual Studio auf Neu, und klicken Sie auf Projekt.
Erweitern Sie im Bereich Projekttypen den Eintrag Visual Basic oder Visual C#, klicken Sie auf Intelligentes Gerät, im Bereich Vorlagen auf Projekt für intelligente Geräte, geben Sie im Feld NameParamQuerySample ein, und klicken Sie auf OK.
Wählen Sie im Dialogfeld Neues Projekt für intelligente Geräte hinzufügen im Dropdownmenü Zielplattform die Option Pocket PC 2003 aus, klicken Sie auf Geräteanwendung und dann auf OK.

Im Windows Forms-Designer wird eine Darstellung eines Pocket PC-Geräts angezeigt.

Hinzufügen von Datenfunktionen

Dieser Abschnitt umfasst die folgenden Aufgaben:

Auswählen eines Datenquellentyps
Auswählen und Konfigurieren einer Datenverbindung
Auswählen von Datenbankobjekten
Hinzufügen von datengebundenen Steuerelementen zum Formular

So wählen Sie einen Datenquellentyp aus

Klicken Sie im Menü Daten auf Neue Datenquelle hinzufügen, um den Assistenten zum Konfigurieren von Datenquellen zu öffnen.
Klicken Sie auf der Seite Datenquellentyp auswählen nacheinander auf Datenbank und dann auf Weiter.

So können Sie eine Datenverbindung auswählen und konfigurieren

Klicken Sie auf der Seite Wählen Sie Ihre Datenverbindung aus auf Neue Verbindung.

Klicken Sie im Dialogfeld Datenquelle auswählen auf die Option Microsoft SQL Server Compact 3.5 und dann auf Weiter.

Hinweis:
Je nach Einstellungen und früheren Projekten wird anstelle des Dialogfelds Datenquelle auswählen das Dialogfeld Verbindung hinzufügen angezeigt. In diesem Fall klicken Sie im Dialogfeld Verbindung hinzufügen auf Ändern, um das Dialogfeld Datenquelle wechseln zu öffnen. Wählen Sie dann Microsoft SQL Server Compact 3.5 aus, und klicken Sie auf OK.

Wählen Sie im Dialogfeld Verbindung hinzufügen die Option Arbeitsplatz aus.
Klicken Sie im Dialogfeld Verbindung hinzufügen auf Durchsuchen.
Wählen Sie im Dialogfeld SQL Server Compact 3.5-Datenbankdatei auswählen die Datei Northwind.sdf aus, und klicken Sie dann auf Öffnen.
Lassen Sie im Dialogfeld Verbindung hinzufügen das Feld Kennwort leer.

Diese Datenbank besitzt kein Kennwort.

Sicherheitshinweis:

Verwenden Sie ein sicheres Kennwort für Datenbanken, die in realen Anwendungen verwendet werden.

Sicherheitshinweis:
Verwenden Sie ein sicheres Kennwort für Datenbanken, die in realen Anwendungen verwendet werden.

Klicken Sie auf Testverbindung, um die Verbindung zu überprüfen.

Hinweis:
Falls der Zugriff auf die Datei Northwind.sdf verweigert wird, kopieren Sie die Datei auf den Desktop, und öffnen Sie dann die Kopie. Dieser Fall kann eintreten, wenn Sie auf dem Entwicklungscomputer nicht über ausreichende Rechte zum Öffnen der Datei von ihrem Standardspeicherort aus verfügen, der zu Beginn dieser Vorgehensweise aufgeführt wird.

Klicken Sie in dem Meldungfeld, in dem die erfolgreiche Herstellung der Verbindung angezeigt wird, auf OK, und klicken Sie anschließend auf OK, um das Dialogfeld Verbindung hinzufügen zu schließen.
Klicken Sie auf der Seite Wählen Sie Ihre Datenverbindung aus auf Weiter.
Klicken Sie in dem Meldungsfeld, in dem Sie gefragt werden, ob die Datei in das Projekt kopiert werden soll, auf Ja.

So wählen Sie Datenbankobjekte aus

Erweitern Sie auf der Seite Datenbankobjekte auswählen den Knoten Tables, und wählen Sie dann die Tabelle Orders aus.
Klicken Sie auf Fertig stellen.

Das Dataset NorthwindDataset wird erstellt. Sie können die Datenquelle anzeigen, indem Sie im Menü Daten auf die Option Datenquellen anzeigen klicken.

So erstellen Sie die Abfrage

Erweitern Sie im Datenquellenfenster die Tabelle Orders.
Klicken Sie auf die Spalte Ship Country, dann auf den Dropdownpfeil, und wählen Sie anschließend die Option Label aus.
Ziehen Sie die Spalte Ship Country auf das Formular im Designer.
Klicken Sie auf dem Label-Steuerelement im Designer auf das Smarttag und dann auf Abfrage hinzufügen.
Klicken Sie im Dialogfeld Suchkriterien-Generator auf Abfrage-Generator.
Geben Sie in der Zeile Order ID in der Spalte Filter ein Fragezeichen (?) ein.

Dieses Symbol gibt an, dass Benutzer der Anwendung einen Wert für Bestell-Nr. eingeben müssen.
Klicken Sie auf OK.

Die WHERE-Klausel im Feld Abfragetext sollte jetzt ([Order ID]=@PARAM1) lauten.
Klicken Sie auf OK, um das Dialogfeld Suchkriterien-Generator zu schließen.

Auf dem Formular im Designer wird ein Bereich angezeigt.

So passen Sie die Benutzeroberfläche an

Klicken Sie mit der rechten Maustaste im Designer auf das Label-Steuerelement PARAM1, und klicken Sie dann auf Eigenschaften.

- oder -

Wählen Sie im Eigenschaftenfenster das Steuerelement Param1Label aus.
Ändern Sie die Text-Eigenschaft in Order ID.
Wählen Sie die Schaltfläche FillBy aus, und ändern Sie dann die Text-Eigenschaft in Show country.
Erweitern Sie den Bereich und die Steuerelemente, um die Bildlaufleisten zu entfernen und den ganzen Text anzuzeigen. Achten Sie insbesondere darauf, dass Ship_CountryLabel und das zugehörige Textfeld nicht von FillByPanel und den zugehörigen Steuerelementen verdeckt wird.

Testen der Anwendung

In diesem Abschnitt erstellen Sie die Anwendung, laden sie auf den Pocket PC 2003 SE-Emulator herunter und überprüfen, ob die Anwendung ordnungsgemäß funktioniert.

So testen Sie die Anwendung

Klicken Sie im Menü Debuggen auf Starten oder Debuggen starten.
Wählen Sie im nun angezeigten Dialogfeld Bereitstellen die Option Pocket PC 2000 SE-Emulator aus, und klicken Sie auf Bereitstellen.

Der Fortschritt der Bereitstellung wird in der Statusleiste angezeigt. Die Bereitstellung für den Emulator kann einige Zeit in Anspruch nehmen.
Wenn die Anwendung auf dem Emulator ausgeführt wird, geben Sie eine Auftragsnummer zwischen 10000 und 11077 aus der Datenbank Northwind ein, und klicken Sie dann auf Show country.

Das Ship Country für diesen Auftrag wird im Label-Steuerelement angezeigt.

Vorbereitungen für weitere exemplarische Vorgehensweisen

Wenn Sie weitere exemplarische Vorgehensweisen durchgehen oder andere Projekte öffnen möchten, sollten Sie den Emulator herunterfahren und die Projektmappe schließen.

So schließen Sie den Emulator und die Projektmappe

Klicken Sie im Emulator im Menü Datei auf Beenden.
Klicken Sie im Meldungsfeld Geräteemulator , in dem Sie gefragt werden, ob der Emulatorzustand gespeichert werden soll, auf Nein.
(Visual Basic) Klicken Sie im Menü Datei auf Projekt schließen.

- oder -

(Visual C#) Klicken Sie im Menü Datei auf Projektmappe schließen.

Wenn Sie aufgefordert werden, das Projekt oder die Projektmappe zu speichern, klicken Sie auf Speichern, wenn Sie das Projekt oder die Projektmappe erneut verwenden möchten; andernfalls klicken Sie auf Verwerfen, damit die Dateien nicht gespeichert werden.

Siehe auch

Freigeben über