ItemOperations.AddNewItem, méthode

Ajoute un nouvel élément au projet en cours.

Espace de noms :  EnvDTE
Assembly :  EnvDTE (dans EnvDTE.dll)

Syntaxe

'Déclaration
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

Paramètres

• Item
  Type : System.String
  Facultatif.Chemin d'accès virtuel à l'élément basé sur la chaîne de ressource de l'interface utilisateur (voir la section Notes ci-dessous) ou affiché occasionnellement dans le contenu de la boîte de dialogue Nouveau fichier dans la mise en forme « category\templatename ».Category est issu du volet gauche de la boîte de dialogue et templatename du volet droit.Par exemple, pour ajouter un nouveau fichier HTML à un projet Visual Basic, vous devez utiliser « General\\HTML Page ». Pour plus d'informations, consultez la section Notes.

• Name
  Type : System.String
  Facultatif.Nom complet à utiliser pour le nouvel élément lorsqu'il est ajouté à un projet.

Valeur de retour

Type : EnvDTE.ProjectItem
Un objet ProjectItem.

Notes

AddNewItem modélise la boîte de dialogue Nouveau fichier. Le contenu de cette boîte de dialogue varie en fonction du type de projet. Il existe deux façons de déterminer les valeurs à placer dans le paramètre Item : examiner les valeurs de la boîte de dialogue Nouveau fichier ou examiner les valeurs du fichier de ressources d'interface utilisateur approprié.

Pour ajouter des éléments à un projet à l'aide de la première méthode, examinez les éléments disponibles pour le projet dans la boîte de dialogue Nouveau fichier. La boîte de dialogue Nouveau fichier comporte deux volets : Catégories et Modèles. Le paramètre Item de la méthode AddNewItem est

dans le format «category\templatename». Category provient généralement du volet gauche de la boîte de dialogue (Catégories) et templatename du volet droit (Modèles). Par exemple, pour ajouter un nouveau fichier HTML à un projet Visual Basic, vous devez utiliser « General\\HTML Page ». Cependant, en raison des différences de langage, les valeurs exactes ne se sont pas toujours répercutées exactement dans la boîte de dialogue Nouveau fichier.

Une méthode plus cohérente et fiable pour obtenir les valeurs exactes du paramètre Item consiste à rechercher la chaîne nécessaire dans le fichier de ressources de l'interface utilisateur pour chaque langage de programmation. Vous utilisez alors cette valeur avec le nom de l'élément que vous souhaitez ajouter, tel qu'il est affiché dans les boîtes de dialogue Nouveau fichier et Ajouter un nouvel élément. Par exemple, pour ajouter un nouveau fichier de classe Visual Basic à votre projet, vous utiliseriez AddNewItem("Visual Basic Items\Class", "test.vb"). Pour ajouter un nouveau fichier de classe Visual C# à votre projet, vous utiliseriez AddNewItem("Visual C# Project Items\Class", test.cs");.

Le nom « Éléments Visual Basic Items » (ainsi que d'autres éléments de langage) est recherché de la manière suivante :

• Pour le fichier Visual Basic, ouvrez la clé de Registre suivante : HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\8.0\Projects\{F184B08F-C81C-45f6-A57F-5ABD9991F28F}\AdditemTemplates\TemplateDirs\{164B10B9-B200-11D0-8C61-00A0C91E29D5}\ /1. Sa valeur par défaut est #3082.

• Ouvrez le fichier msvbprjui.dll dans Visual Studio à l'aide de l'éditeur de ressources. Pour ce faire, dans le menu Fichier, sélectionnez Ouvrir, Fichier, puis ouvrez le fichier. Ouvrez le nœud Table de chaînes et consultez l'ID de ressource 3082. Il a la valeur "Visual Basic Items". Il s'agit de la chaîne que vous mettez dans l'appel AddNewItem. La même procédure s'applique aux systèmes de projet Visual C#, Visual C++et Visual C#, si ce n'est que les noms de fichiers et les ID de ressource à utiliser sont différents.

Ci-après, une table des ID et emplacements des ressources pour les fichiers de ressources de l'interface utilisateur :

Exemples

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

Sécurité .NET Framework

• Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

ItemOperations Interface

EnvDTE, espace de noms