UrlMappingCollection.Clear Metoda

Definice

Obor názvů:

System.Web.Configuration

Sestavení:

System.Web.dll

Odebere všechny UrlMapping objekty z kolekce.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Příklady

Následující příklad kódu odebere všechny UrlMapping objekty z UrlMappingCollection.

V příkladu kódu v tématu předmětu UrlMappingCollection se dozvíte, jak získat kolekci.

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

Poznámky

Pokud konfigurační soubor uložíte po volání Clear metody, výsledek bude závislý na zvoleném ConfigurationSaveMode.

Následující seznam popisuje podmínky, které platí, pokud použijete metodu Save k uložení souboru:

• Pokud předáte Full hodnotu parametru nebo ConfigurationSaveMode.Modified jako hodnotu parametru, clear vloží se prvek do urlMappings části konfiguračního souboru na aktuální úrovni hierarchie.

• Pokud předáte Minimal hodnotu parametru, přidá se remove řada prvků do urlMappings konfiguračního souboru na aktuální úrovni hierarchie. Tyto remove prvky odeberou všechny odkazy na add prvky definované v nadřazených konfiguračních souborech na vyšších úrovních v hierarchii. S hodnotou výčtu Minimal existuje jedna další vlastnost kolekce, která ovlivňuje, co se serializuje do konfiguračního souboru. Vlastnost je EmitClear a je false ve výchozím nastavení. Platí jedna z následujících podmínek:

  • EmitClear nastaveno na true. Prvek clear se vloží do urlMappings části konfiguračního souboru na aktuální úrovni hierarchie. Tím se odeberou všechny odkazy na add prvky definované v nadřazených konfiguračních souborech na vyšších úrovních v hierarchii.

  • EmitClear příznak je nastaven na false. To má vliv na odebrání elementu clear z urlMappings oddílu konfiguračního souboru na aktuální úrovni hierarchie, pokud existuje.

Metoda Clear skutečně odstraní add prvky definované v urlMappings části konfiguračního souboru na aktuální úrovni hierarchie. Odebere také všechny odkazy na add prvky definované v nadřazených konfiguračních souborech na vyšších úrovních v hierarchii, ale neodstraní je.

Viz také

• UrlMapping
• UrlMappingsSection