Exemplarische Vorgehensweise: Hello World: Ein COM-Interop-Beispiel für intelligente Geräte

Artikel
09/02/2008

Aktualisiert: November 2007

Diese exemplarische Vorgehensweise veranschaulicht, wie ein einfaches COM-Objekt und eine verwaltete Anwendung in einer einzigen Projektmappe kombiniert werden.

Hinweis:
Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Diese exemplarische Vorgehensweise wurde mithilfe von Visual C++-Entwicklungseinstellungen geschrieben.

Erstellen eines COM-Objekts

So erstellen Sie ein ATL-Projekt für intelligente Geräte

Zeigen Sie im Menü Datei auf Neu, klicken Sie auf Projekt, erweitern Sie im BereichProjekttypen den Knoten Visual C++, und klicken Sie dann auf Intelligentes Gerät.
Klicken Sie im Bereich Vorlagen auf ATL-Projekt für intelligente Geräte.
Geben Sie im Feld Name die Zeichenfolge HelloCOMObject ein.
Geben Sie im Feld Projektmappenname die Zeichenfolge InteropSolution ein.
Klicken Sie auf OK, um den ATL-Projekt-Assistenten für intelligente Geräte zu starten.
Klicken Sie auf Fertig stellen, um den Assistenten zu schließen.

Für diese exemplarische Vorgehensweise müssen Sie keine Standardeinstellungen im Assistenten ändern.

So fügen Sie eine Klasse hinzu

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt HelloCOMObject, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Klasse, um das Dialogfeld Klasse hinzufügen zu öffnen.
Klicken Sie im Bereich Kategorien auf Intelligentes Gerät.
Klicken Sie im Bereich Vorlagen auf Einfaches ATL-Objekt, und klicken Sie dann auf Hinzufügen, um den ATL-Assistenten für einfache Objekte zu öffnen.
Geben Sie im Feld Kurzer Name die Zeichenfolge Hello ein.
Klicken Sie im linken Bereich auf Optionen, um die Seite Optionen zu öffnen.
Wählen Sie in der Gruppe Threadmodell den Eintrag Frei aus, und klicken Sie dann auf Fertig stellen.

So fügen Sie der Klasse eine Methode hinzu

Öffnen Sie das Fenster Klassenansicht auf der Registerkarte auf dem Desktop oder über das Menü Ansicht.
Erweitern Sie HelloCOMObject, um die IHello-Schnittstelle anzuzeigen.
Klicken Sie mit der rechten Maustaste auf IHello, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Methode hinzufügen, um den Assistenten zum Hinzufügen von Methoden zu öffnen.
Geben Sie im Feld Methodenname die Zeichenfolge HelloWorld ein.
Wählen Sie im Feld Parametertyp den Eintrag BSTR* aus.
Geben Sie im Feld Parametername die Zeichenfolge text ein.
Wählen Sie in der Gruppe Parameterattribute die Option out aus.
Klicken Sie auf Hinzufügen.

Im Methodenfeld wird [out] BSTR* text angezeigt.
Klicken Sie auf Fertig stellen, um den Assistenten zum Hinzufügen von Methoden zu schließen.

Die STDMETHOD(HelloWorld)(BSTR* text)-Methode wird in der Datei Hello.h angezeigt.

So fügen Sie der Methode eine Implementierung hinzu

Doppelklicken Sie im Projektmappen-Explorer auf Hello.cpp, um diese Datei im Code-Editor zu öffnen.
Fügen Sie im STDMETHODIMP-Abschnitt den folgenden Implementierungscode vor der return-Anweisung ein:
```
*text = SysAllocString(L"Hello World!");
```
Klicken Sie im Menü Erstellen auf HelloCOMObject erstellen.

Jetzt ist ein COM-Objekt Bestandteil der Projektmappe, und der erste Teil der exemplarischen Vorgehensweise ist abgeschlossen.

Erstellen eines verwalteten Projekts

