WebBrowser.ScriptErrorsSuppressed Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define um valor que indica se o WebBrowser exibe caixas de diálogo como mensagens de erro de script.

public:
 property bool ScriptErrorsSuppressed { bool get(); void set(bool value); };
public bool ScriptErrorsSuppressed { get; set; }
member this.ScriptErrorsSuppressed : bool with get, set
Public Property ScriptErrorsSuppressed As Boolean

Valor da propriedade

Boolean

true se o controle não exibir suas caixas de diálogo; caso contrário, false. O padrão é false.

Exceções

ObjectDisposedException

Essa instância WebBrowser não é mais válida.

InvalidOperationException

Uma referência a uma implementação da interface IWebBrowser2 não pôde ser recuperada do controle WebBrowser do ActiveX subjacente.

Exemplos

O exemplo de código a seguir demonstra como suprimir erros de script sem suprimir outras caixas de diálogo. No exemplo, a ScriptErrorsSuppressed propriedade é definida como para false garantir que as caixas de diálogo sejam exibidas. Um manipulador para o HtmlWindow.Error evento suprime o erro. Esse evento só é acessível quando um documento termina de carregar, portanto, o manipulador é anexado em um DocumentCompleted manipulador de eventos.

// Hides script errors without hiding other dialog boxes.
private void SuppressScriptErrorsOnly(WebBrowser browser)
{
    // Ensure that ScriptErrorsSuppressed is set to false.
    browser.ScriptErrorsSuppressed = false;

    // Handle DocumentCompleted to gain access to the Document object.
    browser.DocumentCompleted +=
        new WebBrowserDocumentCompletedEventHandler(
            browser_DocumentCompleted);
}

private void browser_DocumentCompleted(object sender, 
    WebBrowserDocumentCompletedEventArgs e)
{
    ((WebBrowser)sender).Document.Window.Error += 
        new HtmlElementErrorEventHandler(Window_Error);
}

private void Window_Error(object sender, 
    HtmlElementErrorEventArgs e)
{
    // Ignore the error and suppress the error dialog box. 
    e.Handled = true;
}

' Hides script errors without hiding other dialog boxes.
Private Sub SuppressScriptErrorsOnly(ByVal browser As WebBrowser)

    ' Ensure that ScriptErrorsSuppressed is set to false.
    browser.ScriptErrorsSuppressed = False

    ' Handle DocumentCompleted to gain access to the Document object.
    AddHandler browser.DocumentCompleted, _
        AddressOf browser_DocumentCompleted

End Sub

Private Sub browser_DocumentCompleted(ByVal sender As Object, _
ByVal e As WebBrowserDocumentCompletedEventArgs)

    AddHandler CType(sender, WebBrowser).Document.Window.Error, _
        AddressOf Window_Error

End Sub

Private Sub Window_Error(ByVal sender As Object, _
    ByVal e As HtmlElementErrorEventArgs)

    ' Ignore the error and suppress the error dialog box. 
    e.Handled = True

End Sub

Comentários

Defina essa propriedade como false para depurar páginas da Web exibidas no WebBrowser controle . Isso é útil quando você usa o controle para adicionar controles baseados na Web e código de script ao seu aplicativo. É menos útil quando você usa o controle como um navegador genérico. Quando terminar de depurar seu aplicativo, defina essa propriedade como true para suprimir erros de script.

Observação

Quando ScriptErrorsSuppressed é definido como true, o WebBrowser controle oculta todas as caixas de diálogo originadas do controle ActiveX subjacente, não apenas erros de script. Ocasionalmente, talvez seja necessário suprimir erros de script ao exibir caixas de diálogo, como aquelas usadas para configurações de segurança do navegador e logon do usuário. Nesse caso, defina ScriptErrorsSuppressed como false e suprima erros de script em um manipulador para o HtmlWindow.Error evento. Para obter mais informações, consulte o exemplo de código neste tópico.

Aplica-se a

Confira também