WebBrowser.ScriptErrorsSuppressed WebBrowser.ScriptErrorsSuppressed WebBrowser.ScriptErrorsSuppressed WebBrowser.ScriptErrorsSuppressed Property

Définition

Obtient ou définit une valeur indiquant si le contrôle WebBrowser affiche les boîtes de dialogue telles que les messages d'erreur de script.Gets or sets a value indicating whether the WebBrowser displays dialog boxes such as script error messages.

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

Valeur de propriété

true si le contrôle n'affiche pas ses boîtes de dialogue ; sinon, false.true if the control does not display its dialog boxes; otherwise, false. La valeur par défaut est false.The default is false.

Exceptions

Cette instance de WebBrowser n'est plus valide.This WebBrowser instance is no longer valid.

Une référence à une implémentation de l’interface IWebBrowser2 n’a pas pu être récupérée du contrôle WebBrowser ActiveX sous-jacent.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Exemples

L’exemple de code suivant montre comment supprimer les erreurs de script sans supprimer les autres boîtes de dialogue.The following code example demonstrates how to suppress script errors without suppressing other dialog boxes. Dans l’exemple, la ScriptErrorsSuppressed propriété a la false valeur pour s’assurer que les boîtes de dialogue sont affichées.In the example, the ScriptErrorsSuppressed property is set to false to ensure that dialog boxes are displayed. Un gestionnaire pour l' HtmlWindow.Error événement supprime l’erreur.A handler for the HtmlWindow.Error event suppresses the error. Cet événement n’est accessible qu’à la fin du chargement d’un document. par conséquent, le DocumentCompleted gestionnaire est attaché dans un gestionnaire d’événements.This event is only accessible when a document is finished loading, so the handler is attached in a DocumentCompleted event handler.

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

Remarques

Affectez à cette false propriété la valeur pour déboguer les pages WebBrowser Web que vous affichez dans le contrôle.Set this property to false to debug Web pages that you display in the WebBrowser control. Cela est utile lorsque vous utilisez le contrôle pour ajouter des contrôles Web et du code de script à votre application.This is useful when you use the control to add Web-based controls and scripting code to your application. Elle est moins utile lorsque vous utilisez le contrôle comme navigateur générique.It is less useful when you use the control as a generic browser. Lorsque vous avez terminé de déboguer votre application, affectez true à cette propriété la valeur pour supprimer les erreurs de script.When you have finished debugging your application, set this property to true to suppress script errors.

Notes

Lorsque ScriptErrorsSuppressed a la truevaleur, le WebBrowser contrôle masque toutes les boîtes de dialogue qui proviennent du contrôle ActiveX sous-jacent, et pas seulement les erreurs de script.When ScriptErrorsSuppressed is set to true, the WebBrowser control hides all its dialog boxes that originate from the underlying ActiveX control, not just script errors. Parfois, vous devrez peut-être supprimer les erreurs de script lors de l’affichage de boîtes de dialogue telles que celles utilisées pour les paramètres de sécurité du navigateur et la connexion de l’utilisateur.Occasionally you might need to suppress script errors while displaying dialog boxes such as those used for browser security settings and user login. Dans ce cas, affectez false à la valeur ScriptErrorsSuppressed et supprimez les erreurs de HtmlWindow.Error script dans un gestionnaire pour l’événement.In this case, set ScriptErrorsSuppressed to false and suppress script errors in a handler for the HtmlWindow.Error event. Pour plus d’informations, consultez l’exemple de code dans cette rubrique.For more information, see the code example in this topic.

Sécurité

SecurityPermission
pour que les appelants immédiats utilisent ce contrôle.for immediate callers to use this control. Valeur de la LinkDemanddemande:; Jeux d’autorisations nommés: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

S’applique à

Voir aussi