ItemOperations.AddNewItem (Método)
Agrega un nuevo elemento al proyecto actual.
Espacio de nombres: EnvDTE
Ensamblado: EnvDTE (en EnvDTE.dll)
Sintaxis
'Declaración
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: System.String
Opcional.La ruta de acceso virtual al elemento basada en la cadena de recursos de la interfaz de usuario (definida en la sección Comentarios que figura más abajo) o que se muestra ocasionalmente en el contenido del cuadro de diálogo Nuevo archivo en formato "category\templatename".Category procede del recuadro izquierdo del cuadro de diálogo y templatename del recuadro derecho.Por ejemplo, para agregar un archivo HTML nuevo a un proyecto de Visual Basic, se utilizaría "General\Página HTML". Vea la sección Comentarios para obtener más información.
- Name
Tipo: System.String
Opcional.Nombre para mostrar que deberá utilizarse para el elemento cuando éste sea agregado a un proyecto.
Valor devuelto
Tipo: EnvDTE.ProjectItem
Un objeto ProjectItem.
Comentarios
AddNewItem modela el cuadro de diálogo Nuevo archivo. El contenido de este cuadro de diálogo depende del tipo de proyecto. Hay dos maneras de determinar los valores que se asignan al parámetro Item: buscar los valores en el cuadro de diálogo Nuevo archivo o buscarlos en el archivo de recursos de interfaz de usuario adecuado.
Para agregar elementos a algunos proyectos con el primer método, examine los elementos disponibles para el proyecto en el cuadro de diálogo Nuevo archivo. El cuadro de diálogo Nuevo archivo tiene dos paneles: Categorías y Plantillas. El parámetro Item del método AddNewItem es
en formato "category\templatename". Category procede normalmente del recuadro izquierdo del cuadro de diálogo (Categorías) y templatename del recuadro derecho (Plantillas). Por ejemplo, para agregar un archivo HTML nuevo a un proyecto de Visual Basic, se utilizaría "General\Página HTML". Sin embargo, debido a diferencias entre los lenguajes, los valores del cuadro de diálogo Nuevo archivo no siempre son exactos.
Un método más coherente y confiable para obtener los valores exactos del parámetro Item consiste en buscar la cadena necesaria en el archivo de recursos de interfaz de usuario para cada lenguaje de programación. A continuación, puede usar este valor junto con el nombre del elemento que desee agregar, tal como se muestra en los cuadros de diálogo Nuevo archivo y Agregar nuevo elemento. Por ejemplo, para agregar un nuevo archivo de clase de Visual Basic al proyecto, utilizaría AddNewItem("Visual Basic Items\Class", "test.vb"). Para agregar un nuevo archivo de clase de Visual C# al proyecto, utilizaría AddNewItem("Visual C# Project Items\Class", test.cs");.
La cadena "Elementos de Visual Basic" (así como otros elementos del lenguaje) se busca de la manera siguiente:
Para el archivo de Visual Basic, abra la siguiente clave del Registro: HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\8.0\Projects\{F184B08F-C81C-45f6-A57F-5ABD9991F28F}\AdditemTemplates\TemplateDirs\{164B10B9-B200-11D0-8C61-00A0C91E29D5}\ /1. Su valor predeterminado es #3082.
Abra el archivo msvbprjui.dll en Visual Studio mediante el Editor de recursos. Para hacerlo, busque el archivo seleccionando Archivo, en el menú Abrir, que se encuentra en el menú Archivo y, a continuación, abra el archivo. Abra el nodo Tabla de cadenas y examine el identificador de recursos 3082; está establecido en "Elementos de Visual Basic". Ésta es la cadena que se coloca en la llamada AddNewItem. Se aplica el mismo procedimiento a los sistemas de proyectos Visual C#, Visual C++ y Visual C#, aunque los nombres de archivo y los identificadores de recursos utilizados son diferentes.
A continuación se incluye una tabla de identificadores de recursos y ubicaciones de los archivos de recursos de la interfaz de usuario:
Lenguaje de programación |
Nombre de archivo de la interfaz de usuario |
Identificador de recursos de la clase |
|---|---|---|
Visual Basic |
...\Archivos de programa\Microsoft Visual Studio 8\VB\Bin\1033\msvbprojUI.dll |
3082 |
Visual C# |
...\Archivos de programa\Microsoft Visual Studio 8\VC#\VCSPackages\1033\csprjui.dll |
2346 |
Visual C++ |
...\Archivos de programa\Microsoft Visual Studio 8\VC\vcpackages\1033\VCProjectUI.dll |
10007 |
Ejemplos
Sub AddNewItemExample()
Dim ItemOp As ItemOperations
ItemOp = DTE.ItemOperations
ItemOp.AddNewItem("General\Text File", "A new text file")
End Sub
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.