<cache> Element for <referral>
Specifies the referral cache for the WSE router, which contains the list of routing directives.
<microsoft.web.services3> Element
<referral> Element
<cache name="referralCache.config" />
Attributes and Elements
Attributes
| Attribute | Description |
|---|---|
name |
Required attribute. The path to a file on the local computer containing the routing directives. |
Child Elements
None
Parent Elements
| Element | Description |
|---|---|
Controls the routing information for a WSE application. |
Remarks
Before adding the <cache> element to a configuration file, you must add the microsoft.web.services3 configuration section handler to the configuration file. For details about adding the microsoft.web.services3 configuration section handler, see <section> Element.
It is strongly recommended that the file containing the referral cache have a .config extension. When ASP.NET is installed on a computer, ASP.NET prohibits files with a .config extension from being requested by a user. Failure to use a .config extension for the referral cache may allow Web browsers to request the referral cache, possibly exposing sensitive application information.
The WSE router requires that the file containing the referral cache not have the Read-only attribute set and that WSE has read/write access to the file. WSE runs under the account specified in the userName attribute of the <processModel> element in the Machine.config file. The default installation of the .NET Framework sets the userName attribute to machine. When the userName attribute is set to machine, WSE runs under an account named ASPNET. Therefore, the ASPNET account must be given read/write permissions to the referral cache file.
Example
The following code example specifies that the referral cache is in a file named referralCache.config in the root folder for the Web application.
<configuration>
<microsoft.web.services3>
<referral>
<cache name="referralCache.config" />
</referral>
</microsoft.web.services3>
</configuration>