Cenni preliminari sul controllo WebBrowser

Articolo
09/12/2008

Aggiornamento: novembre 2007

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 disattivare 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

Condividi tramite

Cenni preliminari sul controllo WebBrowser

Proprietà, metodi ed eventi di uso comune

Vedere anche

Attività

Concetti

Riferimenti

Risorse aggiuntive