Information: Verwenden ActiveX Data Objects (ADO) über # Import in VC++

Die # Import-Direktive in Visual C++ bietet einen leistungsfähigen neuen Mechanismus zum Bearbeiten von OLE-Server. Mit ActiveX Data Objects (ADO) verwendet, vereinfachen die # Import Ihrer Daten abrufen. Dieser Artikel beschreibt was # Import mit ADO nutzen erforderlich ist.

Bevor Sie instanziieren alle Klassen erstellt durch # Import

Es ist wichtig OLE initialisieren, bevor Sie alle Instanzen von Klassen, die durch # Import erstellt erstellen. Der folgende Code ist z. B. sicher, es einen intelligenter Zeiger # Import deklariert, initialisiert OLE und instanziiert intelligenten Zeiger:

Im nächste Codebeispiel jedoch ist nicht sicher und eine unbehandelte Ausnahme generiert. Globale intelligente Zeiger p ist sowohl deklariert und instanziiert (aufgrund von einer bestimmten Uuid im Konstruktor übergeben):

Da p eine globale Variable ist, wird er instanziiert, bevor CoInitialize jemals in main() aufgerufen wird. Sie können dies korrigieren, mit dem folgenden Codeausschnitt:
Eine Instanz der Struktur InitOle deklariert ist, und bevor p instanziiert, und daher in seinem Konstruktor initialisiert OLE. Ohne diese Art von ausfallsicheres sehen Sie die folgende Fehlermeldung:

Richtige Implementierung von # Import

Es ist wichtig, ADO korrekt in Ihrem Programm aufrufen, oder Sie können Compilerfehler über. Der folgende Code veranschaulicht, wie von # Import mit Msado10.dll die MSADO15.dll ordnungsgemäß:

Fehlerbehandlung

Mit ADO Sie möglicherweise eine Fehlermeldung in das von einer ADO-Methode zurückgegebene HRESULT, erhalten Sie möglicherweise eine Ausnahme von # Import generierten Klassen und entweder Bedingung kann ADO Errors-Auflistung aufgefüllt werden. Um bei der Errors-Auflistung abgerufen werden, benötigen Sie eine gültige Connection-Objekt. Weitere Informationen finden Sie in der folgenden Artikel der Microsoft Knowledge Base:

ADO und Dbdaoint.h

