Demonstra Passo a passo: Controles de formulários do Windows personalizados de depuração em tempo de Design

  • Artigo

Quando você cria um controle personalizado, você freqüentemente achará necessário para depurar seu comportamento em tempo de design. Isso é especialmente verdadeiro se você estiver criando um designer personalizado para seu controle personalizado. Para obter detalhes, consulte:Demonstra Passo a passo: Criando um controle Windows Forms que tira proveito dos recursos de tempo de Design de Visual Studio.

Você pode depurar seus controles personalizados usando o Visual Studio, exatamente como você deseja depurar qualquer outro.Classes do NET Framework. A diferença é que você irá depurar uma instância separada do Visual Studio que está executando o código do seu controle personalizado

As tarefas ilustradas neste passo a passo incluem:

  • Criando um projeto Windows Forms para hospedar seu controle personalizado

  • Criando um projeto de biblioteca de controle

  • Adicionar uma propriedade para o seu controle personalizado

  • Adicionando o seu controle personalizado para o formulário de host

  • Configurando o projeto para depuração de tempo de design

  • Depuração do seu controle personalizado em tempo de design

Quando tiver terminado, você terá uma compreensão das tarefas necessárias para depurar o comportamento de tempo de design de um controle personalizado.

ObservaçãoObservação

As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição. Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

Criando o projeto

A primeira etapa é criar um projeto de aplicativo. Você usará este projeto para criar o aplicativo que hospeda o controle personalizado.

Para criar o projeto

Criando um projeto de biblioteca de controle

A próxima etapa é criar o projeto de biblioteca de controle e configurar o controle personalizado.

Para criar o projeto de biblioteca de controle

  1. Adicionar um Windows Control Library o projeto à solução.

  2. Adicionar um novo UserControl item no projeto DebugControlLibrary. Para obter detalhes, consulte:Como: Adicionar novos itens de projeto. Nomeie o novo arquivo de origem uma base de "debugcontrol".

  3. Usando o Solution Explorer, excluir o controle do padrão do projeto, excluindo o arquivo de código com um nome de base de "UserControl1". Para obter detalhes, consulte:Como: Remover, Deletar e excluir itens.

  4. Crie a solução.

Ponto de Verificação

Neste ponto, você será capaz de ver o seu controle personalizado no caixa de ferramentas.

Para verificar seu andamento.

  • Localizar a nova guia chamada Componentes de DebugControlLibrary e clique para selecioná-lo. Quando ela for aberta, você verá o seu controle listado como DebugControl com o ícone padrão ao lado dele.

Adicionar uma propriedade para o controle personalizado

Para demonstrar que o código do seu controle personalizado está em execução em tempo de design, você irá adicionar uma propriedade e definir um ponto de interrupção no código que implementa a propriedade.

Para adicionar uma propriedade para o seu controle personalizado

  1. Abrir DebugControl no O Editor de código. Adicione o seguinte código à definição de classe:

    Private demoStringValue As String = Nothing
<BrowsableAttribute(true)>
Public Property DemoString() As String

    Get
        Return Me.demoStringValue
    End Get

    Set(ByVal value As String)
        Me.demoStringValue = value
    End Set

End Property

    private string demoStringValue = null;
[Browsable(true)]
public string DemoString
{
    get
    {
        return this.demoStringValue;
    }
    set
    {
        demoStringValue = value;
    }
}

  2. Crie a solução.

Adicionando o controle personalizado para o formulário de Host

Para depurar o comportamento de tempo de design do seu controle personalizado, você colocará uma instância da classe de controle personalizado em um formulário do host.

Para adicionar o seu controle personalizado para o formulário de host

  1. No "debuggingexample" projeto, abra o Form1 no Windows Forms Designer.

  2. No Toolbox, abra o Componentes de DebugControlLibrary guia e arraste um DebugControl instância para o formulário.

  3. Encontrar o DemoString a propriedade personalizada na Propriedades janela. Observe que você pode alterar seu valor como faria com qualquer outra propriedade. Observe também que, quando o DemoString propriedade é selecionada, a seqüência de descrição da propriedade aparece na parte inferior do Propriedades janela.

Configurar o projeto para a depuração em tempo de design.

Para depurar o comportamento em tempo de design do seu controle personalizado, você irá depurar uma instância separada do Visual Studio que está executando o código do seu controle personalizado.

Para configurar o projeto para depuração de tempo de design

  1. Clique com o botão direito sobre o DebugControlLibrary projeto no Solution Explorer e selecione Propriedades.

  2. No DebugControlLibrary folha de propriedades, selecione o Debug guia.

    Na caixa Início da ação seção, selecione Iniciar programa externo. Você será então a depuração de uma instância separada do Visual Studio, clique nas reticências (Captura de tela de VisualStudioEllipsesButton) o botão para procurar o Visual Studio IDE. O nome do arquivo executável é devenv, e, se você instalou o local padrão, seu caminho %programfiles%\Microsoft 9.0\Common7\IDE\devenv.exe de Visual Studio.

  3. Clique OK para fechar a caixa de diálogo.

  4. Com o botão direito do DebugControlLibrary de projeto e selecione Set as StartUp Project para habilitar esta configuração de depuração.

Depurando O controle personalizado em tempo de design

Agora você está pronto para depurar o controle personalizado à medida que ele é executado no modo de design. Quando você inicia a sessão de depuração, será criada uma nova instância de Visual Studio, e você o usará para carregar "debuggingexample" solução. Quando você abre o Form1 no Forms Designer, uma instância do seu controle personalizado será criada e iniciar a execução.

Depurando O controle personalizado em tempo de design

  1. Abrir o DebugControl o arquivo de origem no Editor de código e coloque um ponto de interrupção na Set assessor da DemoString propriedade.

  2. Pressione F5 para iniciar a depuração da solução. Observe que uma nova instância do Visual Studio é criada. Você pode distinguir entre as instâncias de duas maneiras:

    • A instância de depuração tem a palavra executando na sua barra de título

    • A instância de depuração tem o Iniciar na barra de seu Debug barra de ferramentas desativada

    O ponto de interrupção é definido na instância de depuração.

  3. Na nova instância de Visual Studio, abrir "debuggingexample" solução. Você poderá localizar facilmente a solução selecionando Projetos recentes da arquivo menu. "DebuggingExample.sln" o arquivo de solução será listado como o arquivo usado recentemente.

  4. Abra o Form1 no Forms Designer e selecione o DebugControl controle.

  5. Alterar o valor de DemoString propriedade. Observe que quando você confirmar a alteração, a instância de depuração do Visual Studio adquire o foco e a execução pára no ponto de interrupção. Você pode em etapa única através do acessador de propriedade apenas como seu faria de qualquer outro código.

  6. Quando tiver terminado com a sessão de depuração, você pode sair dispensar a instância hospedada do Visual Studio ou clicando no Stop Debugging o botão na instância de depuração.

Próximas etapas

Agora que você pode depurar seus controles personalizados em tempo de design, há muitas possibilidades de expansão a interação do controle com o IDE de Visual Studio.

Consulte também

Tarefas

Demonstra Passo a passo: Criando um controle Windows Forms que tira proveito dos recursos de tempo de Design de Visual Studio

Como: Acessar os serviços de tempo de Design

Como: Suporte de tempo de Design de acesso no Windows Forms