Parâmetros personalizados
Os parâmetros personalizados controlam a operação de um assistente após o início do assistente. Um arquivo .vsz relacionado fornece uma matriz de parâmetros definidos pelo usuário que são empacotados pelo ambiente de desenvolvimento integrado (IDE) 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.
A seguir está 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. Em seguida, o IDE chama o método do AddItem projeto com o sinalizador definido e o projeto chama o método responsável por executar o assistente e retornar o VSADDITEMOPERATION RunWizardFile resultado.
O assistente é responsável por analisar a matriz de cadeias de caracteres e agir sobre as cadeias de caracteres adequadamente. Dessa forma, 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 diferentes conjuntos de parâmetros personalizados para controlar o comportamento do assistente em várias situações.
Para obter mais informações, consulte Arquivo do assistente (.vsz).