ConfigurationElementCollection::SerializeElement Method (XmlWriter^, Boolean)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Writes the configuration data to an XML element in the configuration file when overridden in a derived class.

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

public protected:
virtual bool SerializeElement(
	XmlWriter^ writer,
	bool serializeCollectionKey
) override

Parameters

writer
Type: System.Xml::XmlWriter^

Output stream that writes XML to the configuration file.

serializeCollectionKey
Type: System::Boolean

true to serialize the collection key; otherwise, false.

Return Value

Type: System::Boolean

true if the ConfigurationElementCollection was written to the configuration file successfully.

Exception Condition
ArgumentException

One of the elements in the collection was added or replaced and starts with the reserved prefix "config" or "lock".

The SerializeElement method writes the contents of the configuration elements contained in the collection and any nested elements they contain to the configuration file. Override SerializeElement to provide a custom write procedure out of the collection contents and nested elements.

.NET Framework
Available since 2.0
Return to top
Show: