Fichier d’options utilisateur de solution (.suo)
Le fichier options utilisateur de la solution (.suo) contient des options de solution par utilisateur. Ce fichier ne doit pas être case activée dans le contrôle de code source.
Le fichier d’options utilisateur de la solution (.suo) est un fichier de stockage structuré, ou composé, stocké dans un format binaire. Vous enregistrez des informations utilisateur dans des flux avec le nom du flux en tant que clé qui sera utilisée pour identifier les informations dans le fichier .suo. Le fichier d’options utilisateur de la solution est utilisé pour stocker les paramètres de préférence utilisateur et est créé automatiquement lorsque Visual Studio enregistre une solution.
Lorsque l’environnement ouvre un fichier .suo, il énumère tous les VSPackages actuellement chargés. Si un VSPackage implémente l’interface IVsPersistSolutionOpts , l’environnement appelle la LoadUserOptions méthode sur vsPackage lui demandant de charger toutes ses données à partir du fichier .suo.
Il incombe à VSPackage de savoir quels flux il a pu écrire dans le fichier .suo. Pour chaque flux qu’il a écrit, le VSPackage revient à l’environnement par le biais LoadPackageUserOpts du chargement d’un flux particulier identifié par la clé, qui est le nom du flux. L’environnement revient ensuite au VSPackage pour lire ce flux particulier en passant le nom du flux et un IStream pointeur vers la LoadPackageUserOpts méthode.
À ce stade, un autre appel est effectué pour LoadUserOptions voir s’il existe une autre section du fichier .suo qui doit être lu. Ce processus se poursuit jusqu’à ce que tous les flux de données du fichier .suo aient été lus et traités par l’environnement.
Lorsque la solution est enregistrée ou fermée, l’environnement appelle la SavePackageSolutionProps méthode avec un pointeur vers la SaveUserOptions méthode. Une IStream contenant les informations binaires à enregistrer est passée à la WriteUserOptions méthode, qui écrit ensuite les informations dans le fichier .suo et appelle à nouveau la SaveUserOptions méthode pour voir s’il existe un autre flux d’informations à écrire dans le fichier .suo.
Ces deux méthodes, SaveUserOptions et WriteUserOptions, sont appelées de manière récursive pour chaque flux d’informations à enregistrer dans le fichier .suo, en passant le pointeur vers IVsSolutionPersistence. Elles sont appelées de manière récursive pour permettre l’écriture de plusieurs flux dans le fichier .suo. De cette façon, les informations utilisateur sont conservées avec la solution et sont garanties d’être là la prochaine fois que la solution est ouverte.