Condividi tramite


File Opzioni utente soluzione (con estensione suo)

Il file delle opzioni utente della soluzione (con estensione suo) contiene opzioni di soluzione per utente. Questo file non deve essere archiviato nel controllo del codice sorgente.

Il file di opzioni utente della soluzione (con estensione suo) è un file di archiviazione strutturato, o composto, archiviato in un formato binario. Le informazioni utente vengono salvate in flussi con il nome del flusso che sarà la chiave che verrà usata per identificare le informazioni nel file con estensione suo. Il file delle opzioni utente della soluzione viene usato per archiviare le impostazioni delle preferenze utente e viene creato automaticamente quando Visual Studio salva una soluzione.

Quando l'ambiente apre un file con estensione suo, enumera tutti i pacchetti VSPackage attualmente caricati. Se un VSPackage implementa l'interfaccia IVsPersistSolutionOpts , l'ambiente chiama il LoadUserOptions metodo nel VSPackage chiedendo di caricare tutti i dati dal file con estensione suo.

È responsabilità del VSPackage sapere quali flussi potrebbero essere stati scritti nel file con estensione suo. Per ogni flusso scritto, il pacchetto VSPackage richiama l'ambiente attraverso LoadPackageUserOpts per caricare un flusso specifico identificato dalla chiave, ovvero il nome del flusso. L'ambiente chiama quindi di nuovo il VSPackage per leggere quel particolare flusso passando il nome del flusso e un IStream puntatore al LoadPackageUserOpts metodo .

A questo punto, viene effettuata un'altra chiamata per LoadUserOptions verificare se è presente un'altra sezione del file con estensione suo che deve essere letta. Questo processo continua fino a quando tutti i flussi di dati nel file con estensione suo non sono stati letti ed elaborati dall'ambiente.

Quando la soluzione viene salvata o chiusa, l'ambiente chiama il SavePackageSolutionProps metodo con un puntatore al SaveUserOptions metodo . Un IStream oggetto contenente le informazioni binarie da salvare viene passato al WriteUserOptions metodo , che quindi scrive le informazioni nel file con estensione suo e chiama di nuovo il SaveUserOptions metodo per verificare se è presente un altro flusso di informazioni da scrivere nel file con estensione suo.

Questi due metodi, SaveUserOptions e WriteUserOptions, vengono chiamati in modo ricorsivo per ogni flusso di informazioni da salvare nel file con estensione suo, passando il puntatore a IVsSolutionPersistence. Vengono chiamati in modo ricorsivo per consentire la scrittura di più flussi nel file con estensione suo. In questo modo, le informazioni utente vengono rese persistenti con la soluzione e viene garantita la successiva apertura della soluzione.

Vedi anche