ItemOperations.AddNewItem-Methode

Fügt dem aktuellen Projekt ein neues Element hinzu.

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

Syntax

'Declaration
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

Parameter

• Item
  Typ: System.String
  Optional.Der virtuelle Pfad zum Element, der entweder auf der UI-Ressourcenzeichenfolge (im Abschnitt Hinweise weiter unten definiert) basiert oder mitunter im Dialogfeld Neue Datei im Format "category\templatename" angezeigt wird.Category stammt aus dem linken Bereich des Dialogfelds und templatename aus dem rechten Bereich.Beispielsweise würden Sie zum Hinzufügen einer neuen HTML-Datei zu einem Visual Basic-Projekt den Pfad "Allgemein\HTML-Seite" verwenden. Weitere Informationen finden Sie im Abschnitt Hinweise.

• Name
  Typ: System.String
  Optional.Der Anzeigename, der für das Element verwendet werden soll, wenn es einem Projekt hinzugefügt wird.

Rückgabewert

Typ: EnvDTE.ProjectItem
Ein ProjectItem-Objekt.

Hinweise

AddNewItem bildet das Dialogfeld Neue Datei nach. Der Inhalt dieses Dialogfelds hängt von dem Projekttyp ab. Es gibt zwei Möglichkeiten, die Werte für den Item-Parameter zu bestimmen: Sie können die Werte im Dialogfeld Neue Datei oder in der entsprechenden UI-Ressourcendatei suchen.

Um Projekten mit der ersten Methode Elemente hinzuzufügen, sollten Sie die für das Projekt verfügbaren Elemente im Dialogfeld Neue Datei betrachten. Das Dialogfeld Neue Datei enthält zwei Bereiche: Kategorien und Vorlagen. Der Item-Parameter der AddNewItem-Methode hat das Format

im Format "category\templatename". Category stammt normalerweise aus dem linken Bereich des Dialogfelds (Kategorien) und templatename aus dem rechten Bereich (Vorlagen). Beispielsweise würden Sie zum Hinzufügen einer neuen HTML-Datei zu einem Visual Basic-Projekt den Pfad "Allgemein\HTML-Seite" verwenden. Aufgrund von Unterschieden zwischen den Programmiersprachen werden im Dialogfeld Neue Datei jedoch nicht immer die genauen Werte wiedergegeben.

Eine konsistentere und zuverlässigere Methode zum Abrufen der genauen Werte für den Item-Parameter besteht darin, die erforderliche Zeichenfolge in der UI-Ressourcendatei für jede Programmiersprache zu suchen. Sie können diesen Wert anschließend zusammen mit dem in den Dialogfeldern Neue Datei und Neues Element hinzufügen angezeigten Namen des Elements verwenden, das Sie hinzufügen möchten. Um dem Projekt z. B. eine neue Visual Basic-Klassendatei hinzuzufügen, würden Sie AddNewItem("Visual Basic Items\Class", "test.vb") verwenden. Um dem Projekt eine neue Visual C#-Klassendatei hinzuzufügen, würden Sie AddNewItem("Visual C# Project Items\Class", test.cs"); verwenden.

Die Zeichenfolge "Visual Basic Items" und andere Sprachelemente werden wie folgt ermittelt:

• Öffnen Sie für die Visual Basic-Datei den folgenden Registrierungsschlüssel: HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\8.0\Projects\{F184B08F-C81C-45f6-A57F-5ABD9991F28F}\AdditemTemplates\TemplateDirs\{164B10B9-B200-11D0-8C61-00A0C91E29D5}\ /1. Der Standardwert ist #3082.

• Öffnen Sie die Datei msvbprjui.dll in Visual Studio mit dem Ressourcen-Editor. Suchen Sie dazu die Datei über den Befehl Datei im Menü Öffnen, und öffnen Sie die Datei. Öffnen Sie den Knoten String Table, und suchen Sie nach der Ressourcen-ID 3082. Diese ist auf "Visual Basic Items" festgelegt. Dies ist die Zeichenfolge, die Sie in den AddNewItem-Aufruf einsetzen. Die gleiche Vorgehensweise gilt für die Projektsysteme Visual C# , Visual C++ und Visual C#, außer dass sich die Dateinamen und Ressourcen-IDs unterscheiden.

Es folgt eine Tabelle mit Ressourcen-IDs und Speicherorten für die Benutzeroberflächen-Ressourcendateien:

Beispiele

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

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

ItemOperations Schnittstelle

EnvDTE-Namespace