UrlMappingCollection.Clear 方法

定義

命名空間:

System.Web.Configuration

組件:

System.Web.dll

從集合中移除所有的 UrlMapping 物件。

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

範例

下列程式碼範例會從 UrlMappingCollection 移除所有 UrlMapping 物件。

請參閱類別主題中的 UrlMappingCollection 程式碼範例，以瞭解如何取得集合。

// Clear the url mapping collection.
urlMappings.Clear();

// Update the configuration file.

// Define the save modality.
ConfigurationSaveMode saveMode =
  ConfigurationSaveMode.Minimal;

urlMappings.EmitClear =
   Convert.ToBoolean(parm2);

if (parm1 == "none")
{
  if (!urlMappingSection.IsReadOnly())
    configuration.Save();
  msg = String.Format(
  "Default modality, EmitClear:      {0}",
  urlMappings.EmitClear.ToString());
}
else
{
  if (parm1 == "full")
    saveMode = ConfigurationSaveMode.Full;
  else
    if (parm1 == "modified")
      saveMode = ConfigurationSaveMode.Modified;

  if (!urlMappingSection.IsReadOnly())
    configuration.Save(saveMode);

  msg = String.Format(
   "Save modality:      {0}",
   saveMode.ToString());
}

' Clear the url mapping collection.
urlMappings.Clear()

' Update the configuration file.
' Define the save modality.
Dim saveMode _
As ConfigurationSaveMode = _
ConfigurationSaveMode.Minimal

urlMappings.EmitClear = _
Convert.ToBoolean(parm2)

If parm1 = "none" Then
    If Not urlMappingSection.IsReadOnly() Then
        configuration.Save()
    End If
    msg = String.Format( _
    "Default modality, EmitClear:      {0}", _
    urlMappings.EmitClear.ToString())
Else
    If parm1 = "full" Then
        saveMode = ConfigurationSaveMode.Full
    ElseIf parm1 = "modified" Then
        saveMode = ConfigurationSaveMode.Modified
    End If
    If Not urlMappingSection.IsReadOnly() Then
        configuration.Save(saveMode)
    End If
    msg = String.Format( _
    "Save modality:      {0}", _
    saveMode.ToString())
End If

備註

如果您在呼叫 Clear 方法之後儲存組態檔，結果將會相依于所選擇的 ConfigurationSaveMode 。

下列清單描述如果您使用 Save 方法來儲存檔案，則適用的條件：

• 如果您傳遞 Full 或 ConfigurationSaveMode.Modified 做為參數值， clear 專案會 urlMappings 插入組態檔目前階層層級的 區段中。

• 如果您傳遞 Minimal 做為參數值，則會將一系列 remove 專案新增至 urlMappings 目前階層層級之組態檔的 。 這些 remove 元素會移除階層中較高層級上父組態檔中定義之元素的所有參考 add 。 Minimal使用 列舉值時，集合上有一個額外的屬性會影響序列化至組態檔的專案。 屬性預設為 EmitClear ，且為 false 。 適用下列其中一個條件：

  • EmitClear 設定為 true 。 元素 clear 會 urlMappings 插入組態檔目前階層層級的 區段中。 這會移除階層中較高層級上父組態檔中定義之專案的所有參考 add 。

  • EmitClear 旗標設定為 false 。 如果組態檔存在於目前階層層級，則會從組態檔的 區段中移除 clear 元素 urlMappings 的效果。

方法 Clear 實際上會刪除 add 目前階層層級組態檔區段中定義的 urlMappings 專案。 它也會移除階層中較高層級上父組態檔中定義之專案的所有參考 add ，但不會刪除這些專案。

另請參閱

• UrlMapping
• UrlMappingsSection