Controls the routing information for a WSE application.<microsoft.web.services2> Element
Before adding the <referral> element to a configuration file, you must add the microsoft.web.services2 configuration section handler to the configuration file. For details about adding the microsoft.web.services2 configuration section handler, see <section> Element (WSE for Microsoft .NET).
If this element is added to a configuration file and the file referenced by the name attribute does not exist, an exception is thrown.
If multiple entries in the cache configuration file are targeted for the same <for>, only the first one will get loaded.
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.
The following code example specifies the referral cache is in a file named
referralCache.config in the root folder for the Web application.
<configuration> <microsoft.web.services2> <referral> <cache name="referralCache.config" /> </referral> </microsoft.web.services2> </configuration>