UrlMappingCollection.Clear Methode

Definition

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

Entfernt alle UrlMapping-Objekte aus der Auflistung.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Beispiele

Im folgenden Codebeispiel werden alle UrlMapping Objekte aus dem UrlMappingCollection.

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

// 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 Methode zum Speichern der Datei verwenden Save :

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

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

  • EmitClear festgelegt auf true. 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 in den add übergeordneten Konfigurationsdateien auf höheren Ebenen in der Hierarchie definiert sind.

  • EmitClear flag is set to false. Dies wirkt sich auf das Entfernen clear des Elements aus dem urlMappings Abschnitt der Konfigurationsdatei auf der aktuellen Hierarchieebene aus, falls vorhanden.

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

Siehe auch

• UrlMapping
• UrlMappingsSection