<ws2007HttpBinding>

  • Makale

, ReliableSessionve TransactionFlow bağlama öğelerinin doğru sürümleri Securityiçin destek sağlayan birlikte çalışabilir bir bağlama tanımlar.

<Yapılandırma>
  <system.serviceModel>
    <Bağlama>
      <ws2007HttpBinding>

Syntax

<ws2007HttpBinding>
  <binding allowCookies="Boolean"
           bypassProxyOnLocal="Boolean"
           closeTimeout="TimeSpan"
           hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
           maxBufferPoolSize="integer"
           maxReceivedMessageSize="Integer"
           messageEncoding="Text/Mtom"
           name="string"
           openTimeout="TimeSpan"
           proxyAddress="URI"
           receiveTimeout="TimeSpan"
           sendTimeout="TimeSpan"
           textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"
           transactionFlow="Boolean"
           useDefaultWebProxy="Boolean">
    <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" />
        <message clientCredentialType ="Certificate/IssuedToken/None/UserName/Windows"
                 negotiateServiceCredential="Boolean"
                 algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"
                 establishSecurityContext="Boolean" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</ws2007HttpBinding>

Öznitelikler ve Öğeler

Öznitelikler, alt ve üst öğeler aşağıdaki bölümlerde açıklanmaktadır.

Öznitelikler

Öznitelik Açıklama
allowCookies İstemcinin tanımlama bilgilerini kabul edip etmediğini ve bunları gelecekteki isteklere yayıp yaymadığını gösteren bir değer. Varsayılan değer: false.

Tanımlama bilgileri kullanan ASP.NET Web hizmetleri (ASMX) ile etkileşim kurarken bu özelliği kullanabilirsiniz. Bu, sunucunun döndürdüğü tanımlama bilgilerinin söz konusu hizmet için gelecekteki tüm istemci isteklerine otomatik olarak kopyalanmasını sağlar.
bypassProxyOnLocal Yerel adresler için ara sunucunun atlanıp atlanmayacağını belirten bir değer. Varsayılan değer: false.
closeTimeout Kapatma TimeSpan işleminin tamamlanması için zaman aralığını belirten değer. Bu değer değerinden büyük veya eşit Zeroolmalıdır. Varsayılan değer 00:01:00'dır.
hostNameComparisonMode Tekdüzen Kaynak Tanımlayıcılarını (URI) ayrıştırmak için kullanılan HTTP ana bilgisayar adı karşılaştırma modunu belirtir. Bu öznitelik, URI ile eşleştirilirken ana bilgisayar adının hizmete ulaşmak için kullanılıp kullanılmadığını gösteren türündedir HostNameComparisonMode. Varsayılan değer, eşleşmedeki ana bilgisayar adını yoksayan değeridir StrongWildcard.
maxBufferPoolSize Bu bağlama için en büyük arabellek havuzu boyutu. Varsayılan değer 524.288 bayttır (512 × 1.024). Windows Communication Foundation'ın (WCF) birçok bölümünde arabellek kullanılır. Arabellekleri her kullanışında arabellek oluşturmak ve yok etmek, arabellekler için atık toplama gibi pahalıdır. Arabellek havuzları ile havuzdan bir arabellek alabilir, kullanabilir ve işiniz bittiğinde havuza döndürebilirsiniz. Bu, arabellek oluşturma ve yok etme yükünden kaçınır.
maxReceivedMessageSize Bu bağlamayla yapılandırılan bir kanalın alabileceği üst bilgiler de dahil olmak üzere bayt cinsinden ileti boyutu üst sınırı. Bu sınırı aşan bir iletiyi gönderen bir SOAP hatası alır. Alıcı iletiyi bırakır ve izleme günlüğünde olayın bir girişini oluşturur. Varsayılan değer 65536'dır.
messageEncoding İletiyi kodlamak için kullanılan kodlayıcıyı tanımlar. Geçerli değerler şunlardır:

- Text: Kısa mesaj kodlayıcı kullanın.
- Mtom: İleti İletim Kuruluş Mekanizması 1.0 (MTOM) kodlayıcı kullanın.

Varsayılan değer: Text.

