WebBrowser.InvokeScript Método

Definição

Executa uma função de script definida no documento carregado atualmente.Executes a scripting function defined in the currently loaded document.

Sobrecargas

InvokeScript(String)

Executa uma função de script implementada pelo documento carregado no momento.Executes a script function that is implemented by the currently loaded document.

InvokeScript(String, Object[])

Executa uma função de script definida no documento atualmente carregado.Executes a script function that is defined in the currently loaded document.

InvokeScript(String)

Executa uma função de script implementada pelo documento carregado no momento.Executes a script function that is implemented by the currently loaded document.

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

Parâmetros

scriptName
String

O nome da função de script a ser executada.The name of the script function to execute.

Retornos

O objeto retornado pela chamada de Script Ativo.The object returned by the Active Scripting call.

Exceções

A instância WebBrowser não é mais válida.The WebBrowser instance is no longer valid.

Não foi possível recuperar uma referência ao WebBrowser nativo subjacente.A reference to the underlying native WebBrowser could not be retrieved.

A função de script não existe.The script function does not exist.

Exemplos

O exemplo a seguir mostra como chamar uma função de script em um documento de um aplicativo WPFWPF usando InvokeScript(String).The following example shows how to call a script function in a document from a WPFWPF application by using InvokeScript(String). Neste exemplo, a função script não tem parâmetros.In this example, the script function has no parameters.

Veja a seguir o documento HTMLHTML que implementa a função de script que será chamada a partir de WPFWPF.The following is the HTMLHTML document that implements the script function that will be called from WPFWPF.

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

O seguinte mostra a implementação de WPFWPF para chamar a função script no documento HTMLHTML.The following shows the WPFWPF implementation to call the script function in the HTMLHTML document.

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);  
    }  
  }  
}  

Comentários

InvokeScript(String) não deve ser chamado antes que o documento que o implementa tenha terminado de ser carregado.InvokeScript(String) should not be called before the document that implements it has finished loading. Você pode detectar quando um documento concluiu o carregamento manipulando o evento LoadCompleted.You can detect when a document has finished loading by handling the LoadCompleted event.

InvokeScript(String, Object[])

Executa uma função de script definida no documento atualmente carregado.Executes a script function that is defined in the currently loaded document.

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

Parâmetros

scriptName
String

O nome da função de script a ser executada.The name of the script function to execute.

args
Object[]

Os parâmetros a serem passados para a função de script.The parameters to pass to the script function.

Retornos

O objeto retornado pela chamada de Script Ativo.The object returned by the Active Scripting call.

Atributos

Exceções

A instância WebBrowser não é mais válida.The WebBrowser instance is no longer valid.

Não foi possível recuperar uma referência ao WebBrowser nativo subjacente.A reference to the underlying native WebBrowser could not be retrieved.

A função de script não existe.The script function does not exist.

Exemplos

O exemplo a seguir mostra como chamar funções de script em um documento por meio de um aplicativo usando InvokeScript(String, Object[]).The following example shows how to call script functions in a document from an application by using InvokeScript(String, Object[]). Neste exemplo, as funções de script exigem parâmetros.In this example, the script functions require parameters.

Este é o documento que implementa as funções de script que serão chamadas de WPFWPF.The following is the document that implements the script functions that will be called from WPFWPF.

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

O seguinte mostra a implementação de WPFWPF para chamar as funções de script no documento HTMLHTML.The following shows the WPFWPF implementation to call the script functions in the HTMLHTML document.

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);  
    }  
  }  
}  

Comentários

InvokeScript(String, Object[]) não deve ser chamado antes que o documento que o implementa tenha terminado de ser carregado.InvokeScript(String, Object[]) should not be called before the document that implements it has finished loading. Você pode detectar quando um documento concluiu o carregamento manipulando o evento LoadCompleted.You can detect when a document has finished loading by handling the LoadCompleted event.

Se você não passar valores de parâmetro suficientes para o script que está invocando, os parâmetros para os quais você não passa valores terão o valor indefinido.If you do not pass enough parameter values to the script that you are invoking, the parameters that you do not pass values to will have the undefined value. Se você passar muitos valores de parâmetro, os valores em excesso serão ignorados.If you pass too many parameter values, the excess values are ignored.

Aplica-se a