Konfigurieren eines WCF-CustomIsolated-Empfangshandlers
Sie müssen die Eigenschaften des Empfangshandlers konfigurieren, wenn der WCF-CustomIsolated-Adapter die benutzerdefinierten Verhaltenserweiterungen an anderen Speicherorten als machine.config nachschlagen soll.
Warum sollte der WCF-CustomIsolated-Adapter benutzerdefinierte Verhaltenserweiterungen an anderen Speicherorten als „machine.config“ nachschlagen?
Von BizTalk Server verwendete benutzerdefinierte Verhaltenserweiterungen werden im machine.config registriert. Vor dem Laden der Verhaltenserweiterungen sucht der WCF-CustomIsolated Adapter nach den Verhaltenserweiterungen in machine.config. machine.config wird jedoch idealerweise verwendet, um Konfigurationsinformationen zu speichern, die für alle Anwendungen erforderlich sind, die auf einem bestimmten Computer ausgeführt werden. Andererseits können WCF-Benutzerdefinierte Verhaltenserweiterungen nur für BizTalk Server und nicht für alle anwendungen erforderlich sein, die auf dem Computer ausgeführt werden. Wenngleich das Speichern benutzerdefinierter Verhaltenserweiterungen in machine.config einen Zweck erfüllt, handelt es sich nicht um den optimalen Speicherort.
Mit BizTalk Server stellen die Adapterhandlereigenschaften einen zusätzlichen Speicherort bereit, von dem aus der WCF-CustomIsolated Adapter die benutzerdefinierten Verhaltenserweiterungen suchen kann. Beachten Sie, dass hierdurch nicht die Verhaltenserweiterungen ersetzt werden, die in machine.config bereits verfügbar sind.
Weitere Überlegungen
Berücksichtigen Sie die folgenden Punkte bei der Konfiguration der WCF-CustomIsolated-Empfangshandlereigenschaften:
Die benutzerdefinierten Verhaltenserweiterungen müssen entweder in machine.config oder den Adapterhandlereigenschaften verfügbar sein. Sie dürfen nicht doppelt an beiden Speicherorten vorhanden sein.
Wenn die benutzerdefinierte Verhaltenserweiterung bereits in machine.config verfügbar ist und Sie versuchen, dieselbe Verhaltenserweiterung für die Adapterhandlereigenschaften festzulegen, erhalten Sie eine Fehlermeldung, sobald Sie versuchen, die Eigenschaften festzulegen.
Wenn die benutzerdefinierte Verhaltenserweiterung bereits für die Adapterhandlereigenschaften festgelegt ist und Sie anschließend die Datei machine.config mit derselben Verhaltenserweiterung aktualisieren, erhalten Sie einen Laufzeitfehler, der auch im Ereignisprotokoll protokolliert wird. Der Empfangsspeicherort ist auch deaktiviert.
Die Assemblys, auf die in der benutzerdefinierten Verhaltenserweiterung verwiesen wird, müssen im globalen Assemblycache (GAC) vorhanden sein, bevor Sie die Adapterhandlereigenschaften festlegen können.
Konfigurieren der Adapterhandlereigenschaften
Konfigurieren Sie einen WCF-CustomIsolated-Empfangshandler anhand der folgenden Vorgehensweise.
So konfigurieren Sie die Adapterhandlereigenschaften
Erweitern Sie in der BizTalk-Verwaltungskonsole BizTalk ServerAdministration, BizTalk-Gruppe, Plattformeinstellungen und dann Adapter.
Klicken Sie in der erweiterten Adapterliste auf WCF-CustomIsolated, klicken Sie im rechten Bereich mit der rechten Maustaste auf den Empfangshandler, den Sie konfigurieren möchten, und klicken Sie dann auf Eigenschaften.
Wählen Sie im Dialogfeld Eigenschaften des Adapterhandlers auf der Registerkarte Allgemein in der Liste Hostname den Host aus, dem der Empfangshandler zugeordnet werden soll, und klicken Sie dann auf Eigenschaften.
Führen Sie im Dialogfeld WCF-CustomIsolated Transport Properties (WCF-CustomIsolated Transport Properties ) auf der Registerkarte WCF-Erweiterungen die folgenden Schritte aus:
Option Aufgabe Importieren Importiert eine WCF-Konfigurationsdatei mit benutzerdefinierten WCF-Verhaltenserweiterungen. Wenn Sie auf diese Schaltfläche klicken, wird das Dialogfeld WCF-Konfiguration importieren geöffnet, um eine WCF-Konfigurationsdatei zu durchsuchen und zu suchen. Beachten Sie, dass es sich bei der Datei um eine gültige WCF-Konfigurationsdaten handeln muss. Weitere Informationen zum WCF-Konfigurationsschema finden Sie unter "Windows Communication Foundation-Konfigurationsschema" unter https://go.microsoft.com/fwlink/?LinkId=163953. Export Exportiert die benutzerdefinierte WCF-Verhaltenserweiterung in eine WCF-Konfigurationsdatei. Wenn Sie auf diese Schaltfläche klicken, wird das Dialogfeld WCF-Konfiguration exportieren geöffnet, um die WCF-Konfigurationsdatei zu durchsuchen und zu speichern. Clear Entfernt die vorhandene benutzerdefinierte WCF-Verhaltenserweiterung aus den Adapterhandlereigenschaften.