Partilhar via


Exemplo de Controle Web para Tinta

Este exemplo mostra como criar um controle habilitado para tinta para uso em um navegador da Web. O exemplo pega o formulário de reclamações de automóveis original e transforma-o num controlo que é colocado numa página Web.

Para obter mais informações sobre como usar tinta na Web, consulte Tinta na Web.

Modificações no projeto de amostra original

Este exemplo consiste em uma solução que inclui dois projetos e um arquivo HTML. O primeiro projeto, AutoClaims, é um projeto Microsoft Visual C# Control Library (um controle de usuário). O código-fonte para esse controle é quase idêntico ao do exemplo AutoClaims com duas diferenças:

  • A classe AutoClaims neste exemplo herda da classe UserControl , em vez da classe Form .

    public class AutoClaims : System.Windows.Forms.UserControl 
    
  • A classe AutoClaims neste exemplo tem um método público adicionado, DisposeResources, que elimina os controlos internos secundários usados para recolher tinta. Esse método deve ser chamado pela página da Web na qual o controle é usado quando essa página é concluída usando o controle.

Fazendo referência ao controle em HTML

A solução inclui um ficheiro HTML, default.htm. Este arquivo é a página que o navegador navega para carregar o controle. O arquivo contém um objeto <> tag que referencia o controlo. Ele também inclui um script que é chamado quando a página é descarregada, conforme indicado pela presença do atributo onload=" OnUnload() " no corpo <> tag. Essa função chama o método DisposeResources no controle para garantir que todos os recursos sejam liberados corretamente no desligamento.

<html>
    <script language="jscript">
        // Release any resources held by the AutoClaims control
        function OnUnload()
        {
            autoClaimsControl.DisposeResources();
        }
    </script>
    <head>
        <title>AutoClaims (Web Control)</title>
    </head>
    <body onunload="OnUnload()">
        <object 
          id="autoClaimsControl" 
          classid="AutoClaims.dll#AutoClaims.AutoClaims">
        </object>
    </body>
</html> 

Observe o formato do valor do atributo classid para o objeto <> tag. Ele nomeia o assembly, seguido de um separador de sinal #, seguido pelo namespace que contém o controle e pelo nome da classe do controle.

Um controle de usuário do mundo real provavelmente incluiria métodos adicionais usados para persistir ou enviar os dados coletados no aplicativo.

O Projeto AutoClaims_WebControl

O projeto AutoClaims_WebControl é um projeto de implantação que cria uma configuração que adiciona uma raiz virtual, AutoClaims_WebControl, no servidor Web quando instalado. O controle e o arquivo HTML são colocados nesta raiz virtual.

Observação

Os exemplos da Web compilados não são instalados pela opção de instalação padrão para o SDK. Você deve concluir uma instalação personalizada e selecionar a subopção "Exemplos da Web pré-compilados" para instalá-los.

 

Exemplo de formulário de declarações automáticas

Tinta na Web