WebBrowser.ObjectForScripting Egenskap

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll
Källa:
WebBrowser.cs
Källa:
WebBrowser.cs
Källa:
WebBrowser.cs
Källa:
WebBrowser.cs
Källa:
WebBrowser.cs

Hämtar eller anger ett objekt som kan nås genom skriptkod som finns på en webbsida som visas i WebBrowser kontrollen.

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, set
Public Property ObjectForScripting As Object

Egenskapsvärde

Object

Objektet som görs tillgängligt för skriptkoden.

Attribut
BrowsableAttribute

Undantag

ArgumentException

Det angivna värdet när du anger den här egenskapen är en instans av en icke-offentlig typ.

-eller-

Det angivna värdet när du anger den här egenskapen är en instans av en typ som inte är COM-synlig. Mer information finns i IsTypeVisibleFromCom(Type).

Exempel

Följande kodexempel visar hur du använder egenskapen ObjectForScripting . I exemplet är egenskapen ObjectForScripting inställd på det aktuella formuläret.

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

Kommentarer

Använd den här egenskapen för att aktivera kommunikation mellan en webbsida som hanteras av WebBrowser kontrollen och det program som innehåller WebBrowser kontrollen. Med den här egenskapen kan du integrera dynamisk HTML-kod (DHTML) med klientprogramkoden. Objektet som anges för den här egenskapen är tillgängligt för webbsideskriptet window.external som objektet, som är ett inbyggt DOM-objekt som tillhandahålls för värdåtkomst.

Du kan ställa in den här egenskapen på alla COM-synliga objekt som du vill att dess offentliga egenskaper och metoder ska vara tillgängliga för skriptkod för. Du kan göra en com-synlig klass genom att markera den med ComVisibleAttribute.

Om du vill anropa funktioner som definierats på webbsidan från klientprogramkoden använder HtmlDocument.InvokeScript du metoden för det HtmlDocument objekt som du kan hämta från Document egenskapen.

Gäller för

Se även