Compartilhar via


Classes principais para WebView2: Ambiente, Controlador e Núcleo

As CoreWebView2Environmentclasses , CoreWebView2Controllere CoreWebView2 (ou interfaces equivalentes) funcionam em conjunto para que a sua aplicação possa alojar um controlo de browser WebView2 e aceder às respetivas funcionalidades do browser. Estas três classes grandes expõem uma vasta gama de APIs às quais a sua aplicação anfitriã pode aceder para fornecer várias categorias de funcionalidades relacionadas com o browser aos seus utilizadores.

  • A CoreWebView2Environment classe representa um grupo de controlos WebView2 que partilham o mesmo processo de browser WebView2, pasta de dados do utilizador e compositor. A partir desta CoreWebView2Environment classe, vai criar pares de CoreWebView2Controller e CoreWebView2 instâncias.

  • A CoreWebView2Controller classe é responsável por funcionalidades relacionadas com o alojamento, como o foco da janela, visibilidade, tamanho e entrada, onde a sua aplicação aloja o controlo WebView2.

  • A CoreWebView2 classe destina-se às partes específicas da Web do controlo WebView2, incluindo rede, navegação, script e análise e composição de HTML.

Implementação da API entre plataformas

A maioria das APIs webView2 são desenvolvidas inicialmente para C++e, em seguida, a maioria das APIs C++ são encapsuladas como APIs C#. Desta forma, existe um paralelismo e equivalência consistentes entre plataformas e linguagens de programação.

Descrição geral das classes de nível superior

Descrição geral de:

  • CoreWebView2Environment
  • CoreWebView2
  • CoreWebView2Controller vs. WebView2 classes (classe de elemento WebView2 específica da arquitetura da IU, como as classes WPF, WinForms ou WinUI WebView2 ).

ou, equivalente a:

  • ICoreWebView2Environment
  • ICoreWebView2
  • ICoreWebView2Controller

CoreWebView2Environment representa um grupo de controlos WebView2 que todos partilham o seguinte:

  • Partilham o mesmo processo de browser WebView2.
  • Partilham a mesma pasta de dados de utilizador.
  • Potencialmente, partilham o compositor WebView2 e outros processos WebView2.

A partir do CoreWebView2Environment, cria CoreWebView2Controller e CoreWebView2 emparelha. Juntam-se sempre como um CoreWebView2Controller e um correspondente CoreWebView2.

  • O CoreWebView2Controller é responsável por todas as funcionalidades relacionadas com o alojamento, como o foco, visibilidade, tamanho e entrada.
  • O CoreWebView2 é para as partes específicas da Web do controlo WebView2, incluindo rede, navegação, script e análise e composição de HTML.

Classe de elemento WebView2 específica da arquitetura da IU, como classes WPF, WinForms ou WinUI WebView2

É diferente se estiver a utilizar uma classe de elemento WebView2 específica da IU, como as classes WPF, WinForms ou WinUI WebView2.

Em seguida, a classe WebView2 pode utilizar opcionalmente CoreWebView2Environment . Caso contrário, cria uma predefinição CoreWebView2Environment. Internamente, a classe WebView2 cria o respetivo CoreWebView2Controller e CoreWebView2 a CoreWebView2Environmentpartir do .

O WebView2 expõe como CoreWebView2 uma CoreWebView2 propriedade, mas o CoreWebView2Controller é mantido privado para a WebView2 classe. Isto deve-se ao facto de a WebView2 classe ser responsável por ligar todas as CoreWebView2Controller funcionalidades à arquitetura de IU.