Technologiebeispiel für Objektkonstruktion
Aktualisiert: November 2007
In diesem Beispiel wird die Verwendung von Zeichenfolgen einer Objektkonstruktion in einer .NET-Umgebung veranschaulicht. Bei Zeichenfolgen einer Objektkonstruktion handelt es sich um Initialisierungszeichenfolgen, die mithilfe des Verwaltungstools Komponentendienste angegeben oder bearbeitet werden können, d. h., es ist nicht erforderlich, Konfigurationsinformationen in Komponenten fest zu programmieren. Die Benutzeroberfläche des Beispiels ist ein Formular mit einer Schaltfläche, über die ein Objekt erstellt wird, das Konstruktionszeichenfolgen verwendet. In Meldungsfeldern werden die verschiedenen Aktivierungsstufen angezeigt.
Informationen zum Verwenden der Beispiele finden Sie in folgenden Themen:
So erstellen Sie das Beispiel mithilfe der Eingabeaufforderung
Öffnen Sie das Eingabeaufforderungsfenster, und navigieren Sie zu einem der sprachspezifischen Unterverzeichnisse unter dem Verzeichnis Technologies\ComponentServices\ObjectConstruction.
Geben Sie je nach verwendeter Programmiersprache entweder msbuild ObjectConstructionCS.sln oder msbuild ObjectConstructionVB.sln ein.
So erstellen Sie das Beispiel mithilfe von Visual Studio
Öffnen Sie Windows Explorer, und navigieren Sie zu einem der sprachspezifischen Unterverzeichnisse unter dem Verzeichnis Technologies\ComponentServices\ObjectConstruction.
Doppelklicken Sie je nach verwendeter Programmiersprache auf das Symbol für ObjectConstructionCS.sln oder ObjectConstructionVB.sln, um die Datei in Visual Studio zu öffnen.
Klicken Sie im Menü Erstellen auf Projektmappe erstellen.
So führen Sie das Beispiel aus
Öffnen Sie ein Eingabeaufforderungsfenster oder Windows Explorer, und navigieren zu dem Verzeichnis, das die erstellte ausführbare Datei enthält.
Geben Sie OCDemo.exe in der Befehlszeile ein, oder starten Sie die ausführbare Datei, indem Sie in Windows Explorer auf die Datei doppelklicken. Merken Sie sich, ob Sie die C#-Version (im Unterverzeichnis \CS) oder die Visual Basic-Version (im Unterverzeichnis \VB) der Beispielanwendung ausführen, da dadurch die COM+-Komponentenattribute festgelegt werden, die Sie administrativ in einem späteren Schritt bearbeiten.
Klicken Sie auf die Schaltfläche Objekt erstellen, wenn das Programm gestartet ist. Bei jeder Aktivierungsstufe wird ein Meldungsfeld angezeigt. Beachten Sie den Wert der Zeichenfolge der Objektkonstruktion, der im Aufruf von IObjectConstruct::Construct gemeldet wird.
Starten Sie das Verwaltungstool Komponentendienste, indem Sie nacheinander auf Start -> Alle Programme -> Verwaltung -> Komponentendienste klicken. Suchen Sie die OCDemoSvr COM+-Anwendung durch Erweitern des Knotens Komponentendienste\Computer\Arbeitsplatz\COM+-Anwendungen im linken Bereich des Explorer.
Erweitern Sie den Knoten OCDemoSvr\Komponenten, und suchen Sie die Komponente Microsoft.Samples.Technologies.ComponentServices.ObjectConstruction.ObjectConstructionTest.
Klicken Sie mit der rechten Maustaste auf die Komponente ObjectConstructionTest, und wählen Sie im Popupmenü Eigenschaften aus.
Klicken Sie auf die Registerkarte Aktivierung, und geben Sie im Bearbeitungsfeld der Konstruktorzeichenfolge einen neuen Textwert ein. Klicken Sie auf OK, um die Änderung zu übernehmen.
Kehren Sie zur Anwendung OCDemo zurück, und klicken Sie erneut auf Objekt erstellen. Achten Sie auf den neuen Wert, der von der IObjectConstruct-Methode gemeldet wird: Er sollte mit der neu bearbeiteten Zeichenfolge von der Eigenschaftenseite der Komponente im COM+-Explorer identisch sein.
So deinstallieren Sie das Beispiel
Navigieren Sie zum Verzeichnis, indem Sie msbuild.exe ausgeführt oder die SLN-Datei geöffnet haben.
Geben Sie je nach verwendeter Programmiersprache msbuild.exe ObjectConstructionVB.sln /t:Clean oder msbuild.exe ObjectConstructionCS.sln /t:Clean in der Befehlszeile ein. Dadurch werden das .NET Services Installation-Tool (Regsvcs.exe) und das Global Assembly Cache-Tool (Gacutil.exe) mit dem /u-Schalter zum Entfernen der Beispieldateien aus dem COM+-Katalog und dem globalen Assemblycache aufgerufen.
Anforderungen
Plattform: Windows 2000, Windows XP, Windows Server 2003
.NET Framework-Version: 2.0, 1.1, 1.0
Hinweise
Weitere Informationen zum Erstellen von binären Beispieldateien und zu Registrierungsschritten finden in den Kommentaren in den Quellcodedateien.
Diese Prozedur veranschaulicht das Erstellen einer COM+-Komponente mit aktivierter Objektkonstruktion und unter Verwendung einer Standardkonstruktionszeichenfolge. Verschiedene Komponentenmethoden zeigen beim Erstellen einer Objektinstanz Meldungsfelder zum Veranschaulichen der Aufrufreihenfolge an. Sie bearbeiten die Zeichenfolge der Objektkonstruktion mithilfe des Verwaltungsdienstes Komponentendienste und führen das Beispiel erneut aus. Dabei erkennen Sie, dass sich die an die Komponenteninstanz übergebene Zeichenfolge der Objektkonstruktion geändert hat.
.gif "Hinweis") Hinweis: |
|---|
Verwenden Sie das Global Assembly Cache-Tool (Gacutil.exe), um die Assembly OCDemoSvr.dll im globalen Assemblycache zu installieren, bevor Sie das Beispiel ausführen. Gacutil.exe befindet sich im Verzeichnis SDK\<Version>\Bin. Wenn Sie beispielsweise die Visual Basic-Version des Beispiels erstellen, navigieren Sie zum Verzeichnis C:\Dokumente und Einstellungen\Ihr Benutzername\Eigene Dateien\Samples\Technologies\ComponentServices\ObjectConstruction\VB, und geben Sie gacutil -i OCDemoSvr.dll ein. |
Der Komponentenname, wie im Verwaltungstool Komponentendienste angezeigt, lautet Microsoft.Samples.Technologies.ComponentServices.ObjectConstruction.ObjectConstructionTest.
Wenn für eine Komponente die Objektkonstruktion aktiviert ist, ruft COM+ die IObjectContruct::Construct-Methode auf und implementiert diese unmittelbar nach Erstellen einer Instanz des Objekts. Die in den Aktivierungseigenschaften der Komponente angegebene Zeichenfolge der Objektkonstruktion wird als Argument an die Methode übergeben. In Verbindung mit dem Komponentencode, in dem die Objektzeichenfolge ordnungsgemäß verwendet wird, wird so die parametrisierte Objektkonstruktion bereitgestellt.
Sie können einen Standardwert für die Konstruktionszeichenfolge in der Default-Eigenschaft des ConstructionEnabledAttribute, im COM+-Katalog oder in beiden angeben.
Komponentenentwickler verwenden dieses Feature z. B., um eine Komponente mit einer generischen ODBC-Verbindung zu erstellen. Die Zeichenfolge der Objektkonstruktion enthält dann einen genauen DSN, der mithilfe des Verwaltungstools Komponentendienste geändert werden kann.
Zeichenfolgen einer Objektkonstruktion können in Verbindung mit COM+-Diensten für Objektpooling nützlich sein.
Siehe auch
Konzepte
Verwenden von COM-Typen in verwaltetem Code
Referenz
Global Assembly Cache-Tool (Gacutil.exe)