WebBrowser.ScriptErrorsSuppressed Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
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
. La valeur par défaut est false
.
Exceptions
Cette instance de WebBrowser n'est plus valide.
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.
Exemples
L’exemple de code suivant montre comment supprimer les erreurs de script sans supprimer d’autres boîtes de dialogue. Dans l’exemple, la ScriptErrorsSuppressed propriété est définie sur false
pour s’assurer que les boîtes de dialogue sont affichées. Un gestionnaire pour l’événement HtmlWindow.Error supprime l’erreur. Cet événement n’est accessible qu’à la fin du chargement d’un document. Le gestionnaire est donc attaché à un gestionnaire d’événements 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
Remarques
Définissez cette propriété sur false
pour déboguer les pages Web que vous affichez dans le WebBrowser contrôle . Cela est utile lorsque vous utilisez le contrôle pour ajouter des contrôles web et du code de script à votre application. Il est moins utile lorsque vous utilisez le contrôle en tant que navigateur générique. Une fois le débogage de votre application terminé, définissez cette propriété sur true
pour supprimer les erreurs de script.
Notes
Lorsque ScriptErrorsSuppressed est défini sur true
, le WebBrowser contrôle masque toutes ses boîtes de dialogue qui proviennent du contrôle ActiveX sous-jacent, et pas seulement les erreurs de script. Parfois, vous devrez peut-être supprimer les erreurs de script lors de l’affichage des boîtes de dialogue telles que celles utilisées pour les paramètres de sécurité du navigateur et la connexion utilisateur. Dans ce cas, définissez ScriptErrorsSuppressedfalse
sur et supprimez les erreurs de script dans un gestionnaire pour l’événement HtmlWindow.Error . Pour plus d’informations, consultez l’exemple de code de cette rubrique.