<cache> Element for <referral>

Specifies the referral cache for the WSE router, which contains the list of routing directives.

<microsoft.web.services2> Element
  <referral> Element

<cache name="referralCache.config" />

Attributes and Elements

Attributes

Child Elements

None

Parent Elements

Remarks

Before adding the <cache> 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).

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.services2>
    <referral>
      <cache name="referralCache.config" />
    </referral>
  </microsoft.web.services2>
</configuration>

See Also

Reference

<referral> Element