Freigeben über

Eigenschaftsschema und Eigenschaften für WCF-Adapter

  • Artikel

Erfahren Sie mehr über die heraufgestuften Eigenschaften im WCF-Adaptereigenschaftenschema. Die WCF-Adapter weisen den Eigenschaften Werte zu, die Sie in Ihrer Anwendung verwenden. Außerdem stellen die WCF-Adapter einen Mechanismus bereit, um benutzerdefinierte Eigenschaften zu schreiben, aber nicht in den BizTalk-Nachrichtenkontext heraufzustufen, und einen Mechanismus, um benutzerdefinierte Eigenschaften in den BizTalk-Nachrichtenkontext heraufzustufen. Weitere Informationen finden Sie unter SOAP-Header mit veröffentlichten WCF-Diensten.

Namespace:http://schemas.microsoft.com/BizTalk/2006/01/Adapters/WCF-properties

Aktion

Geben Sie das SOAPAction-Headerfeld für ausgehende Nachrichten an. Sie können diesen Wert auf zwei verschiedene Arten angeben: das einzelne Aktionsformat und das Aktionszuordnungsformat. Wenn Sie diese Eigenschaft beispielsweise im einzelnen Aktionsformat festlegen, http://contoso.com/Svc/Op1 wird der SOAPAction-Header für ausgehende Nachrichten immer auf den in dieser Eigenschaft angegebenen Wert festgelegt.

Wenn Sie diese Eigenschaft im Aktionszuordnungsformat festlegen, wird der ausgehende SOAPAction-Header vom BTS bestimmt. Vorgangskontexteigenschaft . Beispielsweise, wenn diese Eigenschaft auf das folgende XML-Format und das BTS festgelegt ist. Die Vorgangseigenschaft ist auf Op1 festgelegt, die der WCF-Sendeadapter für den ausgehenden SOAPAction-Header verwendethttp://contoso.com/Svc/Op1.

<BtsActionMapping>
<Operation Name="Op1" Action="http://contoso.com/Svc/Op1">
<Operation Name="Op2" Action="http://contoso.com/Svc/Op2">
</BtsActionMapping>

Wenn ausgehende Nachrichten von einem Orchestrierungsport stammen, legen Orchestrierungsinstanzen den BTS dynamisch fest. Operation-Eigenschaft mit dem Vorgangsnamen des Ports. Wenn ausgehende Nachrichten mit inhaltsbasiertem Routing weitergeleitet werden, können Sie btS festlegen. Vorgangseigenschaft in Pipelinekomponenten. Diese Eigenschaft wird automatisch aus eingehenden Nachrichten mit dem Einzelaktionsformat heraufgestuft.

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: Alle WCF-Sendeadapter

AffiliateApplicationName

Gibt die Partneranwendung für Einmaliges Anmelden für Unternehmen (SSO) an. Diese Eigenschaft ist erforderlich, wenn die UseSSO-Eigenschaft auf True festgelegt ist.

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: Alle WCF-Sendeadapter mit Ausnahme des WCF-NetNamedPipe-Adapters

AlgorithmSuite

Legt Nachrichtenverschlüsselung und Schlüsselverpackungsalgorithmen fest. Diese Algorithmen sind den Algorithmen in der Spezifikation der Sicherheitsrichtliniensprache (WS-SecurityPolicy) zugeordnet.

Weitere Informationen zu den anwendbaren Werten für die AlgorithmSuite-Eigenschaft finden Sie in der AlgorithmSuite-Eigenschaft im Dialogfeld WCF-NetTcp-Transporteigenschaften, auf der Registerkarte Senden, Sicherheit in der Referenz zu UI-Anleitungen und Entwickler-API-Namespaces.

Typ: Zeichenfolge Standardwert: Basic256 Gilt für:

  • WCF-BasicHttp-Adapter
  • WCF-NetMsmq Adapter
  • WCF-NetTcp-Adapter
  • WCF-WSHttp-Adapter

BindingConfiguration

Geben Sie eine XML-Zeichenfolge mit dem <Bindungselement> an, um verschiedene Typen vordefinierter Bindungen zu konfigurieren, die von Windows Communication Foundation (WCF) bereitgestellt werden. Weitere Informationen zur vom System bereitgestellten Bindung und benutzerdefinierten Bindung finden Sie in den entsprechenden Themen unter Siehe auch.

Beispiel:

<binding name="wsHttpBinding" transactionFlow="true">
<security><message clientCredentialType="UserName"></security>
</binding>

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: WCF-Custom Adapter, WCF-CustomIsolated Adapter

BindingType

Gibt den Typ der Bindung an, die für den Endpunkt verwendet werden soll. Weitere Informationen zu den anwendbaren Werten für die BindingType-Eigenschaft finden Sie in der Eigenschaft Bindungstyp im Dialogfeld WCF-Custom Transport Properties( WCF-Custom Transport Properties), auf der Registerkarte Senden, Bindung in der Referenz zu UI-Leitfaden und API-Namespace für Entwickler.

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: WCF-Custom Adapter, WCF-CustomIsolated Adapter

ClientCertificate

Geben Sie den Fingerabdruck des X.509-Zertifikats für die Authentifizierung dieses Sendeports gegenüber Diensten an. Diese Eigenschaft ist erforderlich, wenn die ClientCredentialsType-Eigenschaft auf Certificate festgelegt ist. Das Zertifikat, das für diese Eigenschaft verwendet werden soll, muss im Speicher "Mein " am Speicherort "Aktueller Benutzer" installiert werden.

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge gilt für:

  • WCF-BasicHttp-Sendeadapter
  • WCF-WSHttp-Sendeadapter
  • WCF-NetTcp Sendeadapter
  • WCF-NetMsmq Sendeadapter

