NameValueFileSectionHandler.Create(Object, Object, XmlNode) Method

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Package:

System.Configuration.ConfigurationManager v9.0.0-rc.2.24473.5

Source:

NameValueFileSectionHandler.cs

Creates a new configuration handler and adds it to the section-handler collection based on the specified parameters.

public:
 virtual System::Object ^ Create(System::Object ^ parent, System::Object ^ configContext, System::Xml::XmlNode ^ section);

public object Create (object parent, object configContext, System.Xml.XmlNode section);

abstract member Create : obj * obj * System.Xml.XmlNode -> obj
override this.Create : obj * obj * System.Xml.XmlNode -> obj

Public Function Create (parent As Object, configContext As Object, section As XmlNode) As Object

Parameters

parent

Object

The parent object.

configContext

Object

The configuration context object.

section

XmlNode

The section XML node.

Returns

Object

A configuration object.

Implements

Create(Object, Object, XmlNode)

Exceptions

ConfigurationErrorsException

The file specified in the file attribute of section exists but cannot be loaded.

-or-

The name attribute of section does not match the root element of the file specified in the file attribute.

Remarks

The parent object parameter acts as the configuration settings in the corresponding parent configuration section. The configContext object parameter is the virtual path for which the configuration section handler computes configuration values. Normally this parameter is reserved and is null. The section parameter is the XmlNode that contains the configuration information to be handled. The section parameter provides direct access to the XML contents of the configuration section.