Cenni preliminari sul controllo WebBrowser

Il controllo WebBrowser fornisce un wrapper gestito per il controllo ActiveX WebBrowser. Il wrapper gestito consente di visualizzare pagine Web nelle applicazioni client Windows Form. È possibile utilizzare il controllo WebBrowser per duplicare le funzionalità del browser Internet Explorer nell'applicazione oppure disabilitare le funzionalità predefinite di Internet Explorer e utilizzare il controllo come semplice visualizzatore di documenti HTML. Il controllo inoltre può essere utilizzato per aggiungere elementi dell'interfaccia utente basata su DHTML al form e nascondere il fatto che siano inclusi nel controllo WebBrowser. Questo approccio consente di combinare facilmente in un'unica applicazione i controlli Web e i controlli Windows Form.

Proprietà, metodi ed eventi di uso comune

Il controllo WebBrowser dispone di numerose proprietà, metodi ed eventi che possono essere utilizzati per implementare i controlli disponibili in Internet Explorer. È possibile utilizzare, ad esempio, il metodo Navigate per implementare una barra degli indirizzi e i metodi GoBack, GoForward, Stop e Refresh per implementare i pulsanti di spostamento su una barra degli strumenti. L'evento Navigated può essere gestito per aggiornare la barra degli indirizzi con il valore della proprietà Url e la barra del titolo con il valore della proprietà DocumentTitle.

Se si desidera generare contenuto personalizzato per le pagine all'interno dell'applicazione, è possibile impostare la proprietà DocumentText. Se si ha dimestichezza con il modello DOM (Document Object Model) HTML, è anche possibile modificare il contenuto della pagina Web corrente mediante la proprietà Document. Con questa proprietà, è possibile archiviare e modificare i documenti in memoria anziché spostarsi tra i vari file.

La proprietà Document consente inoltre di chiamare i metodi implementati nel codice di script delle pagine Web dal codice dell'applicazione client. Per accedere al codice dell'applicazione client dal codice di script, impostare la proprietà ObjectForScripting. L'oggetto specificato sarà accessibile al codice di script come oggetto window.external.

Nome

Descrizione

Proprietà Document

Consente di ottenere un oggetto che fornisce accesso gestito al modello DOM (Document Object Model) HTML della pagina Web corrente.

Evento DocumentCompleted

Si verifica una volta completato il caricamento di una pagina Web.

Proprietà DocumentText

Consente di ottenere o impostare il contenuto HTML della pagina Web corrente.

Proprietà DocumentTitle

Consente di ottenere il titolo della pagina Web corrente.

Metodo GoBack

Consente di passare alla pagina precedente della cronologia.

Metodo GoForward

Consente di passare alla pagina successiva della cronologia.

Metodo Navigate

Consente di passare all'URL specificato.

Evento Navigating

Viene eseguito prima dell'avvio dello spostamento, consentendo l'annullamento dell'azione.

Proprietà ObjectForScripting

Consente di ottenere o impostare un oggetto che può essere utilizzato dal codice di script della pagina Web per comunicare con l'applicazione.

Metodo Print

Consente di stampare la pagina Web corrente.

Metodo Refresh

Consente di ricaricare la pagina Web corrente.

Metodo Stop

Consente di arrestare lo spostamento corrente e interrompere gli elementi di pagina dinamici, come ad esempio gli effetti audio e di animazione.

Proprietà Url

Consente di ottenere o impostare l'URL della pagina Web corrente. L'impostazione di questa proprietà consente di passare al nuovo URL con il controllo.

Vedere anche

Attività

Procedura: passare a un URL con il controllo WebBrowser

Procedura: stampare con un controllo WebBrowser

Procedura: aggiungere funzionalità del browser Web a un'applicazione Windows Form

Procedura: creare un visualizzatore di documenti HTML in un'applicazione Windows Form

Procedura: implementare comunicazioni bidirezionali tra il codice DHTML e il codice dell'applicazione client

Riferimenti

WebBrowser

WebBrowserDocumentCompletedEventArgs

WebBrowserDocumentCompletedEventHandler

WebBrowserEncryptionLevel

WebBrowserNavigatedEventArgs

WebBrowserNavigatedEventHandler

WebBrowserNavigatingEventArgs

WebBrowserNavigatingEventHandler

WebBrowserProgressChangedEventArgs

WebBrowserReadyState

WebBrowserRefreshOption

Concetti

Sicurezza dei controlli WebBrowser