Compartilhar via

Exemplo de controle da Web de tinta

  • Artigo

Este exemplo mostra como criar um controle habilitado para tinta para uso em um navegador da Web. O exemplo usa o Exemplo de Formulário de Declarações Automáticas original e o transforma em um controle que é colocado em uma página da Web.

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

Modificações no projeto de exemplo original

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

  • A AutoClaims classe 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 adicional, DisposeResources que descarta os controles filho internos usados para coletar tinta. Esse método deve ser chamado pelowebpageon, que o controle é usado quando essa página é concluída usando o controle .

Referenciando o controle em HTML

A solução inclui um arquivo HTML, default.htm. Esse arquivo é a página para a qual o navegador navega para carregar o controle. O arquivo contém uma <marca de objeto> que faz referência ao controle . Ele também inclui um script que é chamado quando a página descarrega, conforme indicado pela presença do atributo onload=" OnUnload() " na marca de <corpo> . Essa função chama o DisposeResources método 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 a marca de <objeto> . Ele nomeia o assembly, seguido com um separador de sinal # e, em seguida, o namespace que contém o controle e, em seguida, o 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 nessa 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