<webHttpBinding>

Makale
04/08/2023

SOAP iletileri yerine HTTP isteklerine yanıt veren Windows Communication Foundation (WCF) Web hizmetlerinin uç noktalarını yapılandırmak için kullanılan bir bağlama öğesi tanımlar.

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

Syntax

<webHttpBinding>
  <binding allowCookies="Boolean"
           bypassProxyOnLocal="Boolean"
           closeTimeout="TimeSpan"
           hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
           maxBufferPoolSize="integer"
           maxBufferSize="integer"
           maxReceivedMessageSize="Integer"
           name="string"
           openTimeout="TimeSpan"
           proxyAddress="URI"
           receiveTimeout="TimeSpan"
           sendTimeout="TimeSpan"
           transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
           useDefaultWebProxy="Boolean"
           writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding">
    <security mode="None/Transport/TransportCredentialOnly">
      <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
                 proxyCredentialType="Basic/Digest/None/Ntlm/Windows"
                 realm="string" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</webHttpBinding>

Öznitelikler ve Öğeler

Aşağıdaki bölümlerde öznitelikler, alt öğeler ve üst öğeler 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`.
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	Bu bağlama için arabellek havuzu boyutunun üst sınırını belirten bir tamsayı. Varsayılan değer 524.288 bayttır (512 * 1024). Windows Communication Foundation'ın (WCF) birçok bölümünde arabellek kullanılır. Arabelleklerin her kullanıldığında oluşturulması ve yok edilmesi pahalıdır ve arabellekler için çöp toplama da pahalıdır. Arabellek havuzları ile havuzdan bir arabellek alabilir, kullanabilir ve işiniz bittiğinde havuza döndürebilirsiniz. Bu nedenle arabellek oluşturma ve yok etme ek yükünden kaçınılır.
Maxbuffersize	Kanaldan ileti alan ileti arabelleklerinin yöneticisi tarafından kullanılmak üzere ayrılan en fazla bellek miktarını belirten bir tamsayı. Varsayılan değer 524.288 (0x80000) bayttır.
maxReceivedMessageSize	Bu bağlamayla yapılandırılan bir kanalda alınabilecek üst bilgiler de dahil olmak üzere bayt cinsinden en büyük ileti boyutunu belirten pozitif bir tamsayı. Bu sınırı aşan bir iletiyi gönderen hata alır. Alıcı iletiyi bırakır ve izleme günlüğünde olayın bir girdisini oluşturur. Varsayılan değer 65536'dır. Not: Bu değerin tek başına artırılması uyumlu modda ASP.NET yeterli değildir. değerini `httpRuntime` de artırmalısınız (bkz. httpRuntime Öğesi (ASP.NET Ayarlar Şeması)).
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 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 değerine Zeroeşit olmalı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 değerine Zeroeşit olmalıdır. Varsayılan değer 00:01:00'dır.
transferMode.	TransferMode Bağlama ile yapılandırılan hizmetin akışlı veya arabelleğe alınmış (veya her iki) ileti aktarımı modunu kullanıp kullanmadığını gösteren bir değer. Varsayılan değer: `Buffered`.
useDefaultWebProxy	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`.
writeEncoding	İleti metni için kullanılan karakter kodlamasını belirtir. Geçerli değerler şunlardır: UnicodeFffeTextEncoding: Unicode BigEndian kodlaması. Utf16TextEncoding: 16 bit kodlama. Utf8TextEncoding: 8 bit kodlama. Varsayılan değer Utf8TextEncoding'dir.

Alt Öğeler

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

Üst Öğeler

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

Açıklamalar

WCF Web Programlama Modeli, geliştiricilerin SOAP tabanlı mesajlaşma yerine "düz eski XML" (POX) stili mesajlaşma kullanan HTTP istekleri aracılığıyla WCF Web hizmetlerini kullanıma sunmasını sağlar. İstemcilerin HTTP isteklerini kullanarak bir hizmetle iletişim kurabilmesi için, hizmetin bir uç noktasının WebHttpBehavior'ın> bağlı olduğu <webHttpBinding> ile< yapılandırılması gerekir.

Dağıtım ve ASP için WCF desteği. AJAX tümleştirmesi, Web Programlama Modeli'nin üzerine kurulmuştur. Model hakkında daha fazla bilgi için bkz . WCF Web HTTP Programlama Modeli.

Aracılığıyla paylaş