UrlMappingCollection.Clear Methode

public:
 void Clear();

public void Clear();

member this.Clear : unit -> unit

Public Sub Clear ()

Voorbeelden

In het volgende codevoorbeeld worden alle UrlMapping objecten uit de UrlMappingCollection.

Raadpleeg het codevoorbeeld in het UrlMappingCollection klasseonderwerp voor meer informatie over het ophalen van de verzameling.

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

Opmerkingen

Als u het configuratiebestand opslaat nadat u de methode hebt Clear aangeroepen, is het resultaat afhankelijk van de gekozen ConfigurationSaveMode.

In de volgende lijst worden de voorwaarden beschreven die van toepassing zijn als u de Save methode gebruikt om het bestand op te slaan:

• Als u de parameterwaarde doorgeeft Full of ConfigurationSaveMode.Modified als parameterwaarde, wordt een clear element ingevoegd in de urlMappings sectie van het configuratiebestand op het huidige hiërarchieniveau.

• Als u de parameterwaarde doorgeeft Minimal , wordt er een reeks remove elementen toegevoegd aan het urlMappings configuratiebestand op het huidige hiërarchieniveau. Deze remove elementen verwijderen alle verwijzingen naar de add elementen die zijn gedefinieerd in de bovenliggende configuratiebestanden op hogere niveaus in de hiërarchie. Met de Minimal opsommingswaarde is er één extra eigenschap voor de verzameling die van invloed is op wat wordt geserialiseerd naar het configuratiebestand. De eigenschap is EmitClear en is false standaard. Een van de volgende voorwaarden is van toepassing:

  • EmitClear ingesteld op true. Er wordt een clear element ingevoegd in de urlMappings sectie van het configuratiebestand op het huidige hiërarchieniveau. Hiermee verwijdert u alle verwijzingen naar de add elementen die zijn gedefinieerd in de bovenliggende configuratiebestanden op hogere niveaus in de hiërarchie.

  • EmitClear vlag is ingesteld op false. Dit heeft het effect van het verwijderen van het clear element uit de urlMappings sectie van het configuratiebestand op het huidige hiërarchieniveau, indien aanwezig.

Met Clear de methode worden de add elementen verwijderd die zijn gedefinieerd in de urlMappings sectie van het configuratiebestand op het huidige hiërarchieniveau. Ook worden alle verwijzingen naar de add elementen verwijderd die zijn gedefinieerd in de bovenliggende configuratiebestanden op hogere niveaus in de hiërarchie, maar worden ze niet verwijderd.

Zie ook

• UrlMapping
• UrlMappingsSection