UrlMappingCollection.Remove Method (UrlMapping)

 

Removes the specified UrlMapping object from the collection.

Namespace:   System.Web.Configuration
Assembly:  System.Web (in System.Web.dll)

public void Remove(
	UrlMapping urlMapping
)

Parameters

urlMapping
Type: System.Web.Configuration.UrlMapping

The UrlMapping object to remove from the collection.

The Remove method deletes the add element in the urlMappings section at the current hierarchy level and inserts a remove element. The remove element effectively removes the reference to the add element defined in the parent configuration files at higher levels in the hierarchy but does not delete it.

The following code example removes the UrlMapping object from the UrlMappingCollection.

Refer to the code example in the UrlMappingCollection class topic to learn how to get the collection.


// Create a UrlMapping object.
urlMapping = new UrlMapping(
  "~/home.aspx", "~/default.aspx?parm1=1");

// Remove it from the collection
// (if exists).
urlMappings.Remove(urlMapping);

// Update the configuration file.
if (!urlMappingSection.IsReadOnly())
  configuration.Save();

.NET Framework
Available since 2.0
Return to top
Show: