WebBrowser.ObjectForScripting Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee kunt u een object ophalen of instellen dat toegankelijk is via scriptcode die is opgenomen in een webpagina die in het WebBrowser besturingselement wordt weergegeven.
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 ObjectWaarde van eigenschap
Het object dat beschikbaar wordt gesteld aan de scriptcode.
- Kenmerken
Uitzonderingen
De opgegeven waarde bij het instellen van deze eigenschap is een exemplaar van een niet-openbaar type.
– of –
De opgegeven waarde bij het instellen van deze eigenschap is een exemplaar van een type dat niet zichtbaar is voor COM. Zie IsTypeVisibleFromCom(Type) voor meer informatie.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de ObjectForScripting eigenschap gebruikt. In het voorbeeld wordt de ObjectForScripting eigenschap ingesteld op het huidige formulier.
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
Opmerkingen
Gebruik deze eigenschap om communicatie mogelijk te maken tussen een webpagina die wordt gehost door het WebBrowser besturingselement en de toepassing die het WebBrowser besturingselement bevat. Met deze eigenschap kunt u dynamische HTML-code (DHTML) integreren met uw clienttoepassingscode. Het object dat voor deze eigenschap is opgegeven, is beschikbaar voor webpaginascripts als het window.external object, een ingebouwd DOM-object dat is opgegeven voor hosttoegang.
U kunt deze eigenschap instellen op elk COM-zichtbaar object waarvoor u de openbare eigenschappen en methoden beschikbaar wilt maken voor scriptcode. U kunt een com-klasse zichtbaar maken door deze te markeren met de ComVisibleAttribute.
Als u functies wilt aanroepen die zijn gedefinieerd in uw webpagina vanuit de code van de clienttoepassing, gebruikt u de HtmlDocument.InvokeScript methode van het HtmlDocument object dat u uit de Document eigenschap kunt ophalen.
