<baseAddressPrefixFilters>

Artykuł
06/08/2023

Reprezentuje kolekcję elementów konfiguracji, które określają filtry przekazywane, które zapewniają mechanizm wybierania odpowiednich powiązań usług Internet Information Services (IIS) podczas hostowania aplikacji Windows Communication Foundation (WCF) w usługach IIS.

Ostrzeżenie

<BaseAddressPrefixFilters> nie rozpoznaje "localhost"; zamiast tego użyj w pełni kwalifikowanej nazwy maszyny.

<Konfiguracji>
  <System.servicemodel>
    <serviceHostingEnvironment>
      <baseAddressPrefixFilters>

Składnia

<serviceHostingEnvironment>
  <baseAddressPrefixFilters>
    <add prefix="String" />
   </baseAddressPrefixFilters>
</serviceHostingEnvironment>

Atrybuty i elementy

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

Atrybuty

Brak.

Elementy podrzędne

Element	Opis
<Dodaj>	Dodaje element konfiguracji określający filtr prefiksu dla adresów podstawowych używanych przez hosta usługi.

Elementy nadrzędne

Element	Opis
<serviceHostingEnvironment>	Definiuje typ wystąpienia środowiska hostingu usługi dla określonego transportu.

Uwagi

Filtr prefiksu umożliwia dostawcom hostingu współużytkowanego określenie, które identyfikatory URI mają być używane przez usługę. Umożliwia hostom udostępnionym hostowanie wielu aplikacji z różnymi adresami podstawowymi dla tego samego schematu w tej samej witrynie.

Witryny sieci Web usług IIS to kontenery dla aplikacji wirtualnych zawierających katalogi wirtualne. Dostęp do aplikacji w lokacji można uzyskać za pośrednictwem co najmniej jednego powiązania usług IIS. Powiązania usług IIS zapewniają dwie informacje: protokół powiązania i informacje o powiązaniu. Protokół powiązania (na przykład HTTP) definiuje schemat, w którym odbywa się komunikacja, a informacje o powiązaniu (na przykład adres IP, port, nagłówek hosta) zawierają dane używane do uzyskiwania dostępu do witryny.

Usługi IIS obsługują określanie wielu powiązań usług IIS dla każdej lokacji, co powoduje wiele adresów bazowych dla każdego schematu. Ponieważ usługa WCF hostowana w lokacji umożliwia powiązanie tylko jednego adresu podstawowego dla każdego schematu, można użyć funkcji filtru prefiksu, aby wybrać wymagany adres podstawowy hostowanej usługi. Przychodzące adresy podstawowe dostarczane przez usługi IIS są filtrowane na podstawie opcjonalnego filtru listy prefiksów.

Na przykład witryna może zawierać następujące adresy podstawowe:

http://testl.fabrikam.com/Service.svc  
http://test2.fabrikam.com/Service.svc

Poniższy plik konfiguracji umożliwia określenie filtru prefiksu na poziomie domeny aplikacji.

<system.serviceModel>
  <serviceHostingEnvironment>
    <baseAddressPrefixFilters>
      <add prefix="net.tcp://test1.fabrikam.com:8000" />
      <add prefix="http://test2.fabrikam.com:9000" />
    </baseAddressPrefixFilters>
  </serviceHostingEnvironment>
</system.serviceModel>

W tym przykładzie net.tcp://test1.fabrikam.com:8000 i http://test2.fabrikam.com:9000 są jedynymi adresami podstawowymi odpowiednich schematów, które mogą być przekazywane.

Domyślnie, gdy prefiks nie jest określony, wszystkie adresy są przekazywane. Określenie prefiksu zezwala tylko na przekazywanie pasującego adresu podstawowego dla tego schematu.

Uwaga

Filtr nie obsługuje żadnych symboli wieloznacznych. Ponadto adresy baseAddresses dostarczone przez usługi IIS mogą mieć adresy powiązane z innymi schematami, które nie znajdują się na baseAddressPrefixFilters liście. Te adresy nie są odfiltrowane.

Udostępnij za pośrednictwem