Demonstra Passo a passo: Criando um assistente

Artigo
08/25/2010

Assistentes, sistema autônomo a Assistente de suplemento, são programas que levam a um usuário através de uma série de ações para realizar uma tarefa difícil, complexa ou repetitiva.Janelas, por exemplo, usa assistentes para se conectar a recursos de rede se conectem a impressoras e assim por diante.

In Visual Studio, assistentes geralmente pedir uma série de perguntas que solicitam entrada de um usuário e, em seguida, use os resultados para gerar código. Assistentes, no entanto, não sempre exibem uma interface de usuário (UI).Eles podem ser programados para gerar o código por trás dos bastidores forma invisível.

Existem três tipos diferentes de assistentes.

Novos assistentes de projeto — sistema autônomo o nome sugere, esses assistentes são usados para gerar novo código para um determinado tipo de projeto, oferecendo ao usuário um ponto inicial a partir do qual adicionar seu próprio código.Este é o tipo mais usado do assistente.
Adicionar novo item assistentes — Esses assistentes são usados para adicionar novos itens, sistema autônomo Web formulários, arquivos de texto, HTML páginas, páginas XML e assim por diante, para um projeto.
Assistentes personalizados — Esses assistentes não sejam chamados em uma caixa de diálogo.Em vez disso, eles são chamados diretamente do add-ins, macros ou outros tipos de código.Elas podem ou talvez não seja exibida uma interface do usuário.Em ambos os casos, eles geram código.Esse tipo de assistente é usado com freqüência o menor.

Independentemente do tipo de assistente, todas elas têm características comuns.

Elas são objetos .NET que implementam o IDTWizard interface e tem um método associado, Execute, que contém o código que você deseja que o assistente seja executado.
Todos eles usar um arquivo .vsz para exibir-se em Visual Studio.
Eles todos geram código ou realizar alguma Outros tarefa.

Você pode personalizar a aparência de elementos nos assistentes que você criar.Assistentes com mais freqüência consistir em uma ou mais janelas ou páginas.Páginas podem conter uma imagem descritiva, sistema autônomo na parte superior ou para o lado esquerdo da página, uma descrição do rótulo, instruções e uma área na quais controles de navegação, sistema autônomo Próximo and Anterior pode ser colocado.

O processo de criação de assistentes em Visual C++ é um bit diferente da criação de padrão Visual Studio assistentes. Para obter informações adicionais sobre como criar assistentes direcionados a Visual C++, consulte Criando um assistente e Criando um assistente Personalizar.

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.Esses procedimentos foram desenvolvidos com o Geral Development Settings ativo.Para alterar as configurações, escolher Import and ExportSettings on the Tools menu.Para obter mais informações, consulte Configurações do Visual Studio.

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.Esses procedimentos foram desenvolvidos com o Geral Development Settings ativo.Para alterar as configurações, escolher Import and ExportSettings on the Tools menu.Para obter mais informações, consulte Configurações do Visual Studio.

Exemplo de um assistente básico

Esta figura mostra um painel do Assistente de suplemento, tipo de assistente que orienta você em uma série de etapas para criar um suplemento no novo projeto.Você pode personalizar a aparência de seus assistentes, mas o Assistente de suplemento é um mercadoria exemplo do estilo de um tipo padrão do assistente.Modelos disponível no se tornam assistentes concluídosNovo projeto or Adicionar novo item caixas de diálogo.

A seguir demonstra como criar um assistente básico e, opcionalmente, atribua a ele um ícone personalizado.

Para criar um assistente básico no Visual Basic e Visual translation from VPE for Csharp

criar um novo projeto classe biblioteca chamado MyNewWizard.
Adicionar referências a EnvDTE e EnvDTE80 para o projeto.

Para fazer isso, clicar com o botão direito do mouse no projeto e clique em Adicionar referência.Na guia .NET do Adicionar referência de caixa de diálogo, clicar EnvDTE e EnvDTE80 e, em seguida, clicar OK.

No módulo de classe, incluem referências a EnvDTE e EnvDTE80 e implementar o IDTWizard interface. Para este Visual C# exemplo, você também deve adicionar uma referência para System.Windows.Forms.

Imports EnvDTEImports EnvDTE80
Public Class Class1
    Implements IDTWizard

using System;
using System.Collections.Generic;
using System.Text;
using EnvDTE;using EnvDTE80;using Windows.System.Forms;

namespace MyNewWizard
{
    public class Class1 : IDTWizard
    {
    }
}

Quando você adiciona o Implements demonstrativo para Visual Basic, posicione o cursor no participante da linha e pressione enter para criar automaticamente um Execute procedimento de método. For Visual C#, no entanto, você deve adicionar o Execute procedimento manualmente:

