Implementieren von Generatoren einzelner Dateien
Ein benutzerdefiniertes Tool , das manchmal als einzelner Dateigenerator bezeichnet wird, kann verwendet werden, um die Visual Basic- und Visual C#-Projektsysteme in Visual Studio zu erweitern. Ein benutzerdefiniertes Tool ist eine COM-Komponente, die die IVsSingleFileGenerator Schnittstelle implementiert. Mithilfe dieser Schnittstelle wandelt ein benutzerdefiniertes Tool eine einzelne Eingabedatei in eine einzelne Ausgabedatei um. Das Ergebnis der Transformation kann Quellcode oder eine andere ausgabe sein, die nützlich ist. Zwei Beispiele für benutzerdefinierte, vom Tool generierte Codedateien sind Code, der als Reaktion auf Änderungen in einem visuellen Designer und Dateien generiert wird, die mit der Web Services Description Language (WSDL) generiert werden.
Wenn ein benutzerdefiniertes Tool geladen wird oder die Eingabedatei gespeichert wird, ruft das Projektsystem die Generate Methode auf und übergibt einen Verweis auf eine IVsGeneratorProgress Rückrufschnittstelle, wodurch das Tool den Fortschritt an den Benutzer melden kann.
Die vom benutzerdefinierten Tool generierte Ausgabedatei wird dem Projekt mit einer Abhängigkeit von der Eingabedatei hinzugefügt. Das Projektsystem bestimmt automatisch den Namen der Ausgabedatei, basierend auf der Zeichenfolge, die von der Implementierung DefaultExtensiondes benutzerdefinierten Tools zurückgegeben wird.
Ein benutzerdefiniertes Tool muss die IVsSingleFileGenerator Schnittstelle implementieren. Optional unterstützen benutzerdefinierte Tools die IObjectWithSite Schnittstelle zum Abrufen von Informationen aus anderen Quellen als der Eingabedatei. Bevor Sie ein benutzerdefiniertes Tool verwenden können, müssen Sie es in jedem Fall beim System oder in der lokalen Registrierung von Visual Studio registrieren. Weitere Informationen zum Registrieren von benutzerdefinierten Tools finden Sie unter Registrieren einzelner Dateigeneratoren.