<referral> Element

Article
09/13/2006

Controls the routing information for a WSE application.

<referral>
  <cache name="referralCache.config" />
</referral>

Attributes and Elements

Attributes

None

Child Elements

Element	Description
<cache> Element for <referral>	Specifies the referral cache for WSE router, which contains the list of routing directives.

Parent Elements

Element	Description
<microsoft.web.services3> Element	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>

Share via