public class Class1 : IDTWizard
    {
    public void Execute(object Application,         int hwndOwner, ref object[] contextParams,         ref object[] customParams,         ref EnvDTE.wizardResult retval)

Adicione o código que você deseja que o Assistente para executar o Execute procedimento. Neste exemplo, adicionaremos apenas uma caixa de mensagem simples.

Você deve ter o seguinte:

Imports EnvDTE
Imports EnvDTE80

Public Class Class1
    Implements IDTWizard

    Public Sub Execute(ByVal Application As Object, ByVal _
    hwndOwner As Integer, ByRef ContextParams() As Object, ByRef _
    CustomParams() As Object, ByRef retval As EnvDTE.wizardResult) _
    Implements EnvDTE.IDTWizard.Execute
        MsgBox("The wizard is now running.")
    End Sub
End Class

using System.Text;
using EnvDTE;
using EnvDTE80;
using System.Windows.Forms;

namespace MyNewWizardCS
{
    public class Class1 : IDTWizard
    {

    public void Execute(object Application, 
        int hwndOwner, ref object[] contextParams, 
        ref object[] customParams, 
        ref EnvDTE.wizardResult retval)
    {
        MessageBox.Show("The wizard is now running.");
    }
}

}

The Execute procedimento é chamado quando o assistente for iniciado.

For Visual Basic, clicar com o botão direito do mouse em seu projeto na O gerenciador de soluções e clique em Propriedades para em em aberto o Propriedades do projeto página, clique no Compilar Guia de e marque o Registrar para interoperabilidade COM caixa na parte inferior da página.

Não é necessário executar essa etapa para Visual C#.
Construir o projeto para criar a dll da biblioteca de classes clicando Criar solução on the Compilação menu.

Crie um arquivo de texto .vsz para que o assistente chamado MyNewWizard.vsz.

Para fazer isso, clicar Arquivo, point to Novoe, em seguida, clicar Arquivo.

Um arquivo .vsz é um arquivo de texto que permite a Visual Studio para reconhecer o assistente e exibi-lo na Novo projeto or Adicionar novo item caixas de diálogo.The Wizard parâmetro deve ser definido como o progID (Project.classname) do projeto ou a GUID. Para obter mais informações, consulte Configurando .vsz arquivos iniciar assistentes.

Observação:
Opcionalmente, você também pode criar um arquivo VSDir para que o assistente.Contém informações que é exibido sistema autônomo uma descrição para o assistente no AddNew Project or AddNew File dialog boxes.Também permite especificar um ícone e organizar sua localização na lista.Para obter mais informações, consulte Assistentes para adicionar a adicionar o item e caixas de diálogo New projeto usando .Vsdir arquivos.

Opcionalmente, você também pode criar um arquivo VSDir para que o assistente.Contém informações que é exibido sistema autônomo uma descrição para o assistente no AddNew Project or AddNew File dialog boxes.Também permite especificar um ícone e organizar sua localização na lista.Para obter mais informações, consulte Assistentes para adicionar a adicionar o item e caixas de diálogo New projeto usando .Vsdir arquivos.

Adicione o seguinte MyNewWizard.vsz:

VSWizard 7.0
Wizard=MyNewWizard.Class1
Param=First Item
Param=Second Item

salvar o novo arquivo .vsz no diretório onde você deseja que o assistente apareça.

Neste exemplo, queremos que o assistente apareça no Adicionar novo item caixa de diálogo Visual Basic projetos, portanto, salvar o arquivo .vsz no seguinte diretório: <unidade>: \programa Files\Microsoft visual Studio 8\VB\VBProjectItems.
SairVisual Studio e, em seguida, reinicie-o.

Isso força Visual Studio para ler o novo arquivo .vsz.
Criar um novo Visual Basic projeto such sistema autônomo um projeto Windows aplicativo.
Right-click the project, point to Additem, and then click New Item.

Você deve ver o novo assistente (MyNewWizard) no Adicionar novos itens caixa de diálogo.
clicar no assistente e clicar no Adicionar botão.

Você ver a mensagem, "O assistente está em execução."

Para exibir um ícone personalizado para o novo Assistente

Coloque um arquivo de ícone com o mesmo nome de arquivo base do arquivo .dll, mas com uma extensão .ico no diretório mesmo que o arquivo de assistente.

Por exemplo, se o assistente é denominado MyNewWizard.dll, nomeie o arquivo .ico MyNewWizard.ico.

- ou -
Se você tiver criado um arquivo VSDir, especifique um caminho para o arquivo de ícone (.ico) existe.

Consulte também

Demonstra Passo a passo: Criando um assistente

Exemplo de um assistente básico

Para criar um assistente básico no Visual Basic e Visual translation from VPE for Csharp

Para exibir um ícone personalizado para o novo Assistente

Consulte também

Tarefas

Conceitos

Referência

Outros recursos

Recursos adicionais