<basicHttpContextBinding>

Artykuł
07/07/2023

Określenie powiązania, które zapewnia kontekst wymiany BasicHttpBinding , włączając pliki cookie HTTP jako mechanizm wymiany.

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

Składnia

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

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ść domyślna to `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`. Zasób internetowy jest lokalny, jeśli ma adres lokalny. Adres lokalny to taki, który znajduje się na tym samym komputerze, lokalna sieć LAN lub intranet i jest identyfikowany, synktycznie, przez brak kropki (.) jak w identyfikatorach `http://webserver/` URI i `http://localhost/`. Ustawienie tego atrybutu określa, czy punkty końcowe skonfigurowane przy użyciu protokołu BasicHttpBinding używają serwera proxy podczas uzyskiwania dostępu do zasobów lokalnych. Jeśli ten atrybut to `true`, żądania do lokalnych zasobów internetowych nie używają serwera proxy. Użyj nazwy hosta (zamiast hosta lokalnego), jeśli chcesz, aby klienci przechodzili przez serwer proxy podczas rozmowy z usługami na tej samej maszynie, gdy ten atrybut ma wartość `true`. Gdy ten atrybut to `false`, wszystkie żądania internetowe są wykonywane za pośrednictwem serwera proxy.
`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`	Wartość 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 524288 (0x80000) bajtów. Menedżer buforów minimalizuje koszt używania buforów przy użyciu puli buforów. Bufory są wymagane do przetwarzania komunikatów przez usługę, gdy wyjdą z kanału. Jeśli w puli buforów nie ma wystarczającej ilości pamięci do przetworzenia obciążenia komunikatów, Menedżer buforów musi przydzielić dodatkową pamięć ze sterta CLR, co zwiększa obciążenie odzyskiwania pamięci. Obszerna alokacja sterty pamięci CLR jest wskazaniem, że rozmiar puli buforów jest zbyt mały i że wydajność można poprawić przy użyciu większej alokacji, zwiększając limit określony przez ten atrybut.
`maxBufferSize`	Wartość całkowita określająca maksymalny rozmiar w bajtach buforu, który przechowuje komunikaty podczas przetwarzania dla punktu końcowego skonfigurowanego za pomocą tego powiązania. Wartość domyślna to 65 536 bajtów.
`maxReceivedMessageSize`	Dodatnia liczba całkowita definiująca maksymalny rozmiar komunikatu w bajtach, w tym nagłówki, dla komunikatu, który można odebrać w kanale skonfigurowanym za pomocą tego powiązania. Nadawca otrzymuje błąd PROTOKOŁU SOAP, jeśli komunikat jest za duży dla odbiornika. Odbiorca pominie komunikat i tworzy wpis zdarzenia w dzienniku śledzenia. Wartość domyślna to 65 536 bajtów.
`messageEncoding`	Definiuje koder używany do kodowania komunikatu SOAP. Prawidłowe wartości obejmują następujące wartości: - Tekst: użyj kodera wiadomości SMS. - Mtom: Użyj kodera mechanizmu organizacji transmisji komunikatów 1.0 (MTOM). Wartość domyślna to Text. Ten atrybut jest typu WSMessageEncoding.
`messageVersion`	Określa wersję komunikatu używaną przez klientów i usługi skonfigurowane z powiązaniem. Ten atrybut jest typu MessageVersion.
`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 zawierający adres serwera proxy HTTP. Jeśli `useSystemWebProxy` ustawiono wartość `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:10: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.
`textEncoding`	Ustawia kodowanie zestawu znaków, które ma być używane do emitowania komunikatów w powiązaniu. Prawidłowe wartości obejmują następujące wartości: - BigEndianUnicode: kodowanie Unicode BigEndian. - Unicode: kodowanie 16-bitowe. - UTF8: kodowanie 8-bitowe Wartość domyślna to UTF8. Ten atrybut jest typu Encoding.
`transferMode`	Prawidłowa TransferMode wartość określająca, czy komunikaty są buforowane, czy przesyłane strumieniowo na żądanie lub odpowiedź.
`useDefaultWebProxy`	Wartość logiczna określająca, czy ma być używany automatycznie skonfigurowany serwer proxy HTTP systemu, jeśli jest dostępny. Wartość domyślna to `true`.

Elementy podrzędne

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

Elementy nadrzędne

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

Uwagi

Ten element powiązania zapewnia poziom ochrony i mechanizm wymiany w ramach kontekstu dla elementu BasicHttpBinding.