WebBrowser.ObjectForScripting Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um objeto que pode ser acessado pelo código de script contido em uma página da Web exibida no WebBrowser controle.
public:
property System::Object ^ ObjectForScripting { System::Object ^ get(); void set(System::Object ^ value); };[System.ComponentModel.Browsable(false)]
public object ObjectForScripting { get; set; }[System.ComponentModel.Browsable(false)]
public object? ObjectForScripting { get; set; }[<System.ComponentModel.Browsable(false)>]
member this.ObjectForScripting : obj with get, setPublic Property ObjectForScripting As ObjectValor da propriedade
O objeto que está sendo disponibilizado para o código de script.
- Atributos
Exceções
O valor especificado ao definir essa propriedade é uma instância de um tipo não público.
- ou -
O valor especificado ao definir essa propriedade é uma instância de um tipo que não é visível para COM. Para obter mais informações, consulte IsTypeVisibleFromCom(Type).
Exemplos
O exemplo de código a seguir demonstra como usar a ObjectForScripting propriedade. No exemplo, a ObjectForScripting propriedade é definida como o formulário atual.
using System;
using System.Windows.Forms;
using System.Security.Permissions;
[System.Runtime.InteropServices.ComVisibleAttribute(true)]
public class Form1 : Form
{
private WebBrowser webBrowser1 = new WebBrowser();
private Button button1 = new Button();
[STAThread]
public static void Main()
{
Application.EnableVisualStyles();
Application.Run(new Form1());
}
public Form1()
{
button1.Text = "call script code from client code";
button1.Dock = DockStyle.Top;
button1.Click += new EventHandler(button1_Click);
webBrowser1.Dock = DockStyle.Fill;
Controls.Add(webBrowser1);
Controls.Add(button1);
Load += new EventHandler(Form1_Load);
}
private void Form1_Load(object sender, EventArgs e)
{
webBrowser1.AllowWebBrowserDrop = false;
webBrowser1.IsWebBrowserContextMenuEnabled = false;
webBrowser1.WebBrowserShortcutsEnabled = false;
webBrowser1.ObjectForScripting = this;
// Uncomment the following line when you are finished debugging.
//webBrowser1.ScriptErrorsSuppressed = true;
webBrowser1.DocumentText =
"<html><head><script>" +
"function test(message) { alert(message); }" +
"</script></head><body><button " +
"onclick=\"window.external.Test('called from script code')\">" +
"call client code from script code</button>" +
"</body></html>";
}
public void Test(String message)
{
MessageBox.Show(message, "client code");
}
private void button1_Click(object sender, EventArgs e)
{
webBrowser1.Document.InvokeScript("test",
new String[] { "called from client code" });
}
}
Imports System.Windows.Forms
Imports System.Security.Permissions
<PermissionSet(SecurityAction.Demand, Name:="FullTrust")> _
<System.Runtime.InteropServices.ComVisibleAttribute(True)> _
Public Class Form1
Inherits Form
Private webBrowser1 As New WebBrowser()
Private WithEvents button1 As New Button()
<STAThread()> _
Public Shared Sub Main()
Application.EnableVisualStyles()
Application.Run(New Form1())
End Sub
Public Sub New()
button1.Text = "call script code from client code"
button1.Dock = DockStyle.Top
webBrowser1.Dock = DockStyle.Fill
Controls.Add(webBrowser1)
Controls.Add(button1)
End Sub
Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) _
Handles Me.Load
webBrowser1.AllowWebBrowserDrop = False
webBrowser1.IsWebBrowserContextMenuEnabled = False
webBrowser1.WebBrowserShortcutsEnabled = False
webBrowser1.ObjectForScripting = Me
' Uncomment the following line when you are finished debugging.
'webBrowser1.ScriptErrorsSuppressed = True
webBrowser1.DocumentText = _
"<html><head><script>" & _
"function test(message) { alert(message); }" & _
"</script></head><body><button " & _
"onclick=""window.external.Test('called from script code')"" > " & _
"call client code from script code</button>" & _
"</body></html>"
End Sub
Public Sub Test(ByVal message As String)
MessageBox.Show(message, "client code")
End Sub
Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
Handles button1.Click
webBrowser1.Document.InvokeScript("test", _
New String() {"called from client code"})
End Sub
End Class
Comentários
Use essa propriedade para habilitar a comunicação entre uma página da WebBrowser Web hospedada pelo controle e o aplicativo que contém o WebBrowser controle. Essa propriedade permite que você integre o código HTML dinâmico (DHTML) ao código do aplicativo cliente. O objeto especificado para essa propriedade está disponível para o script de página da Web como o window.external objeto, que é um objeto DOM interno fornecido para acesso ao host.
Você pode definir essa propriedade para qualquer objeto com visível para o qual deseja que suas propriedades públicas e métodos disponíveis para o código de script. Você pode tornar uma classe COM visível marcando-a com o ComVisibleAttribute.
Para chamar funções definidas na página da Web do código do aplicativo cliente, use o HtmlDocument.InvokeScript método do HtmlDocument objeto que você pode recuperar da Document propriedade.
