Freigeben über

ATL-OLE DB-Consumer-Assistent

  • Artikel

Dieser Assistent ist in Visual Studio 2019 und höher nicht verfügbar.

Dieser Assistent richtet eine OLE DB-Consumerklasse mit den Datenbindungen ein, die zum Zugriff auf die angegebene Datenquelle über den angegebenen OLE DB-Anbieter erforderlich sind.

Hinweis

Dieser Assistent erfordert, dass Sie auf die Schaltfläche Datenquelle klicken, um eine Datenquelle auszuwählen, bevor Sie Namen in die Felder Class und H-Datei eingeben.

UIElement-Liste

  • Datenquelle

    Mithilfe der Schaltfläche Datenquelle können Sie die angegebene Datenquelle unter Verwendung des angegebenen OLE DB-Anbieters einrichten. Wenn Sie auf diese Schaltfläche klicken, wird das Dialogfeld Datenverknüpfungseigenschaften geöffnet. Weitere Informationen zum Erstellen von Verbindungszeichenfolgen und dem Dialogfeld Datenverknüpfungseigenschaften finden Sie im Abschnitt Übersicht über die Data Link-API in der Windows SDK-Dokumentation.

    Die folgenden zusätzlichen Informationen beschreiben die Registerkarten im Dialogfeld Datenverknüpfungseigenschaften.

    • Registerkarte Anbieter

      Wählen Sie einen geeigneten Anbieter zum Verwalten der Verbindung mit der Datenquelle aus. Der Anbietertyp wird üblicherweise durch den Typ der Datenbank bestimmt, mit der Sie eine Verbindung herstellen. Klicken Sie auf die Schaltfläche Weiter oder auf die Registerkarte Verbindung.

    • Registerkarte Verbindung

      Die Inhalte dieser Registerkarte hängen vom ausgewählten Anbieter ab. Obwohl es viele Arten von Anbietern gibt, behandelt dieser Abschnitt Verbindungen für die beiden am häufigsten verwendeten SQL- und ODBC-Daten. Die weiteren Verbindungen sind ähnliche Variationen der hier beschriebenen Felder.

      Für SQL-Daten:

      1. Wählen Sie einen Servernamen aus, oder geben Sie ihn ein: Klicken Sie auf das Dropdownlistenmenü, um alle registrierten Datenserver im Netzwerk anzuzeigen, und wählen Sie eins aus.

      2. Geben Sie Informationen ein, um sich beim Server anzumelden: Geben Sie einen Benutzernamen und ein Kennwort ein, um sich beim Datenspeicherserver anzumelden.

        Hinweis

        Es besteht ein Sicherheitsproblem mit dem Feature „Kennwortspeicherung zulassen“ im Dialogfeld „Datenverknüpfungseigenschaften“. Der Abschnitt „Geben Sie Informationen zur Anmeldung beim Server ein“ enthält zwei Optionsschaltflächen:

        • Integrierte Sicherheit von Windows NT verwenden
        • Bestimmten Benutzernamen und bestimmtes Kennwort verwenden

        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 ist sicher, weil das Kennwort verschlüsselt wird. Es kann Situationen geben, in denen Sie "Kennwort speichern zulassen" auswählen möchten. Wenn Sie z. B. eine Bibliothek mit einer privaten Datenbanklösung freigeben, sollten Sie nicht direkt auf die Datenbank zugreifen, sondern stattdessen eine Anwendung auf mittlerer Ebene verwenden, um den Benutzer (über das von Ihnen ausgewählte Authentifizierungsschema) zu überprüfen und dann die für den Benutzer verfügbare Art von Daten einzuschränken.

      3. Wählen Sie die Datenbank auf dem Server aus: Klicken Sie auf das Dropdownlistenmenü, um alle registrierten Datenbanken auf dem Datenbankserver anzuzeigen, und wählen Sie eins aus.

        - oder -

        Fügen Sie eine Datenbankdatei als Datenbanknamen an: Geben Sie eine Datei an, die als Datenbank verwendet werden soll, und geben Sie den expliziten Pfadnamen ein.

      Für ODBC-Daten:

      1. Geben Sie die Datenquelle an: Sie können einen Datenquellennamen oder eine Verbindungszeichenfolge verwenden.

        Verwenden Sie den Namen der Datenquelle: In dieser Dropdownliste werden datenquellen angezeigt, die auf Ihrem Computer registriert sind. Sie können Datenquellen vorab über den ODBC-Datenquellenadministrator einrichten.

        - oder -

        Verwenden Sie Verbindungszeichenfolge: Geben Sie entweder eine Verbindungszeichenfolge ein, die Sie bereits erhalten haben, oder klicken Sie auf die Schaltfläche "Erstellen". Das Dialogfeld "Datenquelle auswählen" wird angezeigt. Wählen Sie eine Datei oder eine Computerdatenquelle aus, und klicken Sie auf OK.

        Hinweis

        Sie können eine Verbindungszeichenfolge abrufen, indem Sie die Eigenschaften einer vorhandenen Verbindung im Server-Explorer anzeigen, oder Sie können eine Verbindung erstellen, indem Sie im Server-Explorer auf Verbindung hinzufügen doppelklicken.

      2. Geben Sie Informationen ein, um sich beim Server anzumelden: Geben Sie einen Benutzernamen und ein Kennwort ein, um sich beim Datenspeicherserver anzumelden.

      3. Geben Sie den Anfangskatalog ein, der verwendet werden soll.

      4. Klicken Sie auf Verbindung testen. Wenn der Test erfolgreich war, klicken Sie auf OK. Falls der Test nicht erfolgreich war, überprüfen Sie Ihre Anmeldeinformationen, oder versuchen Sie es mit einer anderen Datenbank oder einem anderen Datenserver.

    • Erweitert Registerkarte

      Netzwerkeinstellungen: Geben Sie die Identitätswechselebene an (die Ebene des Identitätswechsels, die der Server beim Identitätswechsel des Clients verwenden darf; entspricht direkt den RPC-Identitätswechselstufen) und der Schutzebene (der Schutzgrad der zwischen Client und Server gesendeten Daten; entspricht direkt rpc-Schutzebenen).

      Andere: Geben Sie in Connect-Timeout die Anzahl der Sekunden der Leerlaufzeit an, die vor dem Auftreten eines Timeouts zulässig ist. Geben Sie in Zugriffsberechtigungen die Zugriffsberechtigungen für die Datenverbindung an.

      Weitere Informationen zu erweiterten Initialisierungseigenschaften finden Sie in der Dokumentation zum jeweiligen OLE DB-Anbieter.

    • Registerkarte Alle

      Auf dieser Registerkarte wird eine Zusammenfassung der Initialisierungseigenschaften für die angegebene Datenquelle und Verbindung angezeigt. Sie können diese Werte bearbeiten.

      Klicken Sie auf OK, um den Vorgang abzuschließen. Das Dialogfeld Datenbankobjekt auswählen wird angezeigt. Wählen Sie in diesem Dialogfeld die Tabelle, Ansicht oder gespeicherte Prozedur aus, die der Consumer verwenden wird.

  • Klasse

    Nachdem Sie eine Datenquelle ausgewählt haben, wird dieses Feld mit einem Standardklassennamen aufgefüllt, der auf der ausgewählten Tabelle oder gespeicherten Prozedur basiert (siehe Datenquelle auswählen unten). Sie können den Klassennamen bearbeiten.

  • H-Datei

    Nachdem Sie eine Datenquelle ausgewählt haben, wird dieses Feld mit einem standardmäßigen Headerklassennamen aufgefüllt, der auf der ausgewählten Tabelle oder gespeicherten Prozedur basiert (siehe Datenquelle auswählen unten). Sie können den Namen der Headerdatei bearbeiten oder eine vorhanden Headerdatei auswählen.

  • Attributiert

    Diese Option gibt an, ob der Assistent Consumerklassen mithilfe von Attributen oder Vorlagendeklarationen erstellt. Bei Auswahl dieser Option verwendet der Assistent Attribute anstelle von Vorlagendeklarationen (dies ist die Standardoption). Wenn Sie diese Option deaktivieren, verwendet der Assistent Vorlagendeklarationen anstelle von Attributen.

    • Wenn Sie als Typ für den Consumer Tabelle auswählen, verwendet der Assistent die Attribute db_source und db_table, um die Klassendeklarationen für die Tabelle und den Tabellenaccessor zu erstellen, und verwendet db_column zum Erstellen der Spaltenzuordnung. Beispielsweise wird diese Zuordnung erstellt:

      // Inject table class and table accessor class declarations
