Windows Forms Class Viewer-Tool (Wincv.exe)
Mit dem Windows Forms Class Viewer-Tool können Sie gemäß einem Suchmuster schnell Informationen über eine Klasse oder eine Reihe von Klassen anzeigen lassen. Das Class Viewer-Tool zeigt Informationen an, indem der Typ mithilfe der Reflexions-API der Common Language Runtime analysiert wird.
Das Windows Forms Class Viewer-Tool ist nur im Lieferumfang der .NET Framework SDK-Versionen 1.0 und 1.1 enthalten.
wincv [options]
Hinweise
In der folgenden Tabelle werden die verfügbaren Optionen beschrieben.
| Option | Beschreibung |
|---|---|
/h |
Zeigt Befehlssyntax und Optionen für das Tool an. |
/hide:type |
Blendet den angegebenen Membertyp aus. Sie müssen protected, private, internal oder inherited als type-Argument angeben. Wenn Sie diese Option nicht angeben, sind die Typen protected, private und internal standardmäßig ausgeblendet. Um mehrere auszublendende Membertypen festzulegen, geben Sie die Option /hide mehrere Male hintereinander durch Leerzeichen getrennt in die Befehlszeile ein. Beispiel: /hide:protected /hide:private. |
/nostdlib[+|-] |
Gibt an, ob die folgenden Standardassemblys geladen werden sollen: mscorlib.dll, System.dll, System.Data.dll, System.Design.dll, System.DirectoryServices.dll, System.Drawing.dll, System.Drawing.Design.dll, System.Messaging.dll, System.Runtime.Serialization.Formatters.Soap.dll, System.ServiceProcess.dll, System.Web.dll, System.Web.Services.dll, System.Windows.Forms.dll, System.XML.dll. Wenn Sie das Pluszeichen (+) angeben, werden die Standardassemblys von Wincv.exe nicht geladen. Der Standardwert, bei dem die Standardassemblys geladen werden, lautet /nostdlib-. |
/r: assemblyFile |
Gibt eine zu ladende und zu durchsuchende Assembly an. |
/show: type |
Zeigt den angegebenen Membertyp an. Sie müssen protected, private, internal oder inherited als type-Argument angeben. Wenn Sie diese Option nicht angeben, werden nur inherited-Typen standardmäßig angezeigt. Um mehrere anzuzeigende Membertypen festzulegen, geben Sie die Option /show mehrere Male hintereinander durch Leerzeichen getrennt in die Befehlszeile ein. Beispiel: /show:protected /show:private. |
@ fileName |
Liest weitere Optionen aus der angegebenen Antwortdatei. |
/? |
Zeigt Befehlssyntax und Optionen für das Tool an. |
Starten Sie Wincv.exe über die Befehlszeile, und geben Sie im Textfeld im oberen Teil des Formulars einen Typnamen oder einen Teil eines Typnamens ein. Im Listenfeld auf der linken Seite des Formulars wird eine Liste aller Typen angezeigt, die Wincv.exe ausgehend vom eingegebenen Namen finden konnte. Der System-Namespace ergibt sich aus den Klassennamen. Deshalb wird in der Liste der Klassennamen "Object" und nicht "System.Object" angezeigt. Wenn Sie einen Typ aus der Liste auswählen, wird die Typdefinition im rechten Bereich angezeigt. Die Typdefinition wird mittels einer C#-ähnlichen Syntax angezeigt. Jedoch werden nicht alle Typdefinitionen im C#-Compiler genauso kompiliert, wie sie im Viewer angezeigt werden. Das folgende Beispiel veranschaulicht, wie Informationen in der ButtonBase-Klasse gesucht werden.
So suchen Sie mit Wincv.exe eine Typdefinition
Geben Sie an der Eingabeaufforderung wincv ein. Hierdurch werden die Standardassemblys geladen und der Class Viewer angezeigt.
Geben Sie im Textfeld im oberen Bereich des Formulars Button ein.
Wählen Sie aus den im Listenfeld auf der linken Seite des Formulars angezeigten Typen den ButtonBase-Klassennamen im System.Windows.Forms-Namespace aus.
Die Definition von System.Windows.Forms.ButtonBase wird rechts im Bereich angezeigt.
Beispiele
Der folgende Befehl führt Wincv.exe aus und lädt myApp.exe sowie die Standardassemblys zum Durchsuchen.
wincv /r:myApp.exe
Der folgende Befehl führt Wincv.exe aus und lädt nur myApp.exe zum Durchsuchen. Die Standardassemblys werden nicht geladen.
wincv /r:myApp.exe /nostdlib+
Das folgende Beispiel zeigt den Inhalt einer Antwortdatei mit dem Namen myFile.rsp. Wenn Sie eine Antwortdatei verwenden, entfällt die Notwendigkeit, Befehle einzeln in der Befehlszeile einzugeben.
/r:myAssembly.dll
/r:myOtherAssembly.dll
Der folgende Befehl liest die Antwortdatei myFile.rsp und führt die in der Datei angegebenen Befehle aus.
wincv @myFile.rsp
Siehe auch
Referenz
.NET Framework-Tools
MSIL Disassembler-Tool (Ildasm.exe)