Scribd
Upload
172 views4 pages

Wisej 2: Getting Started With Wisej 2

The document provides instructions for getting started with Wisej 2, including installing Wisej 2, creating a first Wisej application, and upgrading an existing Wisej 1.5 application to Wisej 2. It describes installing Wisej 2 templates and references in Visual Studio, changing target frameworks and references to the Wisej.Framework assembly, and updating resources.

Uploaded by

Bolfat Tloore
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
172 views4 pages

Wisej 2: Getting Started With Wisej 2

The document provides instructions for getting started with Wisej 2, including installing Wisej 2, creating a first Wisej application, and upgrading an existing Wisej 1.5 application to Wisej 2. It describes installing Wisej 2 templates and references in Visual Studio, changing target frameworks and references to the Wisej.Framework assembly, and updating resources.

Uploaded by

Bolfat Tloore
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 4

Wisej 2

Getting Started with Wisej 2


1 INSTALLATION
Since you are reading this the installation worked fine.

2 FIRST WISEJ APPLICATION


In Visual Studio, select File->New->Project.

In the New Project dialog, select Installed\Visual C#\Wisej, or Installed\Visual Basic\Wisej.

Now you should see a number of templates. Start with either the Web Application or the Web Desktop
Application template. The only difference is that Web Desktop Application also creates a desktop
component.

3 HELLO WORLD EXAMPLE


The installer has added a Wisej project in “[Current User]\Documents\Wisej\Projects\HelloWorld”. You
can start with this example instead of creating a new project.

4 ADDITIONAL EXAMPLES
You can find many new example applications at http://wisej.com/examples and on GitHub at
http://github.com/iceteagroup/wisej-examples. If you click “Watch” in GitHub you will receive a
notification when we add new examples.

5 THEME BUILDER
The theme builder executable should have a shortcut on your desktop. When you start it the first time,
it will automatically copy the built-in themes to “[Current User]\Documents\Wisej\Themes”. You can
use these files as the starting point for new themes.

Additional themes are available at http://wisej.com/themes and on GitHub at


http://github.com/iceteagroup/wisej-themes.
6 UPGRADE FROM WISEJ 1.5
To upgrade an existing Wisej 1.x application to Wisej 2 follow these easy steps:

Change the Target Framework to 4.6 or above

Wisej 2 starts at .NET 4.6. You need to change each project’s target framework to at least 4.6.

Don’t forget to change the target framework setting in web.config:


<httpRuntime targetFramework="4.5" maxRequestLength="1048576"/>
to:
<httpRuntime targetFramework="4.6" maxRequestLength="1048576"/>

Please note that if you´re using Visual Studio 2013 you need to install the targeting pack for .NET
framework 4.6.
Change Wisej.Core to Wisej Framework in web.config.

Wisej.Core is referenced in two places in web.config.


<modules>
<add name="Wisej" type="Wisej.Core.HttpModule, Wisej.Core"/>
</modules>
<handlers>
<add name="json" verb="*" path="*.json" type="System.Web.HttpForbiddenHandler" />
<add name="wisej" verb="*" path="*.wx" type="Wisej.Core.HttpHandler, Wisej.Core"/>
</handlers>
Should become
<modules>
<add name="Wisej" type="Wisej.Core.HttpModule, Wisej.Framework"/>
</modules>
<handlers>
<add name="json" verb="*" path="*.json" type="System.Web.HttpForbiddenHandler" />
<add name="wisej" verb="*" path="*.wx" type="Wisej.Core.HttpHandler,
Wisej.Framework"/>
</handlers>

Remove Wisej.Core and Wisej.Web from the project references and add Wisej.Framework only.

Under References, delete Wisej.Core and Wisej.Web in all projects and add only 1 reference to
Wisej.Framework.

Please note that the namespaces have not changed (besides the design mentioned later). So all
instructions like using wisej.web; and using wisej.core should remain as is.

Change using Wisej.Core.Design and Wise.Web.Design to Wisej.Design.

If you have used a design time feature from Wisej you may have using statements to Wisej.Core.Design
and/or Wisej.Web.Design.

They can be replaced by only one statement:


using Wisej.Design;
Ensure to use the right toolbox controls

Wisej 2.0 adds a new tab in the toolbox called Wisej 2. Please make sure to use the controls in that tab
when you are designing your windows. If you accidentally pick a control from Wisej 1.x and drop it on a
container, references to Wisej.web and Wisej.core may be readded.
In that case simply delete those references again.

If the Wisej tab is missing in your toolbox, you can add it manually and choose items from
Wisej.Framework.dll.

Ensure to use the right project and item templates

The project templates and item templates that are installed with Wisej 2.0 are listed in Wisej 2 (under
Visual Basic or Visual C#). If you accidentally pick a template from Wisej 1.x it can fail and/or add
references to Wisej.web and Wisej.core may be readded.
In that case simply delete those references again.

If your Wisej 2 templates are not showing, please check if you have selected .NET framework 4.6.
If they still don´t appear, please check the content of
C:\users\<youruser>\documents\visual studio 2012|2013|2015|2017\templates
If you don´t see the files under Project Templates or Item Templates, you can download them from the
following locations:

http://wisej.s3.amazonaws.com/downloads/Templates/CSharpTemplates.zip
http://wisej.s3.amazonaws.com/downloads/Templates/VBNetTemplates.zip

If they are present or don´t show after you copied them to the target location run an elevated Visual
Studio Command Prompt and execute the following command:
devenv /installvstemplates

Ensure to use the 2.0 extensions

Please check all your references and change them from the 1.x extensions to the 2.0 extensions.

Upgrade resources

Search for all *.resx and do a global replace of


“Wisej.Web, Version=1.0.0.0” with “Wisej.Framework, Version=2.0.0.0” and
“Wisej.Core, Version=1.0.0.0” with “Wisej.Framework, Version=2.0.0.0”

See also http://wisej.com/docs/html/UpgradeFromWisej1.htm.

You might also like