UrlMappingCollection.Clear Метод

Определение

Пространство имен:

System.Web.Configuration

Сборка:

System.Web.dll

Удаляет все объекты UrlMapping из коллекции.

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 метода для сохранения файла:

• При передаче Full или ConfigurationSaveMode.Modified значении параметра clear элемент вставляется в urlMappings раздел файла конфигурации на текущем уровне иерархии.

• При передаче Minimal в качестве значения параметра в файл конфигурации на текущем уровне иерархии добавляется urlMappings ряд remove элементов. Эти remove элементы удаляют все ссылки на элементы, add определенные в родительских файлах конфигурации, на более высоких уровнях иерархии. Minimal При значении перечисления в коллекции есть одно дополнительное свойство, которое влияет на сериализацию в файл конфигурации. Свойство имеет значение EmitClear по false умолчанию. Применяется одно из следующих условий:

  • EmitClear задано значение true. Элемент clear вставляется в urlMappings раздел файла конфигурации на текущем уровне иерархии. При этом удаляются все ссылки на элементы, add определенные в родительских файлах конфигурации, на более высоких уровнях иерархии.

  • EmitClear Для флага задано значение false. Это влияет на удаление clear элемента из urlMappings раздела файла конфигурации на текущем уровне иерархии, если он существует.

Метод Clear фактически удаляет add элементы, определенные в urlMappings разделе файла конфигурации на текущем уровне иерархии. Он также удаляет все ссылки на элементы, add определенные в родительских файлах конфигурации, на более высоких уровнях иерархии, но не удаляет их.

См. также раздел

• UrlMapping
• UrlMappingsSection