BackupEndpointCollection 類別

定義

命名空間:

System.ServiceModel.Routing.Configuration

組件:

System.ServiceModel.Routing.dll

表示組態專案，其中包含 BackupEndpointElement 物件的集合。

public ref class BackupEndpointCollection : System::Configuration::ConfigurationElementCollection

[System.Configuration.ConfigurationCollection(typeof(System.ServiceModel.Routing.Configuration.BackupEndpointElement))]
public class BackupEndpointCollection : System.Configuration.ConfigurationElementCollection

[<System.Configuration.ConfigurationCollection(typeof(System.ServiceModel.Routing.Configuration.BackupEndpointElement))>]
type BackupEndpointCollection = class
    inherit ConfigurationElementCollection

Public Class BackupEndpointCollection
Inherits ConfigurationElementCollection

繼承

Object

ConfigurationElement

ConfigurationElementCollection

BackupEndpointCollection

屬性

ConfigurationCollectionAttribute

備註

BackupEndpointCollection 包含已排序的端點集合，訊息會在傳送至主要端點時發生通訊例外狀況時傳送至該端點。

如果傳送至 EndpointName 中包含的主要端點失敗，通訊例外狀況會失敗，路由服務會嘗試將訊息傳送至 BackupEndpointCollection中包含的第一個端點。 如果這也會因為通訊例外狀況而失敗，路由服務會嘗試將訊息傳送至集合中包含的下一個端點，直到傳送嘗試成功、傳回通訊例外狀況以外的失敗，或集合中的所有端點都傳回失敗為止。

在下列範例中，如果傳送至名為 「Destination」 的主要端點傳回通訊例外狀況，服務會嘗試將訊息傳送至 「alternateServiceQueue」。。 如果此嘗試也會傳回通訊例外狀況，路由服務會嘗試將訊息傳送至集合中的下一個端點。

<filterTables>  
     <filterTable name="filterTable1">  
          <add filterName="MatchAllFilter1" endpointName="Destination" backupList="backupEndpointList"/>  
     </filterTable>  
</filterTables>  
<backupLists>  
     <backupList name="backupEndpointList">  
          <add endpointName="backupServiceQueue" />  
          <add endpointName="alternateServiceQueue" />  
     </backupList>  
</backupLists>  

建構函式

BackupEndpointCollection()

建立 BackupEndpointCollection 類別的新實例。

屬性

AddElementName	取得或設定在衍生類別中覆寫時，要與 ConfigurationElementCollection 中加入作業產生關聯的 ConfigurationElement 名稱。 (繼承來源 ConfigurationElementCollection)
ClearElementName	取得或設定在衍生類別中覆寫時，要與 ConfigurationElementCollection 中的清除作業產生關聯的 ConfigurationElement 名稱。 (繼承來源 ConfigurationElementCollection)
CollectionType	取得 ConfigurationElementCollection的型別。 (繼承來源 ConfigurationElementCollection)
Count	取得集合中的項目數目。 (繼承來源 ConfigurationElementCollection)
CurrentConfiguration	取得最上層 Configuration 實例的參考，表示目前 ConfigurationElement 實例所屬的組態階層。 (繼承來源 ConfigurationElement)
ElementInformation	取得 ElementInformation 物件，其中包含 ConfigurationElement 物件的不可自定義資訊和功能。 (繼承來源 ConfigurationElement)
ElementName	取得在衍生類別中覆寫時，用來識別組態檔中專案集合的名稱。 (繼承來源 ConfigurationElementCollection)
ElementProperty	取得代表 ConfigurationElement 物件本身的 ConfigurationElementProperty 物件。 (繼承來源 ConfigurationElement)
EmitClear	取得或設定值，指定是否已清除集合。 (繼承來源 ConfigurationElementCollection)
EvaluationContext	取得 ConfigurationElement 物件的 ContextInformation 物件。 (繼承來源 ConfigurationElement)
HasContext	取得值，這個值表示 CurrentConfiguration 屬性是否 null。 (繼承來源 ConfigurationElement)
IsSynchronized	取得值，指出是否同步存取集合。 (繼承來源 ConfigurationElementCollection)
Item[ConfigurationProperty]	取得或設定這個組態項目的屬性或屬性。 (繼承來源 ConfigurationElement)
Item[String]	取得或設定這個組態專案的屬性、屬性或子專案。 (繼承來源 ConfigurationElement)
LockAllAttributesExcept	取得鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockAllElementsExcept	取得鎖定專案的集合。 (繼承來源 ConfigurationElement)
LockAttributes	取得鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockElements	取得鎖定專案的集合。 (繼承來源 ConfigurationElement)
LockItem	取得或設定值，指出專案是否已鎖定。 (繼承來源 ConfigurationElement)
Name	取得或設定用來識別組態檔中專案集合的名稱。
Properties	取得屬性的集合。 (繼承來源 ConfigurationElement)
RemoveElementName	取得或設定在衍生類別中覆寫時，要與 ConfigurationElementCollection 中移除作業產生關聯的 ConfigurationElement 名稱。 (繼承來源 ConfigurationElementCollection)
SyncRoot	取得對象，這個物件用來同步處理對 ConfigurationElementCollection的存取。 (繼承來源 ConfigurationElementCollection)
ThrowOnDuplicate	取得值，指出是否嘗試將重複 ConfigurationElement 加入至 ConfigurationElementCollection 會導致擲回例外狀況。 (繼承來源 ConfigurationElementCollection)

方法

