Erstellen eines einfachen Consumers
Verwenden Sie den ATL-Projekt-Assistenten und den ATL-OLE DB-Consumer-Assistenten, um einen OLE DB-Vorlagenconsumer zu erstellen.
So erstellen Sie eine Konsolenanwendung für einen OLE DB-Consumer
Klicken Sie im Menü Datei erst auf Neu und dann auf Projekt.
Das Dialogfeld Neues Projekt wird angezeigt.
Klicken Sie im Bereich Projekttypen auf den Ordner Visual C++-Projekte, und klicken Sie im Bereich Vorlagen auf das Symbol Win32-Projekt. Geben Sie im Feld Name den Namen des Projekts ein, z. B. MyCons.
Klicken Sie auf OK.
Der Win32-Anwendungs-Assistent wird angezeigt.
Wählen Sie auf der Seite Anwendungseinstellungen die Option Konsolenanwendung aus, und wählen Sie anschließend ATL-Unterstützung hinzufügen aus.
Klicken Sie auf Fertig stellen, um den Assistenten zu schließen und das Projekt zu erstellen.
Verwenden Sie als nächstes den ATL OLE DB-Consumer-Assistenten, um ein OLE DB-Consumerobjekt hinzuzufügen.
So erstellen Sie einen Consumer mit dem ATL-OLE DB-Consumer-Assistenten
Klicken Sie in der Klassenansicht mit der rechten Maustaste auf das Projekt "MyCons".
Klicken Sie im Kontextmenü auf Hinzufügen und dann auf Klasse hinzufügen.
Das Dialogfeld Klasse hinzufügen wird angezeigt.
Klicken Sie im Bereich Kategorien auf Visual C++ und im Bereich Vorlagen auf das Symbol ATL-OLE DB-Consumer. Klicken Sie dann auf Öffnen.
Der ATL-OLE DB-Consumer-Assistent wird angezeigt.
Klicken Sie auf die Schaltfläche Datenquelle.
Das Dialogfeld Datenverbindungseigenschaften wird angezeigt.
Führen Sie im Dialogfeld Datenverknüpfungseigenschaften die folgenden Schritte aus:
Geben Sie auf der Registerkarte Anbieter einen OLE DB-Anbieter an.
Geben Sie auf der Registerkarte Verbindung den Servernamen, die Anmelde-ID und das Kennwort für die Datenquelle sowie die Datenbank auf dem Server an.
Tipp
Das Feature Speichern des Kennworts zulassen im Dialogfeld Datenverknüpfungseigenschaften kann ein Sicherheitsproblem verursachen. In Geben Sie Informationen zur Anmeldung beim Server ein sind zwei Optionsfelder vorhanden: Windows NT Integrated Security verwenden und Bestimmten Benutzernamen und ein Kennwort verwenden.
Tipp
Bei Auswahl von Bestimmten Benutzernamen und ein Kennwort verwenden können Sie das Kennwort zwar speichern (mit dem Kontrollkästchen Speichern des Kennworts zulassen), diese Option ist jedoch nicht sicher. Daher wird empfohlen, Windows NT Integrated Security verwenden auszuwählen und auf diese Weise die Identität durch Windows NT zu überprüfen.
Tipp
Wenn Sie nicht mit Windows NT Integrated Security arbeiten können, sollten Sie eine Anwendung mittlerer Ebene verwenden, damit der Benutzer zur Eingabe eines Kennworts aufgefordert oder das Kennwort an einem sicheren Ort (und nicht im Quellcode) gespeichert wird.
Klicken Sie nach dem Auswählen des Anbieters und der anderen Einstellungen auf Testverbindung, um die auf den vorherigen Dialogfeldseiten festgelegten Einstellungen zu überprüfen. Wenn im Feld Ergebnisse die Meldung Die Testverbindung war erfolgreich angezeigt wird, klicken Sie auf OK, um die Datenverknüpfung zu erstellen.
Das Dialogfeld Datenbankobjekt auswählen wird geöffnet.
Wählen Sie in der Strukturansicht eine Tabelle, eine Ansicht oder eine gespeicherte Prozedur aus. Wählen Sie für diese Prozedur die Tabelle Products aus der Northwind-Datenbank.
Klicken Sie auf OK. Dadurch gelangen Sie wieder zurück zum ATL-OLE DB-Consumer-Assistenten.
Der Assistent vervollständigt die Namen unter Klasse und .h-Datei anhand des Namens der ausgewählten Tabelle, Ansicht oder gespeicherten Prozedur. Sie können diese Namen nach Wunsch bearbeiten.
Deaktivieren Sie das Kontrollkästchen Attributiert, damit der Assistent zur Erstellung des Consumercodes nicht die standardmäßigen OLE DB-Consumerattribute sondern OLE DB-Vorlagenklassen verwendet.
Wählen Sie unter Typ die Option Befehl aus.
Wenn Sie Befehl auswählen, erstellt der Assistent einen CCommand-basierten Consumer. Wenn Sie Tabelle auswählen, wird ein CTable-basierter Consumer erstellt. Die Tabellen- oder Befehlsklasse wird nach dem ausgewählten Objekt benannt. Sie können den Namen jedoch bearbeiten.
Aktivieren Sie unter Unterstützung die Kontrollkästchen Ändern, Einfügen und Löschen nicht.
Wählen Sie Ändern, Einfügen oder Löschen aus, um bei Bedarf das Ändern, Einfügen und Löschen von Datensätzen im Rowset zu unterstützen. Weitere Informationen über das Schreiben von Daten in den Datenspeicher finden Sie unter Aktualisieren von Rowsets.
Klicken Sie auf Fertig stellen, um den Consumer zu erstellen.
Der Assistent erstellt eine Befehlsklasse und eine Benutzerdatensatz-Klasse, wie unter Vom Consumer-Assistenten generierte Klassen aufgezeigt. Die Befehlsklasse trägt den Namen, den Sie im Assistenten im Feld Klasse eingegeben haben (in diesem Fall CProducts). Die Benutzerdatensatzklasse trägt den Namen des Formulars "ClassNameAccessor" (in diesem Fall CProductsAccessor).
Tipp
Der Assistent fügt in Products.h die folgende Zeile ein:
#error Security Issue: The connection string may contain a password
Tipp
Diese Zeile hindert die Consumeranwendung am Kompilieren, und erinnert Sie daran, die Verbindungszeichenfolgen für fest codierte Kennwörter zu überprüfen. Sie können diese Codezeile entfernen, nachdem Sie die Verbindungszeichenfolge überprüft haben.