Partager via


Solution3.GetProjectItemTemplate, méthode

Retourne un chemin au modèle d'élément de projet indiqué.

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

Syntaxe

'Déclaration
Function GetProjectItemTemplate ( _
    TemplateName As String, _
    Language As String _
) As String
string GetProjectItemTemplate(
    string TemplateName,
    string Language
)
String^ GetProjectItemTemplate(
    String^ TemplateName, 
    String^ Language
)
abstract GetProjectItemTemplate : 
        TemplateName:string * 
        Language:string -> string
function GetProjectItemTemplate(
    TemplateName : String, 
    Language : String
) : String

Paramètres

  • TemplateName
    Type : String

    Nom du modèle.

  • Language
    Type : String

    Langage utilisé pour écrire le modèle.

Valeur de retour

Type : String
Nom complet du modèle d'élément de projet.

Notes

Les modèles de projet sont stockés sous forme de fichiers zip. Cette méthode demande le nom et le langage du projet et retourne le chemin d'accès au modèle.

Les paramètres de GetProjectItemTemplate peuvent être fournis de différentes manières, comme suit :

  • Passez le GUID d'un projet virtuel Smart Device Visual Basic comme paramètre Language et le nom du fichier zip comme TemplateName.

    GetProjectItemTemplate("NETCFv2-Class.zip", "{3114F5B0-E435-4bc5-A03D-168E20D9BF83}");
    
  • Passez le GUID d'un projet virtuel Smart Device Visual Basic comme paramètre Language et la chaîne « Class » comme TemplateName. La chaîne "Class" est dérivée de la hiérarchie de dossiers et est connue en tant que chaîne d'interface utilisateur. "HTML Page" (page HTML) et "Splash Screen" (écran de démarrage) sont d'autres chaînes d'interface utilisateur. Les chaînes d'interface utilisateur sont dépendantes de paramètres régionaux. L'utilisation du nom du fichier zip est le moyen le plus sûr de passer le paramètre TemplateName.

    GetProjectItemTemplate("Class", "{3114F5B0-E435-4bc5-A03D-168E20D9BF83}");
    
  • Passez la chaîne "VisualBasic" comme le paramètre Language, et le nom du fichier zip pour le paramètre TemplateName. Cela fonctionne, car NETCFv2-Class.zip est spécifique aux appareils de type Smart Device.

    GetProjectItemTemplate("NETCFv2-Class.zip", "VisualBasic/SmartDevice-NETCFv2");
    

Vous pouvez également créer des modèles personnalisés pour les éléments de projet. Pour spécifier le répertoire dans lequel vous stockerez vos modèles, cliquez sur Options dans le menu Outils. Dans le volet gauche de la boîte de dialogue Options, cliquez sur Projets et solutions. Tapez le chemins d'accès à vos modèles dans les zones Emplacement des modèles d'élément pour l'utilisateur de Visual Studio. Vous pouvez également accepter l'emplacement par défaut.

Les modèles personnalisés requièrent des noms de fichiers uniques qui n'entrent pas en conflit avec les noms de fichiers définis dans :

<Lecteur>:\Program Files\Microsoft Visual Studio 9\Common7\IDE\ItemTemplates\Langue.

Assurez-vous que vous utilisez des noms de fichiers longs (par opposition au modèle 8.3). Pour plus d'informations, consultez Creating Project and Item Templates.

Exemples

Pour plus d'informations sur l'exécution de ce code de complément, consultez Comment : compiler et exécuter les exemples de code du modèle objet Automation.

Public Sub OnConnection(ByVal application As Object, _
 ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
 ByRef custom As Array) Implements IDTExtensibility2.OnConnection
    _applicationObject = CType(application, DTE2)
    _addInInstance = CType(addInInst, AddIn)
    SaveAsExample(_applicationObject)
End Sub

Sub SaveAsExample(ByVal dte As DTE2)
    ' This add-in adds an HTML page to a solution.
    ' Open a Visual Basic solution in Visual Studio
    ' before running this example.

    Dim soln As Solution3 = _
    CType(_applicationObject.Solution, Solution3)
    Dim prj As Project
    Dim prjItem As ProjectItem
    Dim itemPath As String

    Try
        prj = soln.Projects.Item(1)
        itemPath = soln.GetProjectItemTemplate("HTMLPage.zip", _
        "VisualBasic")
        ' Create a new project item based on the template. 
        ' (In this case, an HTML page.)
        prjItem =  _
        prj.ProjectItems.AddFromTemplate(itemPath, "MyNewHtml")

    Catch ex As SystemException
        MsgBox("ERROR: " & ex.ToString())
    End Try
End Sub
using System.Windows.Forms;
public void OnConnection(object application,
 Extensibility.ext_ConnectMode connectMode, object addInInst,
 ref System.Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    // Pass the applicationObject member variable to the code example.
    SolnGetProjetItemExample((DTE2)_applicationObject);
}
public void SolnGetProjetItemExample(DTE2 dte)
{
    // This add-in adds an item to a Visual Basic solution.
    // Open a Visual Basic solution in Visual Studio 
    // before running this example.
 
    Solution3 soln = (Solution3)_applicationObject.Solution;
    Project prj;
    ProjectItem prjItem;
    string itemPath;
    try
    {

        prj = soln.Projects.Item(1);
        itemPath = 
          soln.GetProjectItemTemplate("HTMLPage.zip", "VisualBasic");
        // Create a new project item based on the template. 
        // (In this case, an HTML page.)
        prjItem = 
prj.ProjectItems.AddFromTemplate(itemPath, "MyNewHtml");

    }
    catch (SystemException ex)
    {
        MessageBox.Show("ERROR: " + ex);
    }
}

Sécurité .NET Framework

Voir aussi

Référence

Solution3 Interface

EnvDTE90, espace de noms

Autres ressources

Comment : compiler et exécuter les exemples de code du modèle objet Automation