Sdílet prostřednictvím


Implementace generátorů tvořených jedním souborem

Vlastní nástroj ( někdy označovaný jako jeden generátor souborů) se dá použít k rozšíření systémů projektů Visual Basic a Visual C# v sadě Visual Studio. Vlastní nástroj je komponenta MODELU COM, která implementuje IVsSingleFileGenerator rozhraní. Pomocí tohoto rozhraní vlastní nástroj transformuje jeden vstupní soubor do jednoho výstupního souboru. Výsledkem transformace může být zdrojový kód nebo jakýkoli jiný výstup, který je užitečný. Dva příklady vlastních souborů kódu generovaných nástroji jsou kód generovaný v reakci na změny vizuálního návrháře a soubory generované pomocí wsDL (Web Services Description Language).

Při načtení vlastního nástroje nebo uložení vstupního souboru systém projektu volá Generate metodu a předává odkaz na IVsGeneratorProgress rozhraní zpětného volání, kde nástroj může hlásit jeho průběh uživateli.

Výstupní soubor, který vlastní nástroj generuje, se přidá do projektu se závislostí na vstupním souboru. Systém projektu automaticky určí název výstupního souboru na základě řetězce vráceného implementací vlastního DefaultExtensionnástroje .

Vlastní nástroj musí implementovat IVsSingleFileGenerator rozhraní. Volitelně vlastní nástroje podporují IObjectWithSite rozhraní pro načtení informací z jiných zdrojů než ze vstupního souboru. V každém případě je nutné ho před použitím vlastního nástroje zaregistrovat v systému nebo v místním registru sady Visual Studio. Další informace o registraci vlastníchnástrojůch