Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Nous recommandons d’utiliser Visual Studio 2017

Comment : accéder aux propriétés de fichiers de types de projets spécifiques

Vous pouvez définir et examiner manuellement les propriétés de fichiers présents dans le projet dans l'environnement de développement intégré (IDE) de Visual Studio. Pour examiner des propriétés de fichier, ouvrez un projet dans Visual Studio, cliquez avec le bouton droit sur un fichier projet, tel que filename.cs, dans l'Explorateur de solutions. Dans le menu contextuel, sélectionnez Propriétés pour afficher la boîte de dialogue Propriétés. La boîte de dialogue Propriétés affiche les propriétés de fichier que vous pouvez alors définir manuellement pour le fichier choisi.

L'espace de noms VSLangProj80 permet d'accéder par programmation aux propriétés des fichiers des projets Visual C# ou Visual Basic. Plus spécifiquement, FileProperties2 définit un jeu de propriétés enrichi pour accéder à des informations relatives aux fichiers et contrôler ces dernières. Certaines propriétés définies dans FileProperties2 ne sont pas valides pour chaque type de fichier. Par exemple, la propriété DateCreated est définie pour les fichiers de code, mais non pour d'autres fichiers projet.

Pour accéder à une propriété FileProperties2 spécifique, vous devez passer le nom de cette propriété comme une chaîne à EnvDTE.Property.Properties.Item(object index), comme dans l'exemple de code ci-dessous.

Project project;
ProjectItems projItems;
ProjectItem projItem;
Property prop;
project = _applicationObject.Solution.Projects.Item(1);
projItems = project.ProjectItems;
projItem = projItems.Item(1);
prop = projItem.Properties.Item("FileName");

Ce code permet d'accéder à la propriété FileName d'un fichier dans un projet Visual C# ou Visual Basic.

En effet, les propriétés définies dans FileProperties2 constituent une liste de références des propriétés disponibles pour des fichiers accessibles en tant qu'éléments de propriété de projet pour des projets Visual C# ou Visual Basic.

Les étapes ci-dessous détaillent la manière d'accéder par programmation à des propriétés de fichier dans un complément Visual Studio.

RemarqueRemarque

Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes. Ces éléments dépendent de l'édition de Visual Studio dont vous disposez et des paramètres que vous utilisez. Pour plus d'informations, consultez Paramètres Visual Studio.

Pour accéder aux propriétés de fichiers pour un type spécifique de projet

  1. Créez un projet de complément Visual Studio en utilisant Visual C#.

  2. Dans le menu Projet, cliquez sur Ajouter une référence, puis sur l'onglet .NET. Ensuite, sélectionnez VSLangProj, VSLangProj2 et VSLangProj80, puis cliquez sur OK.

  3. Ajoutez les instructions d'utilisation suivantes au début du fichier Connect.cs :

    using VSLangProj;
    using VSLangProj2;
    using VSLangProj80;
    
  4. Ajoutez l'appel de méthode suivant à la méthode OnConnection.

    public void OnConnection(object application, ext_ConnectMode connectMode, object addInInst, ref Array custom)
    {
        _applicationObject = (DTE2)application;
        _addInInstance = (AddIn)addInInst;
        VSProjectFileProps2(_applicationObject);
    }
    
  5. Ajoutez la méthode VSProjectFileProps2 immédiatement sous la méthode OnConnection.

    public void VSProjectFileProps2(DTE2 dte)
    {
        try
        {
            // Open a Visual C# or Visual Basic project
            // before running this add-in.
            Project project;
            ProjectItems projItems;
            ProjectItem projItem;
            Property prop;
            project = _applicationObject.Solution.Projects.Item(1);
            projItems = project.ProjectItems;
            for(int i = 1 ; i <= projItems.Count; i++ )
            {
                projItem = projItems.Item(i);
                prop = projItem.Properties.Item("FileName");
                MessageBox.Show("The file name of item " + i + " is: " 
    + prop.Value.ToString());
                if (prop.Value.ToString().Contains(".cs") 
    || prop.Value.ToString().Contains(".vb"))
                {
                    prop = projItem.Properties.Item("FileSize");
                    MessageBox.Show("The file size of item " + i + " 
    is: " + prop.Value.ToString());
                    prop = projItem.Properties.Item("DateCreated");
                    MessageBox.Show("The creation date of item " + i 
    + " is: " + prop.Value.ToString());
                }
            }
        }
        catch(Exception ex)
        {
            MessageBox.Show(ex.Message);
        }
    }
    

    La méthode VSProjectFileProps2 répertorie la propriété FileName pour chaque fichier dans le projet. La méthode détermine ensuite si le fichier présente une extension .cs ou .vb. Dans l'affirmative, les valeurs de propriété Filesize et valeurs de propriété DateCreated sont également affichées.

    La section Exemple fournit l'intégralité du code.

  6. Générez le complément en cliquant sur Générer la solution dans le menu Générer.

  7. Ouvrez un projet Visual C# ou Visual Basic dans l'IDE Visual Studio.

  8. Dans le menu Outils, cliquez sur Gestionnaire de compléments, puis sélectionnez votre complément dans la boîte de dialogue Gestionnaire de compléments. Cliquez sur OK pour exécuter votre complément.

L'exemple suivant est un complément Visual Studio de base qui montre comment accéder aux propriétés d'un fichier dans un type de projet spécifique, à l'aide de l'automation Visual Studio.

using System;
using Extensibility;
using EnvDTE;
using EnvDTE80;
using System.Windows.Forms;
using VSLangProj;
using VSLangProj2;
using VSLangProj80;
public void OnConnection(object application, 
ext_ConnectMode connectMode, object addInInst, ref Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    VSProjectFileProps2(_applicationObject);
}
public void VSProjectFileProps2(DTE2 dte)
{
    try
    {
        // Open a Visual C# or Visual Basic project
        // before running this add-in.
        Project project;
        ProjectItems projItems;
        ProjectItem projItem;
        Property prop;
        project = _applicationObject.Solution.Projects.Item(1);
        projItems = project.ProjectItems;
        for(int i = 1 ; i <= projItems.Count; i++ )
        {
            projItem = projItems.Item(i);
            prop = projItem.Properties.Item("FileName");
            MessageBox.Show("The file name of item " + i + " is: " 
+ prop.Value.ToString());
            if (prop.Value.ToString().Contains(".cs") 
|| prop.Value.ToString().Contains(".vb"))
            {
                prop = projItem.Properties.Item("FileSize");
                MessageBox.Show("The file size of item " + i + " is: "
 + prop.Value.ToString());
                prop = projItem.Properties.Item("DateCreated");
                MessageBox.Show("The creation date of item " + i 
+ " is: " + prop.Value.ToString());
            }
        }
    }
    catch(Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}

Pour compiler ce code, créez un projet de complément Visual Studio et remplacez le code de la méthode OnConnection par celui de l'exemple. Pour plus d'informations sur l'exécution d'un complément, consultez Comment : contrôler des compléments avec le Gestionnaire de compléments.

Afficher: