Metodo ItemOperations.AddNewItem

Articolo
08/11/2011

Aggiunge un nuovo elemento al progetto corrente.

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Sintassi

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

Parametri

Item
Tipo: System.String
Facoltativo.Percorso virtuale dell'elemento basato sulla stringa di risorse dell'interfaccia utente (definita nella sezione Osservazioni seguente) oppure in alcuni casi visualizzato nel contenuto della finestra di dialogo Nuovo file nel formato "category\templatename".L'oggetto Category viene fornito dal riquadro di sinistra della finestra di dialogo e templatename dal riquadro di destra.Ad esempio, per aggiungere un nuovo file HTML a un progetto Visual Basic, utilizzare "General\HTML Page". Per ulteriori informazioni vedere la sezione Osservazioni.

Name
Tipo: System.String
Facoltativo.Il nome visualizzato da utilizzare per l'elemento quando viene aggiunto a un progetto.

Valore restituito

Tipo: EnvDTE.ProjectItem
Oggetto ProjectItem.

Note

AddNewItem modella la finestra di dialogo Nuovo file. Il contenuto di questa finestra di dialogo varia in base al tipo di progetto. Per determinare i valori da inserire nel parametro Item è possibile procedere in due modi: cercare i valori nella finestra di dialogo Nuovo file oppure nel file di risorse dell'interfaccia utente appropriato.

Per aggiungere elementi a un progetto utilizzando il primo metodo, esaminare gli elementi disponibili per il progetto nella finestra di dialogo Nuovo file. La finestra di dialogo Nuovo file contiene due riquadri: Categorie e Modelli. Il parametro Item del metodo AddNewItem è

in formato "category\templatename". Category viene generalmente fornito dal riquadro di sinistra della finestra di dialogo (Categorie) e templatename dal riquadro di destra Modelli). Ad esempio, per aggiungere un nuovo file HTML a un progetto Visual Basic, utilizzare "General\HTML Page". A causa delle differenze di linguaggio, tuttavia, i valori esatti non sono sempre riportati con esattezza nella finestra di dialogo Nuovo file.

Un metodo più coerente ed affidabile per ottenere i valori esatti per il parametro Item consiste nel cercare la stringa necessaria nel file di risorse dell'interfaccia utente per ogni linguaggio di programmazione. Questo valore può quindi essere utilizzato insieme al nome dell'elemento da aggiungere, come visualizzato nelle finestre di dialogo Nuovo file e Aggiungi nuovo elemento. Ad esempio, per aggiungere un nuovo file di classe Visual Basic al progetto, sarà necessario utilizzare AddNewItem("Visual Basic Items\Class", "test.vb"), mentre per aggiungere un nuovo file di classe Visual C#, si utilizzerà AddNewItem("Visual C# Project Items\Class", test.cs");.

Per trovare la stringa "Elementi di Visual Basic" e altri elementi del linguaggio, procedere nel modo seguente:

Per il file Visual Basic, aprire la seguente chiave del Registro di sistema: HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\8.0\Projects\{F184B08F-C81C-45f6-A57F-5ABD9991F28F}\AdditemTemplates\TemplateDirs\{164B10B9-B200-11D0-8C61-00A0C91E29D5}\ /1. Il valore predefinito è #3082.
Aprire il file msvbprjui.dll in Visual Studio tramite l'editor di risorse. Per eseguire questa operazione, selezionare il file mediante il comando File del menu Apri, disponibile sotto il menu File, e quindi aprirlo. Aprire il nodo Tabella di stringhe ed esaminare l'ID di risorsa 3082, impostato su Elementi di Visual Basic. Si tratta della stringa inserita nella chiamata AddNewItem. La stessa procedura è valida per i sistemi di progetto Visual C# , Visual C++ e Visual C#, eccetto la diversità dei nomi di file e degli ID di risorsa da utilizzare.

Di seguito è riportata una tabella relativa agli ID di risorsa e ai percorsi per i file di risorse dell'interfaccia utente:

Linguaggio di programmazione	Nome file UI	ID di risorsa per classe
Visual Basic	…\Programmi\Microsoft Visual Studio 8\VB\Bin\1033\msvbprojUI.dll	3082
Visual C#	…\Programmi\Microsoft Visual Studio 8\VC#\VCSPackages\1033\csprjui.dll	2346
Visual C++	…\Programmi\Microsoft Visual Studio 8\VC\vcpackages\1033\VCProjectUI.dll	10007

Esempi

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

ItemOperations Interfaccia

Spazio dei nomi EnvDTE

Condividi tramite