WebBrowser.InvokeScript Méthode

Définition

Espace de noms:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Exécute une fonction de script définie dans le document actuellement chargé.

Surcharges

Nom Description
InvokeScript(String)

Exécute une fonction de script implémentée par le document actuellement chargé.
InvokeScript(String, Object[])

Exécute une fonction de script définie dans le document actuellement chargé.

InvokeScript(String)

Exécute une fonction de script implémentée par le document actuellement chargé.

public:
 System::Object ^ InvokeScript(System::String ^ scriptName);
public object InvokeScript(string scriptName);
member this.InvokeScript : string -> obj
Public Function InvokeScript (scriptName As String) As Object

Paramètres

scriptName
String

Nom de la fonction de script à exécuter.

Retours

Object

Objet retourné par l’appel de script actif.

Exceptions

ObjectDisposedException

L’instance WebBrowser n’est plus valide.

InvalidOperationException

Impossible de récupérer une référence au natif WebBrowser sous-jacent.

COMException

La fonction de script n’existe pas.

Exemples

L’exemple suivant montre comment appeler une fonction de script dans un document à partir d’une application WPF à l’aide de InvokeScript(String). Dans cet exemple, la fonction de script n’a aucun paramètre.

Voici le document HTML qui implémente la fonction de script qui sera appelée à partir de WPF.

<html>
    <head>
        <script type="text/javascript">
            // Function Without Parameters
            function JavaScriptFunctionWithoutParameters()
            {
              outputID.innerHTML = "JavaScript function called!";
            }
        </script>
    </head>
    <body>
    <div id="outputID" style="color:Red; font-size:16">
        Hello from HTML document with script!
    </div>
    </body>
</html>

L’exemple suivant montre l’implémentation WPF pour appeler la fonction de script dans le document HTML.

private void callScriptFunctionNoParamButton_Click(object sender, RoutedEventArgs e)
{
  // Make sure the HTML document has loaded before attempting to
  // invoke script of the document page. You could set loadCompleted
  // to true when the LoadCompleted event on the WebBrowser fires.
  if (this.loadCompleted)
  {
    try
    {
      this.webBrowser.InvokeScript("JavaScriptFunctionWithoutParameters");
    }
    catch (Exception ex)
    {
      string msg = "Could not call script: " +
                   ex.Message +
                  "\n\nPlease click the 'Load HTML Document with Script' button to load.";
      MessageBox.Show(msg);
    }
  }
}

Remarques

InvokeScript(String) ne doit pas être appelé avant le chargement du document qui l’implémente. Vous pouvez détecter quand un document a terminé le chargement en gérant l’événement LoadCompleted .

S’applique à

InvokeScript(String, Object[])

Exécute une fonction de script définie dans le document actuellement chargé.

public:
 System::Object ^ InvokeScript(System::String ^ scriptName, ... cli::array <System::Object ^> ^ args);
[System.Security.SecurityCritical]
public object InvokeScript(string scriptName, params object[] args);
public object InvokeScript(string scriptName, params object[] args);
[<System.Security.SecurityCritical>]
member this.InvokeScript : string * obj[] -> obj
member this.InvokeScript : string * obj[] -> obj
Public Function InvokeScript (scriptName As String, ParamArray args As Object()) As Object

Paramètres

scriptName
String

Nom de la fonction de script à exécuter.

args
Object[]

Paramètres à passer à la fonction de script.

Retours

Object

Objet retourné par l’appel de script actif.

Attributs
SecurityCriticalAttribute

Exceptions

ObjectDisposedException

L’instance WebBrowser n’est plus valide.

InvalidOperationException

Impossible de récupérer une référence au natif WebBrowser sous-jacent.

COMException

La fonction de script n’existe pas.

Exemples

L’exemple suivant montre comment appeler des fonctions de script dans un document à partir d’une application à l’aide InvokeScript(String, Object[])de . Dans cet exemple, les fonctions de script nécessitent des paramètres.

Voici le document qui implémente les fonctions de script qui seront appelées à partir de WPF.

<html>
    <head>
        <script type="text/javascript">
            // Function Without Parameters
            function JavaScriptFunctionWithoutParameters()
            {
              outputID.innerHTML = "JavaScript function 'called: " + message + ".";
            }
        </script>
    </head>
    <body>
    <div id="outputID" style="color:Red; font-size:16">
        Hello from HTML document with script!
    </div>
    </body>
</html>

L’exemple suivant montre l’implémentation WPF pour appeler les fonctions de script dans le document HTML.

private void callScriptFunctionNoParamButton_Click(object sender, RoutedEventArgs e)
{
  // Make sure the HTML document has loaded before attempting to
  // invoke script of the document page. You could set loadCompleted
  // to true when the LoadCompleted event on the WebBrowser fires.
  if (this.loadCompleted)
  {
    try
    {
      this.webBrowser.InvokeScript("JavaScriptFunctionWithoutParameters", this.messageTextBox.Text);
    }
    catch (Exception ex)
    {
      string msg = "Could not call script: " +
                   ex.Message +
                  "\n\nPlease click the 'Load HTML Document with Script' button to load.";
      MessageBox.Show(msg);
    }
  }
}

Remarques

InvokeScript(String, Object[]) ne doit pas être appelé avant le chargement du document qui l’implémente. Vous pouvez détecter quand un document a terminé le chargement en gérant l’événement LoadCompleted .

Si vous ne transmettez pas suffisamment de valeurs de paramètre au script que vous appelez, les paramètres auxquels vous ne transmettez pas les valeurs auront la valeur non définie. Si vous transmettez trop de valeurs de paramètre, les valeurs excédentaires sont ignorées.

S’applique à