Condividi tramite

Creazione guidata consumer OLE DB ATL

  • Articolo

Questa procedura guidata non è disponibile in Visual Studio 2019 e versioni successive.

Questa procedura guidata configura una classe consumer OLE DB con le associazioni di dati necessarie per accedere all'origine dati specificata tramite il provider OLE DB indicato.

Nota

In questa procedura guidata è necessario fare clic sul pulsante Origine dati per selezionare un'origine dati prima di immettere i nomi nei campi Class e File con estensione h.

Elenco degli elementi di interfaccia

  • Origine dati

    Il pulsante Origine dati permette di configurare l'origine dati specificata usando il provider OLE DB indicato. Quando si fa clic su questo pulsante, viene visualizzata la finestra di dialogo Proprietà di Data Link. Per altre informazioni sulla creazione di stringhe di connessione e sulla finestra di dialogo Proprietà di Data Link, vedere Panoramica dell'API Data Link nella documentazione di Windows SDK.

    Le informazioni aggiuntive seguenti descrivono le schede della finestra di dialogo Proprietà di Data Link.

    • Scheda Provider

      Selezionare un provider appropriato per gestire la connessione all'origine dati. Il tipo di provider in genere è determinato dal tipo di database cui ci si connette. Fare clic sul pulsante Avanti oppure sulla scheda Connessione.

    • Scheda Connessione

      Il contenuto di questa scheda dipende dal provider selezionato. Anche se esistono molti tipi di provider, questa sezione illustra le connessioni per i due dati più comuni: SQL e ODBC. Gli altri sono varianti simili dei campi descritti qui.

      Per dati SQL:

      1. Selezionare o immettere un nome del server: fare clic sul menu a discesa per visualizzare tutti i server dati registrati nella rete e selezionarne uno.

      2. Immettere le informazioni per accedere al server: immettere un nome utente e una password per accedere al server dati.

        Nota

        Esiste un problema di sicurezza relativo alla funzionalità "Consenti salvataggio password" della finestra di dialogo Proprietà di Data Link. In "Immettere le informazioni per l'accesso al server" sono disponibili due pulsanti di opzione:

        • Usa sicurezza integrata di Windows NT
        • Usa nome utente e password specifici

        Se si seleziona Utilizza nome utente e password specifici, è possibile scegliere di salvare la password (usando la casella di controllo "Consenti salvataggio password"), ma questa opzione non è sicura. È consigliabile selezionare Usa sicurezza integrata di Windows NT: questa opzione è sicura perché crittografa la password. Potrebbero verificarsi situazioni in cui si vuole selezionare "Consenti salvataggio password". Ad esempio, se si rilascia una libreria con una soluzione di database privato, non è consigliabile accedere direttamente al database, ma usare invece un'applicazione di livello intermedio per verificare l'utente (tramite qualsiasi schema di autenticazione scelto) e quindi limitare l'ordinamento dei dati disponibili all'utente.

      3. Selezionare il database nel server: fare clic sul menu a discesa dell'elenco a discesa per visualizzare tutti i database registrati nel server dati e selezionarne uno.

        - oppure -

        Allegare un file di database come nome di database: specificare un file da usare come database. Immettere il percorso esplicito.

      Per dati ODBC:

      1. Specificare l'origine dei dati: è possibile usare un nome di origine dati o un stringa di connessione.

        Usa il nome dell'origine dati: in questo elenco a discesa vengono visualizzate le origini dati registrate nel computer. È possibile configurare le origini dati in anticipo tramite Amministrazione origine dati ODBC

        - oppure -

        Usare stringa di connessione: immettere un stringa di connessione già ottenuto oppure fare clic sul pulsante Compila. Verrà visualizzata la finestra di dialogo Seleziona origine dati. Selezionare un'origine dati file o computer e fare clic su OK.

        Nota

        È possibile ottenere una stringa di connessione visualizzando le proprietà di una connessione esistente in Esplora server oppure è possibile creare una connessione facendo doppio clic su Aggiungi connessione in Esplora server.

      2. Immettere le informazioni per accedere al server: immettere un nome utente e una password per accedere al server dati.

      3. Immettere il catalogo iniziale da usare.

      4. Fare clic su Test connessione. Se il test riesce, fare clic su OK. In caso contrario, controllare le informazioni di accesso, provare un altro database o provare un altro server dati.

    • Scheda Avanzate

      Impostazioni di rete: specificare il livello di rappresentazione (il livello di rappresentazione che il server può usare durante la rappresentazione del client; corrisponde direttamente ai livelli di rappresentazione RPC) e il livello di protezione (il livello di protezione dei dati inviati tra client e server; corrisponde direttamente ai livelli di protezione RPC).

      Altro: in Connessione timeout specificare il numero di secondi di tempo di inattività consentiti prima che si verifichi un timeout. In Autorizzazioni di accesso specificare le autorizzazioni di accesso per la connessione dati.

      Per altre informazioni sulle proprietà di inizializzazione avanzate, vedere la documentazione fornita con ogni provider OLE DB specifico.

    • Scheda Tutte

      Questa scheda visualizza un riepilogo delle proprietà di inizializzazione per l'origine dati e la connessione specificate. È possibile modificare questi valori.

      Fare clic su OK per terminare. Verrà visualizzata la finestra di dialogo Seleziona oggetto di database. Da questa finestra di dialogo selezionare la tabella, la visualizzazione o la stored procedure che verrà usata dal consumer.

  • Classe

    Dopo aver selezionato un'origine dati, in questa casella viene immesso un nome di classe predefinito in base alla tabella o alla stored procedure selezionata (vedere Selezionare un'origine dati di seguito). È possibile modificare il nome della classe.

  • File con estensione h

    Dopo aver selezionato un'origine dati, in questa casella viene immesso un nome di classe intestazione predefinito in base alla tabella o alla stored procedure selezionata (vedere Selezionare un'origine dati di seguito). È possibile modificare il nome del file di intestazione o selezionare un file di intestazione esistente.

  • Con attributi

    Questa opzione specifica se la procedura guidata creerà classi consumer tramite attributi o dichiarazioni di modello. Quando si seleziona questa opzione, la procedura guidata usa attributi invece di dichiarazioni di modello (impostazione predefinita). Quando si deseleziona questa opzione, la procedura guidata usa dichiarazioni di modello anziché attributi.

    • Se si seleziona un tipo di consumer TypeTable, la procedura guidata usa gli attributi db_source e db_table per creare le dichiarazioni di classe della tabella e delle funzioni di accesso alla tabella e usa db_column per creare la mappa delle colonne. Ad esempio, crea questa mappa:

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

      invece di usare la classe modello CTable per dichiarare la classe della tabella e delle funzioni di accesso alla tabella e le macro BEGIN_COLUMN_MAP ed END_COLUMN_MAP per creare la mappa delle colonne, come in questo esempio:

      // 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()

    • Se si seleziona un tipo di consumer TypeCommand, la procedura guidata usa gli attributi db_source e db_command e usa db_column per creare la mappa delle colonne. Ad esempio, crea questa mappa:

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

      invece di usare le dichiarazioni di classe del comando e delle funzioni di accesso al comando nel file con estensione h della classe del comando, ad esempio:

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

      Per altre informazioni, vedere Meccanismi di base degli attributi .

  • Type

    Selezionare uno di questi pulsanti di opzione per specificare se la classe consumer verrà derivata da CTable o CCommand (impostazione predefinita).

    • Tabella

      Selezionare questa opzione se si vuole usare CTable o db_table per creare le dichiarazioni di classe della tabella e delle funzioni di accesso alla tabella.

    • Comando

      Selezionare questa opzione se si vuole usare CCommand o db_command per creare le dichiarazioni di classe del comando e delle funzioni di accesso al comando. Si tratta della selezione predefinita.

  • Supporto

    Selezionare le caselle di controllo per specificare i tipi di aggiornamenti che devono essere supportati nel consumer (l'impostazione predefinita è nessuno). Ognuna delle opzioni seguenti imposterà DBPROP_IRowsetChange e le voci appropriate per DBPROP_UPDATABILITY nella mappa del set di proprietà.

    • Modifica

      Specifica che il consumer supporta gli aggiornamenti dei dati di riga nel set di righe.

    • Inserimento

      Specifica che il consumer supporta l'inserimento di righe nel set di righe.

    • CANC

      Specifica che il consumer supporta l'eliminazione di righe nel set di righe.

Vedi anche

Consumer OLE DB ATL
Aggiunta di funzionalità con creazioni guidate codice
Stringhe di connessione e collegamenti dati (OLE DB)