Partilhar via

Assistentes para adicionar a adicionar o item e caixas de diálogo New projeto usando .Vsdir arquivos

  • Artigo

Um arquivo VSDir é um arquivo de texto com uma extensão .vsdir criados por você para fornecer informações sobre como exibir seus itens a Adicionar item and Novo projeto caixas de diálogo.As informações incluem nomes de itens, a ordem em que aparecem e o ícone exibido com eles.Você pode alterar qualquer um desses itens.Arquivos VSDir são usados para adicionar novos modelos ou assistentes a Adicionar item and Novo projeto caixas de diálogo.

Não há nenhum arquivo de VSDir padrão.Se um estiver presente, Visual Studio lê-lo e adiciona seu Sumário às caixas de diálogo. Caso não haja algum, os modelos padrão e assistentes exibem.Você pode ter vários arquivos VSDir em um único diretório e todos os seus conteúdos serão adicionados às caixas de diálogo.Normalmente, um único arquivo 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 em cada registro.Qualquer campo opcional para o qual não haja não significativos dados contiver um zero (0) ou um espaço sistema autônomo um espaço reservado.Seqüências de caracteres inseridas nos campos não exigem as aspas ao redor deles.

Arquivo VSDir componentes

Seguem exemplos VSDir arquivos.Primeiro faz referência a um assistente simples, que foi criada no tópico Demonstra Passo a passo: Criando um assistente:

MyNewWizard.vsz| |A New Wizard|1|My New Wizard|C:\Addins\MyNewWizard\MyNewWizard\bin\Debug| | |MyNewWizard99

O próximo arquivo VSDir exemplo faz referência a um número de arquivos .vsz assistente, juntamente com outras informações pertinentes relacionadas a cada assistente (sistema autônomo descrito posteriormente neste tópico).Esses são diferentes do arquivo VSDir anterior em que eles fazem referência cadeias de caracteres sistema autônomo números de ID do recurso, seqüências de caracteres literal 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 VSDir:

Campo

Significado

RelPathName

Obrigatório.O nome do .vsz arquivo Assistente do, sistema autônomo MyWizard.vsz, em relação à Visual Studio diretório de instalar do.

{clsidPackage}

Opcional.Um GUID que representa um produto (sistema autônomo, por exemplo, Visual C++) que tem uma DLL que contém recursos localizados. Normalmente, este campo fica em branco para VSDir arquivos que correspondem aos assistentes de terceiros.

LocalizedName

Opcional.Isso é o nome localizável do assistente ou modelo e o nome que aparece no Adicionar 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 classificar e a prioridade relativa do assistente, com 1 sendo mais alto.Por exemplo, se este item for "1", em seguida, ele será exibido próximo a outros 1s e antes de todos os 2s ou inferior.

Descrição

Obrigatório.Uma descrição localizável no modelo ou assistente sistema autônomo ela aparecerá na Adicionar 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 somente ao modelo de arquivos e pastas não.

DLLPath ou {clsidPackage}

Obrigatório.Especifica um caminho completo para um arquivo DLL ou EXE ou um GUID de um produto que tem um arquivo .dll que contém um ícone para carregar para que o assistente.O ícone é carregado sistema autônomo um recurso fora de um arquivo EXE/DLL utilizando a determinado IconResourceId. Essa configuração substitui {clsidPackage}, se especificado, para o local do ícone. Ele se aplica somente ao modelo de arquivos e pastas não.

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 que o item.Ele se aplica somente ao modelo de arquivos e pastas não.

Sinalizadores

Opcional.See Flags Descrição e a tabela abaixo. Ele se aplica somente ao modelo de arquivos e pastas não.

SuggestedBaseName

Obrigatório.O nome padrão para que 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 for exclusivo, o ambiente anexará o nome com um número inteiro.Por exemplo, MyFile.aspx pode ser alterado para MyFile1.aspx.Se nenhum nome for fornecido, "Projeto" será usado.Ele se aplica somente ao modelo de arquivos e pastas não.

  • Anotações
    Qualquer campo não é necessário para o qual não há nenhum dado significativo deve conter um 0 (zero) sistema autônomo um espaço reservado.

    Se nenhum nome localizado for fornecido, o caminho relativo será usado.

    Se nenhum ícone for definido, o IDE substitui o ícone padrão para um arquivo com a extensão.

    Se nenhum nome de base sugerido for fornecido, "Projeto" será usado.

  • Sinalizadores
    Um agrupar de sinalizadores de bit a bit usadas para habilitar ou desabilitar o Nome and Local campos a Adicionar item caixa de diálogo.Isto é, quando o usuário seleciona Adicionar novo item from the Adicionar Determina do projeto de menu, se o nome e local serão exibidos no Modelos painel, mas os sinalizadores de determinar se o nome e o local estão disponível para o usuário.

    conjunto o valor de Flags a soma dos valores individuais. Isto é, 33 é equivalente a VSDIRFLAG_NonLocalTemplate | VSDIRITEM_DisableLocationField.

    Nome do sinalizar

    Valor decimal

    Descrição

    VSDIRFLAG_NonLocalTemplate

    1

    Use o comportamento de interface do usuário não-local e salvar mecanismos.

    VSDIRFLAG_BlankSolution

    2

    criar uma solução em branco (vazia).Não crie um projeto.

    VSDIRFLAG_DisableBrowseButton

    4

    desabilitar no botão Procurar para este projeto ou item.

    VSDIRFLAG_DontAddDefExtension

    8

    Não anexar uma extensão padrão para o nome fornecido para o item.(Essa configuração inválido é válida para projetos).

    VSDIRFLAG_DisableLocationField

    32

    desabilitar o campo de local para este projeto ou item.

    VSDIRFLAG_DontInitNameField

    4096

    Não inicializar 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

Como: Criar um suplemento

Demonstra Passo a passo: Criando um assistente

Conceitos

Criando um assistente

Configurando .vsz arquivos iniciar assistentes

Outros recursos

Criando suplementos e assistentes