Método ItemOperations.AddNewItem

Artigo
05/17/2015

Adiciona um novo item ao projeto atual.

Namespace: EnvDTE
Assembly: EnvDTE (em EnvDTE.dll)

Sintaxe

'Declaração
Function AddNewItem ( _
    Item As String, _
    Name As String _
) As ProjectItem

ProjectItem AddNewItem(
    string Item,
    string Name
)

ProjectItem^ AddNewItem(
    [InAttribute] String^ Item, 
    [InAttribute] String^ Name
)

abstract AddNewItem : 
        Item:string * 
        Name:string -> ProjectItem

function AddNewItem(
    Item : String, 
    Name : String
) : ProjectItem

Parâmetros

Item
Tipo: String

Opcional. O caminho virtual para o item com base em ambos a seqüência de recurso da interface do usuário (definida na seção comentários abaixo) ou, ocasionalmente, como exibido no conteúdo da Novo arquivo caixa de diálogo no "category\templatename" formato. Categoryvem do painel esquerdo da caixa de diálogo e templatename no painel direito. Por exemplo, para adicionar um novo arquivo HTML a uma Visual Basic o projeto, você usaria "Page General\HTML". Consulte a seção de comentários para obter mais informações.

Name
Tipo: String

Opcional. O nome de exibição a ser usado para o item quando ele é adicionado a um projeto.

Valor de retorno

Tipo: EnvDTE.ProjectItem
A ProjectItem object.

Comentários

AddNewItemmodelos de Novo arquivo caixa de diálogo. O conteúdo dessa caixa de diálogo varia dependendo do tipo de projeto. Há duas maneiras para determinar os valores para colocar na Item parâmetro: consultar os valores na Novo arquivo caixa de diálogo ou examinar os valores no arquivo de recursos de interface de usuário apropriado.

Para adicionar itens a um alguns projetos usando o primeiro método, examine os itens disponíveis para o projeto na Novo arquivo caixa de diálogo. O Novo arquivo caixa de diálogo possui dois painéis: categorias e modelos de. O Item parâmetro da AddNewItem método é

in "category\templatename" format. Categorygeralmente é fornecido no painel esquerdo da caixa de diálogo (categorias) e templatename do painel direito (modelos de). Por exemplo, para adicionar um novo arquivo HTML a uma Visual Basic o projeto, você usaria "Page General\HTML". Por causa das diferenças de linguagem, no entanto, os valores exatos para que isso não são sempre refletidos precisamente na Novo arquivo caixa de diálogo.

Um método de mais consistente e confiável para obter os valores exatos para o Item parâmetro é verificar a cadeia de caracteres necessários no arquivo de recurso da interface do usuário para cada linguagem de programação. Em seguida, usa esse valor junto com o nome do item que deseja adicionar, conforme ele exibe na Novo arquivo de e Add New Item caixas de diálogo. Por exemplo, para adicionar um novo Visual Basic arquivo de classe para seu projeto, você usaria AddNewItem("Visual Basic Items\Class", "test.vb"). Para adicionar um novo Visual C# arquivo de classe para seu projeto, você usaria AddNewItem("Visual C# Project Items\Class", test.cs");.

A seqüência de caracteres "itens de Visual Basic" (bem como outros itens de idioma) encontra-se da seguinte maneira:

Para o Visual Basic de arquivo, abra a seguinte chave do registro: HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\8.0\Projects\{F184B08F-C81C-45f6-A57F-5ABD9991F28F}\AdditemTemplates\TemplateDirs\{164B10B9-B200-11D0-8C61-00A0C91E29D5}\ /1. O valor padrão é # 3082.
Abra o msvbprjui.dll de arquivo em Visual Studio usando o editor de recursos. Para fazer isso, navegue até o arquivo, selecionando o arquivo … no menu aberto, que está no menu Arquivo, e, em seguida, abra o arquivo. Abra o nó da tabela de cadeia de caracteres e examine o recurso ID 3082, ele é definido como "Itens de Visual Basic". Esta é a seqüência de caracteres que você colocar o AddNewItem chamar. O mesmo procedimento se aplica para o Visual C# , Visual C++, e Visual C# sistemas de projeto, exceto os nomes de arquivo e o recurso IDs usar são diferentes.

A seguir está uma tabela de identificações de recurso e locais para os arquivos de recursos de interface do usuário:

Linguagem de programação	Nome do arquivo de interface do usuário	Identificação do recurso para classe
Visual Basic	8\VB\Bin\1033\msvbprojUI.dll do … \Arquivos de Programas\Microsoft Visual Studio	3082
Visual C#	8\VC#\VCSPackages\1033\csprjui.dll do … \Arquivos de Programas\Microsoft Visual Studio	2346
Visual C++	8\VC\vcpackages\1033\VCProjectUI.dll do … \Arquivos de Programas\Microsoft Visual Studio	10007

Exemplos

Sub AddNewItemExample()
   Dim ItemOp As ItemOperations
   ItemOp = DTE.ItemOperations
   ItemOp.AddNewItem("General\Text File", "A new text file")
End Sub

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

ItemOperations Interface

Namespace EnvDTE

Compartilhar via