Professional IronPython

ScriptRuntime.CreateRemote()
: A factory method that helps you to create a 
ScriptRuntime
object in another domain. The code must meet strict requirements to per-
form remote execution. See Section 4.1.3, “Create* Methods,” in the Hosting APIs specifica-
tion for details.
At its name implies, a 
ScriptRuntimeSetup
object gives a host full control over the 
ScriptRuntime
object configuration. The 
ScriptRuntimeSetup
object contains settings for debug mode, private execu-
tion, the host type, host arguments, and other setup features. Simply creating a 
ScriptRuntimeSetup
object sets the defaults for executing a script. Once you use a 
ScriptRuntimeSetup
object to create a 
ScriptRuntime
object, you can’t change the settings — doing so will raise an exception.
548592c14.indd 294
2/24/10 12:49:05 PM
www.finebook.ir

---

Working with Hosting APIs
 
❘
 
295
The Hosting APIs actually support a number of objects that you use to create a scripting environ-
ment, load the code you want to execute, and control the execution process. The figure at 
http://
www.flickr.com/photos/john_lam/2220796647/
provides an overview of these objects and how 
you normally use them within the hosting session.
It’s important to isolate code during execution. The Hosting APIs provide three levels of isolation.
➤➤
AppDomain
: The highest isolation level, which affects the entire application. The 
AppDomain
lets you execute code at different trust levels, and load and unload code as needed.
➤
➤
ScriptRuntime
: Every 
AppDomain
can have multiple 
ScriptRuntime
s within it. Each 
ScriptRuntime
object can have different name bindings, use different .NET assemblies, 
have different settings (one can be in debug mode, while another might not), and provide 
other settings and options support.
➤
➤