WebBrowser.InvokeScript Méthode
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.
Exécute une fonction de script définie dans le document actuellement chargé.
Surcharges
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 qui est 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
Objet retourné par l'appel Active Scripting.
Exceptions
L’instance de WebBrowser n’est plus valide.
Impossible de récupérer une référence au WebBrowser
natif sous-jacent.
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 InvokeScript(String)de . 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 la fin du chargement du document qui l’implémente. Vous pouvez détecter le chargement d’un document en gérant l’événement LoadCompleted .
S’applique à
InvokeScript(String, Object[])
Exécute une fonction de script qui est 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
Objet retourné par l'appel Active Scripting.
- Attributs
Exceptions
L’instance de WebBrowser n’est plus valide.
Impossible de récupérer une référence au WebBrowser
natif sous-jacent.
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 la fin du chargement du document qui l’implémente. Vous pouvez détecter le chargement d’un document 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 de valeurs auront la valeur non définie. Si vous transmettez trop de valeurs de paramètre, les valeurs excédentaires sont ignorées.