UrlMappingCollection.Clear Metodo

Definizione

Spazio dei nomi:

System.Web.Configuration

Assembly:

System.Web.dll

Rimuove tutti gli oggetti UrlMapping dall'insieme.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Esempio

Nell'esempio di codice seguente vengono rimossi tutti gli UrlMapping oggetti da UrlMappingCollection.

Fare riferimento all'esempio di codice nell'argomento della UrlMappingCollection classe per informazioni su come ottenere la raccolta.

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

Commenti

Se si salva il file di configurazione dopo aver chiamato il Clear metodo , il risultato dipenderà dall'oggetto scelto ConfigurationSaveMode.

Nell'elenco seguente vengono descritte le condizioni applicabili se si utilizza il Save metodo per salvare il file:

• Se si passa Full o ConfigurationSaveMode.Modified come valore del parametro, viene inserito un clear elemento nella urlMappings sezione del file di configurazione a livello di gerarchia corrente.

• Se si passa Minimal come valore del parametro, una serie di remove elementi viene aggiunta al urlMappings del file di configurazione a livello di gerarchia corrente. Questi remove elementi rimuovono tutti i riferimenti agli add elementi definiti nei file di configurazione padre a livelli superiori nella gerarchia. Con il Minimal valore di enumerazione, è presente una proprietà aggiuntiva nella raccolta che influisce sugli elementi serializzati nel file di configurazione. La proprietà è ed è EmitClear per false impostazione predefinita. Si applica una delle condizioni seguenti:

  • EmitClear impostare su true. Un clear elemento viene inserito nella urlMappings sezione del file di configurazione a livello di gerarchia corrente. In questo modo vengono rimossi tutti i riferimenti agli add elementi definiti nei file di configurazione padre a livelli superiori nella gerarchia.

  • EmitClear flag è impostato su false. Ciò ha l'effetto di rimuovere l'elemento clear dalla urlMappings sezione del file di configurazione a livello di gerarchia corrente, se esistente.

Il Clear metodo elimina effettivamente gli add elementi definiti nella urlMappings sezione del file di configurazione a livello di gerarchia corrente. Rimuove anche tutti i riferimenti agli add elementi definiti nei file di configurazione padre a livelli superiori nella gerarchia, ma non li elimina.

Vedi anche

• UrlMapping
• UrlMappingsSection