Parâmetros personalizadosCustom parameters

Parâmetros personalizados controlam a operação de um assistente depois de um assistente foi iniciado.Custom parameters control the operation of a wizard after a wizard has started. Um relacionados . vsz arquivo fornece uma matriz de parâmetros definidos pelo usuário que são empacotados pelo ambiente de desenvolvimento integrado (IDE) e passado para o assistente como uma matriz de cadeias de caracteres quando o assistente for iniciado.A related .vsz file provides an array of user-defined parameters that are packaged by the integrated development environment (IDE) and passed to the wizard as an array of strings when the wizard is started. Em seguida, o assistente analisa a matriz de cadeias de caracteres e usa as informações para controlar a operação real do assistente.The wizard then parses the array of strings and uses the information to control the actual operation of the wizard. Dessa forma, um assistente pode personalizar a funcionalidade dependendo do conteúdo do . vsz arquivo.In this manner, a wizard can customize functionality depending on the contents of the .vsz file.

Parâmetros de contexto, por outro lado, definem o estado do projeto quando o assistente for iniciado.Context parameters, on the other hand, define the state of the project when the wizard is started. Para obter mais informações, consulte parâmetros de contexto.For more information, see Context parameters.

A seguir está um exemplo de uma . vsz arquivo que tem parâmetros personalizados:Following is an example of a .vsz file that has custom parameters:

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 . vsz arquivo adiciona os valores dos parâmetros.The author of the .vsz file adds the values of the parameters. Quando um usuário seleciona novo projeto ou Adicionar Novo Item sobre o arquivo menu ou clicando em um projeto no Gerenciador de soluções, o IDE coleta esses valores em uma matriz de cadeias de caracteres.When a user selects New Project or Add New Item on the File menu or by right-clicking a project in Solution Explorer, the IDE collects these values into an array of strings. O IDE, em seguida, chama o projeto AddItem método com o VSADDITEMOPERATION sinalizador conjunto e as chamadas de projeto a RunWizardFile método que é responsável por executar o assistente e retornar o resultado.The IDE then calls the project's AddItem method with the VSADDITEMOPERATION flag set, and the project calls the RunWizardFile method that is responsible for running the wizard and returning the result.

O assistente é responsável por analisar a matriz de cadeias de caracteres e agir sobre as cadeias de caracteres corretamente.The wizard is responsible for parsing the array of strings and acting on the strings appropriately. Dessa forma, com a implementação de parâmetros personalizados, você pode criar um assistente que executa uma variedade de funções.In this manner, by implementing custom parameters you can create one wizard that performs a variety of functions. Em outras palavras, um assistente poderia ter três diferentes . vsz arquivos.In other words, one wizard could have three different .vsz files. Cada arquivo passa a diferentes conjuntos de parâmetros personalizados para controlar o comportamento do assistente em várias situações.Each file passes different sets of custom parameters to control the behavior of the wizard in various situations.

Para obter mais informações, consulte arquivo do assistente (. vsz).For more information, see Wizard (.vsz) file.

Consulte tambémSee also

IVsProject3
Parâmetros de contexto Context parameters
Assistentes Wizards
Arquivo do assistente (. vsz)Wizard (.vsz) file