UrlMappingCollection.Clear Methode

public:
 void Clear();

public void Clear();

member this.Clear : unit -> unit

Public Sub Clear ()

Beispiele

Im folgenden Codebeispiel werden alle UrlMapping Objekte aus dem UrlMappingCollectionCode entfernt.

Weitere Informationen zum Abrufen der Auflistung finden Sie im Codebeispiel im UrlMappingCollection Klassenthema.

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

Hinweise

Wenn Sie die Konfigurationsdatei nach dem Aufrufen der Clear Methode speichern, hängt das Ergebnis von der ausgewählten ConfigurationSaveModeDatei ab.

In der folgenden Liste werden die Bedingungen beschrieben, die gelten, wenn Sie die Datei mithilfe der Save Methode speichern:

• Wenn Sie den Parameterwert übergeben oder Full als Parameterwert übergebenConfigurationSaveMode.Modified, wird ein clear Element in den urlMappings Abschnitt der Konfigurationsdatei auf der aktuellen Hierarchieebene eingefügt.

• Wenn Sie den Parameterwert übergeben Minimal , werden der Konfigurationsdatei auf der aktuellen Hierarchieebene eine Reihe von remove Elementen hinzugefügt urlMappings . Diese remove Elemente entfernen alle Verweise auf die Elemente, die add in den übergeordneten Konfigurationsdateien auf höheren Ebenen in der Hierarchie definiert sind. Mit dem Minimal Enumerationswert gibt es eine zusätzliche Eigenschaft für die Auflistung, die sich auf das Serialisierungsobjekt in der Konfigurationsdatei auswirkt. Die Eigenschaft ist EmitClear und ist false standardmäßig. Eine der folgenden Bedingungen gilt:

  • Legen Sie EmitClear auf true fest. Ein clear Element wird in den urlMappings Abschnitt der Konfigurationsdatei auf der aktuellen Hierarchieebene eingefügt. Dadurch werden alle Verweise auf die elemente entfernt, die add in den übergeordneten Konfigurationsdateien auf höheren Ebenen in der Hierarchie definiert sind.

  • EmitClear flag ist auf false. Dadurch wird das clear Element aus dem urlMappings Abschnitt der Konfigurationsdatei auf der aktuellen Hierarchieebene entfernt, sofern vorhanden.

Die Clear Methode löscht tatsächlich die add im urlMappings Abschnitt der Konfigurationsdatei definierten Elemente auf der aktuellen Hierarchieebene. Außerdem werden alle Verweise auf die elemente entfernt, die add in den übergeordneten Konfigurationsdateien auf höheren Ebenen in der Hierarchie definiert sind, aber nicht gelöscht.

Weitere Informationen

• UrlMapping
• UrlMappingsSection