ConfigurationElementCollection.CreateNewElement Method (String)
Creates a new ConfigurationElement when overridden in a derived class.
Assembly: System.Configuration (in System.Configuration.dll)
Protected Overridable Function CreateNewElement ( elementName As String ) As ConfigurationElement
Parameters
- elementName
-
Type:
System.String
The name of the ConfigurationElement to create.
Return Value
Type: System.Configuration.ConfigurationElementA 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.
Available since 2.0