Compartilhar via


Configurando arquivos .Vsz para iniciar assistentes

Os suplementos do Visual Studio foram substituídos no Visual Studio 2013. Você deve atualizar seus suplementos para as extensões VSPackage. Para obter mais informações sobre atualização, consulte Perguntas frequentes: convertendo suplementos em extensões VSPackage.

Visual Studio usa um tipo de arquivo chamado .vsz para iniciar assistentes. Esses arquivos são arquivos de texto com uma extensão .vsz que o Visual Studio usa para determinar o assistente a ser chamado e as informações a serem transmitidas a ele, se houver.

Comparação com arquivo INI

Um arquivo .vsz é uma versão simplificada de um arquivo de texto de formato .ini, mas não tem seções com rótulo. A primeira parte armazena informações conhecidas no ambiente do Visual Studio. A segunda seção permite que os parâmetros específicos do assistente sejam coletados pelo ambiente e passados ao assistente.

A seguir está um exemplo de um arquivo de exemplo .vsz:

VSWizard 8.0
Wizard=VIDWizard.CBlankSiteWizard
Param=<item1>
Param=<item2>
…

Dica

O valor do assistente também pode ser uma GUID no formato {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} — englobando as seções 8,4,4,4 e 12 caracteres.

O arquivo tem estas partes:

  • VSWizard — Este é o número de versão do formato de arquivo de modelo, para o qual Visual Studio é “VSWizard 8,0”. Nenhum outro número é válido, e o uso de outros números resulta em um erro de "formato inválido".

  • Assistente — Esta é a identificação programática (ProgID), como MyWizard.MyClass, ou, como alternativa, uma representação de GUID de cadeia de caracteres do CLSID do assistente que deve ser criado junto pelo Visual Studio.

  • Param — Esses parâmetros são opcionais e você pode adicionar tantos quanto o assistente exigir. Eles são usados para permitir que o arquivo .vsz transmita parâmetros personalizados adicionais ao assistente. Cada valor é passado para o assistente como um elemento de cadeia de caracteres em uma matriz.

Consulte também

Tarefas

Como criar um suplemento

Instruções passo a passo: criando um assistente

Conceitos

Adicionando assistentes às caixas de diálogo Adicionar Item e Novo Projeto usando arquivos .Vsdir

Outros recursos

Criando suplementos e assistentes