Бөлісу құралы:

WebBrowser.ObjectForScripting Свойство

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll
Исходный код:
WebBrowser.cs
Исходный код:
WebBrowser.cs
Исходный код:
WebBrowser.cs
Исходный код:
WebBrowser.cs
Исходный код:
WebBrowser.cs

Получает или задает объект, к которому можно получить доступ с помощью кода скрипта, содержащегося на веб-странице, отображаемой в элементе WebBrowser управления.

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

Значение свойства

Object

Объект, который предоставляется коду скрипта.

Атрибуты
BrowsableAttribute

Исключения

ArgumentException

Указанное значение при настройке этого свойства является экземпляром недоступного типа.

–или–

Указанное значение при настройке этого свойства является экземпляром типа, который не отображается com-видимым. Дополнительные сведения см. в разделе IsTypeVisibleFromCom(Type).

Примеры

В следующем примере кода показано, как использовать ObjectForScripting свойство. В примере ObjectForScripting для свойства задана текущая форма.

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

Комментарии

Это свойство позволяет включить взаимодействие между веб-страницей, WebBrowser размещенной элементом управления, и приложением, содержащим элемент WebBrowser управления. Это свойство позволяет интегрировать динамический код HTML (DHTML) с кодом клиентского приложения. Объект, указанный для этого свойства, доступен для скрипта веб-страницы в качестве window.external объекта, который является встроенным объектом DOM, предоставляемым для доступа к узлу.

Это свойство можно задать для любого объекта COM-видимого объекта, для которого требуется его общедоступные свойства и методы, доступные для кода скриптов. Класс COM можно сделать видимым, помечая его с помощью ComVisibleAttribute.

Чтобы вызвать функции, определенные на веб-странице из кода клиентского HtmlDocument приложения, используйте HtmlDocument.InvokeScript метод объекта, который можно получить из Document свойства.

Применяется к

См. также раздел