Professional IronPython

Using the Hosting APIs
The DLR specification lists a number of hosting scenarios, such as operating on dynamic 
objects you create within C# or Visual Basic.NET applications. (See the section “Working 
with IDynamicObject” later in this chapter for details on dynamic objects in C# and Visual 
Basic.NET.) It’s also possible to use the Hosting APIs to create a scripting environment within 
Silverlight or other types of Web applications.
Whatever sort of host environment you create, you can use it to execute code snippets or entire 
applications found in files. The script run time can appear locally or within a remote application so 
you can use this functionality to create agent applications or scripting that relies on server support. 
The Hosting APIs make it possible to choose a specific scripting engine to execute the code or to 
let DLR choose the most appropriate scripting engine for the task. This second option might seem 
foolhardy, but it can actually let your code use the most recent scripting engine, even if that engine 
wasn’t available at the time you wrote the host environment code.
Chaos could result if you couldn’t control the extent (range) of the script execution in some way. 
For example, two developers could create variables with the same name in different areas of the 
548592c14.indd 293
2/24/10 12:49:05 PM
www.finebook.ir

---

294
❘
CHAPTER 14
InteractIng wIth the DLr
application. The Hosting APIs make it possible to add scope to script execution. The scope acts 
much like a namespace does when writing code. Just as a namespace eliminates naming conflicts in 
assemblies, scoping eliminates them in the scripting environment. Executing the code within a scope 
also provides it with an execution context (controlled using a 
ScriptScope
). Scopes are either pub-
lic or private, with private scopes providing a measure of protection for the scripting environment. A 
script can also import scopes for use within the environment or require the host to support a certain 
scope to execute the script.
The Hosting APIs also provide support for other functionality. For example, you can employ 
reflection to obtain information about object members, obtain parameter information, and view 
documentation. You can also control how the scripting engine resolves file content when dynamic 
languages import code files.