Schritt 9: Erstellen und Bereitstellen des Echo-Adapters

Artikel
07/21/2023

Schritt 9 von 9

Abgeschlossene Zeit: 10 Minuten

In diesem Schritt führen Sie die zum Bereitstellen des Echoadapters erforderlichen Aufgaben aus. Dies umfasst folgendes:

Erstellen sie eine Datei mit starkem Namen, und weisen Sie sie der Echo-Adapterassembly zu.
Erstellen des Echoadapters
Veröffentlichen der Assembly im GAC
Registrieren des Echoadapters bei Windows Communication Foundation (WCF)

Voraussetzungen

Um diesen Schritt erfolgreich abzuschließen, sollten Sie mit dateien mit starken Namen 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

Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf das Projekt EchoAdapter, und klicken Sie dann auf Eigenschaften.
Wählen Sie im Dialogfeld EchoAdapter-Eigenschaftenseiten im linken Bereich die Option Signatur aus.
Klicken Sie auf die Registerkarte Assembly sign . .
Wählen Sie <neu...> für die Datei mit starkem Namen aus. Wenn Sie zur Eingabe eines Dateinamens aufgefordert werden, geben Sie EchoAdapter.snk ein, deaktivieren Sie die Option Meine Schlüsseldatei mit kennwort schützen, und klicken Sie dann auf OK.
Klicken Sie auf die Registerkarte Anwendung .
Ändern Sie den Assemblynamen in Microsoft.Adapters.Samples.EchoV2.
Klicken Sie im Visual Studio-Menü auf Datei , und wählen Sie Dann Alle speichern aus.

So erstellen Und Bereitstellen des Echoadapters

Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf das Projekt EchoAdapter, und klicken Sie dann auf Erstellen. Wenn der Build nicht erfolgreich ist, beheben Sie alle Fehler, und versuchen Sie, den Echoadapter neu zu erstellen.
Öffnen Sie eine Visual Studio-Eingabeaufforderung.
Geben Sie folgenden Befehl ein:

gacutil.exe /if "<Pfad zu assembly\Microsoft.Adapters.Samples.EchoV2.dll>"

Dadurch wird die Assembly im GAC installiert, wobei eine bereits vorhandene Assembly mit demselben Namen überschrieben wird.

So registrieren Sie den Echoadapter bei Windows Communication Foundation

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

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

Hinweis

Ersetzen Sie die Version, Kultur, das öffentliche Schlüsseltoken und andere assemblyspezifische Informationen durch die Informationen Ihres Adapters.

<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 Version, Kultur, das öffentliche Schlüsseltoken und andere assemblyspezifische Informationen durch die Informationen 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>

Speichern Sie die Datei machine.config.

Was habe ich nur getan?

In diesem letzten Schritt des Echoadapter-Tutorials haben Sie dem Echoadapter einen starken Namen hinzugefügt, den Adapter erstellt und bereitgestellt und dann Machine.config geändert, um Informationen zum Adapter aufzunehmen. An diesem Punkt sollte der Echoadapter für anwendungen verfügbar sein.

Nächste Schritte

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

Weitere Informationen

Schritt 8: Implementieren des synchronen Eingangshandlers für den Echo-Adapter
Tutorial 2: Nutzen des Echo-Adapters aus .NET

Freigeben über