<basicHttpContextBinding>

Artikel
09/12/2008

Angeben einer Bindung, die Kontext für den Austausch von BasicHttpBinding bietet, indem HTTP-Cookies als Austauschmechanismus aktiviert werden.

<<system.serviceModel>>
<bindings>
<basicHttpContextBinding>

<basicHttpContextBinding>
   <binding 
       allowCookies="Boolean"
       bypassProxyOnLocal="Boolean"
       closeTimeout="TimeSpan" 
       envelopeVersion="None/Soap11/Soap12"
       hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
       maxBufferPoolSize="Integer"
       maxBufferSize="Integer"
       maxReceivedMessageSize="Integer"
       messageEncoding="Text/Mtom"
       name="string" 
       openTimeout="TimeSpan" 
       proxyAddress="URI"
       receiveTimeout="TimeSpan"
       sendTimeout="TimeSpan"
       textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"
       transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
       useDefaultWebProxy="Boolean"
       <security mode="None/Transport/Message/TransportWithMessageCredential/TransportCredentialOnly">
           <transport clientCredentialType="None/Basic/Digest/Ntlm/Windows/Certificate"
                  proxyCredentialType="None/Basic/Digest/Ntlm/Windows"
                                    realm="string" />
           <message  algorithmSuite="Aes128/Aes192/Aes256/Rsa15Aes128/ Rsa15Aes256/TripleDes"
                                    clientCredentialType="UserName/Certificate"/>
       </security>
       <readerQuotas maxDepth="Integer" 
            maxStringContentLength="Integer"
            maxByteArrayContentLength="Integer"
            maxBytesPerRead="Integer"
            maxNameTableCharCount="Integer" />
   </binding>
</basicHttpContextBinding>

Attribute und Elemente

Attribute

Attribut	Beschreibung
allowCookies	Ein boolescher Wert, der angibt, ob der Client Cookies akzeptiert und für zukünftige Anfragen propagiert. Die Standardeinstellung ist false. Sie können diese Eigenschaft verwenden, wenn Sie mit ASMX-Webdiensten interagieren, die Cookies verwenden. Auf diese Weise können Sie sicherstellen, dass die vom Server zurückgegebenen Cookies automatisch bei allen zukünftigen Clientanfragen für diesen Dienst kopiert werden.
bypassProxyOnLocal	Ein boolescher Wert, der angibt, ob der Proxyserver bei lokalen Adressen umgangen werden soll. Die Standardeinstellung ist false. Eine Internetressource gilt als lokal, wenn sie über eine lokale Adresse verfügt. Eine lokale Adresse befindet sich auf dem gleichen Computer, im LAN oder Intranet und kann anhand des fehlenden Punkts (.) erkannt werden, wie bei den URIs "http://webserver/" und "https://localhost/". Durch dieses Attribut wird festgelegt, ob mit BasicHttpBinding konfigurierte Endpunkte den Proxyserver zum Zugreifen auf lokale Ressourcen verwenden. Wenn dieses Attribut true ist, wird bei Anforderungen lokaler Internetressourcen der Proxyserver nicht verwendet. Ist dieses Attribut auf true festgelegt, sollten Sie den Hostnamen anstatt localhost verwenden, wenn die Clients bei der Kommunikation mit Diensten auf demselben Computer einen Proxy nutzen sollen. Wenn dieses Attribut false ist, werden alle Internetanforderungen über den Proxyserver ausgeführt.
closeTimeout	Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Schließvorgangs angibt. Dieser Wert muss größer oder gleich Zero sein. Der Standardwert ist 00:01:00.
envelopeVersion	Gibt die SOAP-Version an, die für Nachrichten verwendet wird, die von dieser Bindung verarbeitet werden. Der einzige gültige Wert ist Soap11.
hostnameComparisonMode	Gibt den HTTP-Hostnamen-Vergleichsmodus an, der verwendet wird, um URIs zu analysieren. 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, wobei der Hostname beim Abgleich ignoriert wird.
maxBufferPoolSize	Eine ganze Zahl, welche die maximale Speicherkapazität der Nachrichtenpuffer angibt, die Nachrichten aus dem Kanal empfangen. Der Standardwert ist 524.288 (0x80000) Byte. Der Puffer-Manager reduziert den Pufferaufwand durch Verwendung eines Pufferpools. Puffer sind zur Verarbeitung von Nachrichten durch den Dienst erforderlich, wenn sie aus dem Kanal eintreffen. Wenn die Speicherkapazität des Pufferpools zur Verarbeitung der Nachrichten nicht ausreicht, muss der Puffer-Manager zusätzliche Speicherkapazität aus dem CLR-Heap zuweisen. Dadurch wird die Auslastung der Garbage Collection erhöht. Eine umfangreiche Zuweisung aus dem CLR-Heap der Garbage Collection weist darauf hin, dass die Größe des Pufferpools nicht ausreichend ist und dass die Leistung durch eine größere Zuweisung infolge einer Erhöhung des maximalen Grenzwerts, der durch dieses Attribut angegeben wird, verbessert werden kann.
maxBufferSize	Eine ganze Zahl, die die maximale Größe eines Puffers in Bytes angibt, in dem Nachrichten gespeichert werden, während sie für einen mit dieser Bindung konfigurierten Endpunkt verarbeitet werden. Der Standardwert ist 65.536 Byte.
maxReceivedMessageSize	Eine positive ganze Zahl, die die maximale Nachrichtengröße in Bytes einschließlich Header definiert, die in einem für diese Bindung konfigurierten Kanal beim Nachrichtenempfang zulässig ist. Der Absender erhält einen SOAP-Fehler, wenn die Nachricht zu groß für den Empfänger ist. Der Empfänger verwirft die Nachricht und erstellt einen Eintrag des Ereignisses im Ablaufverfolgungsprotokoll. Der Standardwert beträgt 65.536 Byte.
messageEncoding	Definiert den Encoder, der verwendet wird, um die SOAP-Nachricht zu codieren. Folgende Werte sind gültig: Text: Verwenden Sie einen Textnachrichtenencoder. Mtom: Verwenden Sie einen MTOM-Encoder (Message Transmission Organisation Mechanism 1.0). Der Standardwert ist Text. Dieses Attribut ist vom Typ WSMessageEncoding.
messageVersion	Gibt die Nachrichtenversion an, die von den Clients und Diensten verwendet wird, die mit der Bindung konfiguriert wurden. Dieses Attribut ist vom Typ MessageVersion.
name	Eine Zeichenfolge, die den Konfigurationsnamen der Bindung enthält. Dieser Wert sollte eindeutig sein, da er von der Bindung zur Identifizierung verwendet wird. Jede Bindung hat ein name-Attribut und ein namespace-Attribut, die die Bindung in den Metadaten des Diensts eindeutig identifizieren. Außerdem kommt dieser Name bei den Bindungen eines Typs nur einmal vor.
namespace	Gibt den XML-Namespace der Bindung an. Der Standardwert ist "http://tempuri.org/Bindings". Jede Bindung hat ein name-Attribut und ein namespace-Attribut, mit denen die Bindung in den Metadaten des Diensts eindeutig identifiziert werden.
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.
proxyAddress	Ein URI, der die Adresse des HTTP-Proxys enthält. Wenn useSystemWebProxy auf true festgelegt ist, muss diese Einstellung NULL lauten. Der Standardwert ist NULL.
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.
textEncoding	Legt die Zeichensatzcodierung fest, die zum Ausgeben von Nachrichten über die Bindung verwendet werden soll. Folgende Werte sind gültig: BigEndianUnicode: Unicode BigEndian-Kodierung. Unicode: 16-Bit-Kodierung. UTF8: 8-Bit-Codierung Der Standard ist UTF8. Dieses Attribut ist vom Typ Encoding.
transferMode	Ein gültiger TransferMode-Wert, der angibt, ob Nachrichten bei einer Anforderung oder Antwort gepuffert oder per Stream übertragen werden.
useDefaultWebProxy	Ein boolescher Wert, der angibt, ob der automatisch konfigurierte HTTP-Proxy des Systems bei Verfügbarkeit verwendet werden soll. Die Standardeinstellung ist true.

Untergeordnete Elemente

Element	Beschreibung
<security> von <basicHttpBinding>	Definiert die Sicherheitseinstellungen für die Bindung. Dieses Element ist vom Typ BasicHttpSecurityElement.
<readerQuotas>	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.

Übergeordnete Elemente

Element	Beschreibung
<bindings>	Dieses Element enthält eine Auflistung von standardmäßigen und benutzerdefinierten Bindungen. Jeder Eintrag wird durch seinen eindeutigen name identifiziert. Dienste verwenden Bindungen, indem sie sie mithilfe des name verknüpfen.

Hinweise

Dieses Bindungselement bietet einen Schutzgrad und einen Austauschmechanismus als Teil des Kontextes für eine BasicHttpBinding.

Siehe auch

Referenz

<<basicHttpBinding>>
BasicHttpBinding
BasicHttpContextBinding
BasicHttpContextBindingElement
ContextBindingElement

Konzepte

Weitere Ressourcen

Windows Communication Foundation Bindings
Configuring System-Provided Bindings
Using Bindings to Configure Services and Clients

Freigeben über