Versucht, ADO (über # Import) und MFC-DAO- oder das DAO SDK in der gleichen Implementierungsdatei mischen Sie wie folgt:


Die folgenden sechs Fehler generiert:

Während im Inhalt sehr nahezu identisch, unterschiedlich der tatsächlichen Werte in jeder Enumerationstyp was von ADO erforderlich ist und welche DAO erforderlich ist. Sie haben mehrere Möglichkeiten, dies zu umgehen:

• Separaten ADO und DAO-Code in separaten CPP-Dateien. Halten Sie die Verwendung von # Import oder # include <afxdao.h/dbdao.h> in separate Implementierungsdateien sowie.
• Ändern Sie die Anweisung # Import, so dass ausschließlich für ADO generiert für einen Namespace erstellen. Dies bedeutet, Sie auf den Namespace verweisen, wenn ein ADO-Objekt in die beiden Funktionen unten dargestellten verweisen müssen. Die erste veranschaulicht, wie ADO ausschließlich innerhalb einer Funktion zu verwenden. Das zweite zeigt wie ADO und DAO-Objekte mischen und übereinstimmen. Dies ist möglich, nur durch explizit verweisen auf den ADO-Namespace für alle ADO-Klasse oder Enumerationstyp:
  
  

     #include <afxdao.h>
  
        #import <msado15.dll>                            \ 
                rename_namespace("AdoNS") rename( "EOF", "adoEOF" )
  
        void ADOOnly( void )
        {
            using namespace AdoNS;
  
            _RecordsetPtr   prs;
  
            // Generates Compile Errors:
            CDaoRecordset   rs;
        }
  
        void MixAdoAndDao( void )
        {
            AdoNS::_RecordsetPtr  prs;
  
            // Compiles just fine
            CDaoRecordset   drs;
        }
  						

Dissecting und Verwenden von Msado105.tlh/Msado15.tli--------------------------------------------

# Import generiert zwei Dateien, Msado105.tlh und Msado15.tli aus der Typbibliothek enthaltenen msado15.dll. Die Struktur der TLH-Datei kann wie folgt aufgeteilt werden:

• Forward Verweise und Typdefinitionen
• Intelligente Zeiger TypeDef und Deklarationen
• Typ-Bibliothek Objekte

Jede wird nachstehend ausführlich beschrieben.

Forward Verweise und Typdefinitionen

Forward Verweise und Typdefinitionen werden mithilfe der Struktur __declspec(uuid("...")) auf der GUID für alle Dual Interface, Schnittstelle, erstellt und CoClass in der Typbibliothek definiert.

Nicht alle Schnittstellen, wie z. B. Verbindung haben mehrere Implementierungen. Dies hängt von der Typbibliothek, für ADO die meisten Schnittstellen sind jedoch zwei und nicht implementiert als Schnittstelle oder Co-Klasse.

Intelligente Zeiger TypeDef-Deklarationen

Für Schnittstellen und duale Schnittstellen intelligente Zeiger werden deklariert, die wird erheblich vereinfacht mithilfe der Benutzeroberfläche: beachten, dass kein intelligenter Zeiger für die Schnittstelle Verbindung Co-Klasse deklariert wurde.

Typ-Bibliothek Objekte

Dies umfasst alle Enumerationstypen, die in der Typbibliothek als auch Implementierung der intelligenten Zeigern und Typelib-Elemente definiert:

Im vorherigen Codefragment verwendet der Abschnitt Eigenschaft Daten Declspec um Get deklarieren und legen Sie die Methoden für ConnectionString. Der Wrapper Methoden Abschnitt enthält Methoden, die durch # Import, erstellt diese Methoden umbrochen, und eine _com_error Ausnahme auslösen, wenn Sie nicht erfolgreich sind. Abschnitt RAW Vorgehensweisen deklariert die aktuelle Methode, die durch die Schnittstelle aufgerufen wird.

Während Sie GetConnectionString oder PutConnectionString aufrufen konnte, ist es eigentlich nicht erforderlich. Da eine Eigenschaft ConnectionString würden Sie wie folgt verweisen:



Die eigentliche Implementierung GetConnectionString-PutConnectionString finden Sie in der Datei Msado15.tli.

Wenn das Verbindungsobjekt in Ihrem Code verwenden, würden Sie eine Instanz des intelligenten Zeiger für die duale Schnittstelle im Msado15.tlh wie folgt definiert verwenden:



Wo ist Pubs eine ODBC-Datenquelle.

# Import und explizites Aufrufen von Release()

Der Vorteil von # Import ist, dass es QueryInterface, AddRef und Release für Sie automatisch übernimmt. Wenn Sie explizit aufrufen von Release() starten möchten, können Sie jedoch Probleme für sich selbst erstellen.

Eine Variable, Member M_pInterface ist innerhalb _com_ptr_t. # Import einer sehr einfachen Wrapper ist, macht es keine Unterscheidung mit M_pInterface, nachdem das Objekt im Vergleich zu nur dekrementiert den Verweiszähler ohne das Objekt zu zerstören tatsächlich freigegeben ist. Durch Aufrufen von explizit freigeben versucht ()--ohne sehr explizit aufrufen AddRef() zum Ausgleichen von es--# Import gladly, ein Objekt freigeben, die nicht existiert, Erstellen von interessanten Nebeneffekte und abstürzenden Verhalten.

Empfohlene Empfehlung haben nicht AddRef() er (oder zumindest nicht erforderlich,), nicht es entweder.

• Inside COM von Dale Rogerson ISBN 1-57231-349-8
• Den OLE-COM-Objektkatalog (OLEView.exe), der ausgeliefert wird mit Visual C++ für den Inhalt einer Typenbibliothek untersuchen.
• Visual C++-online-Dokumentation: Suche nach # Import

Weitere Informationen finden Sie folgenden Artikel der Microsoft Knowledge Base: