<webHttpBinding>

Artykuł
07/07/2023

Definiuje element powiązania używany do konfigurowania punktów końcowych dla usług sieci Web windows Communication Foundation (WCF), które odpowiadają na żądania HTTP zamiast komunikatów SOAP.

<Konfiguracji>
  <System.servicemodel>
    <Powiązania>
      <webHttpBinding>

Składnia

<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>

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne

Atrybuty

Atrybut	Opis
allowCookies	Wartość logiczna wskazująca, czy klient akceptuje pliki cookie i propaguje je na przyszłych żądaniach. Wartością domyślną jest false. Tej właściwości można używać podczas interakcji z usługami sieci Web ASMX korzystającymi z plików cookie. W ten sposób można mieć pewność, że pliki cookie zwrócone z serwera są automatycznie kopiowane do wszystkich przyszłych żądań klientów dla tej usługi.
Bypassproxyonlocal	Wartość logiczna wskazująca, czy pominąć serwer proxy dla adresów lokalnych. Wartość domyślna to `false`.
closeTimeout	TimeSpan Wartość określająca interwał czasu określony dla zakończenia operacji zamknięcia. Ta wartość powinna być większa lub równa Zero. Wartość domyślna to 00:01:00.
Hostnamecomparisonmode	Określa tryb porównania nazwy hosta HTTP używany do analizowania identyfikatorów URI. Ten atrybut jest typu HostNameComparisonMode, który wskazuje, czy nazwa hosta jest używana do dotarcia do usługi podczas dopasowywania identyfikatora URI. Wartość domyślna to StrongWildcard, która ignoruje nazwę hosta w dopasowaniu.
Maxbufferpoolsize	Liczba całkowita określająca maksymalny rozmiar puli buforów dla tego powiązania. Wartość domyślna to 524 288 bajtów (512 * 1024). Wiele części programu Windows Communication Foundation (WCF) używa buforów. Tworzenie i niszczenie buforów za każdym razem, gdy są używane, jest kosztowne, a odzyskiwanie pamięci dla buforów jest również kosztowne. W przypadku pul buforów można pobrać bufor z puli, użyć go i wrócić do puli po zakończeniu pracy. W związku z tym unika się nakładu pracy podczas tworzenia i niszczenia buforów.
Maxbuffersize	Liczba całkowita określająca maksymalną ilość pamięci przydzielonej do użycia przez menedżera buforów komunikatów odbierających komunikaty z kanału. Wartość domyślna to 524 288 (0x80000) bajtów.
Maxreceivedmessagesize	Dodatnia liczba całkowita określająca maksymalny rozmiar komunikatu w bajtach, w tym nagłówki, które można odebrać w kanale skonfigurowanym za pomocą tego powiązania. Nadawca komunikatu przekraczającego ten limit otrzyma błąd. Odbiorca pominie komunikat i tworzy wpis zdarzenia w dzienniku śledzenia. Wartość domyślna to 65536. Uwaga: Zwiększenie tej samej wartości nie jest wystarczające w trybie zgodnym z ASP.NET. Należy również zwiększyć wartość `httpRuntime` (zobacz httpRuntime, element (ASP.NET Settings Schema)).
name	Ciąg zawierający nazwę konfiguracji powiązania. Ta wartość powinna być unikatowa, ponieważ jest używana jako identyfikacja powiązania. Począwszy od .NET Framework 4, powiązania i zachowania nie muszą mieć nazwy. Aby uzyskać więcej informacji na temat domyślnej konfiguracji i bez nazw powiązań i zachowań, zobacz Uproszczone konfigurowanie i uproszczona konfiguracja dla usług WCF.
openTimeout	TimeSpan Wartość określająca interwał czasu określony dla operacji otwierania do ukończenia. Ta wartość powinna być większa lub równa Zero. Wartość domyślna to 00:01:00.
Proxyaddress	Identyfikator URI określający adres serwera proxy HTTP. Jeśli `useSystemWebProxy` jest to `true`, to ustawienie musi mieć wartość `null`. Wartość domyślna to `null`.
Receivetimeout	TimeSpan Wartość określająca interwał czasu określony dla wykonania operacji odbierania. Ta wartość powinna być większa lub równa Zero. Wartość domyślna to 00:01:00.
sendTimeout	TimeSpan Wartość określająca interwał czasu określony dla operacji wysyłania do ukończenia. Ta wartość powinna być większa lub równa Zero. Wartość domyślna to 00:01:00.
Transfermode.	TransferMode Wartość wskazująca, czy usługa skonfigurowana za pomocą powiązania używa strumieniowych lub buforowanych (lub obu) trybów transferu komunikatów. Wartość domyślna to `Buffered`.
useDefaultWebProxy	Wartość logiczna określająca, czy jest używany automatycznie skonfigurowany serwer proxy HTTP systemu. Wartość domyślna to `true`.
writeEncoding	Określa kodowanie znaków używane dla tekstu wiadomości. Prawidłowe wartości obejmują następujące wartości: UnicodeFffeTextEncoding: kodowanie Unicode BigEndian. Utf16TextEncoding: kodowanie 16-bitowe. Utf8TextEncoding: kodowanie 8-bitowe. Wartość domyślna to Utf8TextEncoding.

Elementy podrzędne

Element	Opis
<Readerquotas>	Definiuje ograniczenia złożoności komunikatów POX, które mogą być przetwarzane przez punkty końcowe skonfigurowane za pomocą tego powiązania. Ten element jest typu XmlDictionaryReaderQuotasElement.
<Zabezpieczeń>	Definiuje ustawienia zabezpieczeń powiązania. Ten element jest typu WebHttpSecurityElement.

Elementy nadrzędne

Element	Opis
<Powiązania>	Ten element zawiera kolekcję powiązań standardowych i niestandardowych.

Uwagi

Model programowania internetowego WCF umożliwia deweloperom uwidacznianie usług internetowych WCF za pośrednictwem żądań HTTP korzystających z komunikatów w stylu "zwykłego starego kodu XML" (POX) zamiast obsługi komunikatów opartych na protokole SOAP. Aby klienci komunikowali się z usługą przy użyciu żądań HTTP, punkt końcowy usługi musi być skonfigurowany z <usługą webHttpBinding> , która ma <dołączony element WebHttpBehavior> .

Obsługa w programie WCF na potrzeby syndykacji i asp. Integracja AJAX jest oparta na modelu programowania internetowego. Aby uzyskać więcej informacji na temat modelu, zobacz WCF Web HTTP Programming Model (Model programowania http w sieci Web WCF).

Udostępnij za pośrednictwem