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使用枚举值时，集合上有一个附加属性，该属性会影响序列化到配置文件的内容。 The property is EmitClear and is false by default. 以下条件之一适用：

  • EmitClear 设置为 true. clear元素将插入到urlMappings当前层次结构级别的配置文件部分。 这会删除对 add 层次结构中较高级别父配置文件中定义的元素的所有引用。

  • EmitClear 标志设置为 false. 这会影响从当前层次结构级别的配置文件部分中删除 clear 元素 urlMappings （如果存在）。

该方法 Clear 实际上删除 add 在当前层次结构级别的配置文件节中 urlMappings 定义的元素。 它还删除对 add 层次结构中较高级别父配置文件中定义的元素的所有引用，但不删除它们。

另请参阅

• UrlMapping
• UrlMappingsSection