WebBrowser.ObjectForScripting Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ottiene o imposta un oggetto al quale si può accedere tramite il codice di script contenuto in una pagina Web visualizzata nel controllo 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)>]
member this.ObjectForScripting : obj with get, set
Public Property ObjectForScripting As Object

Valore della proprietà

Object

Oggetto reso disponibile al codice di script.

Attributi
BrowsableAttribute

Eccezioni

ArgumentException

Il valore specificato durante l'impostazione di questa proprietà è un'istanza di un tipo non pubblico.

-oppure- Il valore specificato durante l'impostazione di questa proprietà è un'istanza di un tipo non visibile a COM. Per altre informazioni, vedere IsTypeVisibleFromCom(Type).

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la ObjectForScripting proprietà . Nell'esempio la ObjectForScripting proprietà viene impostata sul form corrente.

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

Commenti

Utilizzare questa proprietà per abilitare la comunicazione tra una pagina Web ospitata dal WebBrowser controllo e l'applicazione che contiene il WebBrowser controllo . Questa proprietà consente di integrare codice HTML (DHTML) dinamico con il codice dell'applicazione client. L'oggetto specificato per questa proprietà è disponibile per lo script della pagina Web come oggetto , che è un oggetto DOM predefinito fornito per l'accesso all'host window.external .

È possibile impostare questa proprietà su qualsiasi oggetto visibile com per il quale si desidera che le proprietà e i metodi pubblici siano disponibili per lo scripting del codice. È possibile rendere visibile una classe COM contrassegnandola con .ComVisibleAttribute

Per chiamare le funzioni definite nella pagina Web dal codice dell'applicazione client, usare il HtmlDocument.InvokeScript metodo dell'oggetto HtmlDocument che è possibile recuperare dalla Document proprietà .

Si applica a

Vedi anche