_Application.AutomationSecurity Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Returns or sets an MsoAutomationSecurity constant that represents the security mode Microsoft Excel uses when programmatically opening files.
public:
property Microsoft::Office::Core::MsoAutomationSecurity AutomationSecurity { Microsoft::Office::Core::MsoAutomationSecurity get(); void set(Microsoft::Office::Core::MsoAutomationSecurity value); };public Microsoft.Office.Core.MsoAutomationSecurity AutomationSecurity { get; set; }Public Property AutomationSecurity As MsoAutomationSecurityProperty Value
Remarks
This property is automatically set to msoAutomationSecurityLow when the application is started. Therefore, to avoid breaking solutions that rely on the default setting, you should be careful to reset this property to msoAutomationSecurityLow after programmatically opening a file. Also, this property should be set immediately before and after opening a file programmatically to avoid malicious subversion.
MsoAutomationSecurity can be one of these MsoAutomationSecurity constants:
- msoAutomationSecurityByUI Uses the security setting specified in the Security dialog box.
- msoAutomationSecurityForceDisable Disables all macros in all files opened programmatically without showing any security alerts.
- msoAutomationSecurityLow Enables all macros. This is the default value when the application is started.
Setting ScreenUpdating to False does not affect alerts and will not affect security warnings. The DisplayAlerts setting will not apply to security warnings. For example, if the user sets DisplayAlerts equal to False and AutomationSecurity to msoAutomationSecurityByUI, while the user is on medium security level, then there will be security warnings while the macro is running. This allows the macro to trap file open errors, while still showing the security warning if the file open succeeds.