UrlMappingCollection.Clear Metod

public:
 void Clear();

public void Clear();

member this.Clear : unit -> unit

Public Sub Clear ()

Exempel

Följande kodexempel tar bort alla UrlMapping objekt från UrlMappingCollection.

Se kodexemplet i klassavsnittet UrlMappingCollection för att lära dig hur du hämtar samlingen.

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

Kommentarer

Om du sparar konfigurationsfilen efter att du har anropat Clear metoden kommer resultatet att vara beroende av den valda ConfigurationSaveMode.

I följande lista beskrivs de villkor som gäller om du använder Save metoden för att spara filen:

• Om du skickar Full eller ConfigurationSaveMode.Modified som parametervärde infogas ett clear element i avsnittet i urlMappings konfigurationsfilen på den aktuella hierarkinivån.

• Om du skickar Minimal som parametervärde läggs en serie remove element till urlMappings i konfigurationsfilen på den aktuella hierarkinivån. Dessa remove element tar bort alla referenser till de add element som definierats i de överordnade konfigurationsfilerna på högre nivåer i hierarkin. Minimal Med uppräkningsvärdet finns det ytterligare en egenskap i samlingen som påverkar vad som serialiseras till konfigurationsfilen. Egenskapen är EmitClear och är false som standard. Ett av följande villkor gäller:

  • EmitClear inställt på true. Ett clear element infogas i urlMappings avsnittet i konfigurationsfilen på den aktuella hierarkinivån. Detta tar bort alla referenser till de add element som definierats i de överordnade konfigurationsfilerna på högre nivåer i hierarkin.

  • EmitClear flaggan är inställd på false. Detta innebär att elementet clear tas bort från urlMappings avsnittet i konfigurationsfilen på den aktuella hierarkinivån, om det finns.

Metoden Clear tar faktiskt bort de add element som definierats i urlMappings avsnittet i konfigurationsfilen på den aktuella hierarkinivån. Den tar också bort alla referenser till de add element som definierats i de överordnade konfigurationsfilerna på högre nivåer i hierarkin men tar inte bort dem.

Se även

• UrlMapping
• UrlMappingsSection