Add(BackupEndpointElement)	將新的 BackupEndpointElement 加入至集合。
BaseAdd(ConfigurationElement, Boolean)	將組態專案加入至組態專案集合。 (繼承來源 ConfigurationElementCollection)
BaseAdd(ConfigurationElement)	將群組態專案加入至 ConfigurationElementCollection。 (繼承來源 ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	將組態專案加入至組態專案集合。 (繼承來源 ConfigurationElementCollection)
BaseClear()	從集合中移除所有組態項目物件。 (繼承來源 ConfigurationElementCollection)
BaseGet(Int32)	取得位於指定索引位置的組態專案。 (繼承來源 ConfigurationElementCollection)
BaseGet(Object)	傳回具有指定索引鍵的組態專案。 (繼承來源 ConfigurationElementCollection)
BaseGetAllKeys()	針對包含在 ConfigurationElementCollection中的所有組態項目，傳回索引鍵的陣列。 (繼承來源 ConfigurationElementCollection)
BaseGetKey(Int32)	取得位於指定索引位置之 ConfigurationElement 的索引鍵。 (繼承來源 ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	表示指定之 ConfigurationElement的索引。 (繼承來源 ConfigurationElementCollection)
BaseIsRemoved(Object)	指出是否已從 ConfigurationElementCollection中移除具有指定索引鍵的 ConfigurationElement。 (繼承來源 ConfigurationElementCollection)
BaseRemove(Object)	從集合中移除 ConfigurationElement。 (繼承來源 ConfigurationElementCollection)
BaseRemoveAt(Int32)	拿掉位於指定索引位置的 ConfigurationElement。 (繼承來源 ConfigurationElementCollection)
Clear()	從集合中移除所有專案。
CopyTo(ConfigurationElement[], Int32)	將 ConfigurationElementCollection 的內容複製到陣列。 (繼承來源 ConfigurationElementCollection)
CreateNewElement()	建立新的 ConfigurationElement。
CreateNewElement(String)	在衍生類別中覆寫時，建立新的 ConfigurationElement。 (繼承來源 ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	從組態檔讀取 XML。 (繼承來源 ConfigurationElement)
Equals(Object)	比較 ConfigurationElementCollection 與指定的物件。 (繼承來源 ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	取得指定組態專案的專案索引鍵。
GetEnumerator()	取得用來逐一查看 ConfigurationElementCollection的 IEnumerator。 (繼承來源 ConfigurationElementCollection)
GetHashCode()	取得代表 ConfigurationElementCollection 實例的唯一值。 (繼承來源 ConfigurationElementCollection)
GetTransformedAssemblyString(String)	傳回所指定元件名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetTransformedTypeString(String)	傳回指定之型別名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
Init()	將 ConfigurationElement 物件設定為其初始狀態。 (繼承來源 ConfigurationElement)
InitializeDefault()	用來初始化 ConfigurationElement 物件的預設值集。 (繼承來源 ConfigurationElement)
IsElementName(String)	指出指定的 ConfigurationElement 是否存在於 ConfigurationElementCollection中。 (繼承來源 ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	指出是否可以從 ConfigurationElementCollection中移除指定的 ConfigurationElement。 (繼承來源 ConfigurationElementCollection)
IsModified()	指出此 ConfigurationElementCollection 自上次儲存或載入衍生類別時是否已修改。 (繼承來源 ConfigurationElementCollection)
IsReadOnly()	指出 ConfigurationElementCollection 物件是否為唯讀。 (繼承來源 ConfigurationElementCollection)
ListErrors(IList)	將這個 ConfigurationElement 物件和所有子元素中的無效屬性錯誤新增至傳遞的清單。 (繼承來源 ConfigurationElement)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
OnDeserializeUnrecognizedAttribute(String, String)	取得值，指出還原串行化期間是否遇到未知的屬性。 (繼承來源 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	導致組態系統擲回例外狀況。 (繼承來源 ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)	找不到必要屬性時擲回例外狀況。 (繼承來源 ConfigurationElement)
PostDeserialize()	在還原串行化之後呼叫。 (繼承來源 ConfigurationElement)
PreSerialize(XmlWriter)	在串行化之前呼叫。 (繼承來源 ConfigurationElement)
Remove(BackupEndpointElement)	從集合中移除第一個出現的 BackupEndpointElement。
Reset(ConfigurationElement)	在衍生類別中覆寫時，將 ConfigurationElementCollection 重設為其未修改的狀態。 (繼承來源 ConfigurationElementCollection)
ResetModified()	在衍生類別中覆寫時，將 IsModified() 屬性的值重設為 false。 (繼承來源 ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	在衍生類別中覆寫時，將組態數據寫入組態檔中的 XML 專案。 (繼承來源 ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	在衍生類別中實作時，將此組態專案的外部標記寫入組態檔。 (繼承來源 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	將屬性設定為指定的值。 (繼承來源 ConfigurationElement)
SetReadOnly()	設定 ConfigurationElementCollection 物件和所有子元素的 IsReadOnly() 屬性。 (繼承來源 ConfigurationElementCollection)
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	反轉從不同組態階層層級合併組態資訊的效果。 (繼承來源 ConfigurationElementCollection)

明確介面實作

ICollection.CopyTo(Array, Int32)

將 ConfigurationElementCollection 複製到陣列。 (繼承來源 ConfigurationElementCollection)

擴充方法

Cast<TResult>(IEnumerable)	將 IEnumerable 的項目轉換成指定的型別。
OfType<TResult>(IEnumerable)	根據指定的型別篩選 IEnumerable 的專案。
AsParallel(IEnumerable)	啟用查詢的平行處理。
AsQueryable(IEnumerable)	將 IEnumerable 轉換成 IQueryable。