So fügen Sie der Projektmappe ein verwaltetes Projekt hinzu

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf InteropSolution, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Neues Projekt.
Erweitern Sie im Bereich Projekttypen den Eintrag Visual C#, klicken Sie auf Intelligentes Gerät, im Bereich Vorlagen auf Projekt für intelligente Geräte, geben Sie im Feld NameSayHello ein, und klicken Sie auf OK.
Klicken Sie im Dialogfeld Neues Projekt für intelligente Geräte hinzufügen auf Geräteanwendung und dann auf OK.

Das verwaltete Projekt SayHello wird innerhalb der Projektmappe erstellt, und im Designer-Fenster wird ein Windows Mobile 5.0 Pocket PC-Formular angezeigt.

Hinzufügen des COM-Objekts als Verweis im verwalteten Projekt

So fügen Sie das COM-Objekt als Verweis im verwalteten Projekt hinzu

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das SayHello-Projekt, und klicken Sie dann auf Verweis hinzufügen.
Klicken Sie im Dialogfeld Verweis hinzufügen auf Durchsuchen.

Der Ordner SayHello wird im Feld Suchen in angezeigt.
Navigieren Sie zum übergeordneten Ordner (in dieser exemplarischen Vorgehensweise InteropSolution).
Doppelklicken Sie im Fenster, das den Inhalt von Ordnern zeigt, auf HelloCOMObject, doppelklicken Sie auf Windows Mobile 5.0 Pocket PC SDK (ARMV4), doppelklicken Sie auf Debuggen, und klicken Sie dann auf HelloCOMObject.dll.
Klicken Sie auf OK, um das Dialogfeld Verweis hinzufügen zu schließen.

Hinweis:

Sie müssen als Administrator angemeldet sein. In Windows Vista wählen Sie beim Start von Visual Studio Als Administrator ausführen.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Form1.cs, und klicken Sie dann auf Code anzeigen.
Fügen Sie im Using directives-Bereich am Anfang der Datei folgenden Code hinzu:
```
using HelloCOMObjectLib;
```

Hinweis:
Sie müssen als Administrator angemeldet sein. In Windows Vista wählen Sie beim Start von Visual Studio Als Administrator ausführen.

Hinzufügen von Ereignisbehandlungscode zum verwalteten Projekt

So fügen Sie dem verwalteten Projekt Ereignisbehandlungscode hinzu und erstellen das Projekt

Öffnen Sie den Form1-Designer.
Ziehen Sie von der Toolbox einen Button auf das Formular.
Doppelklicken Sie auf diese Schaltfläche, um den Code-Editor beim Klickereignis zu öffnen.

Fügen Sie den folgenden Ereignisbehandlungscode für die Schaltfläche ein:

string text;
HelloClass h = new HelloClass();
h.HelloWorld(out text);
MessageBox.Show(text);

Klicken Sie im Menü Erstellen auf SayHello erstellen.

Vornehmen von abschließenden Anpassungen an der Projektmappe

So konfigurieren Sie die Projektmappe für die Bereitstellung

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt SayHello, und klicken Sie dann auf Als Startprojekt festlegen.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Projektmappe InteropSolution, und klicken Sie auf Projektabhängigkeiten.
Wählen Sie im Dialogfeld Projektabhängigkeiten in der Dropdownliste Projekte das Projekt SayHello aus, und wählen Sie dann im Feld Abhängigkeiten den Eintrag HelloCOMObject aus.
Klicken Sie auf OK.

Die Projektmappe ist nun zur Bereitstellung bereit.

Bereitstellung der gemischten Projektmappe

So stellen Sie die Projektmappe bereit

Klicken Sie im Menü Debuggen auf Starten ohne Debuggen.
Klicken Sie im Dialogfeld Bereitstellen auf Windows Mobile 5.0 Pocket PC Emulator und anschließend auf Bereitstellen.

Speichern Sie diese Projektmappe zur Verwendung in Exemplarische Vorgehensweise: Debuggen einer Projektmappe, die sowohl verwalteten als auch systemeigenen Code enthält.

Freigeben über