Propriedade Application. AutomationSecurity (Excel)Application.AutomationSecurity property (Excel)

Retorna ou define uma constante MsoAutomationSecurity que representa o modo de segurança que o Microsoft Excel usa ao abrir arquivos por programação.Returns or sets an MsoAutomationSecurity constant that represents the security mode that Microsoft Excel uses when programmatically opening files. Leitura/gravação.Read/write.

SintaxeSyntax

expressão. AutomationSecurityexpression.AutomationSecurity

expressão Uma variável que representa um Aplicativo objeto.expression A variable that represents an Application object.

ComentáriosRemarks

Essa propriedade é definida automaticamente como msoAutomationSecurityLow quando o aplicativo é iniciado.This property is automatically set to msoAutomationSecurityLow when the application is started. Portanto, para evitar que as soluções que dependem da configuração padrão, você deve estar cuidado ao redefinir essa propriedade como msoAutomationSecurityLow após programaticamente abrir um arquivo.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. Além disso, essa propriedade deve ser definida imediatamente antes e após a abertura de um arquivo através de programação para evitar transtornos prejudiciais.Also, this property should be set immediately before and after opening a file programmatically to avoid malicious subversion.

MsoAutomationSecurity pode ser uma destas constantes MsoAutomationSecurity :MsoAutomationSecurity can be one of these MsoAutomationSecurity constants:

  • msoAutomationSecurityByUI.msoAutomationSecurityByUI. Usa a configuração de segurança especificada na caixa de diálogo Segurança.Uses the security setting specified in the Security dialog box.

  • msoAutomationSecurityForceDisable.msoAutomationSecurityForceDisable. Desabilita todas as macros em todos os arquivos abertos por programação sem mostrar alertas de segurança.Disables all macros in all files opened programmatically without showing any security alerts.

    Observação

    Esta configuração não desativa as macros do Microsoft Excel 4.0.This setting does not disable Microsoft Excel 4.0 macros. Se um arquivo que contém as macros do Microsoft Excel 4,0 for aberto programaticamente, o usuário será solicitado a decidir se deseja abrir o arquivo.If a file that contains Microsoft Excel 4.0 macros is opened programmatically, the user will be prompted to decide whether to open the file.

  • msoAutomationSecurityLow.msoAutomationSecurityLow. Habilita todas as macros.Enables all macros. É o valor padrão quando o aplicativo é iniciado.This is the default value when the application is started.

A definição de ScreenUpdating como false não afeta alertas e não afetará os avisos de segurança.Setting ScreenUpdating to False does not affect alerts and will not affect security warnings.

A configuração DisplayAlerts não se aplicará a avisos de segurança.The DisplayAlerts setting will not apply to security warnings. Por exemplo, se o usuário define DisplayAlerts igual a false e AutomationSecurity como msoAutomationSecurityByUI enquanto o usuário está no nível de segurança médio, haverá avisos de segurança enquanto a macro estiver em execução.For example, if the user sets DisplayAlerts equal to False and AutomationSecurity to msoAutomationSecurityByUI while the user is on Medium security level, there will be security warnings while the macro is running. Isso permite que a macro intercepte erros ao abrir arquivos, enquanto estiver mostrando avisos de segurança se o arquivo for aberto com sucesso.This allows the macro to trap file open errors, while still showing the security warning if the file open succeeds.

ExemploExample

Este exemplo captura a configuração de segurança atual, altera a configuração para desativar macros, exibe a caixa de diálogo Abrir e, após abrir o documento selecionado, restaura a configuração original para a segurança de automação.This example captures the current automation security setting, changes the setting to disable macros, displays the Open dialog box, and after opening the selected document, sets the automation security back to its original setting.

Sub Security() 
    Dim secAutomation As MsoAutomationSecurity 
 
    secAutomation = Application.AutomationSecurity 
 
    Application.AutomationSecurity = msoAutomationSecurityForceDisable 
    Application.FileDialog(msoFileDialogOpen).Show 
 
    Application.AutomationSecurity = secAutomation 
 
End Sub

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.