Visualizzare i file usando il comando Apri file

I passaggi seguenti descrivono come l'IDE gestisce il comando Apri file , disponibile nel menu File in Visual Studio. I passaggi descrivono anche il modo in cui i progetti devono rispondere alle chiamate provenienti da questo comando.

Quando un utente fa clic sul comando Apri file dal menu File e seleziona un file nella finestra di dialogo Apri file , viene eseguito il processo seguente:

  1. Usando la tabella dei documenti in esecuzione, l'IDE determina se il file è già aperto in un progetto.

    • Se il file è aperto, l'IDE riaccese la finestra.

    • Se il file non è aperto, l'IDE chiama IsDocumentInProject per eseguire una query su ogni progetto per determinare quale progetto può aprire il file.

      Nota

      Nell'implementazione del progetto di IsDocumentInProjectspecificare un valore di priorità che indica il livello in cui il progetto apre il file. I valori di priorità vengono forniti nell'enumerazione VSDOCUMENTPRIORITY .

  2. Ogni progetto risponde con un livello di priorità che indica l'importanza che deve essere il progetto per aprire il file.

  3. L'IDE usa i criteri seguenti per determinare quale progetto apre il file:

    • Il progetto che risponde con la priorità più alta (DP_Intrinsic) apre il file. Se più progetti rispondono con questa priorità, il primo progetto a cui rispondere apre il file.

    • Se nessun progetto risponde con la priorità più alta (DP_Intrinsic), ma tutti i progetti rispondono con la stessa priorità più bassa, il progetto attivo apre il file. Se non è attivo alcun progetto, il primo progetto a cui rispondere apre il file.

    • Se nessun progetto dichiara la proprietà del file (DP_Unsupported), il progetto File esterni apre il file.

      Se viene creata un'istanza del progetto File esterni, il progetto risponde sempre con il valore DP_CanAddAsExternal. Questo valore indica che il progetto può aprire il file. Questo progetto viene usato per ospitare file aperti che non si trovano in alcun altro progetto. L'elenco di elementi in questo progetto non è persistente; questo progetto è visibile in Esplora soluzioni solo quando viene usato per aprire un file.

      Se il progetto File esterni non indica che può aprire il file, non è stata creata un'istanza del progetto. In questo caso, l'IDE crea un'istanza del progetto File esterni e indica al progetto di aprire il file.

  4. Non appena l'IDE determina quale progetto apre il file, chiama il OpenItem metodo su tale progetto.

  5. Il progetto ha quindi la possibilità di aprire il file usando un editor specifico del progetto o un editor standard. Per altre informazioni, vedere Procedura: Aprire rispettivamente editor specifici del progetto e Procedura: Aprire editor standard.