ConfigurationElementCollection.CreateNewElement Method

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

When overridden in a derived class, creates a new ConfigurationElement.

Overloads

CreateNewElement(String)	Creates a new ConfigurationElement when overridden in a derived class.
CreateNewElement()	When overridden in a derived class, creates a new ConfigurationElement.

Remarks

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.

CreateNewElement(String)

Source:

ConfigurationElementCollection.cs

Creates a new ConfigurationElement when overridden in a derived class.

C#

protected virtual System.Configuration.ConfigurationElement CreateNewElement(string elementName);

Parameters

elementName

String

The name of the ConfigurationElement to create.

Returns

ConfigurationElement

A new ConfigurationElement with a specified name.

Remarks

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 Inheritors

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

• Override the GetElementKey(ConfigurationElement) method.

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

CreateNewElement()

Source:

ConfigurationElementCollection.cs

When overridden in a derived class, creates a new ConfigurationElement.

C#

protected abstract System.Configuration.ConfigurationElement CreateNewElement();

Returns

ConfigurationElement

A newly created ConfigurationElement.

Examples

The following code example shows how to override the CreateNewElement method.

C#

protected override ConfigurationElement CreateNewElement()
{
    return new UrlConfigElement();
}

Remarks

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.