Getting Started
AlterNET Studio allows you to extend WinForms and WPF .NET applications with code editing, scripting and user interface designing capabilities.
Installation
AlterNET Studio requires .NET Framework 4.6.1+ and Visual Studio 2017, 2019 or 2022 to be installed on the target machine.
By default AlterNET Studio installation program installs AlterNET Studio binary files to Program Files (x86)\AlterNET Software\AlterNET Studio\Bin\ folder and example projects with source code in \Users\Public\Documents\AlterNET Software\AlterNET Studio folder. These settings can be changed if you select Customize in the installation wizard.
Advanced installation options include platform selection (WinForms, WPF or both), and inclusion of Python/IronPython, TypeScript/JavaScript and LangServer/DAP features.
Installation program registers Visual Studio extensions and places controls and components on the AlterNET Code Editor, AlterNET Scripter and AlterNET Form Designer tabs in the Visual Studio toolbox.
Other versions of .NET Framework 4.5.2,.NET Core 3.0,+ Net 5.0 and .NET 6.0 are supported via NuGet packages. Complete list of NuGet packages can be found here:
https://alternetsoft.com/download#nuget
If you have a previous major version of AlterNET Studio, and decide to install the new one side-by-side, you will have two sets of Visual Studio Extensions and two sets of tabs, each one clearly displaying version number.
Demo and QuickStart projects
Once the product is installed, you can explore demos and quick start projects, either by compiling Alternet.Studio.AllDemos solutions or accessing these demos through the Demo Explorer tool which is added to Windows Start menu.
Core Components
AlterNET Studio includes the following core components:
Code Editor
AlterNET Code Editor is a component library that brings efficient code editing functionality to the .NET applications. It provides code editing capabilities such as syntax highlighting, intellisense (code completion), code outlining, visual indicators for bookmarks, line styles, syntax errors and more.
AlterNET Code Editor matches most of the features of Visual Studio code editor and is specifically tailored for C#, Visual Basic, TypeScript, JavaScript, Python and XML code editing.
Scripter
AlterNET Scripter is a component library designed to integrate C#/Visual Basic, TypeScript/JavaScript and IronPython scripts into the .NET applications. It allows extending functionality of the application logic without recompiling and redeploying the application.
AlterNET Scripter provides a framework to compile and execute user-defined scripts along with the set of debugging tools enabling application developers to make application objects available to the scripts so they can write user-defined scenarios for these applications.
Form Designer
AlterNET Form Designer is a component library providing a quick and convenient way for creating visual user interfaces. It allows placing controls to the design surfaces, setting their initial properties and writing event handlers for their events.
AlterNET Form Designer includes WinForms and WPF designers, both supporting designing visual interfaces, serializing design content and running forms being designed.
Integrating AlterNET Studio components.
AlterNET Code Editor, Scripter and Form Designer can work together in the applications that require text editing, scripting or ui designing functionality. Code Editor is tailored for C#, Visual Basic, TypeScript, JavaScript, Python and XML code editing and can be used in conjunction with Form Designer and Scripter packages to provide code editing functionality for code-behind files, writing event handlers and script editing.
Refer to our AlterNET Studio demo project to see how Code Editor, Scripter and Form Designer work together.
Licensing
AlterNET Studio requires a valid license to be installed for developing .NET applications that use its components. Evaluation-license is supplied upon AlterNET Studio installation and when consuming NuGet packages; these licenses are based on licx files technology provided by Microsoft and are valid for 30 days since first use.
Upon ordering a paid version of our product, a customer is sent a License key and will be able to activate it on the target computer. This key will support a number of activations but it is not transferable between development machines.
Oce you drag AlterNET Studio controls or components from the toolbox, such as SyntaxEdit, TextEditor, FormDesignerControl, or ScriptRun on your form, the licx file will be added to your project under Properties folder with the content like this:
Alternet.Editor.SyntaxEdit, Alternet.Editor.v8, Version=8.0.0.0, Culture=neutral, PublicKeyToken=8032721e70924a63
Alternet.Scripter.ScriptRun, Alternet.Scripter.v8, Version=8.0.0.0, Culture=neutral, PublicKeyToken=8032721e70924a63
Alternet.FormDesigner.WinForms, Alternet.FormDesigner.v8, Version=8.0.0.0, Culture=neutral, PublicKeyToken=8032721e70924a63
In case you these components are created from the code, such a licx file with above content should be added to your project. It also can be copied from our demo projects if needed.
The design-time license is being checked when you work with this component at design-time, or when the project is compiled; and the nag screen reminding about the evaluation mode will appear once in a while. If the project compiled with an evaluation version of licensed components is run outside Microsoft Visual Studio debugger, a screen suggesting that the application was created with an evaluation version of AlterNET Studio will be displayed. Once a paid license is activated using the LicenseActivation tool, this nag screen will no longer appear.
When the evaluation period expires, you will still be able to compile and run your application from within Visual Studio, however applications created with expired license will not be run in standalone mode.
Below is more information about Microsoft license compiler and some discussions related to intent and purpose of licx files, using them with source code control systems, etc.
https://msdn.microsoft.com/en-us/library/ha0k3c9f(v=vs.110).aspx
http://stackoverflow.com/questions/5628969/how-licenses-licx-file-is-used