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)

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