UrlMappingCollection.Clear Método

Definição

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

Remove todos os objetos UrlMapping da coleção.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Exemplos

O exemplo de código a seguir remove todos os UrlMapping objetos do UrlMappingCollection.

Consulte o exemplo de código no tópico de UrlMappingCollection classe para saber como obter a coleção.

// 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

Comentários

Se você salvar o arquivo de configuração depois de chamar o Clear método, o resultado dependerá do escolhido ConfigurationSaveMode.

A lista a seguir descreve as condições que se aplicam se você usar o Save método para salvar o arquivo:

• Se você passar Full ou ConfigurationSaveMode.Modified como o valor do parâmetro, um clear elemento será inserido na urlMappings seção do arquivo de configuração no nível da hierarquia atual.

• Se você passar Minimal como o valor do parâmetro, uma série de remove elementos será adicionada ao urlMappings arquivo de configuração no nível da hierarquia atual. Esses remove elementos removem todas as referências aos add elementos definidos nos arquivos de configuração pai em níveis mais altos na hierarquia. Com o valor de Minimal enumeração, há uma propriedade adicional na coleção que afeta o que é serializado para o arquivo de configuração. A propriedade é EmitClear e é false por padrão. Uma das seguintes condições se aplica:

  • EmitClear definido como true. Um clear elemento é inserido na urlMappings seção do arquivo de configuração no nível da hierarquia atual. Isso remove todas as referências aos add elementos definidos nos arquivos de configuração pai em níveis mais altos na hierarquia.

  • EmitClear sinalizador está definido como false. Isso tem o efeito de remover o clear elemento da urlMappings seção do arquivo de configuração no nível da hierarquia atual, se ele existir.

O Clear método realmente exclui os add elementos definidos na urlMappings seção do arquivo de configuração no nível da hierarquia atual. Ele também remove todas as referências aos add elementos definidos nos arquivos de configuração pai em níveis mais altos na hierarquia, mas não os exclui.

Confira também

• UrlMapping
• UrlMappingsSection