Programming with Reflection

image\rwnprg32.gif AutoUpdateFile property



object.AutoUpdateFile = Value

Data type




Returns (first syntax line) or specifies (second syntax line) the name of a settings update file to be loaded automatically any time you open your settings file. For example, if you set AutoUpdateFile to "D:\Shared\Updates.rsu" and save this change to a complete settings file called MySettings.rsf, then any changes you make to the update settings file, Updates.rsu, are automatically loaded each time you open MySettings.rsf. If the AutoUpdateSave property is set to True (the default value), then the loaded changes are automatically saved to your complete settings file.

When AutoUpdateFile is set to an empty string (the default), Reflection looks for a settings update file called Settings.rsu in the Reflection user folder. This means that you can place a settings update file in the default location and the updates will be applied automatically even if you have not explicitly specified a value for AutoUpdateFile. For example, if you are running a default configuration of Windows XP or Windows 2000 and installed Reflection using default values, Reflection will automatically check for updates in the following location:

C:\Documents and Settings\<user>\My Documents\Attachmate\Reflection\Settings.rsu

You can use UNC path names or URLs to specify an update file located on a network server. This example uses a UNC path:

Session.AutoUpdateFile = "\\MyServer\Reflection\Update Demo.rsu"

This example uses a URL:

Session.AutoUpdateFile = "HTTP:// Demo.rsu"


· If AutoUpdateFile specifies a file that is not a settings update file, such as a regular settings file, the value of this property is ignored and no settings are loaded.


The default value is "".


image\jump.gif Keyword Index

image\popup.gif Related Topics

image\popup.gif Reflection products that use this property