mod_aspdotnet.html.en revision 2d2dd428e5888639cd7df1b05e5413599063a66e
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele This file is generated from xml source: DO NOT EDIT
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5a58787efeb02a1c3f06569d019ad81fd2efa06end<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
5a58787efeb02a1c3f06569d019ad81fd2efa06end<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
2e545ce2450a9953665f701bb05350f0d3f26275nd<link href="/images/favicon.ico" rel="shortcut icon" /></head>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p>
3f08db06526d6901aa08c110b5bc7dde6bc39905nd<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div>
a78048ccbdb6256da15e6b0e7e95355e480c2301nd<p><span>Available Languages: </span><a href="/en/mod/mod_aspdotnet.html" title="English"> en </a></p>
aee1f193a276866212922ae5072e3014db28582frpluem<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Provides an interface for ASP.NET content between Apache HTTP
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<tr><th><a href="module-dict.html#Status">Status:</a></th><td>External, http://httpd.apache.org/mod_aspdotnet/</td></tr>
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<tr><th><a href="module-dict.html#ModuleIdentifier">Module�Identifier:</a></th><td>aspdotnet_module</td></tr>
aee1f193a276866212922ae5072e3014db28582frpluem<tr><th><a href="module-dict.html#SourceFile">Source�File:</a></th><td>mod_aspdotnet.cpp</td></tr>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<tr><th><a href="module-dict.html#Compatibility">Compatibility:</a></th><td>Compatible only with httpd 2.0.44 and later.</td></tr></table>
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive <p>The <code class="directive"><a href="#aspnet">AspNet</a></code> and
5a58787efeb02a1c3f06569d019ad81fd2efa06end <code class="directive"><a href="#aspnetmount">AspNetMount</a></code> directives
5a58787efeb02a1c3f06569d019ad81fd2efa06end and asp.net handler provided by <code class="module"><a href="/mod/mod_aspdotnet.html">mod_aspdotnet</a></code> are used
5a58787efeb02a1c3f06569d019ad81fd2efa06end to configure content to be served of the ASP.NET engine.</p>
5a58787efeb02a1c3f06569d019ad81fd2efa06end <p>The current version is compatible with the .NET Framework versions 1.x
5a58787efeb02a1c3f06569d019ad81fd2efa06end (1.0, 1.1, etc). The current version is not compatible with .NET Framework
df321386f1d9ed17a3e5e6468807996a12890d50gryzor version 2.0 although this may be addressed in the future.</p>
5a58787efeb02a1c3f06569d019ad81fd2efa06end <p>Only modern Windows NT-based operating systems (2000, XP, 2003, etc) are
5a58787efeb02a1c3f06569d019ad81fd2efa06end supported. Older versions such as Windows 98 and ME are not, Windows NT 6
bd43fc31993cfc191e744a9490481f4294894099covener requires Service Pack 6, and the module authors will not invest time or
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh effort on these older versions. Do not contact the project regarding
5a58787efeb02a1c3f06569d019ad81fd2efa06end support of older operating systems.</p>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<div id="quickview"><h3 class="directives">Directives</h3>
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive<li><img alt="" src="/images/down.gif" /> <a href="#aspnet">AspNet</a></li>
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive<li><img alt="" src="/images/down.gif" /> <a href="#aspnetmount">AspNetMount</a></li>
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive<li><img alt="" src="/images/down.gif" /> <a href="#aspnetversion">AspNetVersion</a></li>
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive<li><img alt="" src="/images/down.gif" /> <a href="#usage">Usage</a></li>
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive<li><a href="/handler.html">Configuring Handlers</a></li>
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive <p>Several global configurations must be given to enable the Apache
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive HTTP Server to correctly serve ASP.NET application content.</p>
5a58787efeb02a1c3f06569d019ad81fd2efa06endLoadModule aspdotnet_module modules/mod_aspdotnet.so <br />
aa8cf57195dfb7fa3d0baedf81f8be377946cea8sliveAddHandler asp.net asax ascx ashx asmx aspx axd config cs csproj \<br />
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive licx rem resources resx soap vb vbproj vsdisco webinfo<br />
aa8cf57195dfb7fa3d0baedf81f8be377946cea8sliveAliasMatch "^/(?i)aspnet_client/system_web/(\d+)_(\d+)_(\d+)_(\d+)/(.*)" \<br />
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive "C:/Windows/Microsoft.NET/Framework/v$1.$2.$3/ASP.NETClientFiles/$4"<br />
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive<Directory "C:/Windows/Microsoft.NET/Framework/v*/ASP.NETClientFiles"><br />
c6f41bc69d643835804e7e831776d3d46c6f5962slive Options FollowSymlinks<br />
c6f41bc69d643835804e7e831776d3d46c6f5962slive Order allow,deny<br />
c6f41bc69d643835804e7e831776d3d46c6f5962slive Allow from all<br />
c6f41bc69d643835804e7e831776d3d46c6f5962slive</Directory><br />
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive <p>This will direct all requests for ASP.NET-releated files to the
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive mod_aspdotnet handler, and serve Microsoft's ASP.NET client files
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive and support scripts as expected by ASP.NET applications.</p>
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive <p>Provide individual <code class="directive"><a href="#aspnet">AspNet</a></code> and <code class="directive"><a href="#aspnetmount">AspNetMount</a></code> directives for each application (containing
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem Options FollowSymlinks Indexes<br />
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem AspNet files<br />
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem Order allow,deny<br />
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem Allow from all<br />
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem DirectoryIndex default.htm default.aspx<br />
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem</Directory><br />
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem<div class="directive-section"><h2><a name="AspNet" id="AspNet">AspNet</a> <a name="aspnet" id="aspnet">Directive</a></h2>
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables mod_aspdotnet to process ASP.NET content</td></tr>
c6f41bc69d643835804e7e831776d3d46c6f5962slive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AspNet [[<var>Files</var>] [<var>Directories</var>]
c6f41bc69d643835804e7e831776d3d46c6f5962slive | [<var>All</var>] | [<var>None</var>]</code></td></tr>
c6f41bc69d643835804e7e831776d3d46c6f5962slive<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AspNet None</code></td></tr>
06d77ae37da42a6f8bbea25b7d7f8b6629245629slive<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
c6f41bc69d643835804e7e831776d3d46c6f5962slive<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>Options</td></tr>
c6f41bc69d643835804e7e831776d3d46c6f5962slive<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External, http://httpd.apache.org/mod_aspdotnet/</td></tr>
c6f41bc69d643835804e7e831776d3d46c6f5962slive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_aspdotnet</td></tr>
c6f41bc69d643835804e7e831776d3d46c6f5962slive<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Build 2004 and later</td></tr>
c6f41bc69d643835804e7e831776d3d46c6f5962slive <p>The <code class="directive">AspNet</code> directive determines what content
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive may be served by the ASP.NET host. This directive does -not- actually
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive expose the content or mount the URI to physical files, you must use the
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive <code class="directive"><a href="/mod/mod_alias.html#alias">Alias</a></code> and
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive <code class="directive">AspNetMount</code> directives to expose the content
ffb01336be79c64046b636e59fa8ddca8ec029edsf to the remote user.</p>
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive <p>The <code class="directive">AspNet</code> <var>files</var> directive is
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive the equivilant for ASP.NET files to the behavior of Options ExecCGI
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive for CGI content. In the original version of mod_aspdotnet, in fact,
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive Options ExecCGI was used to determine if ASP.NET content would be
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive invoked through mod_aspdotnet. In version 2.0.2 and later, this is
4ee3ac9c23e31f43d39414f4072f1b1456e43ff8igalic no longer true, and your configuration files must be updated from
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem Options ExecCGI to AspNet files.</p>
4ee3ac9c23e31f43d39414f4072f1b1456e43ff8igalic <p>The None option disables all ASP.NET processing, while the individual
aee1f193a276866212922ae5072e3014db28582frpluem options below enable ASP.NET processing for specific request types:</p>
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive <dd>All options below. This is generally not a recommended setting.</dd>
aee1f193a276866212922ae5072e3014db28582frpluem <dd>Files that exist in the filesystem, which are directed to the
5a58787efeb02a1c3f06569d019ad81fd2efa06end <dd>Directories that exist in the filesystem, which are directed to the
aee1f193a276866212922ae5072e3014db28582frpluem asp.net handler. This can be used to invoke an HttpHandler to produce
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele custom directory listings.</dd>
aee1f193a276866212922ae5072e3014db28582frpluem <dd>Requests that map to neither a file nor directory in the filesystem,
aee1f193a276866212922ae5072e3014db28582frpluem which are directed to the asp.net handler. This is used to invoke any
aee1f193a276866212922ae5072e3014db28582frpluem HttpHandler which accesses non-file based resources, such as ASP.NET
aee1f193a276866212922ae5072e3014db28582frpluem remoting requests.</dd>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele <dd>Error result pages generated by ASP.NET. This option bypasses the
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele normal Apache ErrorDocument error content. This is required to return
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele the full debugging results from the ASP.NET environment in development
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele environments. Caution is urged before using this option in production
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele environments, where path-revealing flaws should be avoided.</dd>
aee1f193a276866212922ae5072e3014db28582frpluem <p>Normally, if multiple <code class="directive">AspNet</code> directives could
aee1f193a276866212922ae5072e3014db28582frpluem apply to a directory, then the most specific one is used and others are
aee1f193a276866212922ae5072e3014db28582frpluem ignored; the AspNet directives are never merged. See <a href="/sections.html#mergin">how sections are merged</a> for a better
aee1f193a276866212922ae5072e3014db28582frpluem understanding of which Files, Directory, or Location section will take
aee1f193a276866212922ae5072e3014db28582frpluem precedence.</p>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele<div class="directive-section"><h2><a name="AspNetMount" id="AspNetMount">AspNetMount</a> <a name="aspnetmount" id="aspnetmount">Directive</a></h2>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Mounts a URI to a physical ASP.NET directory</td></tr>
aee1f193a276866212922ae5072e3014db28582frpluem<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AspNetMount <var>URL-path</var> <var>directory-path</var></code></td></tr>
aee1f193a276866212922ae5072e3014db28582frpluem<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
aee1f193a276866212922ae5072e3014db28582frpluem<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External, http://httpd.apache.org/mod_aspdotnet/</td></tr>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_aspdotnet</td></tr>
aee1f193a276866212922ae5072e3014db28582frpluem <p>The <code class="directive">AspNetMount</code> directive determines which
9bcfc3697a91b5215893a7d0206865b13fc72148nd physical directory is mounted by the ASP.NET host. This directive
9bcfc3697a91b5215893a7d0206865b13fc72148nd does -not- actually expose the content, you must use the
9bcfc3697a91b5215893a7d0206865b13fc72148nd <code class="directive"><a href="/mod/mod_alias.html#alias">Alias</a></code>
aee1f193a276866212922ae5072e3014db28582frpluem directive to expose the content to the remote user.</p>
aee1f193a276866212922ae5072e3014db28582frpluem<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<div class="directive-section"><h2><a name="AspNetVersion" id="AspNetVersion">AspNetVersion</a> <a name="aspnetversion" id="aspnetversion">Directive</a></h2>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force a specific .NET Framework version to be loaded</td></tr>
aee1f193a276866212922ae5072e3014db28582frpluem<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AspNetVersion <var>versionstring</var></code></td></tr>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
aee1f193a276866212922ae5072e3014db28582frpluem<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External, http://httpd.apache.org/mod_aspdotnet/</td></tr>
aee1f193a276866212922ae5072e3014db28582frpluem<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_aspdotnet</td></tr>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Build 2004 and later</td></tr>
aee1f193a276866212922ae5072e3014db28582frpluem <p>The <code class="directive">AspNetVersion</code> directive will override the
aee1f193a276866212922ae5072e3014db28582frpluem default (most current) .NET Framework environment, and elect a different
aee1f193a276866212922ae5072e3014db28582frpluem installed version of the .NET Framework. The chosen version must be
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele installed on the machine.</p>
aee1f193a276866212922ae5072e3014db28582frpluem <p>If this directive is not present, the most current .NET Framework version
aee1f193a276866212922ae5072e3014db28582frpluem is used. This directive should be specified only once, only the last occurance
aee1f193a276866212922ae5072e3014db28582frpluem in the httpd.conf file is used to elect the .NET Framework version.</p>
aee1f193a276866212922ae5072e3014db28582frpluem <p>See the c:\Windows\Microsoft.NET\Framework\ directory for all installed
aee1f193a276866212922ae5072e3014db28582frpluem versions and their version tags (the actual directory names).</p>
aee1f193a276866212922ae5072e3014db28582frpluem# Load mod_aspdotnet using the 1.0 release version of the .NET Framework
aee1f193a276866212922ae5072e3014db28582frpluemAspNetVersion v1.0.3705<br />
aee1f193a276866212922ae5072e3014db28582frpluem# Load mod_aspdotnet using the 1.1 release version of the .NET Framework
aee1f193a276866212922ae5072e3014db28582frpluemAspNetVersion v1.1.4322<br />
aee1f193a276866212922ae5072e3014db28582frpluem<p><span>Available Languages: </span><a href="/en/mod/mod_aspdotnet.html" title="English"> en </a></p>
aee1f193a276866212922ae5072e3014db28582frpluem<p class="apache">Copyright 1995-2006 The Apache Software Foundation or its licensors, as applicable.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
aee1f193a276866212922ae5072e3014db28582frpluem<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div>