ConfigurationElementCollection.CreateNewElement Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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)
Creates a new ConfigurationElement when overridden in a derived class.
protected:
virtual System::Configuration::ConfigurationElement ^ CreateNewElement(System::String ^ elementName);protected virtual System.Configuration.ConfigurationElement CreateNewElement (string elementName);abstract member CreateNewElement : string -> System.Configuration.ConfigurationElement
override this.CreateNewElement : string -> System.Configuration.ConfigurationElementProtected Overridable Function CreateNewElement (elementName As String) As ConfigurationElementParameters
- elementName
- String
The name of the ConfigurationElement to create.
Returns
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.
Applies to
CreateNewElement()
When overridden in a derived class, creates a new ConfigurationElement.
protected:
abstract System::Configuration::ConfigurationElement ^ CreateNewElement();protected abstract System.Configuration.ConfigurationElement CreateNewElement ();abstract member CreateNewElement : unit -> System.Configuration.ConfigurationElementProtected MustOverride Function CreateNewElement () As ConfigurationElementReturns
A newly created ConfigurationElement.
Examples
The following code example shows how to override the CreateNewElement method.
protected override ConfigurationElement CreateNewElement()
{
return new UrlConfigElement();
}
Protected Overloads Overrides Function CreateNewElement() As ConfigurationElement
Return New UrlConfigElement()
End Function
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.