CloseTimeout

Legt einen Wert für den Zeitraum fest, der bis zum vollständigen Schließen eines Kanals zur Verfügung steht.

Typ: Zeichenfolge Standardwert: 00:01:00 Gilt für: Alle WCF-Adapter außer WCF-Custom und WCF-CustomIsolated

CustomDeadLetterQueue

Geben Sie den vollqualifizierten URI mit dem Net.msmq-Schema für den Speicherort der Warteschlange für unzustellbare Nachrichten pro Anwendung an, in der Nachrichten platziert werden, die abgelaufen sind oder bei deren Übertragung oder Übermittlung ein Fehler aufgetreten ist. Zum Beispiel: net.msmq://localhost/Warteschlangename für unzustellbare Nachrichten. Die Warteschlange für unzustellbare Nachrichten ist eine Warteschlange für abgelaufene Nachrichten, die nicht zugestellt werden konnten. Diese Warteschlange befindet sich im Warteschlangen-Manager der sendenen Anwendung. Diese Eigenschaft ist erforderlich, wenn die DeadLetterQueue-Eigenschaft auf Custom festgelegt ist.

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: WCF-NetMsmq Sendeadapter

DeadLetterQueue

Gibt die Warteschlange für unzustellbare Nachrichten an, in die Nachrichten übertragen werden, die nicht an die Anwendung gesendet werden konnten. Weitere Informationen zu den Nachrichten, die an die Warteschlange für unzustellbare Nachrichten übermittelt werden, finden Sie im Wcf-NetMsmq-Transporteigenschaften-Dialogfeld, auf der Registerkarte Senden, Bindung in der Referenz zur Benutzeroberflächenanleitung und im Api-Namespace für Entwickler.

Typ: Zeichenfolge Standardwert: System Gilt für: WCF-NetMsmq Sendeadapter

DisableLocationOnFailure

Gibt an, ob der Empfangsspeicherort, an dem bei der Eingangsverarbeitung ein Fehler in der Empfangspipeline oder beim Weiterleiten aufgetreten ist, deaktiviert werden soll. Möglicherweise möchten Sie diese Eigenschaft auf True festlegen, wenn Empfangsstandorte deaktiviert werden können und Denial-of-Service (DoS) kein Problem darstellt.

Beispiel:

  • WCF-Custom Adapter: Wenn die BindingType-Eigenschaft auf netMsmqBinding festgelegt ist.
  • WCF-Custom Adapter: Wenn die BindingType-Eigenschaft auf customBinding festgelegt ist und die BindingConfiguration-Eigenschaft so konfiguriert ist, dass benutzerdefinierte Kanäle verwendet werden, die auf Warteschlangentransporten wie MSMQ basieren.
  • WCF-CustomIsolated-Adapter: Wenn die BindingType-Eigenschaft auf customBinding festgelegt ist und die BindingConfiguration-Eigenschaft für die Verwendung benutzerdefinierter Kanäle konfiguriert ist, die auf Warteschlangentransporten wie MSMQ basieren
  • WCF-NetMsmq Adapter

Typ: Boolescher Standardwert: False Gilt für:

  • WCF-NetMsmq Empfangsadapter
  • WCF-Custom Empfangsadapter
  • WCF-CustomIsolated-Empfangsadapter

EnableTransaction

Die Wirkung dieser Eigenschaft variiert je nach WCF-Adapter. Weitere Informationen zu dieser Eigenschaft finden Sie unter Vorgehensweisen für jeden WCF-Adapter in WCF-Adaptern.

Typ: Boolean Gilt für:

  • WCF-WSHttp-Adapter
  • WCF-NetTcp-Adapter
  • WCF-NetNamedPipe Adapter
  • WCF-NetMsmq Adapter

EndpointBehaviorConfiguration

Geben Sie eine XML-Zeichenfolge mit dem <behavior-Element> des <endpointBehaviors-Elements> an, um die Verhaltenseinstellungen eines WCF-Endpunkts zu konfigurieren. Weitere Informationen zum <endpointBehaviors-Element> finden Sie im entsprechenden Thema unter Siehe auch.

Beispiel:

<behavior name="sampleBehavior"><callbackTimeouts/></behavior>

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: WCF-Custom Sendeadapter

EstablishSecurityContext

Legt fest, ob der Sicherheitskanal eine sichere Sitzung aufbaut. In einer sicheren Sitzung wird vor dem Austausch der Anwendungsnachrichten ein Sicherheitskontexttoken erstellt.

Typ: Boolescher Standardwert: True Angewendet auf: WCF-WSHttp Adapter

FromAddress

Gibt die Adresse des Quellenendpunkts an, über den die eingehenden WCF-Nachrichten gesendet werden. Die Eigenschaft wird automatisch aus eingehenden Nachrichten heraufgestuft.

Typ: Zeichenfolge Gilt für: Alle WCF-Adapter mit Ausnahme des WCF-NetMsmq Sendeadapters

Header

Gibt die Endpunktverweise an, mit denen neben dem URI zusätzliche Adressinformationen bereitgestellt werden. Wenn diese Eigenschaft verwendet wird, muss diese Eigenschaft das <headers-Element> als Stammelement aufweisen. Alle Adressheader müssen im <headers-Element> platziert werden. Diese Eigenschaft wird für eingehende Nachrichten automatisch heraufgestuft.

