Solution4.GetProjectItemTemplate, méthode (String, String)

Article
08/10/2011

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

Espace de noms : EnvDTE100
Assembly : EnvDTE100 (dans EnvDTE100.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 : System.String
Nom du modèle.

Language
Type : System.String
Langage utilisé pour écrire le modèle.

Valeur de retour

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

Implémentations

Solution3.GetProjectItemTemplate(String, String)

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 plusieurs manières différentes, 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 Création de modèles de projet et d'élément.

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 Solution4 = _
    CType(_applicationObject.Solution, Solution4)
    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.
 
    Solution4 soln = (Solution4)_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

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.