[db_source("<initialization_string>"), db_table("dbo.Orders")]
...
// Column map
[ db_column(1, status=m_dwOrderIDStatus, length=m_dwOrderIDLength) ] LONG m_OrderID;
[ db_column(2, status=m_dwCustomerIDStatus, length=m_dwCustomerIDLength) ] TCHAR m_CustomerID[6];
...

      Stattdessen können auch die CTable-Vorlagenklasse zum Deklarieren der Tabellen- und Tabellenaccessorklasse sowie die Makros BEGIN_COLUMN_MAP und END_COLUMN_MAP verwendet werden, um die Spaltenzuordnung zu erstellen, wie in diesem Beispiel:

      // Table accessor class
    class COrdersAccessor; // Table class
    class COrders : public CTable<CAccessor<COrdersAccessor>>;
// ...
// Column map
    BEGIN_COLUMN_MAP(COrderDetailsAccessor)
        COLUMN_ENTRY_LENGTH_STATUS(1, m_OrderID, m_dwOrderIDLength, m_dwOrderIDStatus)
        COLUMN_ENTRY_LENGTH_STATUS(2, m_CustomerID, m_dwCustomerIDLength, m_dwCustomerIDStatus)
        // ...
    END_COLUMN_MAP()

    • Wenn Sie als Typ für den Consumer Befehl auswählen, verwendet der Assistent die Attribute db_source und db_command und verwendet db_column zum Erstellen der Spaltenzuordnung. Beispielsweise wird diese Zuordnung erstellt:

      [db_source("<initialization_string>"), db_command("SQL_command")]
