Konfigurieren eines WCF-Custom-Sendehandlers
Sie müssen die Sendehandlereigenschaften konfigurieren, wenn der WCF-Custom-Adapter die benutzerdefinierten Verhaltenserweiterungen an anderen Speicherorten als machine.config suchen soll.
Warum sollte der WCF-Custom-Adapter benutzerdefinierte Verhaltenserweiterungen an anderen Speicherorten als "machine.config" nachschlagen?
Benutzerdefinierte Verhaltenserweiterungen, die von BizTalk Server verwendet werden, werden im machine.config registriert. Vor dem Laden der Verhaltenserweiterungen sucht der WCF-Custom-Adapter nach den Verhaltenserweiterungen in machine.config. machine.config wird jedoch ideal verwendet, um Konfigurationsinformationen zu speichern, die für alle Anwendungen erforderlich sind, die auf einem bestimmten Computer ausgeführt werden. Andererseits sind WCF-Erweiterungen für benutzerdefiniertes Verhalten möglicherweise nur für BizTalk Server und nicht für alle Anwendungen erforderlich, 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-Custom 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-Custom-Sendehandlereigenschaften:
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.
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 anhand der Anweisung in diesem Thema einen WCF-Custom-Sendehandler.
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-Custom, klicken Sie im rechten Bereich mit der rechten Maustaste auf den Sendehandler, 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 Sendehandler zugeordnet werden soll, und klicken Sie dann auf Eigenschaften.
Führen Sie im Dialogfeld WCF-Benutzerdefinierte Transporteigenschaften 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 nach einer WCF-Konfigurationsdatei 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.