WebBrowser.ScriptErrorsSuppressed Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
true
se o controle não exibir suas caixas de diálogo; caso contrário, false
. O padrão é false
.
Exceções
Essa instância WebBrowser não é mais válida.
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 false
como para 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 ser carregado, 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 para true
suprimir erros de script.
Observação
Quando ScriptErrorsSuppressed é definido true
como , 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.