Comment : utiliser le journal d’activitéHow to: Use the Activity Log

Les VSPackages peuvent écrire des messages dans le journal d’activité.VSPackages can write messages to the activity log. Cette fonctionnalité est particulièrement utile pour déboguer les VSPackages dans les environnements de vente au détail.This feature is especially useful for debugging VSPackages in retail environments.

Conseil

Le journal d’activité est toujours activé.The activity log is always turned on. Visual Studio conserve un tampon propagée des 100 dernières entrées, ainsi que les 10 premières entrées, qui présentent des informations de configuration générale.Visual Studio keeps a rolling buffer of the last 100 entries as well as the first 10 entries, which have general configuration information.

Pour écrire une entrée dans le journal d’activitéTo write an entry to the activity log

  1. Insérez ce code dans la Initialize méthode ou dans toute autre méthode sauf dans le constructeur de VSPackage :Insert this code in the Initialize method or in any other method except the VSPackage constructor:

    IVsActivityLog log = GetService(typeof(SVsActivityLog)) as IVsActivityLog;  
    if (log == null) return;  
    
    int hr = log.LogEntry((UInt32)__ACTIVITYLOG_ENTRYTYPE.ALE_INFORMATION,  
        this.ToString(),  
        string.Format(CultureInfo.CurrentCulture,  
        "Called for: {0}", this.ToString()));  
    

    Ce code obtient le SVsActivityLog de service et le caste vers une IVsActivityLog interface.This code gets the SVsActivityLog service and casts it to an IVsActivityLog interface. LogEntry écrit une entrée d’information dans le journal des activités en utilisant le contexte de la culture actuels.LogEntry writes an informational entry into the activity log using the current cultural context.

  2. Lorsque le VSPackage est chargé (généralement lorsqu’une commande est appelée ou une fenêtre est ouverte), le texte est écrit dans le journal d’activité.When the VSPackage is loaded (usually when a command is invoked or a window is opened), the text is written to the activity log.

Examinez le journal d’activitéTo examine the activity log

  1. Exécutez Visual Studio avec le /journaux commutateur de ligne de commande pour écrire ActivityLog.xml sur le disque pendant votre session.Run Visual Studio with the /Log command line switch to write ActivityLog.xml to disk during your session.

  2. Après la fermeture de Visual Studio, recherchez le journal d’activité dans le sous-dossier pour les données de Visual Studio : %AppData%\Microsoft\VisualStudio\15.0\ActivityLog.xml.After closing Visual Studio, find the activity log in the subfolder for Visual Studio data: %AppData%\Microsoft\VisualStudio\15.0\ActivityLog.xml.

  3. Ouvrez le journal d’activité avec n’importe quel éditeur de texte.Open the activity log with any text editor. Voici une entrée de type :Here is a typical entry:

    Called for: Company.MyApp.MyAppPackage ...  
    

Programmation fiableRobust Programming

Étant donné que le journal d’activité est un service, le journal d’activité n’est pas disponible dans le constructeur du VSPackage.Because the activity log is a service, the activity log is unavailable in the VSPackage constructor.

Vous devez obtenir le journal d’activité juste avant l’écriture dans celle-ci.You should obtain the activity log just before writing to it. Ne pas mettre en cache ou enregistrer le journal d’activité pour une utilisation ultérieure.Do not cache or save the activity log for future use.

Voir aussiSee Also

/Log (devenv.exe) /Log (devenv.exe)
IVsActivityLog
__ACTIVITYLOG_ENTRYTYPE
Dépanner les packages VS Troubleshooting VSPackages
VSPackagesVSPackages