Aracılığıyla paylaş

<webHttpBinding>

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

<configuration>
  <system.serviceModel>
    <bindings>
      <webHttpBinding>

Sözdizimi

<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

Attributes

Özellik Description
Allowcookies İstemcinin tanımlama bilgilerini kabul edip etmediğini ve bunları gelecekteki isteklerde yayıp yaymadığını gösteren Boole değeri. Varsayılan değer false'tur.

Tanımlama bilgileri kullanan ASMX Web hizmetleriyle etkileşim kurarken bu özelliği kullanabilirsiniz. Bu şekilde, sunucudan döndürülen tanımlama bilgilerinin bu 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 buna 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'de 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 en büyük arabellek havuzu boyutunu belirten bir tamsayı. Varsayılan değer 524.288 bayttır (512 * 1024). Windows Communication Foundation'ın (WCF) birçok bölümünde arabellekler kullanılır. Arabellekleri her kullanışında oluşturmak ve yok etmek pahalıdır ve arabellekler için atık 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 tamsayı. Varsayılan değer 524.288 (0x80000) bayttır.
maxReceivedMessageSize Bu bağlamayla yapılandırılmış 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 iletinin göndereni 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ırmanız gerekir (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ç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 buna 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 buna Zeroeşit olmalıdır. Varsayılan değer 00:01:00'dır.
sendTimeout TimeSpan Gönderme işleminin tamamlanması için sağlanan zaman aralığını belirten değer. Bu değer değerinden büyük veya buna Zeroeşit olmalıdır. Varsayılan değer 00:01:00'dır.
transferMode. TransferMode Bağlama ile yapılandırılan hizmetin, ileti aktarımının akışlı veya arabelleğe alınmış (ya da her ikisi birden) modlarını kullanıp kullanmadığını gösteren bir değer. Varsayılan değer: Buffered.
useDefaultWebProxy Sistemin otomatik olarak yapılandırılan HTTP proxy'sinin kullanılıp kullanılmadığını belirten 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 Description
<readerQuotas> Bu bağlama ile 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 Description
<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 > yapılandırılması gerekir.

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

Ayrıca bakınız

  • Last updated on