Implementazione di generatori di file singoli
Uno strumento personalizzato, talvolta definito generatore di file singolo, può essere usato per estendere i sistemi di progetto Visual Basic e Visual C# in Visual Studio. Uno strumento personalizzato è un componente COM che implementa l'interfaccia IVsSingleFileGenerator . Usando questa interfaccia, uno strumento personalizzato trasforma un singolo file di input in un singolo file di output. Il risultato della trasformazione può essere codice sorgente o qualsiasi altro output utile. Due esempi di file di codice personalizzati generati da strumenti sono il codice generato in risposta alle modifiche apportate a una finestra di progettazione visiva e ai file generati tramite WSDL (Web Services Description Language).
Quando viene caricato uno strumento personalizzato o il file di input viene salvato, il sistema di progetto chiama il Generate metodo e passa un riferimento a un'interfaccia IVsGeneratorProgress di callback, in cui lo strumento può segnalare lo stato di avanzamento all'utente.
Il file di output generato dallo strumento personalizzato viene aggiunto al progetto con una dipendenza dal file di input. Il sistema di progetto determina automaticamente il nome del file di output, in base alla stringa restituita dall'implementazione dello strumento personalizzato di DefaultExtension.
Uno strumento personalizzato deve implementare l'interfaccia IVsSingleFileGenerator . Facoltativamente, gli strumenti personalizzati supportano l'interfaccia IObjectWithSite per recuperare informazioni da origini diverse dal file di input. In ogni caso, prima di poter usare uno strumento personalizzato, è necessario registrarlo nel sistema o nel Registro di sistema locale di Visual Studio. Per altre informazioni sulla registrazione di strumenti personalizzati, vedere Registrazione di generatori di file singoli.