GlobalModuleElement Class [IIS 7 and higher]

Configures a native or managed code module that processes requests to the Web server.

Syntax

class GlobalModuleElement : CollectionElement

Methods

This class contains no methods.

Properties

The following table lists the properties exposed by the GlobalModuleElement class.

Name

Description

Image

A read/write string value that specifies either a managed type or the file system path of the .dll file that contains the global module.

Name

A required unique read/write string value that specifies a unique name for the global module. The key property.

PreCondition

A read/write string value that contains a comma-delimited list of values that represent preconditions for the module to be loaded. The possible values are listed later in the Remarks section.

Subclasses

This class contains no subclasses.

Remarks

Instances of this class are contained in the GlobalModules array property of the GlobalModulesSection class.

The following table lists the possible values for the Precondition property. The integratedMode and ISAPIMode settings are mutually exclusive. The default is null.

Value

Description

integratedMode

IIS loads the module only for application pools that run in integrated mode.

ISAPIMode

IIS loads the module only for application pools that run in ISAPI mode.

runtimeVersion

IIS loads the module only for application pools that use the specified .NET Framework version. To enable this precondition, append a string in the format vMajorVersion.MinorVersion to the string "runtimeVersion" (for example, "runtimeVersionv2.0").

managedHandler

IIS loads the module only if the request is mapped to a managed handler. This setting can optimize performance by preventing static files from going through managed modules for every request.

Inheritance Hierarchy

CollectionElement

   GlobalModuleElement

Requirements

Type

Description

Client

Requires IIS 7 on Windows Vista.

Server

Requires IIS 7 on Windows Server 2008.

Product

IIS 7

MOF file

WebAdministration.mof

See Also

Reference

CollectionElement Class [IIS 7 and higher]

GlobalModulesSection Class [IIS 7 and higher]