Apache Module mod_aspdotnet

Available Languages: en

- - - - -

Description:	Provides an interface for ASP.NET content between Apache HTTP -Server 2.0 and Microsoft's ASP.NET host.
Status:	External
Module Identifier:	aspdotnet_module
Source File:	mod_aspdotnet.cpp
Compatibility:	Compatible only with httpd 2.0.44 and later.

Summary

- -

The AspNet and - AspNetMount directives - and asp.net handler provided by mod_aspdotnet are used - to configure content to be served of the ASP.NET engine.

- -

The current version is compatible with the .NET Framework versions 1.x - (1.0, 1.1, etc). The current version is not compatible with .NET Framework - version 2.0 although this may be addressed in the future.

- -

Only modern Windows NT-based operating systems (2000, XP, 2003, etc) are - supported. Older versions such as Windows 98 and ME are not, Windows NT 6 - requires Service Pack 6, and the module authors will not invest time or - effort on these older versions. Do not contact the project regarding - support of older operating systems.

Topics

Usage

Usage

Several global configurations must be given to enable the Apache - HTTP Server to correctly serve ASP.NET application content.

- -

Example:

-LoadModule aspdotnet_module modules/mod_aspdotnet.so - -AddHandler asp.net asax ascx ashx asmx aspx axd config cs csproj \ - - licx rem resources resx soap vb vbproj vsdisco webinfo - -AliasMatch "^/(?i)aspnet_client/system_web/(\d+)_(\d+)_(\d+)_(\d+)/(.*)" \ - - "C:/Windows/Microsoft.NET/Framework/v$1.$2.$3/ASP.NETClientFiles/$4" - -<Directory "C:/Windows/Microsoft.NET/Framework/v*/ASP.NETClientFiles"> - Options FollowSymlinks - Order allow,deny - Allow from all -</Directory> -

- -

This will direct all requests for ASP.NET-releated files to the - mod_aspdotnet handler, and serve Microsoft's ASP.NET client files - and support scripts as expected by ASP.NET applications.

- -

Provide individual AspNet and AspNetMount directives for each application (containing - a unique web.config file at it's application root.)

- -

Example:

-AspNetMount /app-uri "C:/path/to/app" -Alias /app-uri "C:/path/to/app" -<Directory "C:/path/to/app"> - Options FollowSymlinks Indexes - AspNet files - Order allow,deny - Allow from all - DirectoryIndex default.htm default.aspx -</Directory> -

- -

AspNet Directive

- - - - - - - - - -

Description:	Enables mod_aspdotnet to process ASP.NET content
Syntax:	`AspNet [[Files] [Directories] - [Virtual] [Errors]] - \| [All] \| [None]`
Default:	`AspNet None`
Context:	server config, virtual host, directory, .htaccess
Override:	Options
Status:	External
Module:	mod_aspdotnet
Compatibility:	Build 2004 and later

- -

The AspNet directive determines what content - may be served by the ASP.NET host. This directive does -not- actually - expose the content or mount the URI to physical files, you must use the - Alias and - AspNetMount directives to expose the content - to the remote user.

- -

The AspNet files directive is - the equivilant for ASP.NET files to the behavior of Options ExecCGI - for CGI content. In the original version of mod_aspdotnet, in fact, - Options ExecCGI was used to determine if ASP.NET content would be - invoked through mod_aspdotnet. In version 2.0.2 and later, this is - no longer true, and your configuration files must be updated from - Options ExecCGI to AspNet files.

- -

The None option disables all ASP.NET processing, while the individual - options below enable ASP.NET processing for specific request types:

- -

All: All options below. This is generally not a recommended setting.
Files: Files that exist in the filesystem, which are directed to the - asp.net handler.
Directories: Directories that exist in the filesystem, which are directed to the - asp.net handler. This can be used to invoke an HttpHandler to produce - custom directory listings.
Virtual: Requests that map to neither a file nor directory in the filesystem, - which are directed to the asp.net handler. This is used to invoke any - HttpHandler which accesses non-file based resources, such as ASP.NET - remoting requests.
Error: Error result pages generated by ASP.NET. This option bypasses the - normal Apache ErrorDocument error content. This is required to return - the full debugging results from the ASP.NET environment in development - environments. Caution is urged before using this option in production - environments, where path-revealing flaws should be avoided.

- -

Normally, if multiple AspNet directives could - apply to a directory, then the most specific one is used and others are - ignored; the AspNet directives are never merged. See how sections are merged for a better - understanding of which Files, Directory, or Location section will take - precedence.

- - -

AspNetMount Directive

- - - - - - -

Description:	Mounts a URI to a physical ASP.NET directory
Syntax:	`AspNetMount URL-path directory-path`
Context:	server config
Status:	External
Module:	mod_aspdotnet

- -

The AspNetMount directive determines which - physical directory is mounted by the ASP.NET host. This directive - does -not- actually expose the content, you must use the - Alias - directive to expose the content to the remote user.

- - -

AspNetVersion Directive

- - - - - - - -

Description:	Force a specific .NET Framework version to be loaded
Syntax:	`AspNetVersion versionstring`
Context:	server config
Status:	External
Module:	mod_aspdotnet
Compatibility:	Build 2004 and later

- -

The AspNetVersion directive will override the - default (most current) .NET Framework environment, and elect a different - installed version of the .NET Framework. The chosen version must be - installed on the machine.

- -

If this directive is not present, the most current .NET Framework version - is used. This directive should be specified only once, only the last occurance - in the httpd.conf file is used to elect the .NET Framework version.

- -

See the c:\Windows\Microsoft.NET\Framework\ directory for all installed - versions and their version tags (the actual directory names).

- -

Example:

-# Load mod_aspdotnet using the 1.0 release version of the .NET Framework -AspNetVersion v1.0.3705 -

- -

Example:

-# Load mod_aspdotnet using the 1.1 release version of the .NET Framework -AspNetVersion v1.1.4322 -

- - -

Apache Module mod_aspdotnet

Summary

Directives

Topics

See also

Usage

Example:

Example:

AspNet Directive

AspNetMount Directive

AspNetVersion Directive

Example:

Example: