Compartilhar via

Demonstra Passo a passo: Depuração personalizada Windows Forms Controls at tempo de design

  • Artigo

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

Você pode depurar seus controles personalizados usando o Visual Studio, exatamente sistema autônomo faria depurar sistema autônomo classes do .NET estrutura.A diferença é que você irá depurar uma instância separada do Visual Studio que está executando o código do controle personalizado

Tarefas ilustradas nesta explicação passo a passo incluem:

  • Criando um projeto Windows Forms para hospedar seu controle personalizado

  • Criando um projeto de biblioteca de controle

  • Adicionar uma propriedade a seu controle personalizado

  • Adicionando o controle personalizado ao formulário host

  • Configuração de projeto para depuração design-time

  • depuração seu controle em time de design personalizado

Quando tiver terminado, você terá noções básicas sobre as tarefas necessárias para depurar o comportamento em time de design de um controle personalizado.

Observação:

As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritas na Ajuda, dependendo das configurações ativas ou configurações de edição.Para alterar as configurações, escolher Importar e exportar configurações on the Ferramentas menu.Para obter mais informações, consulte Configurações do Visual Studio.

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 Biblioteca de controle do Windows projeto à solução.Para obter detalhes, consulte:Caixa de Diálogo Add New Project.nome o projeto "DebugControlLibrary".

  2. Adicionar um novo UserControl projeto DebugControlLibrary item.Para obter detalhes, consulte:Como: Itens de Adicionar Novo Projeto.Forneça o novo arquivo de fonte um nome de base de "DebugControl".

  3. Usando o O gerenciador de soluções, excluir padrão controle do projeto através da exclusão do arquivo de código com o nome de base "UserControl1". Para obter detalhes, consulte:Como: Excluir, remover e excluir itens.

  4. Crie a solução.

Ponto de Verificação

Neste ponto, você poderá ver seu controle personalizado no Caixa de ferramentas.

Para verificar seu andamento

  • Localizar a nova guia chamada Componentes DebugControlLibrary e clicar para selecioná-lo.Quando for aberto, você verá seu controle listado sistema autônomo DebugControl com o ícone padrão ao lado dele.

Adicionar uma propriedade do controle personalizado

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

Para adicionar uma propriedade do controle personalizado

  1. em aberto DebugControl in the 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 ao formulário host

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

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

  1. No projeto "DebuggingExample", em aberto Form1 naDesigner de Formulários do Windows.

  2. No Caixa de ferramentas, em aberto the Componentes DebugControlLibrary guia e arrastar um DebugControl instância para o formulário.

  3. Localizar o DemoString propriedade personalizada na Propriedades janela.Observe que você pode alterar seu valor sistema autônomo faria com qualquer Outros propriedade.Observe também que, quando o DemoString propriedade estiver marcada, a seqüência de caracteres de descrição da propriedade aparece na parte inferior das Propriedades janela.

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

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

Para configurar o projeto para depuração design-time

  1. clicar com o botão direito do mouse o DebugControlLibrary projeto no O gerenciador de soluções e selecionar Propriedades.

  2. No DebugControlLibrary propriedade da folha, selecionar o Depurar guia.

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

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

  4. clicar com o botão direito do mouse o DebugControlLibrary projeto e selecionar conjunto sistema autônomo projeto de inicialização 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, uma nova instância do Visual Studio será criada e você o usará para carregar a solução "DebuggingExample".Quando você em aberto Form1 no Designer de formulários, uma instância do seu controle personalizado será criada e iniciar a execução.

Depurando O controle personalizado em tempo de design

  1. em aberto the DebugControl arquivo de fonte a Editor de código e colocar um ponto de interrupção no Set assessor da DemoString propriedade.

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

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

    • A instância de depuração tem o Iniciar botão seusDepurarbarra de ferramentas de desabilitado

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

  3. Na nova instância do Visual Studio, em aberto a solução "DebuggingExample".Você pode com com facilidade encontrar a solução selecionando Projetos recentes from the Arquivo menu.O arquivo de solução "DebuggingExample.sln" será listado sistema autônomo arquivo usado mais recentemente.

  4. Abra Formulário1 no Designer de formulários e selecionar o DebugControl controle.

  5. Alterar o valor de DemoString propriedade. Observe que quando você confirmar a alterar, a instância de depuração do Visual Studio adquire o foco e a execução pára no seu ponto de interrupção.Pode etapa única através do acessador de propriedade sistema autônomo o faria de qualquer Outros código.

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

Próximas etapas

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

Consulte também

Tarefas

Demonstra Passo a passo: Criando um controle Windows Forms que tem a vantagem dos recursos de time de Design Visual Studio

Como: Serviços de tempo de design de Acessar

Como: Suporte de tempo de design de Acessar no Windows Forms