Bereitstellen eines Adapters mithilfe des WCF LOB Adapter SDK

Artikel
07/21/2023

Zum Bereitstellen eines Adapters müssen Sie die Adapterassembly im globalen Assemblycache (GAC) installieren und dann den Adapter in der machine.config-Datei registrieren.

Installieren der Adapterassembly im GAC

Bevor Sie einen Adapter in Visual Studio mithilfe des Befehls Adapterdienstverweis-Plug-In hinzufügen oder in BizTalk Server mithilfe des Features Adapterdienst-Add-In nutzen verwenden, müssen Sie die Assembly im GAC installieren. Nur Assemblys mit starkem Namen können im GAC installiert werden.

Hinweis

Um dieses Verfahren abzuschließen, müssen Sie mit einem Konto angemeldet sein, das über Schreibberechtigungen für den GAC verfügt. Das Administratorkonto auf dem lokalen Computer verfügt über diese Berechtigungen.

Konfigurieren einer Assemblyschlüsseldatei mit starkem Namen

Laden Sie in Visual Studio die Adapterprojektdatei, die einen starken Namen benötigt.
Öffnen Sie eine Visual Studio-Eingabeaufforderung.
Geben Sie in der Eingabeaufforderung aus dem Ordner, in dem Sie die Schlüsseldatei speichern möchten, folgenden Befehl ein, und drücken Sie die EINGABETASTE:

sn /kfile_name.snk

Beispiel: sn /k EchoAdapter.snk

In der Befehlszeile wird eine Bestätigungsmeldung angezeigt, in file_name.snk,>geschriebenes< Schlüsselpaar angezeigt wird.
Klicken Sie in Visual Studio Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, und klicken Sie dann auf Eigenschaften.
Erweitern Sie im linken Bereich Allgemeine Eigenschaften, und klicken Sie dann auf Assembly.
Scrollen Sie im rechten Bereich zum Feld Starker Name .
Klicken Sie im Feld Starker Name auf das Feld neben Assemblyschlüsseldatei, klicken Sie auf die Schaltfläche Durchsuchen (...), und navigieren Sie dann zur Schlüsseldatei.
Klicken Sie auf die Schlüsseldatei, klicken Sie auf Öffnen, und klicken Sie dann auf OK.
Klicken Sie im Visual Studio-Menü auf Erstellen, und wählen Sie dann Projektmappe erstellen aus.

Hinweis

Wenn Ihre Adapterassembly von anderen Assemblys abhängig ist, stellen Sie sicher, dass diese Assemblys, auf die verwiesen wird, mit einem starken Namen signiert sind. Andernfalls erhalten Sie eine Fehlermeldung.

Wenn Sie über die Quelle verfügen, können Sie mit einem starken Namen neu kompilieren, wie zuvor gezeigt. Wenn die Verweisassembly einem Drittanbieter gehört und Sie nicht sicherstellen können, dass sie einen starken Namen erhält, können Sie die Assembly disassemblieren und dann mit einem starken Namen neu zusammenbauen.

Ihre ursprüngliche Assembly wird überschrieben. Wenn Sie also die ursprüngliche Version beibehalten möchten, stellen Sie sicher, dass Sie eine Sicherungskopie davon erstellen, bevor Sie mit den folgenden Schritten fortfahren.

Verwenden Sie MSIL-Disassembler (Microsoft Intermediate Language), um die Assembly zu disassemblieren:

ILDASM thirdparty.dll /out:thirdparty.il

Verwenden Sie MSIL Assembler, um die Assembly mit einem starken Namen neu zusammenzustellen:
ILASM thirdparty.il /dll /key=strongkeyfile.snk

Installieren einer Assembly im GAC

Vergewissern Sie sich, dass Ihr Adapter signiert wurde.
Öffnen Sie eine Visual Studio-Eingabeaufforderung.
Geben Sie folgenden Befehl ein:

gacutil.exe /if "<Pfad zur Assembly .dll Datei>"
Dadurch wird die Assembly im GAC installiert, wobei eine bereits vorhandene Assembly mit demselben Namen überschrieben wird.

Registrieren des Adapters in Machine.config

Ein adapter, der mit dem WCF LOB Adapter SDK entwickelt wurde, wird als WCF-Bindung angezeigt. Weitere Informationen finden Sie unter Microsoft.ServiceModel.Channels.Common.AdapterBinding. Die Adapterbindung wird mithilfe des <Abschnitts bindingExtensions> innerhalb des <Systems bei WCF registriert. ServiceModel> und das Adaptertransportbindungselement werden im Abschnitt bindingElementExtensions> innerhalb des <Systems bei <WCF registriert. ServiceModel>.