Beispiel:

<headers>
<Region xmlns="Uri">"String"</Region>
<Member xmlns="Uri">"String"</Member>
</headers>

Typ: Zeichenfolge Gilt für: Alle WCF-Adapter

Identität

Gibt die Identität des Diensts an, der von diesem Empfangsspeicherort bereitgestellt oder von einem Sendeport erwartet wird. Die Werte, die für die Identity-Eigenschaft angegeben werden können, unterscheiden sich je nach Sicherheitskonfiguration. Durch diese Einstellungen werden Clients in die Lage versetzt, Dienste zu authentifizieren. Während des Handshakevorgangs zwischen Clients und Diensten stellt die Windows Communication Foundation-Infrastruktur (WCF) sicher, dass die Identität der Dienste mit den Werten der Clients übereinstimmt.

Beispiel:

<identity>
<userPrincipalName value="username@contoso.com"/>
</identity>

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: Alle WCF-Adapter

InboundBodyLocation

Geben Sie die Datenauswahl für das SOAP-Body-Element eingehender WCF-Nachrichten an. Weitere Informationen zur Verwendung der InboundBodyLocation-Eigenschaft finden Sie unter Angeben des Nachrichtentexts für die WCF-Adapter.

Typ: Zeichenfolgenstandardwert: UseBodyElement

Anwendbare Werte sind:

  • UseBodyElement: Verwenden Sie den Inhalt des SOAP-Body-Elements einer eingehenden Nachricht, um den BizTalk-Nachrichtentextteil zu erstellen. Wenn das Body-Element mehr als ein untergeordnetes Element aufweist, wird nur das erste Element zum BizTalk-Nachrichtentextteil.
  • UseEnvelope: Erstellen Sie den BizTalk-Nachrichtentextteil aus dem gesamten SOAP-Umschlag einer eingehenden Nachricht.
  • UseBodyPath: Verwenden Sie den Textpfadausdruck in der InboundBodyPathExpression-Eigenschaft , um den BizTalk-Nachrichtentextteil zu erstellen. Der Textpfadausdruck wird anhand des unmittelbar untergeordneten Elements des SOAP-Body-Elements einer eingehenden Nachricht ausgewertet. Diese Eigenschaft ist nur für Ports vom Typ Antwort anfragen gültig.

Gilt für: Alle WCF-Adapter außer WCF-NetMsmq senden

InboundBodyPathExpression

Geben Sie den Textpfadausdruck an, um einen bestimmten Teil einer eingehenden Nachricht zu identifizieren, der zur Erstellung des Textteils einer BizTalk-Nachricht verwendet wird. Dieser Textpfadausdruck wird anhand des unmittelbar untergeordneten Elements des SOAP-Textknotens einer eingehenden Nachricht ausgewertet. Wenn dieser Textpfadausdruck mehrere Knoten zurückgibt, wird nur der erste Knoten für den Textteil der BizTalk-Nachricht ausgewählt. Diese Eigenschaft ist erforderlich, wenn die InboundBodyLocation-Eigenschaft auf UseBodyPath festgelegt ist. Weitere Informationen zur Verwendung der InboundBodyPathExpression-Eigenschaft finden Sie unter WCF Adapters Property Schema and Properties.For more information about how to use the InboundBodyPathExpression property, see WCF Adapters Property Schema and Properties.

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: Alle WCF-Adapter mit Ausnahme des WCF-NetMsmq Sendeadapters

InboundHeaders

Verwenden Sie die InboundHeaders-Eigenschaft , um auf die SOAP-Header eingehender WCF-Nachrichten zuzugreifen. Die WCF-Adapter kopieren alle SOAP-Headerwerte in eingehenden Nachrichten in diese Eigenschaft, u. a. benutzerdefinierte SOAP-Header und SOAP-Standardheader, die in der WCF-Infrastruktur z. B. für WS-Addressing, WS-Security und WS-AtomicTransaction verwendet werden. Der in der Kontexteigenschaft enthaltene Wert ist eine Zeichenfolge, die XML-Daten mit dem Stammelement headers>< enthält, und die eingehenden SOAP-Header werden als untergeordnete Elemente des <headers-Elements> kopiert. Weitere Informationen zum Zugreifen auf SOAP-Header mit den WCF-Adaptern finden Sie im SDK-Beispiel Verwenden von benutzerdefinierten SOAP-Headern mit den WCF-Adaptern von https://go.microsoft.com/fwlink/?LinkId=79960.

Typ: Zeichenfolge Gilt für: Alle WCF-Adapter mit Ausnahme des WCF-NetMsmq Sendeadapters

InboundNodeEncoding

Geben Sie den Codierungstyp an, den der WCF-Empfangsadapter zum Decodieren des Knotens verwendet, der durch den in InboundBodyPathExpression angegebenen Textpfadausdruck identifiziert wird. Diese Eigenschaft ist erforderlich, wenn die InboundBodyLocation-Eigenschaft auf UseBodyPath festgelegt ist.

Typ: Zeichenfolge Standardwert: XML

Anwendbare Werte sind:

  • Base64: Base64-Codierung
  • Hexadezimalcodierung
  • String: Textcodierung – UTF-8
  • XML: Die WCF-Adapter erstellen den BizTalk-Nachrichtentext mit der äußeren XML des Knotens, der durch den Textpfadausdruck in InboundBodyPathExpression ausgewählt wird.

Gilt für: Alle WCF-Adapter mit Ausnahme des WCF-NetMsmq-Sendeadapters

