<netTcpContextBinding>
Gibt einen Kontext für NetTcpBinding an, der voraussetzt, dass die Sicherheitsebene signiert wird. Der contextExchangeMechanism für NetTcpContextBinding lautet SOAPHeader.
<<system.serviceModel>>
<bindings>
<netTcpContextBinding>
<netTcpContextBinding>
<binding
closeTimeout="TimeSpan"
contextProtectionLevel="EncryptAndSign/None/Sign"
hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
listenBacklog="Integer"
maxBufferPoolSize="integer"
maxBufferSize="Integer"
maxConnections="Integer"
maxReceivedMessageSize="Integer"
name="string"
openTimeout="TimeSpan"
portSharingEnabled="Boolean"
receiveTimeout="TimeSpan"
sendTimeout="TimeSpan"
transactionFlow="Boolean"
transactionProtocol="OleTransactions/WSAtomicTransactionOctober2004"
transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
<reliableSession ordered="Boolean"
inactivityTimeout="TimeSpan"
enabled="Boolean" />
<security mode="Message/None/Transport/TransportWithCredential">
<transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
proxyCredentialType="Basic/Digest/None/Ntlm/Windows"
realm="string"
defaultClientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
defaultProxyCredentialType="Basic/Digest/None/Ntlm/Windows"
defaultRealm="string" />
<message clientCredentialType="Certificate/IssuedToken/None/UserName/Windows"
algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"
establishSecurityContext="Boolean"
negotiateServiceCredential="Boolean"/>
</security>
<readerQuotas maxDepth="integer"
maxStringContentLength="integer"
maxByteArrayContentLength="integer"
maxBytesPerRead="integer"
maxNameTableCharCount="integer" />
</binding>
</netTcpContextBinding>
Attribute und Elemente
Attribute
Attribut | Beschreibung |
---|---|
closeTimeout |
Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Schließvorgangs angibt. Dieser Wert muss größer oder gleich Zero sein. Die Standardeinstellung lautet 00:01:00. |
contextProtectionLevel |
Ein gültiger ProtectionLevel-Wert, der die gewünschte Sicherheitsebene des SOAP-Headers angibt, der zum Propagieren der Kontextinformationen verwendet wird. Der Standardwert ist Sign. |
hostnameComparisonMode |
Gibt den zum Analysieren von URIs verwendeten HTTP-Hostnamen-Vergleichsmodus an. Dieses Attribut ist vom Typ HostnameComparisonMode und gibt an, ob beim Abgleich des URI der Hostname zum Erreichen des Diensts verwendet wird. Der Standardwert ist StrongWildcard, wodurch der Hostname beim Abgleich ignoriert wird. |
listenBacklog |
Eine positive ganze Zahl, die die maximale Anzahl an Kanälen angibt, die im Listener darauf warten, akzeptiert zu werden. Verbindungen, die diesen Wert überschreiten, verbleiben so lange in der Warteschlange, bis ein Bereich unter diesem Grenzwert verfügbar wird. Mit dem connectionTimeout-Attribut wird die Zeit beschränkt, die ein Client auf eine Verbindung wartet, bevor eine Verbindungsausnahme ausgelöst wird. Der Standardwert ist 10. |
maxBufferPoolSize |
Eine ganze Zahl, die die maximale Pufferpoolgröße für diese Bindung angibt. Der Standardwert ist 512 * 1.024 Byte. In Windows Communication Foundation (WCF) werden Puffer häufig verwendet. Es ist aufwändig, Puffer bei jeder Verwendung zu erstellen und zu löschen, und die Garbage Collection für Puffer ist ebenfalls aufwändig. Bei Pufferpools können Sie einen zu verwendenden Puffer aus dem Pool nehmen und ihn nach der Verwendung wieder dem Pool zuführen. So wird der mit dem Erstellen und Zerstören von Puffern verbundene Aufwand vermieden. |
maxBufferSize |
Eine positive ganze Zahl, die die maximale Größe des Puffers in Bytes angibt, der zum Speichern von Nachrichten verwendet wird. Falls der Puffer voll ist, verbleiben die überzähligen Daten so lange im zugrunde liegenden Socket, bis der Puffer wieder Platz bietet. Dieser Wert darf nicht kleiner sein als das maxReceivedMessageSize-Attribut. Der Standardwert beträgt 65.536. Weitere Informationen finden Sie unter MaxBufferSize. |
maxConnections |
Eine ganze Zahl, die die maximale Anzahl ausgehender und eingehender Verbindungen angibt, die der Dienst erstellt bzw. akzeptiert. Eingehende und ausgehende Verbindungen werden jeweils bis zur Erreichung eines Grenzwerts gezählt, der durch dieses Attribut angegeben wird. Eingehende Verbindungen, die diesen Grenzwert überschreiten, werden in die Warteschlange gestellt, bis wieder Speicherplatz verfügbar wird. Ausgehende Verbindungen, die diesen Grenzwert überschreiten, werden in die Warteschlange gestellt, bis wieder Speicherplatz verfügbar wird. Der Standardwert ist 10. |
maxReceivedMessageSize |
Eine positive ganze Zahl, die die maximale Nachrichtengröße in Bytes einschließlich Header angibt, die in einem für diese Bindung konfigurierten Kanal beim Nachrichtenempfang zulässig ist. Der Absender einer Nachricht, die diesen Grenzwert überschreitet, erhält einen SOAP-Fehler. Der Empfänger legt die Nachricht ab und erstellt im Ablaufverfolgungsprotokoll einen Eintrag zu diesem Ereignis. Der Standardwert ist 65536. |
name |
Eine Zeichenfolge, die den Konfigurationsnamen der Bindung enthält. Dieser Wert sollte eindeutig sein, da er von der Bindung zur Identifizierung verwendet wird. |
openTimeout |
Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Öffnungsvorgangs angibt. Dieser Wert muss größer oder gleich Zero sein. Der Standardwert ist 00:01:00. |
portSharingEnabled |
Ein boolescher Wert, der angibt, ob die TCP-Anschlussfreigabe für diese Verbindung aktiviert ist. Falls dieser Wert false ist, verwendet jede Bindung ihren eigenen exklusiven Anschluss. Diese Einstellung ist lediglich für Dienste relevant, da keine Clients betroffen sind. |
receiveTimeout |
Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Empfangsvorgangs angibt. Dieser Wert muss größer oder gleich Zero sein. Der Standardwert ist 00:10:00. |
sendTimeout |
Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Sendevorgangs angibt. Dieser Wert muss größer oder gleich Zero sein. Der Standardwert ist 00:01:00. |
transactionFlow |
Ein boolescher Wert, der angibt, ob die Bindung geleitete WS-Transaktionen unterstützt. Die Standardeinstellung ist false. |
transactionProtocol |
Gibt das Transaktionsprotokoll an, das mit dieser Bindung verwendet werden soll. Gültige Werte sind
Der Standardwert ist OleTransactions. Dieses Attribut ist vom Typ TransactionProtocol. |
transferMode |
Ein TransferMode-Wert, der angibt, ob Nachrichten bei einer Anforderung oder Antwort gepuffert oder per Stream übertragen werden. |
Untergeordnete Elemente
Element | Beschreibung |
---|---|
Definiert die Sicherheitseinstellungen für die Bindung. Dieses Element ist vom Typ NetTcpSecurityElement. |
|
Definiert die Beschränkungen der Komplexität von SOAP-Nachrichten, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert wurden. Dieses Element ist vom Typ XmlDictionaryReaderQuotasElement. |
|
Gibt an, ob zuverlässige Sitzungen zwischen Kanalendpunkten aufgebaut werden. |
Übergeordnete Elemente
Element | Beschreibung |
---|---|
Dieses Element enthält eine Auflistung von standardmäßigen und benutzerdefinierten Bindungen. Jeder Eintrag ist durch seinen name gekennzeichnet. Dienste verwenden Bindungen, indem sie sie mithilfe des name verknüpfen. |
Siehe auch
Referenz
<<netTcpBinding>>
NetTcpBinding
netTcpContextBinding
netTcpContextBindingElement
ContextBindingElement
Konzepte
Weitere Ressourcen
Windows Communication Foundation Bindings
Configuring System-Provided Bindings
Using Bindings to Configure Services and Clients