Schritt 9: Erstellen und Bereitstellen des Echoadapters

Zeit bis zum Abschluss: 10 Minuten

In diesem Schritt führen Sie die zum Bereitstellen des Echoadapters erforderlichen Aufgaben aus. Dazu gehören alle folgenden:

• Erstellen sie eine Datei mit starkem Namen, und weisen Sie sie der EchoAdapterassembly zu.

• Erstellen des Echoadapters

• Veröffentliche die Assembly im GAC

• Registrieren des Echoadapters bei windows Communication Foundation (WCF)

Voraussetzungen

Um diesen Schritt erfolgreich abzuschließen, sollten Sie mit starken Namensdateien und dem GAC vertraut sein. Ein grundlegendes Verständnis der Konfiguration von Windows Communication Foundation (WCF) ist hilfreich, aber nicht erforderlich.

So weisen Sie Ihrer Assembly einen starken Namen zu

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das EchoAdapter-Projekt , und klicken Sie dann auf Eigenschaften.

2. Wählen Sie im Dialogfeld "EchoAdapter-Eigenschaftenseiten" im linken Bereich " Signieren " aus.

3. Klicken Sie auf die Registerkarte " Assembly signieren ".

4. Wählen Sie <"Neu" aus,> für die Datei mit starkem Namen. Wenn Sie zur Eingabe eines Dateinamens aufgefordert werden, geben Sie "EchoAdapter.snk" ein, deaktivieren Sie die Option "Meine Schlüsseldatei schützen" mit einer Kennwortoption, und klicken Sie dann auf "OK".

5. Klicken Sie auf die Registerkarte Anwendung.

6. Ändern Sie den Assemblynamen in "Microsoft.Adapters.Samples.EchoV2".

7. Klicken Sie im Visual Studio-Menü auf "Datei ", und wählen Sie dann " Alle speichern" aus.

So erstellen und bereitstellen Sie den Echoadapter

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das EchoAdapter-Projekt , und klicken Sie dann auf "Erstellen". Wenn der Build nicht erfolgreich ist, beheben Sie Fehler, und versuchen Sie, den Echoadapter neu zu erstellen.

2. Öffnen Sie eine Visual Studio-Eingabeaufforderung.

3. Geben Sie den folgenden Befehl ein:

   gacutil.exe /if "<Pfad zur Assembly\Microsoft.Adapters.Samples.EchoV2.dll>"

   Dadurch wird die Assembly im GAC installiert, wobei alle vorhandenen Assemblys mit demselben Assemblynamen überschrieben werden.

So registrieren Sie den Echoadapter bei Windows Communication Foundation

1. Bearbeiten Sie die machine.config Datei, die sich im Microsoft .NET-Konfigurationsordner befindet. Klicken Sie hierzu auf Start, klicken Sie auf Ausführen, geben Sie notepad <Windows-Installationspfad>\Microsoft.NET\Framework\<Version>\CONFIG\machine.config ein, und klicken Sie dann auf OK.

2. Aktualisieren Sie die machine.config Datei. Wenn Ihr machine.config keinen Abschnitt "system.serviceModel" enthält, fügen Sie den folgenden Abschnitt am Ende der Konfigurationsdatei, aber vor dem schließenden Stammtag hinzu.

   Hinweis

   Ersetzen Sie die Versions-, Kultur- und Public-Key-Token sowie andere assemblyspezifische Informationen durch Ihre Adapterinformationen.

   <system.serviceModel>  
     <client>  
       <endpoint binding="echoAdapterBindingV2" contract="IMetadataExchange"  
         name="echov2" />  
     </client>  
     <extensions>  
       <bindingElementExtensions>  
         <add name="echoAdapterV2" type="Microsoft.Adapters.Samples.EchoV2.EchoAdapterBindingElementExtensionElement,Microsoft.Adapters.Samples.EchoV2, Version=1.0.0.0, Culture=neutral, PublicKeyToken=xxxxxxxxxxxxxxxx" />  
       </bindingElementExtensions>  
       <bindingExtensions>  
         <add name="echoAdapterBindingV2" type="Microsoft.Adapters.Samples.EchoV2.EchoAdapterBindingCollectionElement,Microsoft.Adapters.Samples.EchoV2, Version=1.0.0.0, Culture=neutral, PublicKeyToken=xxxxxxxxxxxxxxxx" />  
       </bindingExtensions>  
     </extensions>  
   </system.serviceModel>  
   

   • ODER -

     Wenn Ihr machine.config einen Abschnitt "system.serviceModel" enthält, bestimmen Sie, welche Elemente fehlen, und fügen Sie sie hinzu.

   Hinweis

   Ersetzen Sie die Versionsinformationen, Kulturinformationen, das Public Key Token und andere assemblyspezifische Informationen durch die Angaben Ihres Adapters.

   <client>  
     <endpoint binding="echoAdapterBindingV2" contract="IMetadataExchange"  
       name="echov2" />  
   </client>  
   <extensions>  
     <bindingElementExtensions>  
       <add name="echoAdapterV2" type="Microsoft.Adapters.Samples.EchoV2.EchoAdapterBindingElementExtensionElement,Microsoft.Adapters.Samples.EchoV2, Version=1.0.0.0, Culture=neutral, PublicKeyToken=xxxxxxxxxxxxxxxx" />  
     </bindingElementExtensions>  
     <bindingExtensions>  
       <add name="echoAdapterBindingV2" type="Microsoft.Adapters.Samples.EchoV2.EchoAdapterBindingCollectionElement,Microsoft.Adapters.Samples.EchoV2, Version=1.0.0.0, Culture=neutral, PublicKeyToken=xxxxxxxxxxxxxxxx" />  
     </bindingExtensions>  
   </extensions>  
   

3. Speichern Sie die machine.config Datei.

Was habe ich gerade getan?

In diesem letzten Schritt des Echoadapter-Lernprogramms haben Sie dem Echoadapter einen starken Namen hinzugefügt, den Adapter erstellt und bereitgestellt und anschließend Machine.config so geändert, dass Informationen zum Adapter enthalten sind. An dieser Stelle sollte der Echoadapter für die Nutzung von Anwendungen verfügbar sein.

Nächste Schritte

Dieses Lernprogramm ist abgeschlossen. Wenn Sie die Echoadapterfunktionalität in einem .NET-Projekt testen möchten, lesen Sie Lernprogramm 2: Verwenden des Echoadapters von .NET.

Siehe auch

Schritt 8: Implementierung des synchronen Eingangs-Handlers für den Echoadapter
Lernprogramm 2: Verwenden des Echoadapters von .NET