IsFault

Gibt an, ob SOAP-Fehlermeldungen empfangen werden. Die Eigenschaft wird automatisch aus eingehenden Nachrichten heraufgestuft.

Hinweis

Die IsFault-Eigenschaft kann nicht verwendet werden, um die empfangenen Nachrichten auf Transportfehler wie den HTTP 404-Fehler (Datei oder Verzeichnis nicht gefunden) zu überprüfen.

Typ: Boolean Gilt für: Alle WCF-Adapter mit Ausnahme des WCF-NetMsmq Sendeadapters

LeaseTimeout

Gibt die maximale Lebensdauer einer aktiven Verbindung in einem Pool an. Nach Ablauf der angegebenen Zeit wird die Verbindung geschlossen, nachdem die aktuelle Anforderung verarbeitet wurde.

Der WCF-NetTcp-Adapter nutzt die NetTcpBinding-Klasse , um mit einem Endpunkt zu kommunizieren. Wenn Sie NetTcpBinding in Szenarien mit Lastenausgleich verwenden, sollten Sie das Standardmäßige Leasetimeout verringern. Weitere Informationen zum Lastenausgleich bei Verwendung von NetTcpBinding finden Sie im entsprechenden Thema unter Siehe auch.

Typ: Zeichenfolge Standardwert: 00:05:00 Gilt für: WCF-NetTcp Empfangsadapter

MaxConcurrentCalls

Gibt die Anzahl gleichzeitiger Aufrufe für eine einzelne Dienstinstanz an. Aufrufe, die diese Grenze überschreiten, werden in die Warteschlange eingereiht. Das Festlegen dieses Werts auf 0 entspricht dem Festlegen auf Int32.MaxValue.

Hinweis

Diese Eigenschaft kann nicht mit Überwachungsprofilen in der primären BAM-Importdatenbank überwacht werden.

Typ: Ganzzahl Standardwert: 200 Gilt für: Alle WCF-Empfangsadapter außer den WCF-Custom- und WCF-CustomIsolated adaptern

MaxConnections

Gibt die maximale Anzahl der Verbindungen an, die vom Listener zur Annahme durch die Anwendung bereitgehalten werden können. Wenn dieser Kontingentwert überstiegen wird, werden neue eingehende Verbindungen gelöscht, statt weiter auf die Annahme zu warten.

Hinweis

Da es sich hier um eine Eigenschaft für Adapterhandler handelt, kann diese Eigenschaft in Pipelinekomponenten und Orchestrierungen nicht konfiguriert werden.

Hinweis

Diese Eigenschaft kann nicht mit Überwachungsprofilen in der primären BAM-Importdatenbank überwacht werden.

Typ: Integer Standardwert: 10 Gilt für: WCF-NetNamedPipe Adapter, WCF-NetTcp Adapter

MaxReceivedMessageSize

Gibt die Maximalgröße in Bytes für Nachrichten einschließlich der Header an, die über das Netzwerk empfangen werden können. Die Nachrichtengröße wird durch den für jede Nachricht reservierten Arbeitsspeicher begrenzt. Sie können diese Eigenschaft verwenden, um das Risiko für Denial-of-Service-Angriffe (DoS-Angriffe) einzuschränken.

Typ: Integer Standardwert: 65536 Gilt für:

  • WCF-BasicHttp-Adapter
  • WCF-WSHttp-Adapter
  • WCF-NetTcp-Adapter
  • WCF-NetNamedPipe-Adapter
  • WCF-NetMsmq Empfangsadapter

MessageClientCredentialType

Gibt den Typ der Anmeldeinformationen an, der für die Clientauthentifizierung mit nachrichtenbasierter Sicherheit verwendet werden soll.

Die gültigen Werte variieren je nach WCF-Adapter. Weitere Informationen zur MessageClientCredentialType-Eigenschaft finden Sie unter Vorgehensweisen für jeden WCF-Adapter in WCF-Adaptern.

Typ: String Gilt für:

  • WCF-BasicHttp-Adapter
  • WCF-WSHttp-Adapter
  • WCF-NetTcp-Adapter
  • WCF-NetNamedPipe-Adapter

MessageEncoding

Hier geben Sie den Encoder an, der zum Codieren der SOAP-Nachricht verwendet werden soll.

Typ: Zeichenfolge Standardwert: Text

Anwendbare Werte:

  • Text: Verwenden eines Textnachrichtenencoders
  • Mtom: Verwenden eines MTOM-Encoders (Message Transmission Organization Mechanism 1.0)

Gilt für: WCF-BasicHttp Adapter, WCF-WSHttp Adapter

MsmqAuthenticationMode

Geben Sie an, wie die Nachricht durch den MSMQ-Transport authentifiziert werden muss.

Typ: Zeichenfolge Standardwert: WindowsDomain Weitere Informationen zu den anwendbaren Werten für die MsmqAuthenticationMode-Eigenschaft finden Sie in der MSMQ-Authentifizierungsmoduseigenschaft im Dialogfeld WCF-NetMsmq-Transporteigenschaften, auf der Registerkarte Senden, auf der Registerkarte Sicherheit in der Referenz zu UI-Anleitung und ENTWICKLER-API-Namespace. Gilt für: WCF-NetMsmq Adapter

MsmqEncryptionAlgorithm

Legen Sie den Algorithmus fest, der beim Übertragen von Nachrichten zwischen Nachrichtenwarteschlangen-Managern für die Nachrichtenverschlüsselung im Netzwerk verwendet wird. Diese Eigenschaft ist nur verfügbar, wenn die MsmqProtectionLevel-Eigenschaft auf EncryptAndSign festgelegt ist.

