Udostępnij za pośrednictwem

UrlMappingCollection.Clear Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.Configuration
Zestaw:
System.Web.dll

Usuwa wszystkie UrlMapping obiekty z kolekcji.

public:
 void Clear();
public void Clear ();
member this.Clear : unit -> unit
Public Sub Clear ()

Przykłady

Poniższy przykład kodu usuwa wszystkie UrlMapping obiekty z obiektu UrlMappingCollection.

Zapoznaj się z przykładem kodu w temacie klasy, UrlMappingCollection aby dowiedzieć się, jak pobrać kolekcję.


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

Uwagi

Jeśli zapiszesz plik konfiguracji po wywołaniu Clear metody, wynik będzie zależny od wybranego ConfigurationSaveModeelementu .

Poniższa lista zawiera opis warunków, które mają zastosowanie w przypadku użycia Save metody do zapisania pliku:

  • Jeśli przekażesz Full lub ConfigurationSaveMode.Modified jako wartość parametru, clear element zostanie wstawiony do urlMappings sekcji pliku konfiguracji na bieżącym poziomie hierarchii.

  • W przypadku przekazania Minimal jako wartości parametru remove szereg elementów zostanie dodany do urlMappings pliku konfiguracji na bieżącym poziomie hierarchii. Te remove elementy usuwają wszystkie odwołania do add elementów zdefiniowanych w plikach konfiguracji nadrzędnych na wyższych poziomach w hierarchii. Z wartością Minimal wyliczenia istnieje jedna dodatkowa właściwość w kolekcji, która wpływa na to, co jest serializowane do pliku konfiguracji. Właściwość jest EmitClear domyślnie i jest false . Jedną z następujących warunków jest stosowana:

    • EmitClear ustaw wartość true. Element clear jest wstawiany do urlMappings sekcji pliku konfiguracji na bieżącym poziomie hierarchii. Spowoduje to usunięcie wszystkich odwołań do add elementów zdefiniowanych w plikach konfiguracji nadrzędnych na wyższych poziomach w hierarchii.

    • EmitClear flaga jest ustawiona na false. Ma to wpływ na usunięcie clear elementu z urlMappings sekcji pliku konfiguracji na bieżącym poziomie hierarchii, jeśli istnieje.

Metoda Clear rzeczywiście add usuwa elementy zdefiniowane w urlMappings sekcji pliku konfiguracji na bieżącym poziomie hierarchii. Usuwa również wszystkie odwołania do add elementów zdefiniowanych w plikach konfiguracji nadrzędnych na wyższych poziomach w hierarchii, ale nie usuwa ich.

Dotyczy

Zobacz też