Udostępnij za pośrednictwem


Kreator konsumenta OLE DB ATL

Ten kreator nie jest dostępny w programie Visual Studio 2019 i nowszych wersjach.

Ten kreator konfiguruje klasę konsumenta OLE DB z powiązaniami danych niezbędnymi do uzyskania dostępu do określonego źródła danych za pośrednictwem określonego dostawcy OLE DB.

Uwaga

Ten kreator wymaga kliknięcia przycisku Źródło danych, aby wybrać źródło danych przed wprowadzeniem nazw w Class polach plików i .h.

Lista elementów UI

  • Źródło danych

    Przycisk Źródło danych umożliwia skonfigurowanie określonego źródła danych przy użyciu określonego dostawcy OLE DB. Po kliknięciu tego przycisku zostanie wyświetlone okno dialogowe Właściwości łącza danych. Aby uzyskać więcej informacji na temat tworzenia parametry połączenia i właściwości łącza danych okno dialogowe, zobacz Omówienie interfejsu API linków danych w dokumentacji zestawu Windows SDK.

    Poniższe dodatkowe informacje opisują karty w oknie dialogowym Właściwości łącza danych.

    • Karta Dostawca

      Wybierz odpowiedniego dostawcę, aby zarządzać połączeniem ze źródłem danych. Typ dostawcy jest zwykle określany przez typ bazy danych, z którą nawiązujesz połączenie. Kliknij przycisk Dalej lub kliknij kartę Połączenie.

    • Karta Połączenie

      Zawartość tej karty zależy od wybranego dostawcy. Chociaż istnieje wiele typów dostawców, w tej sekcji omówiono połączenia dla dwóch najbardziej typowych: danych SQL i ODBC. Pozostałe są podobne odmiany pól opisanych tutaj.

      W przypadku danych SQL:

      1. Wybierz lub wprowadź nazwę serwera: kliknij menu listy rozwijanej, aby wyświetlić wszystkie zarejestrowane serwery danych w sieci, a następnie wybierz jeden.

      2. Wprowadź informacje, aby zalogować się na serwerze: wprowadź nazwę użytkownika i hasło, aby zalogować się na serwerze danych.

        Uwaga

        Wystąpił problem z zabezpieczeniami funkcji "Zezwalaj na zapisywanie hasła" w oknie dialogowym Właściwości łącza danych. W obszarze "Wprowadź informacje, aby zalogować się na serwerze", dostępne są dwa przyciski radiowe:

        • Korzystanie ze zintegrowanych zabezpieczeń systemu Windows NT
        • Używanie określonej nazwy użytkownika i hasła

        Jeśli wybierzesz opcję Użyj określonej nazwy użytkownika i hasła, możesz zapisać hasło (przy użyciu pola wyboru "Zezwalaj na zapisywanie hasła"), jednak ta opcja nie jest bezpieczna. Zaleca się wybranie opcji Użyj zintegrowanych zabezpieczeń systemu Windows NT. Ta opcja jest bezpieczna, ponieważ szyfruje hasło. Mogą wystąpić sytuacje, w których chcesz wybrać opcję "Zezwalaj na zapisywanie hasła". Jeśli na przykład publikujesz bibliotekę z prywatnym rozwiązaniem bazy danych, nie należy uzyskiwać bezpośredniego dostępu do bazy danych, ale zamiast tego użyć aplikacji warstwy środkowej, aby zweryfikować użytkownika (za pomocą wybranego schematu uwierzytelniania), a następnie ograniczyć rodzaj danych dostępnych dla użytkownika.

      3. Wybierz bazę danych na serwerze: kliknij menu listy rozwijanej, aby wyświetlić wszystkie zarejestrowane bazy danych na serwerze danych, a następnie wybierz jedną z nich.

        - lub -

        Dołącz plik bazy danych jako nazwę bazy danych: określ plik, który ma być używany jako baza danych; wprowadź jawną nazwę ścieżki.

      W przypadku danych ODBC:

      1. Określ źródło danych: możesz użyć nazwy źródła danych lub parametry połączenia.

        Użyj nazwy źródła danych: ta lista rozwijana wyświetla źródła danych zarejestrowane na maszynie. Źródła danych można skonfigurować z wyprzedzeniem przy użyciu administratora źródła danych ODBC

        - lub -

        Użyj parametry połączenia: wprowadź parametry połączenia, który został już uzyskany, lub kliknij przycisk Kompilacja. Zostanie wyświetlone okno dialogowe Wybieranie źródła danych. Wybierz plik lub źródło danych maszyny i kliknij przycisk OK.

        Uwaga

        Aby uzyskać parametry połączenia, można wyświetlić właściwości istniejącego połączenia w Eksploratorze serwera lub utworzyć połączenie, klikając dwukrotnie pozycję Dodaj połączenie w Eksploratorze serwera.

      2. Wprowadź informacje, aby zalogować się na serwerze: wprowadź nazwę użytkownika i hasło, aby zalogować się na serwerze danych.

      3. Wprowadź początkowy wykaz do użycia.

      4. Kliknij pozycję Testuj połączenie. Jeśli test zakończy się pomyślnie, kliknij przycisk OK. Jeśli tak nie jest, sprawdź informacje logowania, spróbuj użyć innej bazy danych lub spróbuj użyć innego serwera danych.

    • Karta Zaawansowane

      Ustawienia sieci: określ poziom personifikacji (poziom personifikacji, którego serwer może używać podczas personifikacji klienta; odpowiada bezpośrednio poziomom personifikacji RPC) i poziom ochrony (poziom ochrony danych wysyłanych między klientem i serwerem; odpowiada bezpośrednio poziomom ochrony RPC).

      Inne: W obszarze Limit czasu połączenia określ liczbę sekund czasu bezczynności dozwoloną przed upływem limitu czasu. W obszarze Uprawnienia dostępu określ uprawnienia dostępu do połączenia danych.

      Aby uzyskać więcej informacji na temat zaawansowanych właściwości inicjowania, zapoznaj się z dokumentacją udostępnioną dla każdego konkretnego dostawcy OLE DB.

    • Karta Wszystkie

      Ta karta zawiera podsumowanie właściwości inicjowania dla określonego źródła danych i połączenia. Możesz edytować te wartości.

      Kliknij przycisk OK na zakończenie. Zostanie wyświetlone okno dialogowe Wybieranie obiektu bazy danych. W tym oknie dialogowym wybierz tabelę, widok lub procedurę składowaną, której będzie używać odbiorca.

  • Klasa

    Po wybraniu źródła danych to pole zostanie wypełnione domyślną nazwą klasy na podstawie wybranej tabeli lub procedury składowanej (zobacz Wybieranie źródła danych poniżej). Możesz edytować nazwę klasy.

  • Plik .h

    Po wybraniu źródła danych to pole zostanie wypełnione domyślną nazwą klasy nagłówka na podstawie wybranej tabeli lub procedury składowanej (zobacz Wybieranie źródła danych poniżej). Możesz edytować nazwę pliku nagłówka lub wybrać istniejący plik nagłówka.

  • Przypisane

    Ta opcja określa, czy kreator utworzy klasy odbiorców przy użyciu atrybutów lub deklaracji szablonów. Po wybraniu tej opcji kreator używa atrybutów zamiast deklaracji szablonu (jest to opcja domyślna). Po usunięciu zaznaczenia tej opcji kreator używa deklaracji szablonu zamiast atrybutów.

    • Jeśli wybierzesz typ tabeli odbiorcy, kreator użyje db_source atrybutów i db_table do utworzenia deklaracji klas dostępu tabeli i tabeli oraz użyje db_column ich do utworzenia mapy kolumn. Na przykład tworzy tę mapę:

      // 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];
      ...
      

      zamiast używać klasy szablonu CTable do deklarowania klasy akcesoriów tabeli i tabeli oraz makr BEGIN_COLUMN_MAP i END_COLUMN_MAP w celu utworzenia mapy kolumn, jak w tym przykładzie:

      // 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()
      
    • Jeśli wybierzesz typ polecenia użytkownika, kreator użyje db_source atrybutów i db_command i użyje ich db_column do utworzenia mapy kolumn. Na przykład tworzy tę mapę:

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

      zamiast używać deklaracji klas dostępu poleceń i poleceń w pliku .h klasy poleceń, na przykład:

      // 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'
      

      Aby uzyskać więcej informacji, zobacz Podstawowa mechanika atrybutów .

  • Type

    Wybierz jeden z tych przycisków radiowych, aby określić, czy klasa odbiorcy będzie pochodzić z CTable lub CCommand (wartość domyślna).

    • Tabela

      Wybierz tę opcję, jeśli chcesz użyć CTable lub db_table utworzyć deklaracje klas dostępu tabeli i tabeli.

    • Command

      Wybierz tę opcję, jeśli chcesz użyć CCommand polecenia lub db_command utworzyć deklaracje klas dostępu poleceń i poleceń. Jest to wybór domyślny.

  • Pomoc techniczna

    Zaznacz pola wyboru, aby określić rodzaje aktualizacji, które mają być obsługiwane przez użytkownika (wartość domyślna to brak). Każdy z poniższych elementów ustawi DBPROP_IRowsetChange i odpowiednie wpisy dla DBPROP_UPDATABILITY na mapie zestawu właściwości.

    • Zmień

      Określa, że klient obsługuje aktualizacje danych wierszy w zestawie wierszy.

    • Insert

      Określa, że klient obsługuje wstawianie wierszy do zestawu wierszy.

    • Usuń

      Określa, że użytkownik obsługuje usuwanie wierszy z zestawu wierszy.

Zobacz też

Użytkownik OLE DB ATL
Dodawanie funkcji za pomocą kreatorów kodu
Parametry połączenia i łącza danych (OLE DB)