Implementowanie generatorów jednoplikowych
Narzędzie niestandardowe — czasami nazywane pojedynczym generatorem plików — może służyć do rozszerzania systemów projektów Visual Basic i Visual C# w programie Visual Studio. Niestandardowe narzędzie to składnik COM, który implementuje IVsSingleFileGenerator interfejs. Za pomocą tego interfejsu narzędzie niestandardowe przekształca pojedynczy plik wejściowy w jeden plik wyjściowy. Wynikiem transformacji może być kod źródłowy lub inne dane wyjściowe, które są przydatne. Dwa przykłady niestandardowych plików kodu generowanych przez narzędzia to kod generowany w odpowiedzi na zmiany w projektancie wizualizacji i pliki generowane przy użyciu języka WSDL (Web Services Description Language).
Po załadowaniu niestandardowego narzędzia lub zapisaniu pliku wejściowego system projektu wywołuje Generate metodę i przekazuje odwołanie do IVsGeneratorProgress interfejsu wywołania zwrotnego, dzięki czemu narzędzie może zgłosić postęp użytkownika.
Plik wyjściowy generowany przez narzędzie niestandardowe jest dodawany do projektu z zależnością od pliku wejściowego. System projektu automatycznie określa nazwę pliku wyjściowego na podstawie ciągu zwróconego przez implementację narzędzia niestandardowego DefaultExtension.
Narzędzie niestandardowe musi implementować IVsSingleFileGenerator interfejs. Opcjonalnie niestandardowe narzędzia obsługują IObjectWithSite interfejs w celu pobierania informacji ze źródeł innych niż plik wejściowy. W każdym razie, zanim będzie można użyć narzędzia niestandardowego, musisz zarejestrować go w systemie lub w lokalnym rejestrze programu Visual Studio. Aby uzyskać więcej informacji na temat rejestrowania narzędzi niestandardowych, zobacz Rejestrowanie generatorów pojedynczych plików.