Information
Switch
Switch
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ConfigurationElementCollection::CreateNewElement Method (String^)

.NET Framework (current version)
 

Creates a new ConfigurationElement when overridden in a derived class.

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

C#
C++
F#
VB
Copy 
protected:
virtual ConfigurationElement^ CreateNewElement(
	String^ elementName
)

Parameters

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
Show: