https://github.com/tyranid/dotnettojscript

A tool to create a JScript file which loads a .NET v2 assembly from memory.
https://github.com/tyranid/dotnettojscript

Last synced: 13 days ago
JSON representation

A tool to create a JScript file which loads a .NET v2 assembly from memory.

• Host: GitHub
• URL: https://github.com/tyranid/dotnettojscript
• Owner: tyranid
• License: gpl-3.0
• Created: 2017-04-08T23:41:17.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2021-01-18T22:52:10.000Z (almost 4 years ago)
• Last Synced: 2024-10-26T13:22:43.556Z (16 days ago)
• Language: C#
• Size: 55.7 KB
• Stars: 1,234
• Watchers: 48
• Forks: 298
• Open Issues: 7
• Metadata Files:
  • Readme: README
  • License: LICENSE

Awesome Lists containing this project

README

        
This file is part of DotNetToJScript - A tool to generate a 

JScript which bootstraps an arbitrary .NET Assembly and class.

Copyright (C) James Forshaw 2017

DotNetToJScript is free software: you can redistribute it and/or modify

it under the terms of the GNU General Public License as published by

the Free Software Foundation, either version 3 of the License, or

(at your option) any later version.

DotNetToJScript is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

GNU General Public License for more details.

You should have received a copy of the GNU General Public License

along with DotNetToJScript.  If not, see .

Usage Notes:

This only works from full trust JScript(obviously), so should work in

scriptlets etc. By default it will only works if v2/v3/v3.5 is installed.

However if you specify the '-ver auto' switch when building the output it

will also work on v4+ only, however that will introduce a dependency on

WScript.Shell which you might not want.

To use this you'll need to create an assembly which targets .NET 2 (though

in most cases you can also use 3.5 as you don't tend to see .NET 2 installed

in isolation. In the assembly implement a class called TestClass which does

something you want to do in the public, parameterless constructor.

public class TestClass

{

    public TestClass()

    {

        /* Start notepad */

        Process.Start("notepad.exe");

    }

}

Ensure it's public. Then pass to this tool the path to the .NET assembly.

If you annotate the class with the ComVisible attribute you can even interact

with the object after it's created. e.g.

[ComVisible(true)]

public class TestClass

{

    public void DoSomething(string arg) { }

}

You can change the name of the entry class by using the -c switch and adding the name.

You can also get the tool to add additional code to interact with the object by

specifying the -s parameter with the path to a text file containing the additional

JScript. The created object is named 'o', so for example if you wanted to call

the DoSomething method load a file containing:

o.DoSomething("SomeArg");

The default mode is to output a JScript file which can be executed in Windows

Scripting Host. However if you want a scriptlet pass either -m (for a scriptlet

which can be used from a scriptlet moniker) or -u (for a scriptlet which can be

used from regsvr32). You can also specify the '-l vba' switch to output a VBA 

file which should work in Office Macros or '-l vbscript' for VBScript.

Finally by default the tool will output to stdout, you can output direct to a file

using the -o switch.