UrlMappingCollection.Clear Método

Definición

Espacio de nombres:

System.Web.Configuration

Ensamblado:

System.Web.dll

Quita todos los objetos UrlMapping de la colección.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Ejemplos

En el ejemplo de código siguiente se quitan todos los UrlMapping objetos de UrlMappingCollection.

Consulte el ejemplo de código del tema de clase UrlMappingCollection para obtener información sobre cómo obtener la colección.

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

Comentarios

Si guarda el archivo de configuración después de llamar al Clear método , el resultado dependerá del elegido ConfigurationSaveMode.

En la lista siguiente se describen las condiciones que se aplican si usa el Save método para guardar el archivo:

• Si pasa Full o ConfigurationSaveMode.Modified como valor de parámetro, se inserta un clear elemento en la urlMappings sección del archivo de configuración en el nivel de jerarquía actual.

• Si pasa Minimal como valor de parámetro, se agrega una serie de remove elementos al urlMappings del archivo de configuración en el nivel de jerarquía actual. Estos remove elementos quitan todas las referencias a los add elementos definidos en los archivos de configuración primarios en niveles superiores de la jerarquía. Con el Minimal valor de enumeración, hay una propiedad adicional en la colección que afecta a lo que se serializa en el archivo de configuración. La propiedad es EmitClear y es false de forma predeterminada. Se aplica una de las siguientes condiciones:

  • EmitClear establezca en true. Se inserta un clear elemento en la urlMappings sección del archivo de configuración en el nivel de jerarquía actual. Esto quita todas las referencias a los add elementos definidos en los archivos de configuración primarios en niveles superiores de la jerarquía.

  • EmitClear flag se establece en false. Esto tiene el efecto de quitar el clear elemento de la urlMappings sección del archivo de configuración en el nivel de jerarquía actual, si existe.

El Clear método elimina realmente los add elementos definidos en la urlMappings sección del archivo de configuración en el nivel de jerarquía actual. También quita todas las referencias a los elementos definidos en los add archivos de configuración primarios en niveles superiores de la jerarquía, pero no los elimina.

Consulte también

• UrlMapping
• UrlMappingsSection