WebBrowser.ScriptErrorsSuppressed Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает или задает значение, указывающее, отображаются ли элементом управления WebBrowser диалоговые окна, такие как сообщения об ошибках скрипта.

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

Значение свойства

Boolean

Значение true, если элементом управления отображаются его диалоговые окна; в противном случае — значение false. Значение по умолчанию — false.

Исключения

ObjectDisposedException

Данный экземпляр WebBrowser больше не действителен.

InvalidOperationException

Ссылка на реализацию интерфейса IWebBrowser2 не может быть получена из базового ActiveX элемента управления WebBrowser.

Примеры

В следующем примере кода показано, как подавлять ошибки скрипта без подавления других диалоговых окон. В этом примере свойству ScriptErrorsSuppressed присваивается значение false , чтобы обеспечить отображение диалоговых окон. Обработчик события HtmlWindow.Error подавляет ошибку. Это событие доступно только после завершения загрузки документа, поэтому обработчик присоединяется к обработчику DocumentCompleted событий.

// 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

Комментарии

Присвойте этому свойству значение false для отладки веб-страниц, отображаемых в элементе WebBrowser управления . Это полезно при использовании элемента управления для добавления веб-элементов управления и кода сценариев в приложение. Это менее полезно при использовании элемента управления в качестве универсального браузера. Завершив отладку приложения, присвойте этому свойству значение true , чтобы отключить ошибки скрипта.

Примечание

Если ScriptErrorsSuppressed задано значение true, WebBrowser элемент управления скрывает все диалоговые окна, исходящие из базового элемента управления ActiveX, а не только ошибки скрипта. Иногда может потребоваться отключить ошибки скрипта при отображении диалоговых окон, например тех, которые используются для параметров безопасности браузера и входа пользователя. В этом случае задайте значение ScriptErrorsSuppressedfalse и подавляйте ошибки скрипта в обработчике HtmlWindow.Error события. Дополнительные сведения см. в примере кода в этом разделе.

См. также раздел

• Элемент управления WebBrowser
• Интерфейс IWebBrowser2