Compartilhar via


Parâmetros personalizados

Parâmetros personalizados controlam a operação de um assistente depois que um assistente é iniciado. Um arquivo .vsz relacionado fornece uma matriz de parâmetros definidos pelo usuário que são empacotados pelo IDE (ambiente de desenvolvimento integrado) e passados para o assistente como uma matriz de cadeias de caracteres quando o assistente é iniciado. Em seguida, o assistente analisa a matriz de cadeias de caracteres e usa as informações para controlar a operação real do assistente. Dessa maneira, um assistente pode personalizar a funcionalidade dependendo do conteúdo do arquivo .vsz .

Os parâmetros de contexto, por outro lado, definem o estado do projeto quando o assistente é iniciado. Para obter mais informações, consulte parâmetros de contexto.

Veja a seguir um exemplo de um arquivo .vsz que tem parâmetros personalizados:

VSWIZARD 8.0
Wizard=VsWizard.VsWizard_Engine
Param="WIZARD_NAME = Sample Wizard"
Param="WIZARD_UI = FALSE"
Param="RELATIVE_PATH = VSWizards\Classwiz\ATL"
Param="PREPROCESS_FUNCTION = CanAddATLSupport"
Param="PROJECT_TYPE = CSPROJ"

O autor do arquivo .vsz adiciona os valores dos parâmetros. Quando um usuário seleciona Novo Projeto ou Adicionar Novo Item no menu Arquivo ou clicando com o botão direito do mouse em um projeto no Gerenciador de Soluções, o IDE coleta esses valores em uma matriz de cadeias de caracteres. A IDE então chama o método AddItem do projeto com o sinalizador VSADDITEMOPERATION definido, e o projeto chama o método RunWizardFile responsável por executar o assistente e retornar o resultado.

O assistente é responsável por analisar a matriz de cadeias de caracteres e agir nas cadeias de caracteres adequadamente. Dessa maneira, implementando parâmetros personalizados, você pode criar um assistente que executa uma variedade de funções. Em outras palavras, um assistente pode ter três arquivos .vsz diferentes. Cada arquivo passa conjuntos diferentes de parâmetros personalizados para controlar o comportamento do assistente em várias situações.

Para obter mais informações, consulte o arquivo assistente (.vsz).