BaseAddressPrefixFilterElement 類別

定義

表示指定通過篩選條件的組態元素,如此便提供一項機制,可在將 Windows Communication Foundation (WCF) 應用程式裝載於 IIS 時挑選適當的 IIS 繫結。 此類別無法獲得繼承。

public ref class BaseAddressPrefixFilterElement sealed : System::Configuration::ConfigurationElement
public sealed class BaseAddressPrefixFilterElement : System.Configuration.ConfigurationElement
type BaseAddressPrefixFilterElement = class
    inherit ConfigurationElement
Public NotInheritable Class BaseAddressPrefixFilterElement
Inherits ConfigurationElement
繼承
BaseAddressPrefixFilterElement

備註

前置詞篩選準則提供者是一種機制,可讓服務系結至特定的 URI。 它可讓您在相同的網站上裝載多個應用程式,而且相同的配置具有不同的基底位址。

IIS 網站是包含虛擬目錄的虛擬應用程式的容器。 網站中的應用程式則可以透過一個或多個 IIS 繫結來存取。 IIS 繫結提供繫結通訊協定和繫結這兩項資訊。 系結通訊協定 (例如,HTTP) 定義進行通訊的配置,而系結資訊 (例如 IPAddress、Port、主機標頭) 包含用來存取網站的資料。

IIS 支援為每個網站指定多個 IIS 繫結,讓每個配置能夠有多個基底位址。 由於裝載在網站下的 WCF 服務只允許每個配置系結至一個基底位址,因此您可以使用前置詞篩選功能來挑選託管服務所需的基底位址。 IIS 提供的傳入基底位址會依據選擇性的前置詞清單篩選條件進行篩選。

例如,您的網站可能包含下列基底位址:

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

您可以使用下列組態檔在 appdomain 層級指定前置詞篩選條件。

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

在此範例中,net.tcp://test1.fabrikam.com:8000http://test2.fabrikam.com:9000 分別是其配置的唯一基底位址,而且已被允許通過篩選。

根據預設,如果沒有指定前置詞,則所有位址都會通過。 如果指定前置詞,將造成只有符合該配置的基底位址能夠通過篩選。

注意

篩選條件不支援任何萬用字元。 此外,IIS 提供的 baseAddress 中,可能會有位址繫結程序至不在 baseAddressPrefixFilters 清單中的配置, 而且這些位址尚未經過篩選。

建構函式

BaseAddressPrefixFilterElement()

初始化 BaseAddressPrefixFilterElement 類別的新執行個體。

BaseAddressPrefixFilterElement(Uri)

使用特定 URI 初始化 BaseAddressPrefixFilterElement 類別的新執行個體。

屬性

CurrentConfiguration

取得最上層 Configuration 執行個體的參考,這個執行個體表示目前 ConfigurationElement 執行個體所屬的組態階層架構。

(繼承來源 ConfigurationElement)
ElementInformation

取得 ElementInformation 物件,其中包含 ConfigurationElement 物件之不可自訂的資訊和功能。

(繼承來源 ConfigurationElement)
ElementProperty

取得表示 ConfigurationElementProperty 物件本身的 ConfigurationElement 物件。

(繼承來源 ConfigurationElement)
EvaluationContext

取得 ConfigurationElement 物件的 ContextInformation 物件。

(繼承來源 ConfigurationElement)
HasContext

取得值,指出 CurrentConfiguration 屬性是否為 null

(繼承來源 ConfigurationElement)
Item[ConfigurationProperty]

取得或設定此組態項目的屬性 (Property) 或屬性 (Attribute)。

(繼承來源 ConfigurationElement)
Item[String]

取得或設定此一組態項目的屬性或子項目。

(繼承來源 ConfigurationElement)
LockAllAttributesExcept

取得已鎖定屬性的集合。

(繼承來源 ConfigurationElement)
LockAllElementsExcept

取得已鎖定項目的集合。

(繼承來源 ConfigurationElement)
LockAttributes

取得已鎖定屬性的集合。

(繼承來源 ConfigurationElement)
LockElements

取得已鎖定項目的集合。

(繼承來源 ConfigurationElement)
LockItem

取得或設定值,指出此項目是否已被鎖定。

(繼承來源 ConfigurationElement)
Prefix

取得或設定用於比對部分基底位址的前置詞。

Properties

取得屬性的集合。

(繼承來源 ConfigurationElement)

方法

DeserializeElement(XmlReader, Boolean)

從組態檔讀取 XML。

(繼承來源 ConfigurationElement)
Equals(Object)

將目前的 ConfigurationElement 執行個體與指定的物件相比較。

(繼承來源 ConfigurationElement)
GetHashCode()

取得表示目前 ConfigurationElement 執行個體的唯一值。

(繼承來源 ConfigurationElement)
GetTransformedAssemblyString(String)

傳回指定之組件名稱的轉換版本。

(繼承來源 ConfigurationElement)
GetTransformedTypeString(String)

傳回指定之型別名稱的轉換版本。

(繼承來源 ConfigurationElement)
GetType()

取得目前執行個體的 Type

(繼承來源 Object)
Init()

ConfigurationElement 物件設定為它的初始狀態。

(繼承來源 ConfigurationElement)
InitializeDefault()

用來初始化 ConfigurationElement 物件的預設值集。

(繼承來源 ConfigurationElement)
IsModified()

在衍生類別中進行實作時,指出這個組態項目自上次儲存或載入後是否已修改。

(繼承來源 ConfigurationElement)
IsReadOnly()

取得值,這個值表示 ConfigurationElement 物件是否唯讀。

(繼承來源 ConfigurationElement)
ListErrors(IList)

將這個 ConfigurationElement 物件中和所有子項目中的無效屬性錯誤加入傳遞的清單。

(繼承來源 ConfigurationElement)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
OnDeserializeUnrecognizedAttribute(String, String)

取得值,指出在還原序列化程序中是否遇到未知的屬性 (Attribute)。

(繼承來源 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

取得值,指出在還原序列化程序中是否遇到未知的項目。

(繼承來源 ConfigurationElement)
OnRequiredPropertyNotFound(String)

在找不到必要的屬性時擲回例外狀況 (Exception)。

(繼承來源 ConfigurationElement)
PostDeserialize()

還原序列化之後呼叫。

(繼承來源 ConfigurationElement)
PreSerialize(XmlWriter)

序列化之前呼叫。

(繼承來源 ConfigurationElement)
Reset(ConfigurationElement)

重設 ConfigurationElement 物件的內部狀態,包括鎖定和屬性的集合。

(繼承來源 ConfigurationElement)
ResetModified()

在衍生類別中實作時,將 IsModified() 方法的值重設為 false

(繼承來源 ConfigurationElement)
SerializeElement(XmlWriter, Boolean)

在衍生類別中實作時,將此組態項目的內容寫入組態檔中。

(繼承來源 ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)

在衍生類別中實作時,將此組態項目的外部標記寫入組態檔中。

(繼承來源 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

將屬性設定為指定的值。

(繼承來源 ConfigurationElement)
SetReadOnly()

設定 IsReadOnly() 物件和所有子項目的 ConfigurationElement 屬性。

(繼承來源 ConfigurationElement)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

修改 ConfigurationElement 物件,以移除不應該儲存的所有值。

(繼承來源 ConfigurationElement)

適用於