© 2004 Microsoft Corporation. All rights reserved.

Figure 2 Sample ClockBox Script
  ' PacificTime.vb
imports System
module Script
    sub Main()
        Clock.Caption = "Pacific Time (Me)"
    end sub
    sub Clock_Tick() handles Clock.TickEvent
        dim utc as DateTime = Clock.Now.ToUniversalTime()
        Clock.Now = utc.AddHours(-8)
    end sub    
end module

Figure 4 IVsaEngine Interface
  public interface Microsoft.Vsa.IVsaEngine {
    Assembly Assembly { get; }
    bool GenerateDebugInfo { get; set; }
    bool IsCompiled { get; }
    bool IsDirty { get; }
    bool IsRunning { get; }
    IVsaItems Items { get; }
    string Language { get; }
    int LCID { get; set; }
    string Name { get; set; }
    string RootMoniker { get; set; }
    string RootNamespace { get; set; }
    IVsaSite Site { get; set; }
    string Version { get; }
    void Close();
    bool Compile();
    object GetOption(string name);
    void InitNew();
    bool IsValidIdentifier(string identifier);
    void LoadSourceState(IVsaPersistSite site);
    void Reset();
    void RevokeCache();
    void Run();
    void SaveCompiledState(ref Byte[] pe, ref Byte[] pdb);
    void SaveSourceState(IVsaPersistSite site);
    void SetOption(string name, object value);
}

Figure 5 Initializing an Engine
  switch( et ) {
case EngineType.JScript:
  _engine = new Microsoft.JScript.Vsa.VsaEngine();
  break;
case EngineType.VBScript:
  _engine = new Microsoft.VisualBasic.Vsa.VsaEngine();
  break;
}
_engine.RootMoniker = "clockbox://clock/" + _clockCount;
_engine.Site = this;
_engine.InitNew();
_engine.RootNamespace = "ClockScript";

Figure 6 Assembly Reference Items
  IVsaItems           items = _engine.Items;
IVsaReferenceItem   refItem;
// Add system.dll
refItem = (IVsaReferenceItem)items.CreateItem("system.dll",
                                              VsaItemType.Reference,
                                              VsaItemFlag.None);
refItem.AssemblyName = "system.dll";
// Add mscorlib.dll
refItem = (IVsaReferenceItem)items.CreateItem("mscorlib.dll",
                                              VsaItemType.Reference,
                                              VsaItemFlag.None);
refItem.AssemblyName = "mscorlib.dll";
// Add System.Windows.Forms.dll
refItem = (IVsaReferenceItem)items.CreateItem("WinForms",
                                              VsaItemType.Reference,
                                              VsaItemFlag.None);
refItem.AssemblyName = "System.Windows.Forms.dll";

Figure 7 Using Reflection
  IVsaEngine engine = new Microsoft.VisualBasic.Vsa.VsaEngine();
•••
engine.RootNamespace = "ClockScript";
IVsaItems items = _engine.Items;
codeItem = (IVsaCodeItem)items.CreateItem("Script", ...);
codeItem.SourceText = ...
_engine.Compile();
_engine.Run();
// Execute ClockScript.Script.Main()
Assembly   assem = _engine.Assembly;
Type       type = assem.GetType("ClockScript.Script");
MethodInfo method = type.GetMethod("Main");
method.Invoke(null, null);

Figure 8 Adding Event Source
  if( et != EngineType.JScript ) {
    // Add the "Clock" event source
    codeItem.AddEventSource("Clock", "ClockBox.ScriptableClock");
}
// NOTE: Visual Basic gets confused if you add an event source and a 
// global object with the same name. Luckily, you can access members of
// an event source in Visual Basic.
else {
    // Add the global "Clock" item
    IVsaGlobalItem  clockItem = items.CreateItem("Clock",
                                       VsaItemType.AppGlobal,
                                       VsaItemFlag.None);
    clockItem.TypeString = "ClockBox.ScriptableClock";
}

Figure 9 JScript .NET Versus Visual Basic .NET VSA

Feature
JScript
Visual Basic VSA
Event handling
Via manual subscription
Via named event sources
Global functions and variables
Yes
No
Global code
Yes
No
Print
Yes
No
Types from EXEs
Yes
No
Types from DLLs
Yes
Yes
VSA IDE support
No
Yes