Typ: Zeichenfolge Standardwert: RC4Stream

Anwendbare Werte sind: RC4Stream, AES

Gilt für: WCF-NetMsmq Adapter

MsmqProtectionLevel

Legen Sie den Typ der Nachrichtensicherheit auf Ebene des MSMQ-Transports fest.

Typ: Zeichenfolge Standardwert: Sign

Anwendbare Werte sind:

  • Keine: Kein Schutz
  • Zeichen: Nachrichten sind signiert
  • EncryptAndSign: Nachrichten werden verschlüsselt und signiert. Um diese Schutzstufe verwenden zu können, müssen Sie die Active Directory-Integration für MSMQ aktivieren.

Gilt für: WCF-NetMsmq Adapter

MsmqSecureHashAlgorithm

Legen Sie den Hashalgorithmus fest, der zum Berechnen der Nachrichtenübersicht verwendet wird. Diese Eigenschaft ist nicht verfügbar, wenn die MsmqProtectionLevel-Eigenschaft auf None festgelegt ist.

Typ: Zeichenfolge Standardwert: SHA1

Anwendbare Werte sind: MD5, SHA1, SHA25, SHA512

Gilt für: WCF-NetMsmq Adapter

NegotiateServiceCredential

Geben Sie an, ob die Dienstanmeldeinformationen auf diesem Client außer der Reihe bereitgestellt oder vom Dienst bei einem Aushandlungsvorgang an diesen Client übermittelt werden. Eine solche Verhandlung ist Vorläufer zum üblichen Nachrichtenaustausch.

Wenn die MessageClientCredentialType-Eigenschaftkeine, Benutzername oder Zertifikat ist, bedeutet das Festlegen dieser Eigenschaft auf False , dass das Dienstzertifikat out-of-band auf dem Client verfügbar ist und dass der Client das Dienstzertifikat angeben muss. Dieser Modus ist mit SOAP-Stapeln interoperabel, die WS-Trust und WS-SecureConversation implementieren.

Wenn die MessageClientCredentialType-Eigenschaft auf Windows festgelegt ist, gibt das Festlegen dieser Eigenschaft auf False die Kerberos-basierte Authentifizierung an. Dies bedeutet, dass Client und Dienst Teil der gleichen Kerberos-Domäne sein müssen. Dieser Modus ist mit SOAP-Stapeln interoperabel, die das Kerberos-Tokenprofil (gemäß der Definition in OASIS WSS TC) sowie WS-Trust und WS-SecureConversation implementieren.

Wenn diese Eigenschaft True ist, verursacht sie eine .NET SOAP-Aushandlung, die SPNego-Austausch über SOAP-Nachrichten tunnelt.

Typ: Boolescher Standardwert: True Gilt für: WCF-WSHttp Adapter

OpenTimeout

Legt einen Wert für den Zeitraum fest, der bis zum vollständigen Öffnen eines Kanals zur Verfügung steht.

Hinweis

Diese Eigenschaft kann nicht mit Überwachungsprofilen in der primären BAM-Importdatenbank überwacht werden.

Typ: Zeichenfolge Standardwert: 00:01:00 Gilt für: Alle WCF-Adapter mit Ausnahme der WCF-Custom- und WCF-CustomIsolated-Adapter

OrderedProcessing

Geben Sie an, ob Nachrichten seriell verarbeitet werden sollen. Wenn diese Eigenschaft ausgewählt ist, kann dieser Empfangsspeicherort die geordnete Nachrichtenübermittlung aufnehmen, wenn er in Verbindung mit einem BizTalk-Messaging- oder Orchestrierungs-Sendeport verwendet wird, für den die Option Bestellte Übermittlung auf Truefestgelegt ist. Weitere Informationen zur Option "Bestellte Lieferung " finden Sie in den entsprechenden Themen unter Siehe auch.

Diese Eigenschaft kommt in den folgenden Fällen zum Tragen:

  • WCF-Custom Adapter: Wenn die BindingType-Eigenschaft auf netMsmqBinding festgelegt ist
  • WCF-Custom Adapter: Wenn die BindingType-Eigenschaft auf customBinding festgelegt ist und die BindingConfiguration-Eigenschaft für die Verwendung benutzerdefinierter Kanäle konfiguriert ist, die von Transporten abhängig sind, die die geordnete Übermittlung wie MSMQ unterstützen.
  • WCF-CustomIsolated Adapter: Wenn die BindingType-Eigenschaft auf customBinding festgelegt ist und die BindingConfiguration-Eigenschaft für die Verwendung benutzerdefinierter Kanäle konfiguriert ist, die von Transporten abhängig sind, die die geordnete Übermittlung unterstützen.
  • WCF-NetMsmq Adapter

Typ: String Standardwert: False Gilt für:

  • WCF-NetMsmq Empfangsadapter
  • WCF-Custom Empfangsadapter
  • WCF-CustomIsolated-Empfangsadapter

OutboundBodyLocation

Geben Sie die Datenauswahl für das SOAP-Body-Element ausgehender WCF-Nachrichten an. Weitere Informationen zur Verwendung der OutboundBodyLocation-Eigenschaft finden Sie unter Angeben des Nachrichtentexts für die WCF-Adapter.

Typ: String Default value: UseBodyElement