...
// Column map using db_column is the same as for consumer type of 'table'

      Stattdessen können auch die Befehls- und Befehlsaccessor-Klassendeklarationen in der H-Datei der Befehlsklasse verwendet werden, wie in diesem Beispiel:

      // Command accessor class:
    class CListOrdersAccessor;
// Command class:
    class CListOrders : public CCommand<CAccessor<CListOrdersAccessor>>;
// ...
// Column map using BEGIN_COLUMN_MAP ... END_COLUMN_MAP is the same as
// for consumer type of 'table'

      Weitere Informationen finden Sie unter "Grundlegende Mechanik von Attributen ".

  • Typ

    Aktivieren Sie eine dieser Optionsschaltflächen, um anzugeben, ob die Consumerklasse von CTable oder CCommand (Standard) abgeleitet wird.

    • Tabelle

      Aktivieren Sie diese Option, wenn Sie CTable oder db_table zum Erstellen der Tabellen- und Tabellenaccessor-Klassendeklarationen verwenden möchten.

    • Befehl

      Wählen Sie diese Option aus, wenn Sie CCommand oder db_command zum Erstellen der Tabellen- und Tabellenaccessor-Klassendeklarationen verwenden möchten. Dies ist die Standardauswahl.

  • Support

    Aktivieren Sie die Kontrollkästchen, um die Art der Aktualisierung anzugeben, die im Consumer unterstützt wird (standardmäßig sind dies keine). Mit jeder der folgenden Optionen werden DBPROP_IRowsetChange und die geeigneten Einträge für DBPROP_UPDATABILITY in der Eigenschaftenzuordnung festgelegt.

    • Ändern

      Gibt an, dass der Consumer das Aktualisieren von Zeilendaten im Rowset unterstützt.

    • Einfügen

      Gibt an, dass der Consumer das Einfügen von Zeilen in das Rowset unterstützt.

    • Delete

      Gibt an, dass der Consumer das Löschen von Zeilen aus dem Rowset unterstützt.

Siehe auch

ATL-OLE DB-Consumer
Hinzufügen neuer Funktionen mit Code-Assistenten
Verbindungszeichenfolgen und Datenverknüpfungen (OLE DB)