Sie können die machine.config-Datei manuell mit einem Text-Editor bearbeiten.

Manuelles Bearbeiten der machine.config-Datei

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.config ein, und klicken Sie dann auf OK.

Aktualisieren Sie die datei machine.config. Wenn die Datei 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 "myAdapterBinding", Version, Kultur und andere assemblyspezifische Informationen durch die Informationen Ihres Adapters.

<system.serviceModel>  
  <extensions>  
    <bindingExtensions>  
        <add name="myAdapterBinding" type="Microsoft.Adapters.Samples.Echo.EchoAdapterBindingCollectionElement,EchoAdapter, Version=0.0.0.0, Culture=neutral, PublicKeyToken= fafafafafafafafa" />  
    </bindingExtensions>      <bindingElementExtensions>  
        <add name="echoAdapter" type="Microsoft.Adapters.Samples.Echo.EchoAdapterBindingElementExtension,EchoAdapter, Version=0.0.0.0, Culture=neutral, PublicKeyToken=37f23b4adb996dcf" />  
      </bindingElementExtensions>  
  </extensions>  
</system.serviceModel>

- ODER -

Wenn Ihre machine.config-Datei einen Abschnitt system.serviceModel enthält, ermitteln Sie, welche Elemente fehlen, und fügen Sie sie hinzu, indem Sie "MyAdapter" und andere Informationen durch die Informationen Ihres Adapters ersetzen.

<extensions>  
  <bindingExtensions>  
        <add name="myAdapterBinding" type="Microsoft.Adapters.Samples.Echo.EchoAdapterBindingCollectionElement,EchoAdapter, Version=0.0.0.0, Culture=neutral, PublicKeyToken= fafafafafafafafa" />  
  </bindingExtensions>  
      <bindingElementExtensions>  
        <add name="echoAdapter" type="Microsoft.Adapters.Samples.Echo.EchoAdapterBindingElementExtension,EchoAdapter, Version=0.0.0.0, Culture=neutral, PublicKeyToken=37f23b4adb996dcf" />  
      </bindingElementExtensions>  
</extensions>

Schließen und speichern Sie die Datei machine.config.

Sie können auch den Dienstkonfigurations-Editor verwenden, um die machine.config Datei zu ändern.

Bearbeiten der machine.config-Datei mit dem Dienstkonfigurations-Editor

Öffnen Sie den Dienstkonfigurations-Editor. Weitere Informationen finden Sie unter Dienstkonfigurations-Editor .
Erweitern Sie im Strukturansichtsbereich (mit der Bezeichnung Konfiguration) die Knotenstruktur. Klicken Sie auf den Ordner Erweitert , klicken Sie auf den Ordner Erweiterungen , und wählen Sie dann das Bindungserweiterungselement aus.
Erstellen Sie eine neue Bindungserweiterung. Klicken Sie auf die Schaltfläche Neu , um das Dialogfeld Erweiterungskonfigurationselement-Editor zu öffnen. Geben Sie unter Konfigurationsname einen eindeutigen Namen für die Erweiterungen ein, z. B . MyAdapterExtension.
Klicken Sie auf das Feld Typ , und klicken Sie dann auf die Schaltfläche mit den Auslassungspunkten (...), um das Dialogfeld Bindungserweiterungstypbrowser zu öffnen.
Klicken Sie auf das Symbol für den globalen Assemblycache (GAC), um die DLLs im GAC aufzulisten.
Klicken Sie auf Ihre Adapterassembly.

"
Klicken Sie auf die Schaltfläche Öffnen , um die Assembly auszuwählen.
Klicken Sie im Dialogfeld Bindungserweiterungstypbrowser auf den Typnamen, der das Bindungsauflistungselement implementiert.
Klicken Sie auf die Schaltfläche Öffnen , um den Typ auszuwählen.
Klicken Sie auf OK , um das Dialogfeld Erweiterungskonfigurationselement-Editor zu schließen.
Vergewissern Sie sich im Detailbereich des Bindungserweiterungs-Editors, dass Ihre Bindungserweiterung angezeigt wird. In der folgenden Abbildung ist MyAdapterExtension hervorgehoben.
Schließen Sie den Dienstkonfigurations-Editor.