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
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
|
|