Anwendbare Werte sind:

  • UseBodyElement: Verwenden Sie den BizTalk-Nachrichtentextteil, um den Inhalt des SOAP-Body-Elements für eine ausgehende Nachricht zu erstellen.
  • UseTem****plate: Verwenden Sie die in der OutboundXMLTemplate-Eigenschaft angegebene Vorlage, um den Inhalt des SOAP-Body-Elements für eine ausgehende Nachricht zu erstellen.

Gilt für: Alle WCF-Adapter mit Ausnahme des WCF-NetMsmq Empfangsadapters

OutboundCustomHeaders

Geben Sie die benutzerdefinierten SOAP-Header für ausgehende Nachrichten an. Wenn diese Eigenschaft verwendet wird, muss die -Eigenschaft das <headers-Element> als Stammelement aufweisen. Alle benutzerdefinierten SOAP-Header müssen im <headers-Element> platziert werden. Wenn der benutzerdefinierte SOAP-Headerwert eine leere Zeichenfolge ist, müssen Sie dieser Eigenschaft Header></Header> oder <Header> zuweisen<. Weitere Informationen zur Verwendung von SOAP-Headern mit den WCF-Adaptern finden Sie im SDK-Beispiel unter Verwenden benutzerdefinierter SOAP-Header mit den WCF-Adaptern von https://go.microsoft.com/fwlink/?LinkId=79960.

Typ: Zeichenfolge Gilt für: Alle WCF-Adapter mit Ausnahme des WCF-NetMsmq Empfangsadapters

OutboundXmlTemplate

Geben Sie die XML-formatierte Vorlage für den Inhalt des SOAP-Body-Elements einer ausgehenden Nachricht an. Diese Eigenschaft ist erforderlich, wenn die OutboundBodyLocation-Eigenschaft auf UseTemplate festgelegt ist. Weitere Informationen zur Verwendung der OutboundXMLTemplate-Eigenschaft finden Sie unter Angeben des Nachrichtentexts für die WCF-Adapter.

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: Alle WCF-Adapter mit Ausnahme des WCF-NetMsmq Empfangsadapters

Kennwort

Geben Sie das Kennwort an, das für die Authentifizierung mit dem Zielserver verwendet werden soll, wenn die UseSSO-Eigenschaft auf False festgelegt ist.

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: Alle WCF-Sendeadapter mit Ausnahme des WCF-NetNamedPipe-Adapters

PropagateFaultMessage

Geben Sie an, ob Nachrichten, die bei der Ausgangsverarbeitung nicht verarbeitet werden, weitergeleitet oder angehalten werden sollen. Diese Eigenschaft ist nur für Ports vom Typ Antwort anfragen gültig.

Hinweis

Diese Eigenschaft kann nicht mit Überwachungsprofilen in der primären BAM-Importdatenbank überwacht werden.

Typ: Boolescher Standardwert: True

Anwendbare Werte sind:

  • True: Weiterleiten der Nachricht, bei der die ausgehende Verarbeitung fehlschlägt, an eine abonnierende Anwendung (z. B. einen anderen Empfangsport oder Orchestrierungszeitplan)
  • False: Anhalten fehlerhafter Nachrichten und Generieren einer negativen Bestätigung (NACK)

Gilt für: Alle WCF-Sendeadapter mit Ausnahme des WCF-NetMsmq-Adapters

ProxyAddress

Geben Sie die Adresse des Proxyservers an. Verwenden Sie je nach Sicherheitskonfiguration das https- oder das HTTP-Schema. Nach dieser Adresse kann ein Doppelpunkt und eine Portnummer stehen. Die -Eigenschaft ist erforderlich, http://127.0.0.1:8080wenn die ProxyToUse-Eigenschaft auf UserSpecified (z. B. ) festgelegt ist.

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: WCF-BasicHttp Sendeadapter, WCF-WSHttp Sendeadapter

ProxyPassword

Geben Sie das Kennwort an, das für den Proxyserver verwendet werden soll, der in der ProxyAddress-Eigenschaft angegeben ist.

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: WCF-BasicHttp Sendeadapter, WCF-WSHttp Sendeadapter

ProxyToUse

Geben Sie an, welcher Proxyserver für ausgehenden HTTP-Datenverkehr verwendet werden soll.

Typ: Zeichenfolge Standardwert: None

Anwendbare Werte sind:

  • Keine: Verwenden Sie keinen Proxyserver für diesen Sendeport.
  • Standard: Verwenden Sie die Proxyeinstellungen im Sendehandler, der diesen Sendeport hostt.
  • UserSpecified: Verwenden Sie den Proxyserver, der in der ProxyAddress-Eigenschaft angegeben ist.

Gilt für: WCF-BasicHttp Adapter senden, WCF-WSHttp Adapter senden

ProxyUserName

Geben Sie den Benutzernamen an, der für den Proxyserver verwendet werden soll, der in der ProxyAddress-Eigenschaft angegeben ist. Die -Eigenschaft ist erforderlich, wenn die ProxyToUse-Eigenschaft auf UserSpecified festgelegt ist.

Weitere Informationen zu dieser Eigenschaft finden Sie unter Konfigurieren eines WCF-WSHttp Sendeports und Konfigurieren eines WCF-BasicHttp Sendeports.

Typ: String Gilt für: WCF-BasicHttp Sendeadapter, WCF-WSHttp Sendeadapter

ReplyToAddress

Geben Sie die Adresse des Antwortendpunkts für die ausgehenden WCF-Nachrichten an, die über die Empfangsspeicherorte vom Typ „Anforderungsantwort“ eingehenden Nachrichten entsprechen. Die Eigenschaft wird automatisch aus eingehenden Nachrichten heraufgestuft.

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: Alle WCF-Adapter mit Ausnahme des WCF-NetMsmq-Adapters

SecurityMode

Gibt den verwendeten Sicherheitstyp an. Die gültigen Werte variieren je nach WCF-Adapter. Weitere Informationen zur SecurityMode-Eigenschaft finden Sie unter Vorgehensweisen für jeden WCF-Adapter in WCF-Adaptern.

Hinweis

Diese Eigenschaft kann nicht mit Überwachungsprofilen in der primären BAM-Importdatenbank überwacht werden.

Typ: Zeichenfolge Gilt für: Alle WCF-Adapter mit Ausnahme der WCF-Custom- und WCF-CustomIsolated-Adapter

SendTimeout

Legt einen Wert für den Zeitraum fest, der bis zum Abschluss eines Sendevorgangs zur Verfügung steht. Mit diesem Wert wird der Zeitraum angegeben, in dem die gesamte Interaktion abgeschlossen sein muss, selbst wenn der Korrespondent eine große Nachricht sendet.

Typ: Zeichenfolge Standardwert: 00:01:00 Gilt für: Alle WCF-Adapter mit Ausnahme der WCF-Custom- und WCF-CustomIsolated-Adapter

ServiceBehaviorConfiguration

Geben Sie eine XML-Zeichenfolge mit dem <behavior-Element> des <serviceBehaviors-Elements> an, um die Verhaltenseinstellungen eines WCF-Diensts zu konfigurieren. Weitere Informationen zum <serviceBehaviors-Element> finden Sie im entsprechenden Thema unter Siehe auch.

Beispiel:

<behavior name="SampleServiceBehavior">
<serviceAuthorization principalPermissionMode="UseAspNetRoles"/>
<serviceCredentials>
<serviceCertificate findValue="539d9ab3089bb6dc187fa7dbb382cf01f8d78f5f" storeLocation="CurrentUser" x509FindType="FindByThumbprint"/>
</serviceCredentials>
<serviceMetadata httpGetEnabled="true"/>
</behavior>

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: WCF-Custom Empfangsadapter, WCF-CustomIsolated Adapter

ServiceCertificate

Wenn diese Eigenschaft für Empfangsspeicherorte verwendet wird, wird hiermit der Fingerabdruck des X.509-Zertifikats für die Empfangsspeicherorte angegeben, mit dem die Clients den Dienst authentifizieren. Das Zertifikat, das für diese Eigenschaft verwendet werden soll, muss im Speicher "Mein " am Speicherort "Aktueller Benutzer" installiert werden.

Wenn diese Eigenschaft für Sendeports verwendet wird, wird hiermit der Fingerabdruck des X.509-Zertifikats für die Authentifizierung des Diensts festgelegt, an den dieser Sendeport Nachrichten sendet. Das Zertifikat, das für diese Eigenschaft verwendet werden soll, muss im Speicher "Andere Personen" am Speicherort "Lokaler Computer" installiert werden.

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge gilt für:

  • WCF-BasicHttp-Adapter
  • WCF-NetMsmq Adapter
  • WCF-WSHttp-Adapter
  • WCF-NetTcp-Empfangsadapter

SuspendMessageOnFailure

Gibt an, ob Anforderungsnachrichten angehalten werden sollen, bei denen bei der Eingangsverarbeitung ein Fehler in der Empfangspipeline oder beim Weiterleiten aufgetreten ist.

Typ: Boolescher Standardwert: True Gilt für: Alle WCF-Empfangsadapter

TextEncoding

Geben Sie die Zeichensatzcodierung an, die zum Senden von Nachrichten in der Bindung verwendet werden soll, wenn die MessageEncoding-Eigenschaft auf Text festgelegt ist.

Hinweis

Diese Eigenschaft kann nicht mit Überwachungsprofilen in der primären BAM-Importdatenbank überwacht werden.

Typ: Zeichenfolge Standardwert: utf-8

Anwendbare Werte sind:

  • unicodeFFF: Unicode BigEndian-Codierung
  • utf-16: 16-Bit-Codierung
  • utf-8: 8-Bit-Codierung

Gilt für: WCF-BasicHttp Adapter, WCF-WSHttp Adapter

timeToLive

Gibt die Dauer der Gültigkeit von Nachrichten an, nach der diese ablaufen und in die Warteschlange für unzustellbare Nachrichten verschoben werden. Diese Eigenschaft wird festgelegt, um damit zu verhindern, dass zeitkritische Nachrichten veralten, bevor sie von einem Sendeport verarbeitet werden. Eine Nachricht in einer Warteschlange, die nicht im angegebenen Zeitintervall von diesem Sendeport verarbeitet wird, gilt als abgelaufen. Abgelaufene Nachrichten werden an eine spezielle Warteschlange gesendet, die als Warteschlange für unzustellbare Nachrichten bezeichnet wird. Der Speicherort der Warteschlange für unzustellbare Nachrichten wird mit der DeadLetterQueue-Eigenschaft festgelegt.

Typ: String Standardwert: 1.00:00:00 Gilt für: WCF-NetMsmq Sendeadapter

Beschreibung

Gibt die Adresse des Zielendpunkts für ausgehende WCF-Nachrichten an, die von WCF-Sendeports gesendet werden.

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: Alle WCF-Sendeadapter

TransactionProtocol

Gibt das mit dieser Bindung zu verwendende Transaktionsprotokoll an. Diese Eigenschaft ist erforderlich, wenn die EnableTransaction-Eigenschaft auf True festgelegt ist.

