FilterElement.FilterData 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定這個組態項目的篩選資料。
public:
property System::String ^ FilterData { System::String ^ get(); void set(System::String ^ value); };
[System.Configuration.ConfigurationProperty("filterData", DefaultValue=null, Options=System.Configuration.ConfigurationPropertyOptions.None)]
public string FilterData { get; set; }
[<System.Configuration.ConfigurationProperty("filterData", DefaultValue=null, Options=System.Configuration.ConfigurationPropertyOptions.None)>]
member this.FilterData : string with get, set
Public Property FilterData As String
屬性值
這個項目的篩選資料。
- 屬性
備註
下表根據 FilterData 的值描述 FilterType 的意義。
篩選條件類型 | 描述 | 篩選資料意義 | 範例篩選 |
---|---|---|---|
動作 | 使用 WCF 提供的 ActionMessageFilter。 | 要進行篩選的動作。 | <filter name="action1" filterType="Action" filterData="http://ACTION" /> |
位址 | 使用 WCF 提供的 EndpointAddressMessageFilter,其中忽略主機名稱 == true。 | 要篩選的位址 (在 [收件者] 標頭中)。 | <filter name="address1" filterType="Address" filterData="http://host/vdir/s.svc/b" /> |
AddressPrefix | 使用 WCF 提供的 PrefixEndpointAddressMessageFilter,其中忽略主機名稱 == true。 | 要使用最長的前置詞比對篩選的位址。 | <filter name="prefix1" filterType="AddressPrefix" filterData="http://host" /> |
StrictAnd | 自訂 AndMessageFilter,會固定在傳回之前評估兩個條件。 | 不會使用 filterData,filter1 和 filter2 會改為包含對應訊息篩選的名稱 (同樣在資料表中),兩者應以 AND 連結。 | <filter name="and1" filterType="And" filter1="address1" filter2="action1" /> |
自訂 | 使用者定義類型,該類型會延伸 MessageFilter 並且擁有取用字串的建構函式。 | customType 屬性是要建立之類別的完整類型名稱,filterData 則是建立篩選時,要傳遞至建構函式的字串。 | <filter name="custom1" filterType="Custom" customType="CustomAssembly.CustomMsgFilter, CustomAssembly" filterData="Custom Data" /> |
EndpointName | 僅用於路由服務的自訂訊息篩選,會根據服務端點的名稱篩選訊息。 | 服務端點的名稱,例如: "serviceEndpoint1"。 這應該是在路由服務上公開的其中一個端點。 | <filter name="stock1" filterType="Endpoint" filterData="SvcEndpoint" /> |
MatchAll | 使用 WCF 提供的 MatchAllMessageFilter。 | N/A | <filter name="matchAll1" filterType="MatchAll" /> |
XPath | 使用 WCF 提供的 XPathMessageFilter。 | 比對訊息時使用的 XPath 查詢。 | <filter name="XPath1" filterType="XPath" filterData="//ns:element" /> |