Condividi tramite


implementare i generatori di file singolo

Uno strumento personalizzato (talvolta definita generatore di file singolo )può essere utilizzato per estendere Visual Basic  i sistemi di progetto csprcs in Visual Studio. Uno strumento personalizzato è un componente COM che implementa l'interfaccia di IVsSingleFileGenerator . L'utilizzo di questa interfaccia, uno strumento personalizzato trasforma un file a un input in un file di output. Il risultato della trasformazione può essere codice sorgente, o qualsiasi altro output che è utile. Due esempi dei file di codice strumento-generati personalizzati sono codice generato in seguito a modifiche in una finestra di progettazione visiva e file compilati utilizzando il Web Services Description Language (WSDL)).

Quando uno strumento personalizzato viene caricato, o il file di input viene salvato, attraverso il sistema di progetto chiama il metodo di Generate e passa un riferimento a un'interfaccia di callback di IVsGeneratorProgress , con cui lo strumento può segnalare lo stato dell'utente.

Il file di output che lo strumento personalizzato generato viene aggiunto al progetto con una dipendenza riguardanti l'archivio di input. Il sistema del progetto determina automaticamente il nome del file di output, in base alla stringa restituita dall'implementazione personalizzata dello strumento di DefaultExtension.

uno strumento personalizzato deve implementare l'interfaccia di IVsSingleFileGenerator . Facoltativamente, gli strumenti personalizzati supportano l'interfaccia di IObjectWithSite per recuperare informazioni da origini diverse da di input. Tuttavia, prima di poter utilizzare uno strumento personalizzato, è necessario registrarlo con il sistema o in locale il Registro di sistema di Visual Studio . Per ulteriori informazioni sulla registrazione degli strumenti personalizzati, vedere registrare i generatori di file singolo.

Vedere anche

Concetti

Determinazione dello spazio dei nomi predefinito

Esporre tipi per le finestre di progettazione visiva