Aracılığıyla paylaş

<basicHttpContextBinding>

  • Makale

Değişim mekanizması olarak HTTP tanımlama bilgilerini etkinleştirerek, değiş tokuş için bağlam BasicHttpBinding sağlayan bir bağlama belirtme.

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

Syntax

<basicHttpContextBinding>
  <binding allowCookies="Boolean"
           bypassProxyOnLocal="Boolean"
           closeTimeout="TimeSpan"
           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 maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</basicHttpContextBinding>

Ö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 boole değeri. Varsayılan değer: false.

Tanımlama bilgilerini kullanan ASMX Web hizmetleriyle etkileşim kurarken bu özelliği kullanabilirsiniz. Bu şekilde, sunucudan döndürülen tanımlama bilgilerinin söz konusu hizmet için gelecekteki tüm istemci isteklerine otomatik olarak kopyalandığından emin olabilirsiniz.
bypassProxyOnLocal Yerel adresler için ara sunucunun atlanıp atlanmayacağını gösteren boole değeri. Varsayılan değer: false.

Bir İnternet kaynağı, yerel bir adresi varsa yereldir. Yerel adres, aynı bilgisayarda, yerel LAN'da veya intranette bulunan adrestir ve URI'lerde http://webserver/http://localhost/olduğu gibi nokta (.) olmamasıyla söz dizimsel olarak tanımlanır.

Bu özniteliğin ayarlanması, TemelHttpBinding ile yapılandırılan uç noktaların yerel kaynaklara erişirken ara sunucuyu kullanıp kullanmadığını belirler. Bu öznitelik ise true, yerel İnternet kaynaklarına yapılan istekler ara sunucuyu kullanmaz. İstemcilerin, bu öznitelik olarak ayarlandığında trueaynı makinedeki hizmetlerle konuşurken ara sunucudan geçmelerini istiyorsanız ana bilgisayar adını (localhost yerine) kullanın.

Bu öznitelik olduğunda false, tüm İnternet istekleri ara sunucu üzerinden yapılır.
closeTimeout Kapatma TimeSpan işleminin tamamlanması için sağlanan zaman aralığını belirten değer. Bu değer değerinden büyük veya değerine Zeroeşit olmalıdır. Varsayılan değer 00:01:00'dır.
hostNameComparisonMode URI'leri 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 konak adını yoksayan değeridir StrongWildcard.
maxBufferPoolSize Kanaldan ileti alan ileti arabelleklerinin yöneticisi tarafından kullanılmak üzere ayrılan en fazla bellek miktarını belirten bir tamsayı değeri. Varsayılan değer 524288 (0x80000) bayttır.

Arabellek Yöneticisi, arabellek havuzu kullanarak arabellekleri kullanma maliyetini en aza indirir. Arabellekler, kanaldan çıkan iletileri hizmet tarafından işlemek için gereklidir. Arabellek havuzunda ileti yükünü işlemek için yeterli bellek yoksa, Arabellek Yöneticisi'nin CLR yığınından ek bellek ayırması gerekir ve bu da çöp toplama ek yükünü artırır. CLR çöp yığınından kapsamlı ayırma, arabellek havuzu boyutunun çok küçük olduğunu ve bu öznitelik tarafından belirtilen sınır artırılarak daha büyük bir ayırma ile performansın geliştirilebileceğinin göstergesidir.
maxBufferSize bu bağlama ile yapılandırılmış bir uç nokta için işlenirken iletileri depolayan bir arabelleğin bayt cinsinden en büyük boyutunu belirten bir tamsayı değeri. Varsayılan değer 65.536 bayttır.
maxReceivedMessageSize Bu bağlamayla yapılandırılmış bir kanalda alınabilen bir ileti için üst bilgiler de dahil olmak üzere bayt cinsinden en büyük ileti boyutunu tanımlayan pozitif bir tamsayı. İleti alıcı için çok büyükse gönderen bir SOAP hatası alır. Alıcı iletiyi bırakır ve izleme günlüğünde olayın bir girdisini oluşturur. Varsayılan değer 65.536 bayttır.
messageEncoding SOAP iletisini kodlamak için kullanılan kodlayıcıyı tanımlar. Geçerli değerler şunlardır:

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

Varsayılan değer Metin'dir. Bu öznitelik türündedir WSMessageEncoding.
messageVersion bağlamasıyla yapılandırılan istemciler ve hizmetler tarafından kullanılan ileti sürümünü belirtir. Bu öznitelik türündedir MessageVersion.
name Bağlamanın yapılandırma adını içeren bir dize. 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çin Basitleştirilmiş Yapılandırma ve Basitleştirilmiş Yapılandırma.
openTimeout Açma TimeSpan işleminin tamamlanması için sağlanan zaman aralığını belirten değer. Bu değer değerinden büyük veya değerine Zeroeşit olmalıdır. Varsayılan değer 00:01:00'dır.
proxyAddress HTTP ara sunucusunun adresini içeren bir URI. olarak ayarlanırsa 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 değerine Zeroeşit olmalıdır. Varsayılan değer 00:10: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 değerine Zeroeşit olmalıdır. Varsayılan değer 00:01:00'dır.
textEncoding Bağlamadaki iletileri yaymak için kullanılacak karakter kümesi kodlamasını ayarlar. Geçerli değerler şunlardır:

- BigEndianUnicode: Unicode BigEndian kodlaması.
- Unicode: 16 bit kodlama.
- UTF8: 8 bit kodlama

Varsayılan değer UTF8'dir. Bu öznitelik türündedir Encoding.
transferMode İletilerin bir istekte veya yanıtta arabelleğe alınıp alınmayacağını veya akışa alınıp alınmayacağını belirten geçerli TransferMode bir değer.
useDefaultWebProxy Varsa, sistemin otomatik olarak yapılandırılmış HTTP proxy'sinin kullanılıp kullanılmayacağını belirten bir Boole değeri. Varsayılan değer: true.

Alt Öğeler

Öğe Açıklama
<Güvenlik> Bağlama için güvenlik ayarlarını tanımlar. Bu öğe türündedir BasicHttpSecurityElement.
<readerQuotas> Bu bağlama ile yapılandırılan uç noktalar tarafından işlenebilen SOAP iletilerinin karmaşıklığıyla ilgili kısıtlamaları tanımlar. Bu öğe türündedir XmlDictionaryReaderQuotasElement.

Üst Öğeler

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

Açıklamalar

Bu bağlama öğesi, bir için bağlamın parçası olarak bir koruma düzeyi ve bir BasicHttpBindingdeğişim mekanizması sağlar.

Ayrıca bkz.