Adicionando os assistentes para o Item Adicionar e caixas de Diálogo Novo projeto usando.Arquivos de Vsdir
Um arquivo de VSDir é um arquivo de texto com uma extensão de .vsdir que você criar para fornecer informações sobre como exibir os seus itens para o Add Item e Novo projeto caixas de diálogo. As informações incluem os nomes dos itens, a ordem em que aparecem e o ícone exibido com eles. Você pode alterar qualquer um desses itens. Arquivos de VSDir são usados para adicionar novos modelos ou assistentes para a Add Item e Novo projeto caixas de diálogo.
Não há nenhum arquivo de VSDir padrão. Se houver, em seguida, Visual Studio lê-lo e adiciona o seu conteúdo para caixas de diálogo. Se um não estiver presente, os assistentes e modelos padrão para exibem. Você pode ter vários arquivos de VSDir em um único diretório e todos os seus conteúdos serão adicionados às caixas de diálogo. Normalmente, um único arquivo de VSDir contém registros de vários assistentes, pastas e modelos. Cada registro no arquivo é separado por um caractere de nova linha. Caracteres de pipe (|) separam os campos de cada registro. Qualquer campo opcional para o qual não há nenhum dado significativo contém um zero (0) ou um espaço como um espaço reservado. Seqüências de caracteres inseridas nos campos não exigem aspas ao redor delas.
Componentes do arquivo de VSDir
A seguir estão exemplos de arquivos de VSDir. Primeiro faz referência a um assistente simples, que foi criada no tópico Walkthrough: Criando um assistente:
MyNewWizard.vsz| |A New Wizard|1|My New Wizard|C:\Addins\MyNewWizard\MyNewWizard\bin\Debug| | |MyNewWizard99
O próximo arquivo de exemplo VSDir faz referência a um número de arquivos do assistente vsz, juntamente com outras informações pertinentes relacionadas para cada Assistente (conforme descrito neste tópico). Esses são diferentes do arquivo VSDir anterior em que eles fazem referência seqüências de caracteres, como números de identificação do recurso, seqüências de caracteres literais não. Além disso, eles usam GUIDs para fazer referência a DLLs.
..\..\Projects\csharp building blocks\BusinessFacade.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5015|10|#5022|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|127|0|Project
..\..\Projects\csharp building blocks\BusinessRules.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5016|20|#5023|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|128|0|Project
..\..\Projects\csharp building blocks\DataAccess.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5017|30|#5024|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|129|0|Project
..\..\Projects\csharp building blocks\SystemFrameworks.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5018|40|#5025|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|130|0|Project
..\..\Projects\csharp building blocks\WebService.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5019|50|#5026|{FAE04EC1-301F-11d3-BF4B-00C04F79EFBC}|4547|1|WebService|Web
..\..\Projects\csharp building blocks\WebUI.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5020|60|#5027|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|131|1|WebUI|web
..\..\Projects\csharp building blocks\WinUI.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5021|70|#5028|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|132|0|Project
Os campos a seguir podem ser especificados para cada registro em um arquivo de VSDir:
Campo |
Significado |
|---|---|
RelPathName |
Obrigatório. O nome do vsz do assistente arquivo, como, por exemplo, MyWizard.vsz, em relação do Visual Studio instalar o diretório. |
{clsidPackage} |
Opcional. Um GUID que representa um produto (como Visual C++) que tem uma DLL contendo localizados recursos. Normalmente, este campo estará em branco para os arquivos de VSDir que correspondem aos assistentes de terceiros. |
LocalizedName |
Opcional. Este é o nome localizável do assistente ou modelo e o nome que aparece no Add Item caixa de diálogo. Isso pode ser uma seqüência de caracteres ou um identificador de recurso do formulário #ResID. |
SortPriority |
Obrigatório. Um inteiro que representa a ordem de classificação e a prioridade relativa do assistente, sendo que 1 mais alto. Por exemplo, se este item será "1", em seguida, ele será exibido próximo a outros 1s e à frente de todos os 2s ou inferior. |
Descrição |
Obrigatório. Uma descrição localizável do modelo ou assistente como ela aparecerá na Add Item caixa de diálogo quando o item é selecionado. Isso pode ser uma seqüência de caracteres ou um identificador de recurso do formulário #ResID. Ele se aplica apenas aos arquivos de modelo, não às pastas. |
DLLPath ou {clsidPackage} |
Obrigatório. Especifica um caminho completo para um arquivo. EXE ou DLL ou um GUID de um produto de um arquivo. dll que contém um ícone para carregar o assistente. O ícone é carregado como um recurso de um arquivo DLL/EXE usando a determinado IconResourceId. Essa configuração substitui {clsidPackage}, se especificado, para o local do ícone. Ele se aplica apenas aos arquivos de modelo, não às pastas. |
IconResourceId |
Opcional. Um identificador de recurso dentro do arquivo DLL que determina o ícone para exibir. Se nenhum ícone for definido, o ambiente substitui o ícone padrão para um arquivo com a mesma extensão do item. Ele se aplica apenas aos arquivos de modelo, não às pastas. |
Sinalizadores |
Opcional. Consulte Flags Descrição e a tabela abaixo. Ele se aplica apenas aos arquivos de modelo, não às pastas. |
SuggestedBaseName |
Obrigatório. O nome padrão para o assistente, exibido na nome campo na caixa de diálogo. Isso é uma seqüência de caracteres ou um identificador de recurso do formulário #ResID. Se o nome não é exclusivo, o ambiente acrescenta o nome com um número inteiro. Por exemplo, MyFile.aspx pode ser alterado para MyFile1.aspx. Se nenhum nome for fornecido, em seguida, "Projeto" é usado. Ele se aplica apenas aos arquivos de modelo, não às pastas. |
Anotações
Qualquer campo não é necessário, para o qual não há nenhum dado significativo deve conter um 0 (zero) como um espaço reservado.Se nenhum nome localizado for fornecido, o caminho relativo é usado.
Se nenhum ícone for definido, o IDE substitui o ícone padrão para um arquivo com a extensão.
Se não sugerida base nome for fornecido, "Projeto" é usado.
Sinalizadores
Um grupo de sinalizadores de bit a bit usadas para ativar ou desativar o nome e local campos no Add Item caixa de diálogo. Ou seja, quando o usuário seleciona Add New Item da Add menu, o projeto determina se o nome e local são exibidos o modelos painel, mas os sinalizadores de determinam se o nome e local estão disponíveis para o usuário.Definir o valor de Flags para a soma dos valores individuais. Isto é, 33 é equivalente a VSDIRFLAG_NonLocalTemplate | VSDIRITEM_DisableLocationField.
Nome do sinalizador
Valor decimal
Descrição
VSDIRFLAG_NonLocalTemplate
1
Use o comportamento da interface de usuário não locais e mecanismos de salvar.
VSDIRFLAG_BlankSolution
2
Crie uma solução de em branco (vazia). Não crie um projeto.
VSDIRFLAG_DisableBrowseButton
4
Desative o botão ' Procurar ' para este projeto ou item.
VSDIRFLAG_DontAddDefExtension
8
Não anexe uma extensão padrão ao nome fornecido para o item. (Essa configuração não é válida para projetos).
VSDIRFLAG_DisableLocationField
32
Desative o campo de local para este projeto ou item.
VSDIRFLAG_DontInitNameField
4096
Não inicialize o campo de nome para este projeto ou item com um nome válido.
VSDIRFLAG_DisableNameField
8192
Desative o campo de nome para este projeto ou item.
Consulte também
Tarefas
Walkthrough: Criando um assistente
Conceitos
Configurando.Arquivos vsz iniciar assistentes