<referral> Element
Controls the routing information for a WSE application.
<microsoft.web.services3> Element
<referral>
<cache name="referralCache.config" />
</referral>
Attributes and Elements
Attributes
None
Child Elements
| Element | Description |
|---|---|
Specifies the referral cache for WSE router, which contains the list of routing directives. |
Parent Elements
| Element | Description |
|---|---|
Controls the configuration options defined by WSE. |
Remarks
Before adding the <referral> 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.
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.
Example
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.services3>
<referral>
<cache name="referralCache.config" />
</referral>
</microsoft.web.services3>
</configuration>