<httpTransport>

Artykuł
06/08/2023

Określa transport HTTP do przesyłania komunikatów SOAP dla powiązania niestandardowego.

<Konfiguracji>
  <System.servicemodel>
    <Powiązania>
      <Custombinding>
        <Wiązania>
          <httpTransport>

Składnia

<httpTransport allowCookies="Boolean"
               authenticationScheme="Digest/Negotiate/Ntlm/Basic/Anonymous"
               bypassProxyOnLocal="Boolean"
               hostnameComparisonMode="StrongWildcard/Exact/WeakWildcard"
               keepAliveEnabled="Boolean"
               maxBufferSize="Integer"
               proxyAddress="Uri"
               proxyAuthenticationScheme="None/Digest/Negotiate/Ntlm/Basic/Anonymous"
               realm="String"
               transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
               unsafeConnectionNtlmAuthentication="Boolean"
               useDefaultWebProxy="Boolean" />

Atrybuty i elementy

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

Atrybuty

Atrybut	Opis
allowCookies	Wartość logiczna określająca, czy klient akceptuje pliki cookie i propaguje je na przyszłych żądaniach. Wartość domyślna to `false`. Ten atrybut można użyć 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.
authenticationScheme	Określa protokół używany do uwierzytelniania żądań klienta przetwarzanych przez odbiornik HTTP. Prawidłowe wartości obejmują następujące wartości: - Szyfruj: określa uwierzytelnianie szyfrowe. - Negocjuj: negocjuje z klientem, aby określić schemat uwierzytelniania. Jeśli zarówno klient, jak i serwer obsługują protokół Kerberos, jest używany; w przeciwnym razie jest używany protokół NTLM. - Ntlm: Określa uwierzytelnianie NTLM. — Podstawowe: określa uwierzytelnianie podstawowe. - Anonimowy: określa uwierzytelnianie anonimowe. Wartość domyślna to Anonimowy. Ten atrybut jest typu AuthenticationSchemes. Ten atrybut można ustawić tylko raz.
Bypassproxyonlocal	Wartość logiczna wskazująca, czy pominąć serwer proxy dla adresów lokalnych. Wartość domyślna to `false`. Adres lokalny to adres lokalny, który znajduje się w lokalnej sieci LAN lub intranecie. Program Windows Communication Foundation (WCF) zawsze ignoruje serwer proxy, jeśli adres usługi zaczyna się od `http://localhost`. Należy użyć nazwy hosta, a nie hosta lokalnego, jeśli chcesz, aby klienci przechodzili przez serwer proxy podczas rozmowy z usługami na tym samym komputerze.
Hostnamecomparisonmode	Określa tryb porównania nazwy hosta HTTP używany do analizowania identyfikatorów URI. Prawidłowe wartości to, - StrongWildcard: ("+") pasuje do wszystkich możliwych nazw hostów w kontekście określonego schematu, portu i względnego identyfikatora URI. - Dokładne: brak symboli wieloznacznych - WeakWildcard: ("*") pasuje do wszystkich możliwych nazw hostów w kontekście określonego schematu, portu i względnego UIR, które nie zostały jawnie dopasowane lub za pomocą silnego mechanizmu symboli wieloznacznych. Ten atrybut jest typu HostNameComparisonMode. Wartość domyślna to StrongWildcard.
keepAliveEnabled	Wartość logiczna określająca, czy nawiązać trwałe połączenie z zasobem internetowym.
Maxbuffersize	Dodatnia liczba całkowita określająca maksymalny rozmiar buforu. Wartość domyślna to 524288
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`.
proxyAuthenticationScheme	Określa protokół używany do uwierzytelniania żądań klienta przetwarzanych przez serwer proxy HTTP. Prawidłowe wartości obejmują następujące wartości: - Brak: nie jest wykonywane uwierzytelnianie. - Szyfruj: określa uwierzytelnianie szyfrowe. - Negocjuj: negocjuje z klientem, aby określić schemat uwierzytelniania. Jeśli zarówno klient, jak i serwer obsługują protokół Kerberos, jest używany; w przeciwnym razie jest używany protokół NTLM. - Ntlm: Określa uwierzytelnianie NTLM. — Podstawowe: określa uwierzytelnianie podstawowe. - Anonimowy: określa uwierzytelnianie anonimowe. Wartość domyślna to Anonimowy. Ten atrybut jest typu AuthenticationSchemes. Należy pamiętać, że AuthenticationSchemes.IntegratedWindowsAuthentication nie jest obsługiwane.
Obszaru	Ciąg określający obszar do użycia na serwerze proxy/serwerze. Wartość domyślna to pusty ciąg. Serwery używają obszaru do partycjonowania chronionych zasobów. Każda partycja może mieć własny schemat uwierzytelniania i/lub bazę danych autoryzacji. Obszary są używane tylko do uwierzytelniania podstawowego i szyfrowego. Po pomyślnym uwierzytelnieniu klienta uwierzytelnianie jest prawidłowe dla wszystkich zasobów w danym obszarze. Aby uzyskać szczegółowy opis obszaru, zobacz RFC 2617 na stronie internetowej IETF.
Transfermode	Określa, czy komunikaty są buforowane, czy przesyłane strumieniowo, czy też żądanie lub odpowiedź. Prawidłowe wartości obejmują następujące wartości: - Buforowane: komunikaty żądania i odpowiedzi są buforowane. - Przesyłane strumieniowo: przesyłane strumieniowo komunikaty żądania i odpowiedzi. - StreamedRequest: komunikat żądania jest przesyłany strumieniowo, a komunikat odpowiedzi jest buforowany. - StreamedResponse: komunikat żądania jest buforowany, a komunikat odpowiedzi jest przesyłany strumieniowo. Wartość domyślna to Buforowane. Ten atrybut jest typu TransferMode .
unsafeConnectionNtlmAuthentication	Wartość logiczna określająca, czy na serwerze włączono niebezpieczne udostępnianie połączeń. Wartość domyślna to `false`. W przypadku włączenia uwierzytelniania NTLM jest wykonywane raz na każdym połączeniu TCP.
useDefaultWebProxy	Wartość logiczna określająca, czy ustawienia serwera proxy dla całego komputera są używane, a nie ustawienia specyficzne dla użytkownika. Wartość domyślna to `true`.

Elementy podrzędne

Brak

Elementy nadrzędne

Element	Opis
<Wiązania>	Definiuje wszystkie możliwości powiązania niestandardowego.

Uwagi

Element httpTransport jest punktem wyjścia do utworzenia powiązania niestandardowego, które implementuje protokół transportu HTTP. HTTP to podstawowy transport używany do celów współdziałania. Ten transport jest obsługiwany przez program Windows Communication Foundation (WCF) w celu zapewnienia współdziałania z innymi stosami usług sieci Web innych niż WCF.