UrlMappingCollection 類別

定義

命名空間:

System.Web.Configuration

組件:

System.Web.dll

代表一組 UrlMapping 物件。 此類別無法獲得繼承。

public ref class UrlMappingCollection sealed : System::Configuration::ConfigurationElementCollection

[System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.UrlMapping))]
public sealed class UrlMappingCollection : System.Configuration.ConfigurationElementCollection

[<System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.UrlMapping))>]
type UrlMappingCollection = class
    inherit ConfigurationElementCollection

Public NotInheritable Class UrlMappingCollection
Inherits ConfigurationElementCollection

繼承

Object

ConfigurationElement

ConfigurationElementCollection

UrlMappingCollection

屬性

ConfigurationCollectionAttribute

範例

以下程式碼範例說明如何從現有網頁應用程式的設定檔取得該 UrlMappingCollection 物件。 同時也展示了設定檔的部分摘錄。

<urlMappings enabled="true">
  <add url= "~/home.aspx"
    mappedUrl="~/default.aspx?parm1=1"/>
  <add url= "~/products.aspx"
    mappedUrl="~/default.aspx?parm1=2"/>
</urlMappings>

// Get the Web application configuration.
System.Configuration.Configuration configuration =
    WebConfigurationManager.OpenWebConfiguration(
    "/aspnetTest");

// Get the <urlMapping> section.
UrlMappingsSection urlMappingSection =
  (UrlMappingsSection)configuration.GetSection(
  "system.web/urlMappings");


// Get the url mapping collection.
UrlMappingCollection urlMappings =
  urlMappingSection.UrlMappings;

' Get the Web application configuration.
Dim configuration _
As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")

' Get the <urlMapping> section.
Dim urlMappingSection _
As UrlMappingsSection = _
CType(configuration.GetSection( _
"system.web/urlMappings"), UrlMappingsSection)

' Get the url mapping collection.
Dim urlMappings _
As UrlMappingCollection = _
urlMappingSection.UrlMappings

備註

該 UrlMappingCollection 型別允許存取 UrlMappings 區段元素集合中的 UrlMappingsSection 元素。

建構函式

名稱	Description
UrlMappingCollection()	初始化 UrlMappingCollection 類別的新執行個體。

屬性

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

方法

名稱	Description
Add(UrlMapping)	將指定的 UrlMapping 資料加入集合。
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)	指出是否已從 ConfigurationElement中移除具有指定索引鍵的 ConfigurationElementCollection。 (繼承來源 ConfigurationElementCollection)
BaseRemove(Object)	從集合中移除 ConfigurationElement。 (繼承來源 ConfigurationElementCollection)
BaseRemoveAt(Int32)	拿掉位於指定索引位置的 ConfigurationElement。 (繼承來源 ConfigurationElementCollection)
Clear()	移除集合中的所有 UrlMapping 物件。
CopyTo(ConfigurationElement[], Int32)	將 ConfigurationElementCollection 的內容複製到陣列。 (繼承來源 ConfigurationElementCollection)
CreateNewElement()	在衍生類別中覆寫時，建立新的 ConfigurationElement。 (繼承來源 ConfigurationElementCollection)
CreateNewElement(String)	在衍生類別中覆寫時，建立新的 ConfigurationElement。 (繼承來源 ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	從組態檔讀取 XML。 (繼承來源 ConfigurationElement)
Equals(Object)	比較 ConfigurationElementCollection 與指定的物件。 (繼承來源 ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	在衍生類別中覆寫時，取得指定組態專案的專案索引鍵。 (繼承來源 ConfigurationElementCollection)
GetEnumerator()	得到IEnumerator一個 ，用於迭代 。ConfigurationElementCollection (繼承來源 ConfigurationElementCollection)
GetHashCode()	取得代表 ConfigurationElementCollection 實例的唯一值。 (繼承來源 ConfigurationElementCollection)
GetKey(Int32)	取得指定元素的集合鍵。
GetTransformedAssemblyString(String)	傳回所指定元件名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetTransformedTypeString(String)	傳回指定之型別名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
Init()	將 ConfigurationElement 物件設定為其初始狀態。 (繼承來源 ConfigurationElement)
InitializeDefault()	用來初始化 ConfigurationElement 物件的預設值集。 (繼承來源 ConfigurationElement)
IsElementName(String)	指出指定的 ConfigurationElement 是否存在於 ConfigurationElementCollection中。 (繼承來源 ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	指出是否可以從 ConfigurationElement中移除指定的 ConfigurationElementCollection。 (繼承來源 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(String)	從集合中移除 UrlMapping 指定名稱的物件。
Remove(UrlMapping)	從集合中移除指定的 UrlMapping 物件。
RemoveAt(Int32)	從集合中移除 UrlMapping 具有指定索引的物件。
Reset(ConfigurationElement)	在衍生類別中覆寫時，將 ConfigurationElementCollection 重設為其未修改的狀態。 (繼承來源 ConfigurationElementCollection)
ResetModified()	在衍生類別中覆寫時，將 IsModified() 屬性的值重設為 false。 (繼承來源 ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	在衍生類別中覆寫時，將組態數據寫入組態檔中的 XML 專案。 (繼承來源 ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	在衍生類別中實作時，將此組態專案的外部標記寫入組態檔。 (繼承來源 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	將屬性設定為指定的值。 (繼承來源 ConfigurationElement)
SetReadOnly()	設定 IsReadOnly() 物件和所有子元素的 ConfigurationElementCollection 屬性。 (繼承來源 ConfigurationElementCollection)
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	反轉從不同組態階層層級合併組態資訊的效果。 (繼承來源 ConfigurationElementCollection)

明確介面實作

名稱	Description
ICollection.CopyTo(Array, Int32)	將 ConfigurationElementCollection 複製到陣列。 (繼承來源 ConfigurationElementCollection)

擴充方法

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

另請參閱

• UrlMapping
• UrlMappingsSection