Typ: Zeichenfolge Standardwert: OleTransaction

Anwendbare Werte sind: OleTransaction, WS-AtomicTransaction

Gilt für: WCF-NetNamedPipe Adapter, WCF-NetTcp Adapter

TransportClientCredentialType

Legt den Typ der Anmeldeinformationen für die Sendeportauthentifizierung fest. Die gültigen Werte variieren je nach WCF-Adapter. Weitere Informationen zur TransportClientCredentialType-Eigenschaft finden Sie unter Vorgehensweisen für jeden WCF-Adapter in WCF-Adaptern.

Typ: Zeichenfolge Gilt für: WCF-Basic Adapter, WCF-NetTcp Adapter, WCF-WSHttp Adapter

TransportProtectionLevel

Gibt die Sicherheit auf TCP-Transportebene an. Das Signieren von Nachrichten verringert das Risiko, dass Nachrichten während der Übertragung durch Dritte manipuliert werden. Mit der Verschlüsselung können Daten während des Transports geschützt werden.

Typ: String Standardwert: EncryptAndSign

Anwendbare Werte sind:

  • Keine: Kein Schutz
  • Zeichen: Nachrichten sind signiert
  • EncryptAndSign: Nachrichten werden verschlüsselt und signiert

Gilt für: WCF-NetTcp Adapter, WCF-NetNamedPipe Adapter

UserName

Geben Sie den Benutzernamen an, der für die Authentifizierung mit dem Zielserver verwendet werden soll, wenn die UseSSO-Eigenschaft auf False festgelegt ist. Für diese Eigenschaft muss nicht das Format Domäne\Benutzer verwendet werden.

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: Alle WCF-Sendeadapter mit Ausnahme des WCF-NetNamedPipe-Adapters

UseSourceJournal

Geben Sie an, ob Kopien von Nachrichten, die von diesem Sendeport verarbeitet werden, in der Quelljournalwarteschlange gespeichert werden sollen.

Typ: Boolescher Standardwert: False Gilt für: WCF-NetMsmq Sendeadapter

UseSSO

Geben Sie an, ob Clientanmeldeinformationen für die Authentifizierung am Zielserver mittels Einmaligem Anmelden abgerufen werden sollen.

Hinweis Diese Eigenschaft kann in der PRIMÄREN BAM-Importdatenbank nicht mit Nachverfolgungsprofilen nachverfolgt werden.

Typ: Boolescher Standardwert: False Gilt für: Alle WCF-Sendeadapter mit Ausnahme des WCF-NetNamedPipe-Adapters

ReferencedBindings

Geben Sie die Bindungskonfigurationen an, auf die das attribut bindingConfiguration des <issuer-Elements> für wsFederationHttpBinding und customBinding verweist, was den Security Token Service (STS) angibt, der Sicherheitstoken ausgibt. Weitere Informationen zum <issuer-Element> finden Sie im Thema "<issuer>" unter https://go.microsoft.com/fwlink/?LinkId=83476.

Die Bindungsinformationen, einschließlich des <Ausstellerelements> für wsFederationHttpBinding und customBinding , können über die BindingConfiguration-Eigenschaft des WCF-Custom- und WCF-CustomIsolated-Adapters konfiguriert werden. Alle Bindungskonfigurationen, auf die für diese Eigenschaft verwiesen wird, müssen in Form des <bindings-Elements> platziert werden.

Hinweis

Das bindingConfiguration-Attribut des <issuer-Elements> muss auf einen gültigen Bindungsnamen in dieser Eigenschaft verweisen.

Hinweis

Das <issuer-Element> in den Bindungskonfigurationen, auf die verwiesen wird, kann auch auf eine andere Bindungskonfiguration in dieser Eigenschaft verweisen, wenn diese Verweiskette keine zirkuläre Abhängigkeit darstellt.

Beispiel:

WCF.BindingConfiguration = @"<wsFederationHttpBinding>
<binding name=""sampleBinding"">
<security mode=""Message"">
<message issuedKeyType=""AsymmetricKey"">
<issuer address=""http://www.contoso.com/samplests"" binding=""wsFederationHttpBinding"" bindingConfiguration=""**contosoSTSBinding**""/>
</message>
</security>
</binding>
</wsFederationHttpBinding>";
WCF.ReferencedBinding =@"<bindings>
<wsFederationHttpBinding>
<binding name=""**contosoSTSBinding**"">
<security mode=""Message"">
<message negotiateServiceCredential=""false"">
<issuer address=""https://northwind.com/samplests"" bindingConfiguration=""**northwindBinding**"" binding=""wsHttpBinding"">
</issuer>
</message>
</security>
</binding>
</wsFederationHttpBinding>
<wsHttpBinding>
<binding name=""**northwindBinding**"">
<security mode=""Message"">
<message clientCredentialType=""Certificate""/>
</security>
</binding>
</wsHttpBinding>
</bindings>"

Hinweis

Die ReferencedBinding-Eigenschaft darf nicht die Bindungskonfiguration enthalten, die in der BindingConfiguration-Eigenschaft verwendet wird.

Typ: Zeichenfolge Standardwert: Eine leere Zeichenfolge Gilt für: WCF-Custom Adapter, WCF-CustomIsolated Adapter

Weitere Informationen

WCF-Adapterverhalten<> von <endpointBehaviors><bindungsverhalten><> von <serviceBehaviors>Ordered Delivery of MessagesLoad Balancing