UrlMappingCollection.Clear 方法

public:
 void Clear();

public void Clear();

member this.Clear : unit -> unit

Public Sub Clear ()

範例

以下程式碼範例將移除所有UrlMapping物件。UrlMappingCollection

參考課堂主題中的 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 所適用的條件：

• 如果你將 or 作為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