共用方式為


可延伸物件

可延伸物件模式是用於以新功能延伸現有的執行階段類別,或將新狀態新增至物件。附加至其中一個可擴充物件的擴充功能會在處理程序中的各種不同階段啟用行為,以存取附加至它們可存取之一般可擴充物件的共用狀態與功能。

IExtensibleObject<T> 模式

在可延伸物件模式中有三種介面:IExtensibleObjectIExtensionIExtensionCollection

IExtensibleObject 介面是由允許 IExtension 物件自訂其功能的類型所實作的。

可延伸物件允許 IExtension 物件的動態彙總。IExtension 物件是使用下列介面來描述特徵:

public interface IExtension<T>
where T : IExtensibleObject<T>
{
    void Attach(T owner);
    void Detach(T owner);
}

類型限制可保證只能定義做為 IExtensibleObject 之類別的延伸。AttachDetach 提供了彙總或分解的通知。

對於限制何時可新增及從擁有者中移除的實作是有效的。例如,您可以不允許整個移除、不允許在擁有者或延伸處於特定狀態時新增或移除延伸、不允許同時新增多個擁有者,或只允許單一新增後接著單一移除。

IExtension 不代表與其他標準 Managed 介面的任何互動。特別是,擁有者物件上的 System.IDisposable.Dispose 方法通常不會中斷連結它的延伸。

當延伸新增至集合時,會在它進入集合之前呼叫 Attach。當從集合中移除延伸時,會在移除之後呼叫 Detach。這表示 (假定適當的同步化) 延伸在 AttachDetach 之間時,可以只在集合中找到。

傳遞至 FindAllFind 的物件不需要是 IExtension (例如,您可以傳遞任何物件),但是傳回的延伸是 IExtension

如果集合中沒有延伸是 IExtensionFind 會傳回 null,而 FindAll 會傳回空集合。如果多個延伸實作 IExtensionFind 會傳回它們其中之一。從 FindAll 傳回的值是快照。

有兩個主要案例。第一個案例是使用 Extensions 屬性做為型別字典,將狀態插入物件,讓另一個元件可使用型別來查閱它。

第二個案例是使用 AttachDetach 屬性,讓物件可參與自訂行為,例如註冊事件、監看狀態轉換等等。

IExtensionCollection 介面是允許依其型別來擷取 IExtensionIExtension 物件的集合。System.ServiceModel.IExtensionCollection.Find 會傳回最近新增的物件,它是該型別的 IExtension

Windows Communication Foundation 中的可延伸物件

Windows Communication Foundation (WCF) 有四種可延伸物件︰

  • ServiceHostBase – 這是服務之主機的基底類別。這個類別的延伸可用於延伸 ServiceHostBase 本身的行為,或儲存各服務的狀態。

  • InstanceContext – 這個類別會連接服務類型的執行個體與服務執行階段。其中包含有關執行個體的資訊,以及包含 ServiceHostBaseInstanceContext 的參照。這個類別的延伸可用於延伸 InstanceContext 的行為,或儲存各服務的狀態。

  • OperationContext – 這個類別代表執行階段為各作業蒐集的作業資訊。其中包括的資訊如傳入訊息標頭、傳入訊息屬性、傳入安全性身分識別和其他資訊。這個類別的延伸可以延伸 OperationContext 的行為,或儲存各作業的狀態。

  • IContextChannel – 這個介面允許檢查由 WCF 執行階段所建置的通道和 Proxy 的各個狀態。這個類別的延伸可以延伸 IClientChannel 的行為,或可用它來儲存各通道的狀態。

下列程式碼範例將示範如何使用簡單的延伸來追蹤 InstanceContext 物件。

另請參閱

參考

IExtensibleObject
IExtension
IExtensionCollection