ConfigurationElementCollection.CreateNewElement Method (String)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Creates a new ConfigurationElement when overridden in a derived class.

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

protected virtual ConfigurationElement CreateNewElement(
	string elementName


Type: System.String

The name of the ConfigurationElement to create.

Return Value

Type: System.Configuration.ConfigurationElement

A new ConfigurationElement with a specified name.

Override the CreateNewElement method to create custom ConfigurationElement objects of a specific type. When a collection is loaded from the configuration file, CreateNewElement is called to create individual elements. CreateNewElement must be overridden in classes that derive from the ConfigurationElementCollection class.

Notes to Implementers:

If you create a custom ConfigurationElementCollection collection that contains heterogeneous ConfigurationElement types, you must perform these steps:

  • Override the GetElementKey method.

  • Make sure that the GetElementKey method returns a string that identifies the type of the element you created by calling the CreateNewElement method.

.NET Framework
Available since 2.0
Return to top