Bu öznitelik türündedir WSMessageEncoding.
name Bağlamanın yapılandırma adı. Bağlama için tanımlama olarak kullanıldığından bu değer benzersiz olmalıdır. .NET Framework 4'den başlayarak, bağlamaların ve davranışların bir ada sahip olması gerekmez. Varsayılan yapılandırma ve adsız bağlamalar ve davranışlar hakkında daha fazla bilgi için bkz. WCF Hizmetleri içinBasitleştirilmiş Yapılandırma ve Basitleştirilmiş Yapılandırma.
openTimeout Açık TimeSpan işlemin tamamlanması için sağlanan zaman aralığını belirten değer. Bu değer değerinden büyük veya eşit Zeroolmalıdır. Varsayılan değer 00:01:00'dır.
proxyAddress HTTP ara sunucusunun adresini belirten bir URI. ise useSystemWebProxytrue, bu ayar olmalıdır null. Varsayılan değer: null.
receiveTimeout Alma TimeSpan işleminin tamamlanması için sağlanan zaman aralığını belirten değer. Bu değer değerinden büyük veya eşit Zeroolmalıdır. Varsayılan değer 00:01:00'dır.
sendTimeout Gönderme TimeSpan işleminin tamamlanması için sağlanan zaman aralığını belirten değer. Bu değer değerinden büyük veya eşit Zeroolmalıdır. Varsayılan değer 00:01:00'dır.
textEncoding Bağlamada iletileri yaymak için kullanılacak karakter kümesi kodlamasını belirtir. Geçerli değerler şunlardır:

- UnicodeFffeTextEncoding: Unicode Büyük Endian kodlaması.
- Utf16TextEncoding: 16 bit kodlama.
- Utf8TextEncoding: 8 bit kodlama.

Varsayılan değer: Utf8TextEncoding.

Bu öznitelik türündedir Encoding.
transactionFlow Bağlamanın akan WS-Transactions'i destekleyip desteklemediğini belirten bir değer. Varsayılan değer: false.
useDefaultWebProxy Sistemin otomatik olarak yapılandırılan HTTP proxy'sinin kullanılıp kullanılmadığını belirten bir değer. Varsayılan değer: true.

Alt Öğeler

Öğe Açıklama
<Güvenlik> Bağlamanın güvenlik ayarlarını tanımlar. Bu öğe türündedir WSHttpSecurityElement.
<readerQuotas> Bu bağlama ile yapılandırılan uç noktaların işleyebileceği SOAP iletilerinin karmaşıklığı üzerindeki kısıtlamaları tanımlar. Bu öğe türündedir XmlDictionaryReaderQuotasElement.
<reliableSession> Kanal uç noktaları arasında güvenilir oturumların oluşturulup kurulmayacağını belirtir.

Üst Öğeler

Öğe Açıklama
<Bağlama> Bu öğe standart ve özel bağlamalardan oluşan bir koleksiyonu barındırıyor.

Açıklamalar

, WS2007HttpBinding öğesine benzer WSHttpBinding bir sistem tarafından sağlanan bağlama ekler, ancak ReliableSession, Security ve TransactionFlow protokollerinin Yapılandırılmış Bilgi Standartlarının (OASIS) Standart Sürümlerinin İlerlemesi için Kuruluş'u kullanır. Bu bağlama kullanılırken nesne modelinde veya varsayılan ayarlarda değişiklik yapılması gerekmez.

Örnek

<configuration>
  <system.ServiceModel>
    <bindings>
      <ws2007HttpBinding>
        <binding closeTimeout="00:00:10"
                 openTimeout="00:00:20"
                 receiveTimeout="00:00:30"
                 sendTimeout="00:00:40"
                 bypassProxyOnLocal="false"
                 transactionFlow="false"
                 hostNameComparisonMode="WeakWildcard"
                 maxReceivedMessageSize="1000"
                 messageEncoding="Mtom"
                 proxyAddress="http://www.contoso.com"
                 textEncoding="utf-16"
                 useDefaultWebProxy="false">
          <reliableSession ordered="false"
                           inactivityTimeout="00:02:00"
                           enabled="true" />
          <security mode="Transport">
            <transport clientCredentialType="Digest"
                       proxyCredentialType="None"
                       realm="someRealm" />
            <message clientCredentialType="Windows"
                     negotiateServiceCredential="false"
                     algorithmSuite="Aes128"
                     defaultProtectionLevel="None" />
          </security>
        </binding>
      </ws2007HttpBinding>
    </bindings>
  </system.ServiceModel>
</configuration>

Ayrıca bkz.