UrlMappingCollection.Remove Method

Definition

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

Removes a UrlMapping object from the collection.

Overloads

Remove(String)	Removes the UrlMapping object with the specified name from the collection.
Remove(UrlMapping)	Removes the specified UrlMapping object from the collection.

Remove(String)

Removes the UrlMapping object with the specified name from the collection.

C#

public void Remove(string name);

Parameters

name

String

The name of the UrlMapping object to remove from the collection.

Examples

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.

C#

// Remove the URL with the
// specified name from the collection
// (if exists).
urlMappings.Remove("~/default.aspx");

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

Remarks

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.

See also

• UrlMapping
• UrlMappingsSection

Remove(UrlMapping)

Removes the specified UrlMapping object from the collection.

C#

public void Remove(System.Web.Configuration.UrlMapping urlMapping);

Parameters

urlMapping

UrlMapping

The UrlMapping object to remove from the collection.

Examples

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.

C#

// 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();

Remarks

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.

See also

• UrlMapping
• UrlMappingsSection