Einzeldateie Generatoren implementieren
Ein benutzerdefiniertes Tool — manchmal als einem Einzeldatei-Generator — kann verwendet werden, um die Visual Basic und Visual C# Projektsysteme in Visual Studiozu erweitern. Ein benutzerdefiniertes Tool ist eine COM-Komponente, die die IVsSingleFileGenerator-Schnittstelle implementiert. Mithilfe dieser Schnittstelle umgewandelt Ein-Input ein benutzerdefiniertes Tool eine Datei in eine Datei mit Ein-Output. Das Ergebnis der Transformation kann Quellcode oder eine beliebige andere Ausgabe, die hilfreich ist. Zwei Beispiele für benutzerdefinierte Tool-generierten Codedateien sind der Code, der in Reaktion auf Änderungen in einem visuellen Designer generiert werden und die Dateien, die mithilfe 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 vom Tool, mit dem Benutzer den Status Gestartet melden kann.
Die Ausgabedatei, die das benutzerdefinierte Tool generiert, wird dem Projekt mit einer Abhängigkeit von der Eingabedatei hinzugefügt. Das Projektsystem bestimmt automatisch den Namen der Ausgabedatei auf Grundlage der Zeichenfolge, die von der benutzerdefinierten Implementierung des Tools über DefaultExtensionzurückgegeben wurde.
Ein benutzerdefiniertes Tool muss die IVsSingleFileGenerator-Schnittstelle implementieren. Optionale Unterstützung benutzerdefinierter Tools die IObjectWithSite-Schnittstelle, um Informationen aus den Quellen andere als die Eingabedatei abzurufen. In jedem Fall bevor Sie ein benutzerdefiniertes Tool verwenden können, müssen Sie es im System oder in der Registrierung Visual Studio Lokale registrieren. Weitere Informationen zum Registrieren von benutzerdefinierten Tools finden Sie unter Einzelne Datei-Generatoren registrieren.