Erstellen eines einfachen Consumers
Der ATL-OLE DB-Consumer-Assistent ist in Visual Studio 2019 und höher nicht verfügbar. Sie können diese Funktionalität weiterhin manuell hinzufügen. Weitere Informationen finden Sie unter Erstellen eines Consumers ohne Assistent.
Verwenden Sie den ATL-Projekt-Assistenten und den ATL-OLE DB-Consumer-Assistenten, um einen OLE DB-Vorlagenconsumer zu generieren.
So erstellen Sie eine Konsolenanwendung für einen OLE DB-Consumer
Klicken Sie im Menü Datei auf Neu und dann auf Projekt.
Das Dialogfeld Neues Projekt wird angezeigt.
Klicken Sie im Bereich Projekttypen auf den Ordner Installiert>Visual C++>Windows Desktop, und klicken Sie dann im Bereich Templates auf das Symbol Windows Desktop-Assistent. Geben Sie im Feld Name den Namen Ihres Projekts ein, z.B. MyCons.
Klicken Sie auf OK.
Der Windows-Desktopprojekt-Assistent wird angezeigt.
Wählen Sie auf der Seite Anwendungseinstellungen die Option Konsolenanwendung und aus, und klicken Sie dann auf Allgemeine Headerdateien hinzufügen für ATL.
Klicken Sie auf OK, um den Assistenten zu schließen und das Projekt zu generieren.
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 im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt
MyCons.Klicken Sie im Kontextmenü auf Hinzufügen, und klicken Sie danach auf Neues Element.
Das Dialogfeld Neues Element hinzufügen wird angezeigt.
Klicken Sie im Bereich Kategorien auf Installiert>Visual C++>ATL. Klicken Sie im Bereich Vorlagen auf das Symbol ATL-OLE DB-Consumer, und klicken Sie dann auf Hinzufügen.
Der ATL-OLE DB-Consumer-Assistent wird angezeigt.
Klicken Sie auf die Schaltfläche Datenquelle.
Das Dialogfeld Datenverknüpfungseigenschaften wird angezeigt.
Gehen Sie im Dialogfeld Datenverknüpfungseigenschaften folgendermaßen vor:
Geben Sie auf der Registerkarte Anbieter einen OLE DB-Anbieter an.
Geben Sie auf der Registerkarte Verbindung die erforderlichen Informationen an, wie z.B. den Servernamen, die Anmelde-ID und das Kennwort für Ihre Datenquelle und Datenbank auf dem Server.
Hinweis
Es besteht ein Sicherheitsproblem mit dem Feature Kennwortspeicherung zulassen im Dialogfeld Datenverknüpfungseigenschaften. In "Informationen eingeben", um sich beim Server anzumelden, gibt es zwei Optionsfelder: Windows NT integrierte Sicherheit verwenden und einen bestimmten Benutzernamen und ein bestimmtes Kennwort verwenden.
Hinweis
Wenn Sie Bestimmten Benutzernamen und ein Kennwort verwenden aktivieren, erhalten Sie die Möglichkeit zur Speicherung des Kennworts (über das Kontrollkästchen Kennwortspeicherung zulassen). Diese Option ist jedoch nicht sicher. Es wird empfohlen, die Option Integrierte Sicherheit von Windows NT verwenden auszuwählen. Diese Option verwendet Windows NT, um Ihre Identität zu überprüfen.
Hinweis
Wenn Sie die integrierte Sicherheit von Windows nicht verwenden können, sollten Sie eine Middle-Tier-Anwendung verwenden, um den Benutzer zur Eingabe des Kennworts aufzufordern oder das Kennwort anstatt im Quellcode an einem Ort zu speichern, der mit Sicherheitsmechanismen geschützt ist.
Nach dem Auswählen des Anbieters und weiteren Einstellungen klicken Sie auf Verbindung testen, um die Einstellungen, die Sie auf den vorherigen Dialogfeldseiten ausgewählt haben, zu überprüfen. Wenn im Feld Ergebnisse die Meldung
Test connection succeededangezeigt wird, klicken Sie auf OK, um die Datenverknüpfung zu erstellen.
Das Dialogfeld Datenbankobjekt auswählen wird angezeigt.
Verwenden Sie das Struktursteuerelement, um eine Tabelle, eine Sicht oder eine gespeicherte Prozedur auszuwählen. Wählen Sie für dieses Beispiel die Tabelle
Productsaus der DatenbankNorthwindaus.Klicken Sie auf OK. Damit kehren Sie zum ATL-OLE DB-Consumer-Assistenten zurück.
Der Assistent vervollständigt die Namen für
Classund die .h-Datei basierend auf dem Namen der Tabelle, Sicht oder gespeicherten Prozedur, die Sie ausgewählt haben. Sie können diese Namen bearbeiten, wenn Sie möchten.Deaktivieren Sie das Kontrollkästchen Attributiert, sodass der Assistent den Consumercode mithilfe von OLE DB-Vorlagenklassen anstatt mit den standardmäßigen OLE DB-Consumerattributen erstellt.
Wählen Sie unter Typ den Eintrag Befehl aus.
Der Assistent erstellt einen CCommand-basierten Consumer, wenn Sie Befehl auswählen, oder einen CTable-basierten Consumer, wenn Sie Tabelle auswählen. Die Tabellen- bzw. Befehlsklasse ist nach dem ausgewählten Objekt benannt, aber Sie können den Namen bearbeiten.
Lassen Sie im Bereich Unterstützung die Kontrollkästchen Ändern, Einfügen und Löschen deaktiviert.
Aktivieren Sie die Kontrollkästchen Ändern, Einfügen und Löschen, um das Ändern, Einfügen und Löschen von Datensätzen im Rowset zu unterstützen. Weitere Informationen zum Schreiben von Daten in den Datenspeicher finden Sie unter Aktualisieren von Rowsets.
Klicken Sie auf Fertig stellen, um den Consumer zu erstellen.
Der Assistent generiert eine Befehlsklasse und eine Benutzerdatensatzklasse, wie in Vom Consumer-Assistenten generierte Klassen gezeigt. Die Befehlsklasse weist den Namen auf, den Sie im Assistenten im Feld Class eingeben (in diesem Fall CProducts), und der Name der Benutzerdatensatzklasse weist die Form „ClassName-Accessor“ auf (in diesem Fall CProductsAccessor).
Hinweis
Der Assistent fügt die folgende Zeile in Products.h ein:
#error Security Issue: The connection string may contain a password
Hinweis
Diese Zeile verhindert, dass die Consumeranwendung kompiliert wird, und erinnert Sie daran, die Verbindungszeichenfolge für hartcodierte Kennwörter zu überprüfen. Nach dem Überprüfen der Verbindungszeichenfolge können Sie diese Codezeile entfernen.