Professional IronPython

/RTF
: Creates the file in RTF format (valid with the 
/OUT
option only). This option is handy for 
making the ILDasm available for a group of developers on a local network using an application 
such as Word. For example, if you type 
ILDasm /OUT=WMPLib.RTF /RTF WMPLib.DLL
and 
press Enter, you obtain 
WMPLib.RTF
. The resulting file is huge — 5.2 MB for 
WMPLib.RTF
,
and may cause Word to freeze.
Of course, you might not want to redirect the output to a file, but may want to change the way the 
console appears instead. The following options change the GUI or file/console output for EXE and 
DLL files only.
➤➤
/BYTES
: Displays actual bytes (in hex) as instruction comments. Generally, this informa-
tion isn’t useful unless you want to get into the low-level details of the interop assembly. For 
example, you might see a series of hex bytes such as 
// SIG: 20 01 01 08
, which won’t be 
helpful to most developers. (In this case, you’re looking at the signature for the 
WMPLib 
.IAppDispatch.adjustLeft()
method.)
548592c09.indd 174
2/24/10 12:48:19 PM
www.finebook.ir

---

Defining an Interop DLL
 
❘
 
175
fIguRE 9-9: 
HTML output is useful for viewing ILDasm output in a browser.
➤➤
/RAWEH
: Shows the exception handling clauses in raw form. This isn’t a useful command line 
switch for interop assemblies because interop assemblies don’t require exception handlers in 
most cases.
➤
➤
/TOKENS
: Displays the metadata tokens of classes and members as comments in the source 
code, as shown in Figure 9-10 for the 
WMPLib.IAppDispatch.adjustLeft()
method. For 
example, the metadata token for 
mscorlib
is 
/*23000001*/
. Most developers won’t require 
this information.