UrlMappingCollection.Clear Método

Definição

Espaço de Nomes:
System.Web.Configuration
Assemblagem:
System.Web.dll

Remove todos os UrlMapping objetos da coleção.

public:
 void Clear();
public void Clear();
member this.Clear : unit -> unit
Public Sub Clear ()

Exemplos

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

Consulta o exemplo do código no UrlMappingCollection tópico da aula para saberes 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

Observações

Se guardar o ficheiro de configuração após chamar o Clear método, o resultado dependerá do ficheiro escolhido ConfigurationSaveMode.

A lista seguinte descreve as condições que se aplicam se usar o Save método para guardar o ficheiro:

  • Se passar Full ou ConfigurationSaveMode.Modified como valor do parâmetro, um clear elemento é inserido na urlMappings secção do ficheiro de configuração ao nível da hierarquia atual.

  • Se passar Minimal como valor do parâmetro, uma série de remove elementos é adicionada ao urlMappings do ficheiro de configuração ao nível da hierarquia atual. Estes remove elementos removem todas as referências aos add elementos definidos nos ficheiros de configuração pai em níveis superiores da hierarquia. Com o Minimal valor de enumeração, existe uma propriedade adicional na coleção que afeta o que é serializado para o ficheiro de configuração. A propriedade é EmitClear e é false por defeito. Aplica-se uma das seguintes condições:

    • EmitClear definido como true. Um clear elemento é inserido na urlMappings secção do ficheiro de configuração ao nível da hierarquia atual. Isto remove todas as referências aos add elementos definidos nos ficheiros de configuração pai em níveis superiores da hierarquia.

    • EmitClear o flag está definido para false. Isto tem o efeito de remover o clear elemento da urlMappings secção do ficheiro de configuração ao nível da hierarquia atual, caso exista.

O Clear método elimina efetivamente os add elementos definidos na urlMappings secção do ficheiro de configuração ao nível da hierarquia atual. Também remove todas as referências aos add elementos definidos nos ficheiros de configuração dos pais em níveis superiores da hierarquia, mas não os elimina.

Aplica-se a

Ver também