Professional IronPython

Obtaining DLR
 
❘
 
289
In order to truly understand DLR, you at least need documentation. Better yet, you can download 
the entire DLR package and begin to understand the true impact of this product. If nothing else, 
spend some time viewing the available components at 
http://www.codeplex.com/dlr
. The follow-
ing sections describe various methods of gaining access to DLR so you can use it to perform some 
custom tasks.
This chapter relies on DLR version 0.92, which is a pre-release version of the 
product. It’s never a good idea to use pre-release software in a production envi-
ronment unless you’re willing to live with the potential issues that pre-release 
software brings, such as reliability, speed, and security problems. This chapter is 
better viewed as food for thought for future production projects and as a means 
of experimenting with new technology.
Using the Direct Method
The direct method is the easiest way to obtain the benefits of DLR, but it’s also the most limited. You 
simply add a reference to the 
IronPython.DLL
file located in the 
\Program Files\IronPython 2.6
folder of your hard drive. This technique works fine for embedding IronPython scripts in your C# or 
Visual Basic.NET application. In fact, you gain access to the following classes:
➤
IronPython
➤
IronPython.Compiler
➤
➤
IronPython.Compiler.Ast
➤
➤
IronPython.Hosting
➤
➤
IronPython.Modules
➤
➤
IronPython.Runtime
➤
➤
IronPython.Runtime.Binding
➤
➤
IronPython.Runtime.Exceptions
➤
➤
IronPython.Runtime.Operations
➤
➤
IronPython.Runtime.Types
➤
➤
For many developers, this is all the DLR support you need, especially if your application only requires 
cross-language support through the Hosting APIs. (You’ll still want to download the documentation 
that’s available on the main DLR Web site — the section “Downloading the Documentation” later in 
this chapter explains how to perform this task.) The following steps describe how to add the required 
reference to gain access to these classes.