Bagikan melalui

WebBrowser.ObjectForScripting Properti

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll
Sumber:
WebBrowser.cs
Sumber:
WebBrowser.cs
Sumber:
WebBrowser.cs
Sumber:
WebBrowser.cs
Sumber:
WebBrowser.cs

Mendapatkan atau mengatur objek yang dapat diakses dengan kode skrip yang terkandung dalam halaman Web yang ditampilkan dalam WebBrowser kontrol.

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

Nilai Properti

Object

Objek yang tersedia untuk kode pembuatan skrip.

Atribut
BrowsableAttribute

Pengecualian

ArgumentException

Nilai yang ditentukan saat mengatur properti ini adalah instans dari jenis non-publik.

-atau-

Nilai yang ditentukan saat mengatur properti ini adalah instans jenis yang tidak terlihat COM. Untuk informasi selengkapnya, lihat IsTypeVisibleFromCom(Type) .

Contoh

Contoh kode berikut menunjukkan cara menggunakan ObjectForScripting properti . Dalam contoh, ObjectForScripting properti diatur ke formulir saat ini.

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

Keterangan

Gunakan properti ini untuk mengaktifkan komunikasi antara halaman Web yang dihosting oleh WebBrowser kontrol dan aplikasi yang berisi WebBrowser kontrol. Properti ini memungkinkan Anda mengintegrasikan kode HTML dinamis (DHTML) dengan kode aplikasi klien Anda. Objek yang ditentukan untuk properti ini tersedia untuk skrip halaman Web sebagai window.external objek, yang merupakan objek DOM bawaan yang disediakan untuk akses host.

Anda dapat mengatur properti ini ke objek yang terlihat COM tempat Anda ingin properti dan metode publiknya tersedia untuk kode pembuatan skrip. Anda dapat membuat kelas COM-terlihat dengan menandainya dengan ComVisibleAttribute.

Untuk memanggil fungsi yang ditentukan di halaman Web Anda dari kode aplikasi klien Anda, gunakan HtmlDocument.InvokeScript metode objek yang HtmlDocument dapat Anda ambil dari Document properti .

Berlaku untuk

Lihat juga